Dark's Weapon Control

---

❓ What Does It Do?

If you want to set up weapon balance on your SMP server — you can manage enchantment restrictions, damage modifiers, and cooldowns without manually editing config files.

⚔️ Mace, Spear, Sword, Axe, Bow, Trident, Crossbow — control them all.

For each weapon, you can configure which enchantments can be applied, maximum enchantment levels, damage modifiers, and usage cooldowns — all through a unified /wc in-game command.

---

✨ Features

🔒 Enchantment Restrictions

• Enchantment control for 7 weapon types: Mace, Spear, Sword, Axe, Bow, Trident, Crossbow
• Fully disable enchantments or set maximum level limits
• Blocks application via enchanting table, anvil, and inventory
• Automatic downgrade of illegal enchants when held in main hand or offhand, or when moved/shift-clicked from chests into the active hotbar slot
• Bypass support with darksweaponcontrols.bypass permission

⏱️ Cooldown & Damage Control

• Set usage cooldowns (in seconds) for all 7 weapons
• Adjust damage modifiers (+/- damage) for all 7 weapons
• Visual hotbar cooldown overlay and action bar notifications

⚙️ In-Game Commands (/wc / /weaponcontrol)

No need to dig through config files. Manage everything from in-game:

Command	Description	Example
/wc enchant <weapon> maxlevel <enchant> <level>	Set maximum level for an enchantment	/wc enchant mace maxlevel density 3
/wc enchant <weapon> disable <enchant|all>	Disable an enchantment or all enchantments	/wc enchant axe disable sharpness
/wc enchant <weapon> enable <enchant|all>	Re-enable an enchantment to default max level	/wc enchant bow enable flame
/wc enchant <weapon> reset	Reset weapon enchantments to server defaults	/wc enchant sword reset
/wc cooldown <weapon> <seconds>	Set usage cooldown (0 = disabled)	/wc cooldown mace 10
/wc damage <weapon> <value>	Set damage modifier (-2, 0, +3.5, etc.)	/wc damage sword 2.5
/wc messages <weapon|all> <true|false>	Toggle in-game gameplay/action bar messages (keeps command responses intact)	/wc messages all false
/wc status [weapon]	View current settings for all or a specific weapon	/wc status mace
/wc reload	Reload configuration files from disk	/wc reload

🎯 Supported Weapons & Default Enchantments

• Mace: wind_burst (max 3), density (max 5), breach (max 4)
• Spear: lunge (max 3), sharpness (max 5)
• Sword: sharpness (max 5), fire_aspect (max 2), sweeping_edge (max 3)
• Axe: sharpness (max 5)
• Bow: flame (max 1), infinity (max 1), power (max 5), punch (max 2)
• Trident: riptide (max 3), loyalty (max 3), channeling (max 1)
• Crossbow: multishot (max 1), quick_charge (max 3), piercing (max 4)

---

📦 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

---

🔧 Configuration

The plugin uses two clean configuration files:

• enchants.yml — Weapon cooldowns, damage modifiers, message toggles, and enchantment limits
• messages.yml — All plugin messages with customizable prefix and color codes (& or §)

---

🔑 Permissions

Permission	Description	Default
darksweaponcontrols.admin	Access to /wc commands	OP
darksweaponcontrols.bypass	Bypass weapon 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:

---