Damage Plugin

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:

1. Download the latest DamagePlugin.jar.
2. Place it in your server's plugins folder.
3. Start or restart your server. A default config.yml will be generated.
4. Open plugins/DamagePlugin/config.yml and customize the settings to your preference.
5. Use /chargedattack reload in-game or via the console to apply your changes.
6. 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 .