⚔️ Balance Repair ⚔️
Advanced Damage Balance System - Combat Reimagined
⚡ Transform your server's combat with dynamic damage scaling, combo mechanics, and environmental hazards!
Advanced Damage Balance System - Combat Reimagined
⚡ Transform your server's combat with dynamic damage scaling, combo mechanics, and environmental hazards!
Download Requirements
Required:
- BalanceRepair.jar (this plugin)
- YukiNoaAPI - Download Here
✨ What is Balance Repair?
Balance Repair is a comprehensive combat overhaul system that gives you precise control over damage mechanics! Whether you're running an RPG server with custom weapons or balancing PvP combat, this plugin provides the tools you need to create the perfect damage system.
Key Features:
- ⚔️ Base Damage Control - Separate multipliers for damage dealt and received
- Combo System - Attack fatigue and vulnerability mechanics
- Critical Strike System - Configurable crits for players and entities
- Environmental Damage - Custom damage for void, fall, fire, lava, and 15+ more types
- ️ Damage Limits - Prevent excessive one-shot kills with configurable caps
- Debug Mode - Real-time damage calculation display
- Multi-Language - Built-in English & Chinese with auto-detection
- bStats Integration - Track your server's statistics
- ⚙️ Highly Configurable - Every system can be fine-tuned independently
⚔️ Base Damage System
Fine-tune all damage interactions:
- Player Attack Multiplier - Scale damage players deal (e.g., 150% for harder combat)
- Player Hurt Multiplier - Scale damage players receive (e.g., 50% for easier survival)
- Minimum Damage Threshold - Prevent chip damage below a certain value
- Damage Cap System - Limit excessive damage with configurable thresholds
- Over-Limit Scaling - Apply reduced multipliers to damage exceeding the cap
Example Configuration:
Code (Text):
PlayerAttack: 100% # Normal damage dealt
PlayerHurt: 75% # Players take 25% less damage
MinDamage: 0.1 # Cancel attacks dealing less than 0.1
Limit: 2000 # Cap damage at 2000
LimitDamage: 10% # Excess damage reduced to 10%
Dynamic Combat Mechanics:
Attack Fatigue (Offensive Penalty):
- Continuous attacking builds fatigue stacks
- Each stack reduces damage dealt by a configurable percentage
- Stacks decay over time when not attacking
- Configurable: trigger threshold, reduction %, decay time, max stacks
- Encourages strategic combat pacing
Vulnerability (Defensive Penalty):
- Taking consecutive hits builds vulnerability stacks
- Each stack increases damage taken by a configurable percentage
- Stacks decay over time when not hit
- Configurable: trigger threshold, increase %, decay time, max stacks
- Punishes players who can't evade attacks
World Blacklist:
- Disable combo mechanics in specific worlds (spawn, creative, etc.)
Critical Strike System
Exciting Burst Damage:
- Player Criticals - Configurable chance for players to deal massive damage
- Entity Criticals - Mobs can also land devastating blows
- Visual Feedback - Special messages when crits occur
- Fully Configurable - Set probability and damage multiplier independently
Default Values:
Code (Text):
Player Crit: 2% chance for 500% damage
Entity Crit: 0.1% chance for 500% damage
Customize ALL Environmental Hazards:
Supported Damage Types (15+):
- ⬛ Void - Falling into the void
- Fall - Fall damage from heights
- Contact - Cactus and other contact hazards
- Drowning - Underwater suffocation
- Fire - Fire and fire tick damage
- Lava - Lava pools
- ☠️ Poison - Poison effects
- Wither - Wither effects
- Starvation - Hunger damage
- Cramming - Entity cramming
- Hot Floor - Magma blocks
- ✈️ Kinetic - Elytra crash damage
- ⚡ Lightning - Lightning strikes
- Suffocation - Block suffocation
- World Border - Border damage
- + Freeze, Sonic Boom, Dragon Breath, and more!
Flexible Damage Calculation:
Each environmental damage type supports THREE calculation modes:
Code (Text):
Final Damage = Fixed + (MaxHealth × MaxHealth%) + (CurrentHealth × CurrentHealth%)
Code (Text):
Void:
Enable: true
Fixed:
Enable: true
Value: 10000 # Base 10000 damage
MaxHealth:
Enable: true
Value: 1000 # + 1000% of max health
CurrentHealth:
Enable: true
Value: 1000 # + 1000% of current health
Main Command:
Code (Text):
/br
/balancerepair
/brr
/balancerepair
/brr
Admin Commands:
- /br reload - Reload all configuration files
- /br check - Toggle real-time damage debugging
Permissions
Code (Text):
br.reload - Reload configuration (default: op)
Modular Design:
- Master Switch - Disable all modifications with one toggle
- Independent Systems - Enable/disable each system separately
- Percentage-Based - All multipliers use intuitive percentages
- Version Control - Auto-updates configs on major version changes only
Example - PvP Focused Server:
Code (Text):
PlayerAttack: 150% # Increase damage dealt
PlayerHurt: 80% # Reduce damage taken
AttackNumber: 30 # Quick fatigue buildup
AttackDamage: 15% # Strong fatigue penalty
PlayerProbability: 5% # Higher crit chance
Code (Text):
PlayerHurt: 150% # Increase incoming damage
Fall:
Enable: true
MaxHealth:
Value: 20 # Deadly falls
Fire:
Enable: true
CurrentHealth:
Value: 30 # Dangerous fire
Spoiler: Click to View Full Config Example
# Base damage control
TotalDamage:
PlayerAttack: 100%
PlayerHurt: 100%
MinDamage: 0.1
Limit: 2000
LimitDamage: 10%
# Combo mechanics
Combo:
AttackNumber: 90
AttackDamage: 10%
AttackClear: 30
HurtNumber: 4
HurtDamage: 44%
HurtClear: 44
# Critical strikes
CriticalStrikes:
PlayerProbability: 2%
PlayerDamage: 500%
EntityProbability: 0.1%
EntityDamage: 500%
# Environmental damage
EnvironmentalDamage:
Void:
Enable: true
Fixed:
Value: 10000
Code (Text):
# Base damage control
TotalDamage:
PlayerAttack: 100%
PlayerHurt: 100%
MinDamage: 0.1
Limit: 2000
LimitDamage: 10%
# Combo mechanics
Combo:
AttackNumber: 90
AttackDamage: 10%
AttackClear: 30
HurtNumber: 4
HurtDamage: 44%
HurtClear: 44
# Critical strikes
CriticalStrikes:
PlayerProbability: 2%
PlayerDamage: 500%
EntityProbability: 0.1%
EntityDamage: 500%
# Environmental damage
EnvironmentalDamage:
Void:
Enable: true
Fixed:
Value: 10000
Installation Guide
- Download BalanceRepair.jar
- Download YukiNoaAPI
- Place both .jar files in your plugins/ folder
- Restart your server
- Configure settings in plugins/BalanceRepair/config.yml
- Customize messages in plugins/BalanceRepair/lang/
- Test with /br reload
- Use /br check to view damage calculations in real-time
Multi-Language Support
Built-in languages: English (en_us), 简体中文 (zh_cn)
Set Language: default in config.yml for auto-detection, or specify:
- Language: en_us - English
- Language: zh_cn - Simplified Chinese
All messages, combat notifications, and debug info are fully customizable!
❓ Frequently Asked Questions
Spoiler: Click to Expand FAQ
Q: Does this work on Paper/Purpur?
A: Yes! It works on Spigot, Paper, Purpur, and most 1.13+ forks.
Q: Can I disable specific features?
A: Absolutely! Each system (base damage, combo, crits, environmental) can be toggled independently.
Q: How does the damage cap work?
A: If damage exceeds Limit, it's multiplied by LimitDamage percentage. This repeats for Cycle times to prevent one-shots.
Q: What's the difference between fatigue and vulnerability?
A: Fatigue reduces damage you deal when attacking rapidly. Vulnerability increases damage you take when hit repeatedly.
Q: How do environmental damage calculations work?
A: Final damage = Fixed Value + (MaxHealth × MaxHealth%) + (CurrentHealth × CurrentHealth%). You can enable/disable each component independently.
Q: Can I make void damage instant-kill?
A: Yes! Enable void damage and set high values for all three components (Fixed, MaxHealth%, CurrentHealth%).
Q: Does the combo system work in all worlds?
A: No, you can blacklist specific worlds where combo mechanics should be disabled.
Q: What does the debug mode show?
A: Use /br check to see real-time damage calculations including original damage, final damage, combo stacks, and environmental damage types.
Q: Are there performance impacts?
A: Minimal! All configs are cached on startup, and calculations are optimized for performance.
Q: Can I use this with RPG plugins?
A: Yes! The damage multipliers work great with custom weapons and armor from RPG plugins.
Q: How do critical strikes interact with other damage modifiers?
A: Crits are applied after base multipliers but before combo penalties/bonuses.
Q: Can I reset config files?
A: Delete the config.yml and restart. Or wait for a major version update (1.x → 2.0) which auto-overwrites configs.
A: Yes! It works on Spigot, Paper, Purpur, and most 1.13+ forks.
Q: Can I disable specific features?
A: Absolutely! Each system (base damage, combo, crits, environmental) can be toggled independently.
Q: How does the damage cap work?
A: If damage exceeds Limit, it's multiplied by LimitDamage percentage. This repeats for Cycle times to prevent one-shots.
Q: What's the difference between fatigue and vulnerability?
A: Fatigue reduces damage you deal when attacking rapidly. Vulnerability increases damage you take when hit repeatedly.
Q: How do environmental damage calculations work?
A: Final damage = Fixed Value + (MaxHealth × MaxHealth%) + (CurrentHealth × CurrentHealth%). You can enable/disable each component independently.
Q: Can I make void damage instant-kill?
A: Yes! Enable void damage and set high values for all three components (Fixed, MaxHealth%, CurrentHealth%).
Q: Does the combo system work in all worlds?
A: No, you can blacklist specific worlds where combo mechanics should be disabled.
Q: What does the debug mode show?
A: Use /br check to see real-time damage calculations including original damage, final damage, combo stacks, and environmental damage types.
Q: Are there performance impacts?
A: Minimal! All configs are cached on startup, and calculations are optimized for performance.
Q: Can I use this with RPG plugins?
A: Yes! The damage multipliers work great with custom weapons and armor from RPG plugins.
Q: How do critical strikes interact with other damage modifiers?
A: Crits are applied after base multipliers but before combo penalties/bonuses.
Q: Can I reset config files?
A: Delete the config.yml and restart. Or wait for a major version update (1.x → 2.0) which auto-overwrites configs.
Perfect For
- ⚔️ PvP Servers - Balance combat with precise damage control
- RPG Servers - Create unique damage mechanics for custom content
- Hardcore Survival - Make environmental hazards truly dangerous
- Adventure Maps - Fine-tune combat difficulty per world
- Minigame Servers - Create balanced PvP arenas with controlled damage
- Challenge Servers - Amp up environmental hazards for expert players
Plugin Statistics
![[IMG]](//proxy.spigotmc.org/7fae3fda0d1d7b78b449785e5c2cbf09c94c373c/68747470733a2f2f6273746174732e6f72672f7369676e6174757265732f62756b6b69742f42616c616e63655265706169722e737667)
Support & Community
Need help? Join our Discord!
Join Discord Server
⭐ If you enjoy this plugin, please leave a 5-star review! ⭐
Your feedback helps improve the plugin and supports continued development! ✨
Custom Development Available!
Need a custom plugin or mod for your server? Feel free to contact me for commission work!
Made with ❤️ by Roinflam
Need help? Join our Discord!
Join Discord Server
⭐ If you enjoy this plugin, please leave a 5-star review! ⭐
Your feedback helps improve the plugin and supports continued development! ✨
Custom Development Available!
Need a custom plugin or mod for your server? Feel free to contact me for commission work!
Made with ❤️ by Roinflam
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.7, 1.8, 1.9
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
BalanceRepair is a free Minecraft Java mod. Compatible with Minecraft 1.7, 1.8, 1.9, 1.10 and newer. Downloaded 10 times (via Spigot). Download it and open it directly in the game.