Limited Maces

# LimitedMaces **Limited Maces** is a small, server-sided mod which allows server administrators to fully control the quantity of **Maces** on their server at any time. It's great for hardcore, SMP or event servers where rare items have to stay truly rare. > Want a *one-mace server* like the Lifesteal SMP? Just set the mace limit to **1**! ### Features - **Mace Count for Server** Establish a definite number of maces that can be in existence within the entire server. - **Mace Container Restrictions** Maces **cannot** be stored in: - Chests - Barrels - Shulker Boxes - All other containers Hoppers **cannot** collect maces. - **Mace Crafting Restriction** - **The mace recipe becomes automatically disabled when limit is reached** - **Autocrafters cannot make maces** - Messages will be sent globally regarding any mace state changes (discord webhook support incoming!!!) - **Destruction Handling** - When the mace gets destroyed: - Server-wide **broadcast message** is sent out - Another mace can be crafted (up to the maximum limit) - **Cleanup of Illegal Maces** - All unregistered and duplicate maces get deleted - **Enchantment Option** - Decide whether you want to make the maces enchantable or not - If `allow-mace-enchanting` is **enabled**, maces can be put in **Enchanting Table** and **Anvils** - If it is **disabled**, maces cannot be put in any enchant 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` ```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&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": 1. Plugin will detect automatically the old plugin folder: `plugins/MultiMace/` 2. Configurations/data will migrate to `plugins/LimitedMaces/` 3. Old folder will be automatically deleted after successful migration. 4. 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