Dark's Armor Control

---

❓ 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 [netherite|enchants]	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

# ==================== 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, and enchantment restrictions	false

---

📋 Requirements

• Server: Paper, Purpur, or any Paper-based fork
• Minecraft: 1.21+ (Spear support requires 1.21.11+)
• Java: 21+

---

💬 Support

Questions, bugs, or suggestions — join our Discord:

---