# 
OneMace - The Ultimate Mace Restrictor
##
Overview
OneMace is a highly specialized Paper/Spigot plugin designed to restrict, track, and punish the use of the Mace. It ensures that only a configurable amount of Maces can ever exist in the world through natural crafting. It aggressively tracks ownership and prevents players from hoarding, stashing, or hiding the Mace. If a player attempts to break the rules, the Mace will shatter into nothingness!
##
Core Features
* Global Crafting Limit: By default, only 1 Mace can be crafted on the server. If the limit is reached, any further attempts to craft a Mace are blocked.
* Persistent Ownership Tracking: The plugin uses UUIDs stored directly in the item's PersistentDataContainer. It remembers exactly who owns the Mace.
* Anti-Stash & Anti-Hoard: The Mace CANNOT be dropped, except upon death. Furthermore, the Mace CANNOT be stored in Chests, Barrels, Shulkers, Hoppers, Droppers, Dispensers, Item Frames, Decorated Pots, Shelves, or Chiseled Bookshelves.
* Shatter Punishment System: If a player attempts to illegally drop or store the Mace 10 times, the Mace will instantly shatter and be wiped from their inventory, freeing up the crafting slot for someone else.
* Offline Decay: If the owner of the Mace does not log into the server for 48 hours, their Mace will shatter while they are offline.
* Failsafe Tracking: If the Mace illegally leaves the player's inventory and remains missing for 10 seconds, it will automatically shatter.
* Element Hazards: If the Mace is thrown into Lava, Fire, or the Void, it will shatter.
* Admin "Shard Maces": Admins can use Creative Mode or /give to spawn additional Maces. These bypass the global crafting limit, but they are automatically branded as Shard Maces and are still subject to all the exact same anti-stash and shattering rules!
##
Commands & Permissions
| Command | Description | Permission |
|---|---|---|
| /mace | Displays the current status of all Maces in the world, shows taken crafted slots, and lists all players holding a Mace (differentiating True vs. Shard Maces). | None |
| /mace give <player> | Transfers your ownership of the Mace to another online player. This command has a 1-hour cooldown per player! | None |
| /maceadmin give <player> | Spawns and directly gives an Admin Shard Mace to the specified player. | onemace.admin |
| /maceadmin reset | Completely wipes the plugin's data, invalidates current Maces (shattering them upon next interaction), and resets the global crafting limit to 0. | onemace.admin |
| /maceadmin reload | Reloads the config.yml and messages.yml files. | onemace.admin |
PlaceholderAPI Integrations
You can use these placeholders in scoreboards, chat formatting plugins, or holograms (Requires PlaceholderAPI).
* %onemace_crafted_count% - Returns the current number of naturally crafted Maces in the world.
* %onemace_max_count% - Returns the maximum allowed naturally crafted Maces from the config.
* %onemace_owner_name% - Returns the username of the player who currently holds the true Crafted Mace (Returns "None" if unowned).
* %onemace_has_mace% - Returns true if the viewer currently holds any active Mace (Crafted or Shard), and false otherwise.
* %onemace_warnings% - Returns the viewer's current shatter warning count (e.g., 0 to 10).
##
Configuration
You can tweak the exact limits, decay times, and cooldowns directly in the config.yml configuration file:
* mace.max_crafted_maces: The global limit of how many natural Maces can exist.
* warnings.max_warnings: How many illegal actions before the Mace shatters.
* mace.give_cooldown_seconds: Cooldown for the /mace give command.
* punishments.offline_timeout_hours: How many hours before an offline player's Mace shatters.
##
Support & Installation
1. Download the .jar file and drop it into your server's plugins folder.
2. Restart your server to generate the configuration files.
3. Configure your limits in plugins/OneMace/config.yml and use /maceadmin reload.
4. (Optional) Install PlaceholderAPI to utilize the custom placeholders.
OneMace - The Ultimate Mace Restrictor##
OverviewOneMace is a highly specialized Paper/Spigot plugin designed to restrict, track, and punish the use of the Mace. It ensures that only a configurable amount of Maces can ever exist in the world through natural crafting. It aggressively tracks ownership and prevents players from hoarding, stashing, or hiding the Mace. If a player attempts to break the rules, the Mace will shatter into nothingness!
##
Core Features* Global Crafting Limit: By default, only 1 Mace can be crafted on the server. If the limit is reached, any further attempts to craft a Mace are blocked.
* Persistent Ownership Tracking: The plugin uses UUIDs stored directly in the item's PersistentDataContainer. It remembers exactly who owns the Mace.
* Anti-Stash & Anti-Hoard: The Mace CANNOT be dropped, except upon death. Furthermore, the Mace CANNOT be stored in Chests, Barrels, Shulkers, Hoppers, Droppers, Dispensers, Item Frames, Decorated Pots, Shelves, or Chiseled Bookshelves.
* Shatter Punishment System: If a player attempts to illegally drop or store the Mace 10 times, the Mace will instantly shatter and be wiped from their inventory, freeing up the crafting slot for someone else.
* Offline Decay: If the owner of the Mace does not log into the server for 48 hours, their Mace will shatter while they are offline.
* Failsafe Tracking: If the Mace illegally leaves the player's inventory and remains missing for 10 seconds, it will automatically shatter.
* Element Hazards: If the Mace is thrown into Lava, Fire, or the Void, it will shatter.
* Admin "Shard Maces": Admins can use Creative Mode or /give to spawn additional Maces. These bypass the global crafting limit, but they are automatically branded as Shard Maces and are still subject to all the exact same anti-stash and shattering rules!
##
Commands & Permissions| Command | Description | Permission |
|---|---|---|
| /mace | Displays the current status of all Maces in the world, shows taken crafted slots, and lists all players holding a Mace (differentiating True vs. Shard Maces). | None |
| /mace give <player> | Transfers your ownership of the Mace to another online player. This command has a 1-hour cooldown per player! | None |
| /maceadmin give <player> | Spawns and directly gives an Admin Shard Mace to the specified player. | onemace.admin |
| /maceadmin reset | Completely wipes the plugin's data, invalidates current Maces (shattering them upon next interaction), and resets the global crafting limit to 0. | onemace.admin |
| /maceadmin reload | Reloads the config.yml and messages.yml files. | onemace.admin |
##
PlaceholderAPI IntegrationsYou can use these placeholders in scoreboards, chat formatting plugins, or holograms (Requires PlaceholderAPI).
* %onemace_crafted_count% - Returns the current number of naturally crafted Maces in the world.
* %onemace_max_count% - Returns the maximum allowed naturally crafted Maces from the config.
* %onemace_owner_name% - Returns the username of the player who currently holds the true Crafted Mace (Returns "None" if unowned).
* %onemace_has_mace% - Returns true if the viewer currently holds any active Mace (Crafted or Shard), and false otherwise.
* %onemace_warnings% - Returns the viewer's current shatter warning count (e.g., 0 to 10).
##
ConfigurationYou can tweak the exact limits, decay times, and cooldowns directly in the config.yml configuration file:
* mace.max_crafted_maces: The global limit of how many natural Maces can exist.
* warnings.max_warnings: How many illegal actions before the Mace shatters.
* mace.give_cooldown_seconds: Cooldown for the /mace give command.
* punishments.offline_timeout_hours: How many hours before an offline player's Mace shatters.
##
Support & Installation1. Download the .jar file and drop it into your server's plugins folder.
2. Restart your server to generate the configuration files.
3. Configure your limits in plugins/OneMace/config.yml and use /maceadmin reload.
4. (Optional) Install PlaceholderAPI to utilize the custom placeholders.
