Mace Config

<div align="center"> <img src="https://cdn.modrinth.com/data/GggKSyTG/images/e86c31a2cb619f395fb9c015ec60db91fc960981.png" alt="Mace Config icon"> <p>Server-side control over mace limits, enchantments, combat rules, and owner visibility.</p> <p> <img src="https://img.shields.io/badge/platforms-Bukkit%20%7C%20Spigot%20%7C%20Paper%20%7C%20Purpur-F2A900" alt="Platforms: Bukkit, Spigot, Paper, and Purpur"> <img src="https://img.shields.io/badge/Minecraft-26.1%E2%80%9326.2-62B47A" alt="Minecraft: 26.1–26.2"> <img src="https://img.shields.io/badge/license-GPL--3.0--only-blue" alt="License: GPL-3.0-only"> </p> </div> | 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. !(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. !(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. !(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 (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 - (https://papermc.io/downloads/paper) - (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`<br> 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 | <details> <summary><strong>Build from source</strong></summary> 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-<version>.jar`. The same jar supports Minecraft 26.1–26.2. </

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.

!(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.

!(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.

!(https://cdn.modrinth.com/data/GggKSyTG/images/6ead27e0e47b150989c8286f3752caf9076a1bb4.png)

1. Install a supported Bukkit-based server for Minecraft 26. 1 or 26. 2. 2. Download the Mace Config `.jar` from (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
• (https://papermc.io/downloads/paper)
• (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.

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 ` | Set an allowed enchantment's maximum level | | `/maceconfig whitelist add ` | Allow an enchantment on maces | | `/maceconfig whitelist remove ` | 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:

```text gradle clean build ```

The distributable jar is written to `build/libs/MaceConfig-.jar`. The same jar supports Minecraft 26. 1–26. 2.