Dark's Armor Control

<div align="center"> !(https://cdn.modrinth.com/data/cached_images/d7423646c00a174c3fa7919b4ffc15a9ae0dc223.png) **Armor balancing plugin for SMP servers.** *Restrict netherite upgrades, control enchantment levels, auto-convert blocked items. Full armor control.* (https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/social/discord-plural_vector.svg)](https://discord.gg/An4tRBRKRY) </div> --- ## ❓ What Does It Do? If you want to set up armor balance on your **SMP** server — you can manage netherite upgrade restrictions, enchantment level limits, and automatic item conversions without manually editing config files. > 🛡️ **Helmet, Chestplate, Leggings, Boots, Sword, Axe, Pickaxe, Shovel, Hoe, Spear** — control netherite upgrades for all of them. For each item, you can configure whether netherite upgrades are allowed, which armor enchantments can be applied, and maximum enchantment levels — all through a unified `/ac` in-game command. Blocked items are automatically converted to their allowed versions. --- ## ✨ Features ### 🔒 Netherite Upgrade Restrictions - Per-item netherite upgrade control for **10 item types**: Helmet, Chestplate, Leggings, Boots, Sword, Axe, Pickaxe, Shovel, Hoe, Spear - Blocks upgrades via **Smithing Table** — blocked items won't show a result - **Auto-conversion:** Netherite items are automatically downgraded to diamond while preserving enchantments, name, lore, trims, and all item data - Enable or disable all netherite upgrades at once, or control each item individually ### 🔮 Enchantment Level Control - Enchantment control for **7 armor enchantments**: `protection`, `fire_protection`, `blast_protection`, `projectile_protection`, `thorns`, `unbreaking`, `mending` - Fully disable enchantments or set maximum level limits - Blocks application via **Enchanting Table**, **Anvil**, and **Inventory** - Items with blocked enchantment levels are automatically downgraded to the max allowed level ### 🔄 Smart Auto-Conversion - Blocked netherite items are automatically converted to diamond on **player join**, **item pickup**, and **inventory close** - Enchantments exceeding allowed levels are automatically downgraded - All item properties are preserved: **custom name, lore, enchantments, armor trims, durability, custom model data, attribute modifiers, item flags** - Message cooldown system to prevent spam ### ⚙️ In-Game Commands (`/ac` / `/armorcontrol`) No need to dig through config files. Manage everything from in-game: | Command | Description | Example | |---|---|---| | `/ac netherite <enable\|disable> <item\|all>` | Toggle netherite upgrades per item or all at once | `/ac netherite disable diamond_helmet` | | `/ac enchant <type> maxlevel <level>` | Set maximum level for an enchantment | `/ac enchant protection maxlevel 2` | | `/ac enchant <type> disable` | Completely disable an enchantment | `/ac enchant mending disable` | | `/ac enchant <type> enable` | Re-enable an enchantment to default max level | `/ac enchant thorns enable` | | `/ac status ` | View current settings for all or specific category | `/ac status netherite` | | `/ac reload` | Reload configuration files from disk | `/ac reload` | ### 🎯 Controllable Items & Enchantments **Netherite Items:** - `diamond_helmet`, `diamond_chestplate`, `diamond_leggings`, `diamond_boots` - `diamond_sword`, `diamond_axe`, `diamond_pickaxe`, `diamond_shovel`, `diamond_hoe`, `diamond_spear` **Armor Enchantments:** - `protection` (max 4), `fire_protection` (max 4), `blast_protection` (max 4), `projectile_protection` (max 4) - `thorns` (max 3), `unbreaking` (max 3), `mending` (max 1) --- ## 📦 Installation 1. Download the latest `.jar` from releases 2. Drop it into your server's `plugins` folder 3. Restart the server 4. **Done!** Starts working with default settings — all items and enchantments are enabled by default --- ## 🔧 Configuration The plugin uses two clean configuration files: - **`armor.yml`** — Netherite upgrade toggles and enchantment level limits - **`messages.yml`** — All plugin messages with customizable prefix and color codes (`&` or `§`) ### `armor.yml` Example ```yaml # ==================== NETHERITE SETTINGS ==================== netherite: diamond_helmet: true diamond_chestplate: true diamond_leggings: true diamond_boots: true diamond_sword: true diamond_axe: true diamond_pickaxe: true diamond_shovel: true diamond_hoe: true diamond_spear: true # ==================== ENCHANTMENT SETTINGS ==================== # Max allowed level for each enchantment # 0 = completely disabled enchants: protection: 4 fire_protection: 4 blast_protection: 4 projectile_protection: 4 thorns: 3 unbreaking: 3 mending: 1 ``` --- ## 🔑 Permissions | Permission | Description | Default | |---|---|---| | `darksarmorcontrol.admin` | Access to `/ac` commands | OP | | `darksarmorcontrol.bypass` | Bypasses all armor, netherite,