Fix your combat meta! This plugin reduces the damage gap between players by lowering excessively high hits and boosting weaker ones. It prevents new players from being instantly obliterated by heavily geared veterans, dramatically improving combat tension and overall PvP balance.



Tired of heavily geared veterans instantly wiping out new players?
PvPBalancer is a lightweight, mathematically advanced combat utility designed to completely overhaul how player-versus-player damage is calculated. Instead of blindly nerfing OP items or overcomplicating vanilla mechanics, this plugin directly addresses the gear gap.
By applying a dynamic non-linear compression algorithm, it aggressively scales down ridiculously high-damage hits. At the same time, it injects smart, customizable flat bonuses to boost weaker attacks and slower weapons.
The result? The "one-shot" meta is destroyed. Fights last longer, tension is high, and PvP becomes a test of actual skill and tactics rather than just who has the most enchanted gear.

Core Mechanics
1. Non-Linear Damage Compression (Nerfing the Strong)
The plugin calculates incoming damage using an advanced mathematical curve. Low-damage attacks remain largely untouched, but as raw damage scales up (from OP gear, strength potions, or max enchants), the compression hits much harder. This puts a soft ceiling on maximum damage, preventing veterans from instantly obliterating under-geared players.
Formula used: scaled = originalDamage * (compressionFactor ^ log(originalDamage + 1))

2. Smart Weapon Flat Bonuses (Boosting the Weak & Slow)
To ensure weaker players can still put up a fight, and to balance out slow weapons against fast-clicking sword users, PvPBalancer adds a flat damage bonus after the compression curve.

• Bows & Crossbows: Rewarded with a flat boost for draw time and accuracy.
• Axes: Given a moderate boost to compensate for their slower swing speed (1.0 vs 1.6 attacks/sec), keeping them highly competitive.

✨ Key Features

• Close the Gear Gap: Naturally protects newbies while keeping high-tier gear valuable but not game-breaking.
• Completely Customizable Math: Fine-tune the compression factor and flat weapon bonuses to perfectly match your server's specific meta.
• World Whitelisting: Enable the balancer globally, or restrict it strictly to specific worlds (e.g., pvp_arena, warzone).
• Permission-Based Scaling: Toggle whether the scaling applies to everyone, or only players with a specific permission node.
• Highly Optimized: Built with performance in mind. Operations are cached and optimized to run flawlessly on production servers with 100+ concurrent players.
• Live Debug Mode: Enable /pvpbalancer reload and turn on debug logging to see exact damage transformations in your console in real-time.

Commands & Permissions

• /pvpbalancer reload - Reloads the config.yml on the fly without restarting the server.
• Permission: pvpbalancer.admin
• Scaling Permission: pvpbalancer.use (If require-permission is set to true in config, only players with this node will have their outgoing damage balanced).

⚙️ Configuration
The configuration is incredibly simple yet powerful. You have complete control over every variable.
Tested Versions: 1.20.x+ (Compatible with Spigot, Paper, Purpur, and Folia).
Take back control of your PvP meta today!

Installation

1. Download the PvPBalancer.jar file.
2. Place the downloaded file into your server's plugins folder.
3. Restart your server or load it via a plugin manager.
4. Modify the config.yml to your preference and run /pvpbalancer reload in-game or from the console.

If you encounter any bugs or have feedback, please contact us via our Discord Support Link. We typically respond within 24 hours.