Item Restriction

# RestrictionsPlugin **A comprehensive, fully configurable restriction system for Paper 1.21.11 servers.** Ban items, limit stack sizes, cap durability, block enchants, control crafting and dropping — all from an in-game GUI or via commands, with no restart required. --- ## ✦ Features ### Global Mechanic Restrictions Individually toggleable rules that target specific vanilla mechanics known to cause balance or exploit issues on SMP servers: | Restriction | What it does | |---|---| | **Totem of Undying** | Totems never drop anywhere. If a player somehow obtains one it is immediately removed from their inventory. | | **End Crystal & Respawn Anchor** | Cannot be crafted, picked up, placed, or moved through hoppers. Existing anchors drop nothing when broken. | | **Mace** | Cannot be obtained or crafted. Does no damage. | | **Elytra** | Cannot be picked up, worn, or used to glide. | | **Potions** | Bans Strength II, Speed II, Turtle Master I & II in all forms (regular, splash, lingering). Brewing is blocked. | | **TNT Minecart** | Maximum 2 per chunk. Cannot be ignited by fire, flame enchanted arrows, fire charges, lava, or any other combustion source. | | **TNT Duper Fix** | Pistons cannot push or pull TNT blocks, eliminating the most common duplication exploits. | | **Mending Trades** | Regular villagers cannot offer or learn Mending book trades. Existing trades are stripped on GUI open. | | **Banned Enchantments** | Breach, Density, and Punch II are stripped from all items globally. | | **Trident** | Capped at 100 durability. Cannot receive Mending. | | **Iron Farm** | Village-spawned Iron Golems are completely blocked. Manually built golems (4 iron blocks + carved pumpkin) are unaffected. | --- ### Per-Item Restriction System Every single Minecraft item can be individually configured with any combination of: - 🚫 **Banned** — completely removes from inventory, prevents pickup, crafting, placing, and dropping - 📦 **Max Stack Size** — cap stacks at any value from 1 to 64 - ⚒️ **Max Durability** — cap remaining durability (e.g. limit a sword to 100 uses) - 🔨 **Banned in Crafting** — block as crafting ingredient or result - 🧱 **Banned Placing** — prevent placing as a block - 🗑️ **Banned Dropping** — block Q-key drops and death drops - ✨ **Per-item Enchant Bans** — strip specific enchantments from a specific item only - 🏷️ **Force Display Name** — override the item name with color code support - 📜 **Force Lore** — inject custom lore lines onto all instances of the item All changes are saved to `items.yml` and take effect immediately without a server restart. --- ### In-Game GUI Open with `/itemgui` — no commands to memorize. **Item Browser** — paginated list of all Minecraft items, configured items shown first with a green enchant glow and a rule summary in the tooltip. **Item Editor** — click any item to open its full editor: - Toggle switches for banned, no-crafting, no-placing, no-dropping - Left/right-click to raise or lower max stack and max durability; shift for ×10 steps; middle-click to reset - Enchant ban preview with click-to-remove buttons - Force name and lore editing via in-chat input **Enchant Picker** — paginated list of all ~40 enchantments. Click to ban or unban for the specific item. Green = currently banned, grey = allowed. --- ## 📋 Requirements - **Paper** 1.21.11 (or any 1.21.x build) - **Java** 17+ - No dependencies --- ## ⚙️ Installation 1. Download `RestrictionsPlugin` 2. Place it in your server's `plugins/` folder 3. Start or restart the server 4. Two config files are created automatically: - `plugins/RestrictionsPlugin/config.yml` — global restriction toggles - `plugins/RestrictionsPlugin/items.yml` — per-item rules --- ## 🔑 Permissions | Permission | Default | Description | |---|---|---| | `restrictions.admin` | OP | Access to all commands and the GUI | --- ## 💬 Commands ### `/restrict` — Global Mechanic Toggles > Requires `restrictions.admin` | Command | Description | |---|---| | `/restrict` | Show all restrictions with their current on/off status | | `/restrict list` | Same as above | | `/restrict toggle <key>` | Toggle a restriction on or off | | `/restrict enable <key>` | Enable a restriction | | `/restrict disable <key>` | Disable a restriction | | `/restrict enableall` | Enable every restriction at once | | `/restrict disableall` | Disable every restriction at once | | `/restrict reload` | Reload `config.yml` from disk | **Available keys:** | Key | Restriction | |---|---| | `totem` | Totem of Undying | | `crystal_anchor` | End Crystal & Respawn Anchor | | `mace` | Mace | | `elytra` | Elytra | | `potions` | Strength II / Speed II / Turtle Master potions | | `tnt_minecart` | TNT Minecart chunk limit & fire immunity | | `tnt_duper` | TNT Duper Fix (piston + TNT) | | `mending_trade` | Mending villager trades | | `enchantments` | Breach, Density, Punch II global ban | | `trident` | Trident durability cap & no Mending | | `iron_farm` | Autom