Bliss Maces

!(https://cdn.modrinth.com/data/cached_images/df9f28a60cb059fb48c7af78015b042fe739548a.png)

# 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.

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

### Energy Token

!(https://cdn.modrinth.com/data/cached_images/4a4b30efdb36b6c10f2976b6c94871e1b6647f83.png)

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

### Individual Mace (numbered 1, 2, then 3)

!(https://cdn.modrinth.com/data/cached_images/9c8d8034d7118174718e4bae6a4072673a6ba5bc.png)

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

!(https://cdn.modrinth.com/data/cached_images/25a74a40c26359c8ed6fc63a71c0e0c99d526249.png)

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> ` | Spawn a tagged mace. | | `/mace token give ` | Spawn Energy Tokens (admin / testing). | | `/mace state` | Show current counters vs. hard caps. | | `/mace set ` | Override the persisted counters. | | `/mace fix ` | 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:

```yaml 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.

- 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