Damage Plugin

DamagePlugin: Master the Art of Charged Attacks!

  Elevate your Minecraft server's combat experience with DamagePlugin!** This powerful and highly configurable plugin introduces a dynamic charged attack system, allowing players to strategically hold and release their attacks for devastating bonus damage. Add a new layer of skill, timing, and excitement to every encounter, whether it's PvP or PvE.

---

 **Why Choose DamagePlugin?**

* Strategic Depth:** Moves combat beyond simple spam-clicking, rewarding players for timing and patience.
* Highly Configurable:** Tailor almost every aspect of the charged attack mechanic to perfectly suit your server's balance and gameplay style.
* Engaging Gameplay:** Adds a satisfying power-up feel to combat, making victories more rewarding.
* User-Friendly Feedback:** Clear visual HUD and customizable messages ensure players understand how the mechanic works.
* Lightweight & Efficient:** Designed to enhance gameplay without bogging down your server.

---

**Core Features:**

 🔋 **Dynamic Charged Attack System**
Players can initiate a charge by performing a configurable action (default: **Sneak + Right-Click**) while holding a designated tool. The longer they hold the charge, the more powerful their next strike becomes!

 🔧 **Fully Customizable Damage Tiers**
You have complete control over the power curve:
* Define Multiple Tiers:** Create distinct charge levels in `config.yml`.
* Set Charge Durations:** Specify the exact number of seconds required to reach the base power of each tier.
* Assign Bonus Damage:** Determine the amount of extra damage each tier will grant.
* Interpolated Damage:** For charge times that fall between defined tier thresholds, the bonus damage is smoothly interpolated, ensuring a fair and progressive power increase. A full charge to `hud-max-charge-seconds` (if beyond the last tier) grants the highest defined tier's bonus.

 📊 **Informative & Customizable HUD**
Keep players informed with an action bar Head-Up Display:
* Two Styles:**
    * `DETAILED`**: Shows a customizable prefix, the current charge percentage, and a visual progress bar (e.g., "Charge: 75%").
    * `SIMPLE_PERCENTAGE`**: Displays only the charge percentage (e.g., "75%").
* Bar Customization (for DETAILED style):**
    * Control the number of segments in the visual bar.
    * Define the characters and colors used for each tier's segment, default filled segments, and empty segments.

 🐌 **Tactical Slowness Effect**
Charging a powerful attack comes with a risk:
* Players receive a **Slowness** potion effect while actively charging.
* The intensity of the Slowness (I, II, or III) automatically corresponds to the damage tier currently being charged.
* This effect is instantly removed once the charged attack is delivered or the charge is cancelled, ensuring no lingering penalties.

 ⚙️ **Flexible Activation & Cancellation**
Configure how players interact with the charge mechanic:
* Activation Method (`activation-method` in `config.yml`):**
    * `SNEAK_RIGHT_CLICK` (Default): Hold Sneak and Right-Click.
    * `LEFT_CLICK`: Simple Left-Click (while not sneaking).
    * `SNEAK_LEFT_CLICK`: Hold Sneak and Left-Click.
* Cancellation Method (`cancellation-method` in `config.yml`):**
    * `LEFT_CLICK` (Default): A single Left-Click while charging will cancel it.
    * `NONE`: The charge only cancels upon attacking, switching items, player quitting, etc.

 🗡️ **Selectable Chargeable Items**
Dictate exactly which tools and weapons can benefit from charged attacks:
* Easily list Minecraft Material names (e.g., `DIAMOND_SWORD`, `NETHERITE_AXE`, `TRIDENT`) in the `chargeable-items` section of `config.yml`.

 💬 **Fully Translatable & Customizable Messages**
Adapt all plugin messages to your server's language and style:
* Every message, from HUD elements to notifications and command responses, can be changed in `config.yml`.
* Full support for standard Minecraft color codes using the `&` symbol (e.g., `&a` for green, `&l` for bold).

 🔄 **Easy Configuration Reload**
Apply changes to your `config.yml` instantly without a server restart:
* Use the `/chargedattack reload` command (aliases: `/ca reload`, `/damagecharge reload`).
* Requires the `damageplugin.command.reload` permission (defaults to OP).
* Tab completion is provided for the `reload` subcommand.

---

 **Installation & Setup:**

1.  Download the latest `DamagePlugin.jar` file from the "Files" tab.
2.  Place the JAR file into your server's `/plugins` directory.
3.  Start or restart your server. This will generate a default `config.yml` file in `/plugins/DamagePlugin/`.
4.  **Crucial Step:** Open the `config.yml` file and customize all settings to your liking, especially `chargeable-items`, `damage-tiers`, and `activation-method`.
5.  Once configured, use the `/chargedattack reload` command in-game or from the console to apply your settings.
6.  (Optional) Grant the `damageplugin.command.reload` permission to any staff members who should have access to the reload command using your preferred permissions plugin.

---

**We are committed to providing a fun and balanced combat enhancement for your server. If you encounter any bugs, have suggestions, or need support, please visit our [Issues Tracker/Modrinth Page/Discord Server - *link to your support page here*].**

*Thank you for choosing DamagePlugin!*