Dark's Weapon Control

<div align="center"> !(https://cdn.modrinth.com/data/cached_images/435e1c04ede458c9ce551156f8c2f5754d8e6d9e.png) **Weapon balancing plugin for SMP servers.** *Restrict enchantments, adjust damage, set cooldowns. Full weapon 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 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 ` | 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: (https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/social/discord-plural_vector.svg)](https://discord.gg/An4tRBRKRY) --- <div align="center"> **Made by DarkKing** </div>