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 .