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

| 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](https://cdn.modrinth.com/data/cached_images/a0e8a7ea55323675b188b00a96f48c07adc69bcd.png) ### Set enchantment limits visually Open the enchantment editor to allow or block each mace enchantment and select its maximum level. ![Mace enchantment editor](https://cdn.modrinth.com/data/GggKSyTG/images/be831bfea3d732a4878da51e8efafafeb0b267b6.png) ### Recognize blocked crafts immediately When the mace limit is reached, the crafting result becomes an uncraftable barrier indicator. ![Blocked mace crafting result](https://cdn.modrinth.com/data/GggKSyTG/images/6ead27e0e47b150989c8286f3752caf9076a1bb4.png) ## Install 1. Install a supported Bukkit-based server for Minecraft 26.1 or 26.2. 2. Download the Mace Config `.jar` from [Modrinth](https://modrinth.com/plugin/mace-config). 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](https://papermc.io/downloads/paper) - [Purpur](https://purpurmc.org/) 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 ` | Set the crafting limit; `0` is unlimited | | `/maceconfig set cooldown ` | Set the custom attack cooldown; `0` disables it | | `/maceconfig set revealinterval ` | Set the position reveal interval; minimum `5` seconds | | `/maceconfig set color ` | Set the shared owner, tab-list, and dropped-mace color | | `/maceconfig toggle ` | Toggle `enchantable`, `glow`, `tab`, `reveal`, `craftedchat`, `fullchat`, or `fulltitle` | | `/maceconfig enchantlevel

Build from source

JDK 25 is required. From the repository root, build the single API target that covers the full supported Minecraft range: ```text gradle clean build ``` The distributable jar is written to `build/libs/MaceConfig-.jar`. The same jar supports Minecraft 26.1–26.2.

GPL-3.0-only · 2026 · NullKeeper-dev

Mace Config

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

Blocked mace crafting result

Settings Panel

Mace Enchantment Editor

Title