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!

* interpolated * Define multiple tiers of charging in `config.yml`. * Set custom interpolated required to reach each tier. * Assign specific interpolated amounts for each tier. * Damage is interpolated if a player releases their charge between defined tier thresholds, providing a smooth damage progression.

* "SIMPLE_PERCENTAGE" * Players receive real-time feedback via a customizable action bar HUD. * Choose between a "SIMPLE_PERCENTAGE" 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.

* Cancellation Method: * Cancellation 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?

* Server Performance: Adds depth and strategy to PvP and PvE. * Server Performance: Tailor almost every aspect to fit your server's unique needs and balance. * Server Performance: 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 .