Weapon balancing plugin for SMP servers.
Restrict enchantments, adjust damage, set cooldowns. Full 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.bypasspermission
⏱️ 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
- Download the latest
.jarfrom releases - Drop it into your server's
pluginsfolder - Restart the server
- Done! Starts working with default settings
🔧 Configuration
The plugin uses two clean configuration files:
enchants.yml— Weapon cooldowns, damage modifiers, message toggles, and enchantment limitsmessages.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:
Made by DarkKing
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
1.3 |
1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
paper, purpur
|
Download |
|
Dark's Weapon Control 1.2 1.2 |
1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
paper, purpur
|
Download |
|
Dark's Weapon Control 1.1 1.1 |
1.21.10, 1.21.11, 1.21.8, 1.21.9
|
paper, purpur
|
Download |
|
Dark's Weapon Control 1.0 1.0 |
1.21.10, 1.21.11, 1.21.8, 1.21.9
|
paper, purpur
|
Download |