DamagePlugin: Unleash Devastating Charged Attacks!
Transform your server's combat with DamagePlugin! This highly configurable plugin introduces a dynamic charged attack mechanic, allowing players to strategically power up their strikes for significant bonus damage. Move beyond simple click-spam and add a new layer of skill and timing to melee encounters.
Key Features:
🔋 Charged Attack System:
- Players can hold a configured key combination (default: Sneak + Right-Click) with designated tools to build up a charge.
- The longer the charge, the greater the potential bonus damage on their next hit!
🔧 Fully Configurable Damage Tiers:
- Define multiple tiers of charging in
config.yml.
- Set custom charge durations (seconds) required to reach each tier.
- Assign specific bonus damage amounts for each tier.
- Damage is interpolated if a player releases their charge between defined tier thresholds, providing a smooth damage progression.
📊 Visual HUD Feedback:
- Players receive real-time feedback via a customizable action bar HUD.
- Choose between a "DETAILED" style (showing a prefix, percentage, and a visual bar) or a "SIMPLE_PERCENTAGE" style (showing only the charge percentage).
- Customize the HUD prefix, percentage color, and the characters/colors used for the visual bar's different states (tier 1, tier 2, tier 3, default fill, empty).
- Set the total number of segments for the visual bar.
🐌 Slowness Effect During Charge:
- To add a risk/reward element, players experience a slowness effect while charging.
- The slowness level (I, II, III) automatically corresponds to the damage tier currently being charged, increasing as the charge gets stronger.
- This effect is immediately removed upon executing the charged attack or cancelling the charge.
⚙️ Customizable Activation & Cancellation:
- Activation Method: Choose precisely how players initiate a charge via
config.yml:
SNEAK_RIGHT_CLICK (Default)LEFT_CLICK (Normal left-click, without sneaking)SNEAK_LEFT_CLICK
- Cancellation Method: Allow players to cancel an ongoing charge:
LEFT_CLICK (Default): A single left-click will cancel the current charge.NONE: Charge only cancels upon attacking, switching items, or other standard game actions.
🗡️ Selectable Chargeable Items:
- You have full control over which tools and weapons can utilize the charged attack mechanic.
- Simply list the Minecraft Material names (e.g.,
DIAMOND_SWORD, NETHERITE_AXE) in the chargeable-items section of config.yml.
💬 All Messages Configurable (with Color Codes!):
- Tailor every player-facing message to fit your server's theme and language.
- Customize HUD text, charge cancellation messages, successful attack notifications, permission errors, and command usage instructions.
- Full support for standard Minecraft color codes using the
& symbol.
🔄 Reload Command:
- Easily apply configuration changes without needing a full server restart using the
/chargedattack reload command.
- Aliases:
/ca reload, /damagecharge reload.
- Permission:
damageplugin.command.reload (defaults to OP).
- Tab completion for the
reload subcommand is included.
Why DamagePlugin?
- Enhanced Combat: Adds depth and strategy to PvP and PvE.
- Highly Customizable: Tailor almost every aspect to fit your server's unique needs and balance.
- User-Friendly: Clear HUD feedback and configurable messages ensure players understand the mechanic.
- Server Performance: Designed to be lightweight and efficient.
Getting Started:
- Download the latest
DamagePlugin.jar.
- Place it in your server's
plugins folder.
- Start or restart your server. A default
config.yml will be generated.
- Open
plugins/DamagePlugin/config.yml and customize the settings to your preference.
- Use
/chargedattack reload in-game or via the console to apply your changes.
- Grant the
damageplugin.command.reload permission to any staff members who should be able to reload the config.
*We hope you and your players enjoy the new charged attack dimension DamagePlugin brings to your server! Please report any issues or suggestions on our Modrinth page .
