Sueta

Dark's Weapon Control

1.3

Weapon balancing plugin for SMP servers.

·Plugin

Dark's Weapon Control

Weapon balancing plugin for SMP servers.

Restrict enchantments, adjust damage, set cooldowns. Full weapon control.

Chat on Discord


❓ 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:

CommandDescriptionExample
/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> resetReset 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 reloadReload 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

PermissionDescriptionDefault
darksweaponcontrols.adminAccess to /wc commandsOP
darksweaponcontrols.bypassBypass weapon restrictionsfalse

📋 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:

Chat on Discord


Made by DarkKing

Similar projects

Plugin →