?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Mace Config

Mace Config

A plugin that provides various customizations for the mace on SMPs.

143downloads
1follower
143downloads
1follower

Compatibility

Minecraft: Java Edition

26.2
26.1.x

Platforms

Links

Report issues View source

Tags

Creators

Details

Licensed GPL-3.0-only
Published 3 weeks ago
Updated 6 hours ago
Mace Config icon

Server-side control over mace limits, enchantments, combat rules, and owner visibility.

Platforms: Bukkit, Spigot, Paper, and Purpur Minecraft: 26.1–26.2 License: GPL-3.0-only

Feature What it does Control
Craft limits Caps the number of tracked maces that can be crafted server-wide Config or GUI
Enchantment rules Allows selected enchantments and enforces a maximum level for each Config, GUI, or commands
Combat balance Adds an optional custom mace attack cooldown Config, GUI, or command
Owner visibility Colors owner glow, dropped maces, and tab-list names Config, GUI, or commands
Position reveals Announces mace wielder locations at a configurable interval Config, GUI, or commands
Milestone alerts Announces mace crafts and when the server-wide limit is reached Config or GUI

See it in action

Configure mace rules from one menu

Run /maceconfig gui to manage limits, combat rules, owner visuals, announcements, tracking, and reloads.

Mace Config settings panel

Set enchantment limits visually

Open the enchantment editor to allow or block each mace enchantment and select its maximum level.

Mace enchantment editor

Recognize blocked crafts immediately

When the mace limit is reached, the crafting result becomes an uncraftable barrier indicator.

Blocked mace crafting result

Install

  1. Install a supported Bukkit-based server for Minecraft 26.1 or 26.2.
  2. Download the Mace Config .jar from Modrinth.
  3. Place the .jar in the server's plugins directory.
  4. Restart the server, then confirm that Mace Config appears in /plugins.

Mace Config has no hard plugin dependencies.

Compatibility

Mace Config supports Minecraft 26.1–26.2 on:

  • CraftBukkit (Bukkit)
  • Spigot
  • Paper
  • Purpur and other non-regionized, Paper-compatible forks

Folia and other region-threaded server software are not currently supported. Mace Config is server-side only; players do not need to install anything.

Use

  1. Join with the maceconfig.admin permission; server operators receive it by default.
  2. Run /maceconfig gui to open the main settings menu.
  3. Select a category to configure mace limits, enchantments, cooldowns, owner visuals, reveals, or announcements.
  4. Run /maceconfig refresh after changing or restoring player storage to recount tracked maces held by online players.
  5. Use /maceconfig reload after editing plugins/MaceConfig/config.yml directly.

Tip: A refresh scans online player inventories, ender chests, and nested shulker boxes. It does not scan offline players or arbitrary world containers.

Commands

Aliases: /macecfg, /mcconfig
Permission: maceconfig.admin

Command Purpose
/maceconfig gui Open the interactive settings menu
/maceconfig reload Reload config.yml and restart configuration-dependent tasks
/maceconfig refresh Recount tracked maces in online player storage
/maceconfig set limit <amount> Set the crafting limit; 0 is unlimited
/maceconfig set cooldown <seconds> Set the custom attack cooldown; 0 disables it
/maceconfig set revealinterval <seconds> Set the position reveal interval; minimum 5 seconds
/maceconfig set color <color> Set the shared owner, tab-list, and dropped-mace color
/maceconfig toggle <setting> Toggle enchantable, glow, tab, reveal, craftedchat, fullchat, or fulltitle
/maceconfig enchantlevel <enchantment> <max-level> Set an allowed enchantment's maximum level
/maceconfig whitelist add <enchantment> Allow an enchantment on maces
/maceconfig whitelist remove <enchantment> Block an enchantment on maces
/maceconfig whitelist list Show allowed mace enchantments
Build from source

JDK 25 is required. From the repository root, build the single API target that covers the full supported Minecraft range:

gradle clean build

The distributable jar is written to build/libs/MaceConfig-<version>.jar. The same jar supports Minecraft 26.1–26.2.

GPL-3.0-only · 2026 · NullKeeper-dev