LimitedMaces
Limited Maces is a small, server-sided plugin that allows server administrators to fully control the number of Maces on their server at any time. It's great for hardcore servers, SMPs, or event servers where rare items have to stay rare.
Want a one-mace server like the Lifesteal SMP? Just set the mace limit to 1!
⚠️ Warning
Spigot and Bukkit support has officially been dropped as of version 1.3.0! Although unlikely, the plugin may work with Spigot/Bukkit; however, we will not test or officially support these server softwares since they are considered outdated.
Features
-
Mace Count for Server Establish a definite number of maces that can exist on the entire server.
-
Mace Container Restrictions
Maces cannot be stored in:- Chests
- Barrels
- Shulker Boxes
- Hoppers
- All other containers
-
Mace Crafting Restrictions
- The mace recipe becomes automatically disabled when the limit is reached
- Autocrafters cannot craft maces
- Messages will be sent in chat if any mace's state changes (Discord webhook support may come in the future)
-
Destroyed Maces
- When the mace gets destroyed:
- A server-wide chat message is sent out
- Another mace can be crafted (up to the maximum limit)
- When the mace gets destroyed:
-
Illegal Mace Detector
- All tracked and duplicate maces get deleted
-
Enchanted Maces
- Decide whether you want to make the maces enchantable or not
- If
allow-mace-enchantingis enabled, maces can be put in enchant tables and anvils. - If it is disabled, maces cannot be put in any enchantment table or anvil and become completely unenchantable
Commands
| Command | Permission | Description |
|---|---|---|
/maces |
limitedmaces.use |
Check tracked maces |
/maces reload |
limitedmaces.reload |
Reload configuration file |
/maces setlimit <n> |
limitedmaces.setlimit |
Set the number of maces |
/maces enchanting <on\|off> |
limitedmaces.enchanting |
Turn on/off mace enchanting |
/getuntrackedmace |
limitedmaces.getuntracked |
Get an untracked mace (ignores the limit) |
/clearuntrackedmaces |
limitedmaces.clearuntracked |
Clear all untracked maces |
/removemace <id> |
`limitedmaces |
Configuration
Configuration file location: plugins/LimitedMaces/config.yml
Data file location: plugins/LimitedMaces/maces.yml. DO NOT EDIT THIS FILE UNLESS YOU KNOW WHAT YOU ARE DOING.
Default / Example config.yml
version: 1.2.1
# Max number of maces that are allowed on the server
allowed-maces: 3
# Allow enchants on the maces
# When set to false, maces won't be allowed to be placed in enchant tables / anvils
allow-mace-enchanting: 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
Migrating from MultiMace
In case you are coming from an older release (version 1.1.3 and below) using the name "MultiMace":
- Plugin will detect automatically the old plugin folder:
plugins/MultiMace/ - Configurations/data will migrate to
plugins/LimitedMaces/ - Old folder will be automatically deleted after successful migration.
- Prefix will change from "MultiMace" to "LimitedMaces". Any custom prefix will be replaced as well!
Should you experience problems regarding the process above or it is not automatically done, feel free to stop by our Discord and create a ticket. Link available on the sidebar.
Compatibility
- Minecraft 1.21.x
- Lightweight
- No dependencies needed
All Versions
+ Add Version- Spigot and Bukkit support has officially been dropped! Although unlikely, the plugin may work with Spigot/Bukkit; however, we will not test or officially support these server softwares since they are considered outdated.
- Added Folia support with region-owned inventory/item work and serialized mace registry updates
- Added optional offline inactivity destruction, disabled by default with a configurable 21-day timeout
- Save offline inventory changes atomically, preserve backups, and broadcast after saving
- Preserve removed mace identities across restarts to prevent stale copies from being registered again
- Ignore item unloads and pickups when detecting destruction
- Keep Folia recipes registered while enforcing the global cap in crafting events
- Added
/limitedmaces info,/limitedmaces reload, and/limitedmaces update - Added exact Minecraft-version filtering through the Modrinth API
- Added verified update downloads into the server plugins folder
- Added delayed startup notices when a compatible update is available
- Kept virtual player-inventory views from OpenInv, InvSee++, and similar plugins exempt from physical-container restrictions
- Reconciled mace ownership after virtual and direct player-inventory transfers
- Added Minecraft Java Edition 26.x compatibility validation through the configurable Spigot API target
- Documented support for Minecraft 1.21.x and Java Edition 26.x
- Bug fixes to mace crafting to track maces better.
- New config option**:
block-container-storage- When set totrue(default), prevents maces from being stored in containers. Set tofalseto allow storing maces in chests, hoppers, etc. - Config auto-update**: Existing configs will automatically receive the new option when upgrading
## Version 1.1.4
- Renamed plugin files, config, and commands** from "MultiMace" to "LimitedMaces" to match Modrinth name
- New folder structure**: Config and data files now stored directly in
plugins/LimitedMaces/instead of subfolders config.ymlis now atplugins/LimitedMaces/config.ymlmaces.ymlis now atplugins/LimitedMaces/maces.yml- New commands**:
/maces setlimit <n>- Change the mace limit in-game/maces enchanting <on|off>- Toggle mace enchanting in-game/removemace <id>- Remove a specific mace from the plugin (also removes item from players, containers, and dropped items)- New permissions**:
limitedmaces.setlimit- Permission to change mace limitlimitedmaces.enchanting- Permission to toggle enchantinglimitedmaces.remove- Permission to remove maces- Automatic migration**: Servers upgrading from 1.1.3 or earlier will have their config and data automatically migrated from the old
MultiMacefolder - All permissions renamed from
multimace.*tolimitedmaces.*
## Version 1.1.3
- Fixed bug where grindstones can not be used to disenchant the mace when enchants are allowed.
## Version 1.1.2
- Patched bug with /maces where you can see the mace holder's coordinates.
## Version 1.1.1
### New Features
- Added detection for maces destroyed via
/killcommand or other forced removals - Maces can no longer be taken from the creative menu item list - they must be crafted to prevent certain bugs
- Added
/getuntrackedmacecommand to give yourself an untracked mace that bypasses the mace limit - Added
/clearuntrackedmacescommand to remove all untracked maces from the server
### Technical Changes
- Improved item removal detection to distinguish between pickups, natural despawns, and forced removals
This also fixes the bug where maces could not be put into anvils or enchantment tables.