promotional bannermobile promotional banner

Damage Plugin

Supercharge your combat! This plugin introduces a configurable charged attack mechanic, allowing players to hold their attack for increased damage with tiered bonuses and visual HUD feedback.
Download

File Details
Download

damageplugin-1.0.0.jar

Bywhitelight3001
  • R
  • May 9, 2025
  • 20.09 KB
  • 28
  • 1.21.5+5

File Name

damageplugin-1.0.0.jar

Supported Versions

  • 1.21.5
  • 1.21.4
  • 1.21.3
  • 1.21.2
  • 1.21.1
  • 1.21

# DamagePlugin - Changelog

## Version 1.0.0 - Initial Release (09/05/2025)

Welcome to the first release of DamagePlugin!

**✨ New Features:**

* **Charged Attack Mechanic:** Hold down a configured activation key (default: Sneak + Right-Click) with a chargeable tool to power up your next attack.
* **Tiered Damage Bonuses:**
    * Define multiple damage tiers in `config.yml` based on charge duration.
    * Each tier provides a configurable additional damage bonus.
    * If the charge time falls between defined tier thresholds, damage is calculated using interpolation.
* **Visual HUD Feedback:**
    * An action bar HUD displays the current charge percentage.
    * HUD style is configurable ("DETAILED" with a bar, or "SIMPLE_PERCENTAGE").
    * The segment count and fill characters of the visual bar are customizable.
* **Slowness Effect During Charge:**
    * Players receive a slowness effect while charging.
    * The slowness level (I, II, III) is automatically adjusted based on the charge tier reached.
    * The effect is removed after attacking or cancelling the charge.
* **Configurable Activation and Cancellation Methods:**
    * Choose how to initiate the charge (`activation-method`: SNEAK_RIGHT_CLICK, LEFT_CLICK, SNEAK_LEFT_CLICK).
    * Choose how to cancel an ongoing charge (`cancellation-method`: LEFT_CLICK, NONE).
* **Configurable Chargeable Items:**
    * Specify which items can use the charged attack mechanic via the `chargeable-items` list in `config.yml`.
* **Fully Configurable Messages:**
    * All player-facing messages (HUD, success, cancellation, errors) can be customized in `config.yml`.
    * Supports standard Minecraft color codes (using the `&` symbol).
* **Reload Command:**
    * Use the `/chargedattack reload` command (aliases: `/ca reload`, `/damagecharge reload`) to reload the configuration without restarting the server.
    * Permission: `damageplugin.command.reload` (default: operators).
    * Tab completion feature for the `reload` subcommand.

**⚙️ Technical Details:**

* Developed for Minecraft 1.21.x (Paper API).
* Uses Java 21.
* Maven-based project.

**🚀 Getting Started:**

1.  Drop the latest `DamagePlugin-1.0.0.jar` file into your server's `plugins` folder.
2.  Start or restart your server.
3.  Customize the `plugins/DamagePlugin/config.yml` file according to your preferences.
4.  Use the `/chargedattack reload` command to apply changes.
5.  If necessary, grant permissions (`damageplugin.command.reload`) to relevant users/groups.

**🐛 Known Issues:**

* No known issues in this initial release. Please report any bugs you find!

---

*Thank you for using DamagePlugin! We hope you enjoy the enhanced combat experience.*