LimitedMaces

Warning

In this repository, the changelogs and README are generated by AI, so they include more info but could be inaccurate. The code itself is NOT AI-generated.

Download on Modrinth: https://modrinth.com/plugin/limitedmaces

LimitedMaces is a lightweight server-side plugin that gives server owners full control over how many Maces can exist on the server at any given time. Perfect for hardcore, SMP, or special-event servers where powerful items should stay rare and meaningful.

💡 Want a one-mace server like the Lifesteal SMP? Just set the mace limit to 1!

---

Features

• Global Mace Limit
  Set a hard cap on how many maces may exist across the entire server.

• Container Restrictions
  Maces cannot be placed into:

  • Chests
  • Barrels
  • Shulker Boxes
  • Any other container

  Virtual player-inventory views from administration plugins such as OpenInv and InvSee++ remain usable. Mace ownership tracking is reconciled after transfers through these views.

  Hoppers cannot pick up maces.

• Crafting Control

  • The mace crafting recipe is disabled automatically once the limit is reached
  • Autocrafters cannot craft maces
  • Global messages are sent out about mace status changes (discord webhook feature coming soon!!!)

• Destruction Handling

  • When a mace is destroyed:
    • A server-wide broadcast is sent
    • A new mace can be crafted again (until the limit is reached)

• Illegal Mace Cleanup

  • Untracked or duplicated maces are automatically removed

• Optional Enchanting

  • Control whether maces can be enchanted
  • When allow-mace-enchanting is true, maces can be placed into Enchanting Tables and Anvils
  • When false, maces cannot be placed into enchant tables or anvils, making them completely unenchantable

• Update Management

  • Check the latest Modrinth version compatible with the server's exact Minecraft version
  • Download compatible updates directly into the server's plugins folder
  • Receive a startup warning when a newer compatible version is available

---

Commands

Command	Permission	Description
/limitedmaces or /limitedmaces info	limitedmaces.info	View installed and latest compatible versions
/limitedmaces reload	limitedmaces.reload	Reload config.yml
/limitedmaces update	limitedmaces.update	Download the latest compatible version from Modrinth
/maces	limitedmaces.use	View tracked maces
/maces reload	limitedmaces.reload	Reload the config
/maces setlimit <n>	limitedmaces.setlimit	Set the mace limit
/maces enchanting <on|off>	limitedmaces.enchanting	Enable/disable mace enchanting
/getuntrackedmace	limitedmaces.getuntracked	Get an untracked mace (bypasses limit)
/clearuntrackedmaces	limitedmaces.clearuntracked	Clear all untracked maces
/removemace <id>	limitedmaces.remove	Remove a mace from the plugin and world

---

Configuration

Configuration file is located at: plugins/LimitedMaces/config.yml

Data file is located at: plugins/LimitedMaces/maces.yml. DO NOT TOUCH THIS UNLESS YOU KNOW WHAT YOU ARE DOING.

Default / Example config.yml

version: 1.2.1

# Maximum number of maces allowed on the server
allowed-maces: 3

# Whether maces can be enchanted
# If false, maces cannot be placed into enchant tables or anvils
allow-mace-enchanting: true

# Whether physical containers reject maces
block-container-storage: true

messages:
  prefix: "&6[LimitedMaces]&r "
  crafted-broadcast: "&a%player% &7crafted &f%amount%&7 mace(s)! &7(%current%/%max%)"
  destroyed-broadcast: "&cA mace was destroyed! &7(last held by &f%lastHolder%&7) &7(%current%/%max%)"
  containers-blocked: "&cYou can't put the mace in any container."
  limit-reached: "&cMace limit reached. A mace must be destroyed before another can be crafted."
  illegal-removed: "&cAn illegal/untracked mace was removed."
  reload: "&aLimitedMaces config reloaded."
  no-permission: "&cYou don't have permission."
  limitedmaces-usage: "&cUsage: /limitedmaces <info|reload|update>"
  update-checking: "&7Checking Modrinth for the latest compatible version..."
  update-in-progress: "&eA LimitedMaces update is already in progress."
  update-no-compatible-version: "&cNo LimitedMaces version supports Minecraft %game_version%."
  update-up-to-date: "&aLimitedMaces is already up to date at version %version%."
  update-downloading: "&eDownloading LimitedMaces %version% from Modrinth..."
  update-success: "&aLimitedMaces %version% was downloaded. Restart the server for the update to take effect."
  update-failed: "&cLimitedMaces update failed: %error%"

---

Migration from MultiMace

If you're upgrading from an older version (1.1.3 or earlier) that used the "MultiMace" name:

1. The plugin will automatically detect the old plugins/MultiMace/ folder
2. Config and data will be migrated to the new plugins/LimitedMaces/ folder
3. The old folder will be deleted after successful migration
4. Prefix "MultiMace" will be updated to "LimitedMaces". If you set a custom prefix, this may override that.

If this is not automatically done or you face issues with this process, feel free to join our Discord and open a ticket. Link is in the sidebar.

---

Compatibility

• Minecraft 1.21.x
• Minecraft Java Edition 26.x
• Designed to be lightweight and efficient
• No dependencies required

The default Gradle build uses the 1.21.8 Spigot API baseline so one jar remains compatible with 1.21.x servers. To validate against a 26.x API, run:

./gradlew build -PminecraftApiVersion=26.2