
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.
📖About 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.
- Define multiple tiers of charging in
📊 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.
- Activation Method: Choose precisely how players initiate a charge via
🗡️ 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 thechargeable-itemssection ofconfig.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 reloadcommand. - Aliases:
/ca reload,/damagecharge reload. - Permission:
damageplugin.command.reload(defaults to OP). - Tab completion for the
reloadsubcommand is included.
- Easily apply configuration changes without needing a full server restart using the
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
pluginsfolder. - Start or restart your server. A default
config.ymlwill be generated. - Open
plugins/DamagePlugin/config.ymland customize the settings to your preference. - Use
/chargedattack reloadin-game or via the console to apply your changes. - Grant the
damageplugin.command.reloadpermission 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 .