BalancedKillRewards

BalancedKillRewards
A Minecraft plugin that scales kill rewards based on the fairness of a fight. Rewards automatically adjust according to the killer's and victim's gear, reducing payouts for overpowered players and keeping PvP economies balanced. Fully configurable with support for money, commands, and item drops. This plugin is compatible with versions 1.8+, but is designed specifically for 1.8 pvp servers (i.e., it will not account for netherrite gear or changes in base weapon damage added in 1.9+).

Features

• Scale kill rewards based on armor, weapon, and bow boosting ability.
• Configurable minimum reward for high-gear kills.
• Fully customizable weights for armor, weapons, and punch bows.
• Supports multiple reward types:
  • Money (range scaled by fairness)
  • Commands (chance scaled by fairness)
  • Item drops (chance scaled by fairness)
• Gear-based scaling can be enabled or disabled per reward.
• Configurable max drops per kill

How it works
When a player kills another, the plugin calculates how "unfair" the kill was based on the relative gear of the killer and the victim:

1. Armor, weapon, and bow points are compared between the killer and victim:
   
   • armorUnfairness = (armorPointsKiller - armorPointsVictim) / (maxArmorPoints - minArmorPoints)
   • weaponUnfairness = (weaponPointsKiller - weaponPointsVictim) / (maxWeaponPoints - minWeaponPoints)
   • bowUnfairness = 1 if the killer has a bow boost, otherwise 0
2. A weighted average of unfairness is calculated using the configured weights for armor, weapons, and bows:
   totalUnfairness = (armorUnfairness * armorWeight + weaponUnfairness * weaponWeight + bowUnfairness * bowWeight) / (armorWeight + weaponWeight + bowWeight)
   
   
3. The reward scale is computed by reducing the reward proportionally to total unfairness:
   scale = 1 - totalUnfairness * (1 - minimumReductionFactor)
   
   
4. The final scale is clamped between the minimum reduction factor and 1, ensuring every kill gives at least a baseline reward.
   

This scale is then applied to all rewards marked as gear-based, adjusting the range of money received, as well as the chance of each drop and command occurring. To assist with configuration, you can use the python tool reward_scale_plot.py. Enter in your configuration values, and run the script to view the range of rewards. Note that this script fixes the bow boost value to maintain a 2d plot for simplification.

Configuration
Example config.yml: