BlissMaces

A Paper plugin that turns the vanilla Mace into a server-wide mythic artifact. Built for the Bliss SMP — only three individual maces and one Mega Mace can ever exist on your server, gated behind a finite, craftable currency.

Overview

• 3 individual maces ever, server-wide. Persistent across restarts.
• 24 Energy Tokens ever, the sole resource that crafts maces.
• Mega Mace assembled from all three — splits back to 3 on the holder's death.
• Cooldown + enchant restrictions on individual maces.
• Storage lockdown — restricted maces can't be hidden in chests, ender chests, shulker boxes, hoppers, etc.
• Indestructible — unbreakable in hand, immune to fire / lava / explosions / void as a dropped item entity.

Recipes

The vanilla mace recipe is removed. Maces can only be crafted through this chain.

Energy Token

Yields 1 Energy Token — an Amethyst Shard with custom NBT, purple display name, and a subtle glow.

Individual Mace (numbered 1, 2, then 3)

8 Energy Tokens around 1 Heavy Core. The first craft produces Mace #1, the second Mace #2, the third Mace #3. Crafting after that fails — the cap is permanent.

Mega Mace

Place all three individual maces in any crafting grid (shapeless). One player must hold all three at once. Crafting a Mega Mace is broadcast server-wide.

Mace mechanics

Individual maces

• 1-minute cooldown between successful hits, per mace, persisted on the item.
• No damage enchantments — Sharpness, Smite, Bane, Density, Breach, and Fire Aspect are stripped at the anvil and enchanting table, and re-scrubbed every time the mace is used.
• Action-bar countdown shows on each blocked hit attempt.

Mega Mace

• No cooldown, no enchantment restrictions.
• Carries a permanent glow and Unbreakable: true.
• On the holder's death, splits back into the three individual maces and drops as loot. Broadcasts to the server.

Indestructibility

All four mace variants are:

• Unbreakable in hand — no durability decay.
• Damage-immune as dropped item entities — fire, lava, cactus, explosions, and the void all cancel.
• Combust-immune — they never visually catch fire.

Storage restriction

Restricted maces may only enter these inventories:

• Player inventory
• 2×2 crafting grid + crafting table
• Anvil
• Enchanting table
• Grindstone

They are blocked from chests, ender chests, shulker boxes, barrels, hoppers, droppers, dispensers, furnaces, brewing stands, and anything else. Click, drag, hopper transfer, and hopper pickup are all intercepted with a clear action-bar warning.

Commands

Command	Description
/mace give <1|2|3|mega> [player]	Spawn a tagged mace.
/mace token give <amount> [player]	Spawn Energy Tokens (admin / testing).
/mace state	Show current counters vs. hard caps.
/mace set <tokens|maces> <count>	Override the persisted counters.
/mace fix [player|all]	Re-issue tagged maces in inventories + ender chests using the current formatting. Preserves mace number and cooldown state.
/mace reload	Reload config.yml and state.yml.

All commands require blissmaces.admin (default: op).

Configuration

config.yml keys, with defaults:

cooldown-seconds: 60
blocked-enchantments:
  - sharpness
  - smite
  - bane_of_arthropods
  - fire_aspect
  - density
  - breach
max-tokens: 24
max-individual-maces: 3
individual-name-format: "&6Mace &e#{number}"
mega-mace-name: "&5&lMega Mace"
cooldown-actionbar: "&cMace cooldown: &e{seconds}s"
enchant-blocked-message: "&cThat enchantment is not allowed on an individual mace."
mega-craft-broadcast: "&5&l{player} &dhas forged the &5&lMega Mace&d!"
mega-death-broadcast: "&d{player} &7died holding the &5&lMega Mace&7 - it split back into 3 maces."
individual-craft-broadcast: "&6{player} &eforged &6Mace #{number}&e!"

Persistent state — tokens-crafted and maces-crafted — lives in plugins/BlissMaces/state.yml. Edit the file or use /mace set to reset.

Requirements

• Paper 1.21.x (Purpur and other forks also fine; not Folia-compatible)
• Java 21

Installation

1. Drop blissmaces-X.X.X.jar into your server's plugins/ folder.
2. Restart the server.
3. Defaults are production-ready. Tune config.yml if you want different caps, messages, or blocked enchants.

Notes

• The plugin removes the vanilla minecraft:mace recipe and additionally voids any third-party recipe that would produce an untagged mace, so the token chain is the only path on your server.
• Maces issued through /give minecraft:mace ... are plain vanilla maces and do not participate in the cooldown, enchant, or storage logic. Always use /mace give instead.
• Caps are persistent. Once 24 tokens have been crafted, no more can ever be made (unless you reset state.yml or run /mace set tokens 0).