VitalStrike


VitalStrike is a powerful and highly customizable Minecraft plugin that enhances combat feedback with dynamic damage indicators, combo systems, and comprehensive statistics tracking.

Documentation
For detailed information about features, installation, and configuration, visit our documentation at https://vitalstrike.vercel.app/

⚡ Requirements

• Java 21 or higher
• Paper 1.21.4+ or compatible forks

✨ Features

• Customizable damage indicators (styles, colors, animations, and directions)
• Dynamic combo system with multipliers, ranks, and hologram displays
• Player combat statistics tracking with leaderboards
• Per-player settings and preferences for a personalized experience
• Supports all damage types and integrates with modern sound systems
• Automatic updates reminder, error handling, and bStats usage tracking
• Easy to configure and use

Quick Start

1. Download the latest version of VitalStrike
2. Place it in your server's plugins folder
3. Restart your server
4. Configure the plugin in plugins/VitalStrike/config.yml

Commands

Command Permission Description Default
/vs help vitalstrike.use Show the help menu true
/vs toggle vitalstrike.use Toggle damage indicators true
/vs reload vitalstrike.reload Reload plugin configuration op
/vs stats vitalstrike.stats View combat statistics true
/vs leaderboard vitalstrike.leaderboard View server leaderboards true
/vs hologram vitalstrike.hologram Toggle combo holograms true
Aliases: /vitalstrike, /vs, /vs lb (for leaderboard)

Damage Formats
VitalStrike supports different formats for various types of damage:

damage-formats:
default: "<gradient:#FF6B6B:#FF8787>-%.1f ❤</gradient>"
critical: "<bold><gradient:#FF0000:#8B0000>-%.1f ⚡</gradient></bold>"
poison: "<gradient:#50C878:#228B22>-%.1f ☠</gradient>"
fire: "<gradient:#FFD700:#FF4500>-%.1f </gradient>"
magic: "<gradient:#9400D3:#800080>-%.1f ✨</gradient>"
# ... and many more!

⚙️ Configuration
Combo System
combo:
enabled: true
reset-time: 3
multiplier:
enabled: true
base: 1.0
per-combo: 0.1
max: 3.0
decay:
enabled: true
time: 10
rate: 1
interval: 1
minimum: 0

Display Settings
display:
duration: 1.5
position:
y: -0.2
x: -0.5
random-offset: -1
direction: "down"
animation:
fade-in: 0.25
fade-out: 0.25
float-speed: 0.03
float-curve: 0.02

Animation Directions

• down: Indicators float downward (default)
• up: Indicators float upward
• left: Indicators float to the left
• right: Indicators float to the right

Player Settings
Players can customize their own damage indicators:

1. Toggle indicators: /vs toggle

API
VitalStrike provides a simple API for developers:

// Get plugin instance
VitalStrike plugin = (VitalStrike) Bukkit.getPluginManager().getPlugin("VitalStrike");

// Player management
boolean isEnabled = plugin.getPlayerManager().isEnabled(player);
plugin.getPlayerManager().setStyle(player, "<gradient:#FF6B6B:#FF8787>-%.1f ❤</gradient>");

// Statistics access
PlayerStats playerStats = plugin.getPlayerStats();
PlayerStats.PlayerStatistics stats = playerStats.getPlayerStatistics(player.getUniqueId());

// Combat statistics
int highestCombo = stats.getHighestCombo();
double totalDamage = stats.getTotalDamageDealt();
double avgDamage = stats.getAverageDamagePerHit();

License
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Contact

• Author: Stawa
• Issues: GitHub Issues