Описание
# 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)
- **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-enchanting` is 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 ` | `limitedmaces.setlimit` | Set the number of maces |
| `/maces enchanting ` | `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 ` | `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[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":
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