DamageModifier | PvP Balancer 1.4.0
Config‑driven PvP with one YAML: weapons, shields, enchants, arrows, trident & crystal.
DamageModifier‑Premium — Config‑Driven Combat Balancer (1.8–1.21)
Take full control of PvP with one clean `config.yml`. Tune swords, axes, shields, enchantments, arrows, trident and ender crystal — modern & legacy, no dependencies.
✨ Highlights
• Modern & Legacy support (1.8–1.21)
• One YAML, hot reload, clean toggles per module
• Lightweight, no database, built for high‑traffic servers
• Clear per‑version features: sword‑block (1.8), shields & projectiles (1.9+)
🧭 Version Compatibility
• Legacy (1.8): classic sword blocking, base arrow damage
• Modern (1.9+): shields, per‑type arrows (normal/spectral/tipped), trident impact, ender crystal explosion
🗡️ Core Combat
• Weapon multipliers for all swords and axes
• Per‑material configuration with independent toggles
• Critical hits: configurable chances, multipliers and visual effects
🛡️ Defense & Armor
• Shield mechanics (1.9+): damage reduction, durability multiplier, axe‑based disable duration
• Sword blocking (1.8): configurable reduction
• Armor durability: per material and piece, with toggles
⭐ Enchantments (Advanced)
• Protection ≥5: configurable reduction per armor piece
• Unbreaking ≥5: configurable chance to prevent durability loss
• Independent toggles per enchantment type
🎯 Projectiles & Explosions (Modern)
• Arrows: damage multiplier/addition, velocity scaling, optional inaccuracy removal
• Targeting by type: normal / spectral / tipped
• Trident: impact damage multiplier/addition
• Ender Crystal: explosion damage multiplier
⚙️ Operation
• Precise damage calculation, rounding and decimal places
• Empty‑hand damage control
• `/damagemodifier reload` to apply changes instantly
⚡ Performance & Compatibility
• Lightweight event handling, no database
• Plays well with most combat/custom‑item plugins
• Spigot, Paper, Purpur — no extra dependencies
🔧 Quick Examples
• Double diamond sword damage
• Extend Protection levels beyond vanilla
• +25% arrow damage and +10% speed
• 0.75× ender crystal explosion damage
• +30% trident impact damage
⚙️ Configurations:
config.yml (modern version)
# ██████╗ █████╗ ███╗ ███╗ █████╗ ██████╗ ███████╗
# ██╔══██╗██╔══██╗████╗ ████║██╔══██╗██╔════╝ ██╔════╝
# ██║ ██║███████║██╔████╔██║███████║██║ ███╗█████╗
# ██║ ██║██╔══██║██║╚██╔╝██║██╔══██║██║ ██║██╔══╝
# ██████╔╝██║ ██║██║ ╚═╝ ██║██║ ██║╚██████╔╝███████╗
# ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚══════╝
# ███╗ ███╗ ██████╗ ██████╗ ██╗███████╗██╗███████╗██████╗
# ████╗ ████║██╔═══██╗██╔══██╗██║██╔════╝██║██╔════╝██╔══██╗
# ██╔████╔██║██║ ██║██║ ██║██║█████╗ ██║█████╗ ██████╔╝
# ██║╚██╔╝██║██║ ██║██║ ██║██║██╔══╝ ██║██╔══╝ ██╔══██╗
# ██║ ╚═╝ ██║╚██████╔╝██████╔╝██║██║ ██║███████╗██║ ██║
# ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝
#
# DamageModifier v1.4.0 - Modern Version (Minecraft 1.9+)
# Made by wwishh <3
# For support or bugs: Discord @wwishh
# ╔════════════════════════════════════════════════════════╗
# ║ WEAPONS CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Sword damage modifier settings
sword_damage_modifiers:
enabled: true # Set to false to completely disable sword damage modifiers
# Values greater than 1.0 increase damage
# Values less than 1.0 reduce damage
# Example: 1.3 = 30% more damage
WOOD_SWORD: 1.0 # Base damage for wooden sword
STONE_SWORD: 1.1 # 10% more damage than base
IRON_SWORD: 1.2 # 20% more damage than base
GOLD_SWORD: 1.0 # Same damage as base
DIAMOND_SWORD: 1.3 # 30% more damage than base
NETHERITE_SWORD: 1.4 # 40% more damage than base
# Axe damage modifier settings
axe_damage_modifiers:
enabled: true # Set to false to completely disable axe damage modifiers
# Works the same as sword multipliers
WOOD_AXE: 1.0 # Base damage for wooden axe
STONE_AXE: 1.1 # 10% more damage than base
IRON_AXE: 1.2 # 20% more damage than base
GOLD_AXE: 1.0 # Same damage as base
DIAMOND_AXE: 1.4 # 40% more damage than base
NETHERITE_AXE: 1.5 # 50% more damage than base
# Bow damage modifier settings
bow_damage_modifiers:
enabled: true # Set to false to completely disable bow damage modifiers
# Values greater than 1.0 increase arrow damage
# Values less than 1.0 reduce arrow damage
BOW: 1.0 # Base damage for regular bow
# Crossbow damage modifier settings
crossbow_damage_modifiers:
enabled: true # Set to false to completely disable crossbow damage modifiers
# Works the same as bow multipliers
CROSSBOW: 1.2 # 20% more damage than bow base
# ╔════════════════════════════════════════════════════════╗
# ║ DEFENSE CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Shield Settings
shield_configuration:
enabled: true # Set to false to disable shield mechanics
damage_reduction: 0.5 # Reduces damage by 50%
durability_multiplier: 1.0 # Shield Durability Multiplier
disable_duration: 1.0 # Duration in seconds that the shield is disabled when hit by an axe
# ╔════════════════════════════════════════════════════════╗
# ║ DURABILITY CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Main setting to enable/disable all armor durability modifiers
armor_durability:
enabled: true # Set to false to disable all armor durability modifications
# Durability modifiers for armor
# enabled: true/false - Enables or disables the modifier
# multiplier: Value that affects durability
# - Values greater than 1.0 = more durability
# - Values less than 1.0 = less durability
armor_durability_multipliers:
LEATHER:
enabled: true
multiplier: 1.0 # Base durability for leather
CHAINMAIL:
enabled: true
multiplier: 1.2 # 20% more durability than base
IRON:
enabled: true
multiplier: 1.5 # 50% more durability than base
GOLD:
enabled: true
multiplier: 1.0 # Same durability as base
DIAMOND:
enabled: true
multiplier: 2.0 # Double durability than base
NETHERITE:
enabled: true
multiplier: 2.5 # 150% more durable than base
# ╔════════════════════════════════════════════════════════╗
# ║ CRITICAL HITS CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Critical hits system
critical_hits:
enabled: true # Set to false to disable ALL critical hit functionality
default_multiplier: 1.5 # Default critical hit multiplier (1.5 = 50% more damage)
chance: 0.2 # Critical hit chance (0.2 = 20% chance)
visual_effect: true # Set to false to disable the critical hit visual effect
# Weapon-specific critical multipliers (only used when critical_hits.enabled is true)
weapon_multipliers:
WOOD_SWORD: 1.5
STONE_SWORD: 1.5
IRON_SWORD: 1.5
GOLD_SWORD: 2.0 # Gold weapons do double critical damage
DIAMOND_SWORD: 1.5
NETHERITE_SWORD: 1.5
WOOD_AXE: 1.5
STONE_AXE: 1.5
IRON_AXE: 1.5
GOLD_AXE: 2.0 # Gold weapons do double critical damage
DIAMOND_AXE: 1.5
NETHERITE_AXE: 1.5
BOW: 1.5 # Bow critical damage
CROSSBOW: 1.5 # Crossbow critical damage
# ╔════════════════════════════════════════════════════════╗
# ║ ENCHANTMENTS CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# This module tunes high-level enchantments beyond vanilla behavior.
#
# How it works:
# - Protection (level >= 5): reduces incoming damage by the configured fraction
# for each armor piece that has Protection. Values are cumulative and capped internally.
# - Unbreaking (level >= 5): gives a probability to cancel durability loss when damage is applied.
#
# Toggles:
# - enchantments.enabled: master toggle for the whole module.
# - enchantments.protection.enabled: toggle Protection only.
# - enchantments.unbreaking.enabled: toggle Unbreaking only.
#
# Add new levels:
# - Just add a numeric key under the corresponding section (e.g. 10: 0.10 or 15: 0.20).
# - Values for Protection are fractions (0.10 = 10% extra reduction per item).
# - Values for Unbreaking are probabilities (0.20 = 20% chance to prevent wear).
# - Keep values between 0.0 and 1.0 for sane behavior.
enchantments:
enabled: true
protection:
enabled: true
5: 0.05 # Example: 5% extra reduction per armor piece with Protection V
6: 0.06 # Example: Protection VI = 6% per piece
7: 0.07 # You can add more: 8, 9, 10, 15, etc.
unbreaking:
enabled: true
5: 0.05 # Example: 5% chance to cancel durability loss at Unbreaking V
6: 0.06 # Example: Unbreaking VI = 6% chance
7: 0.07 # You can add more: 8, 9, 10, 15, etc.
# ╔════════════════════════════════════════════════════════╗
# ║ PROJECTILES & EXPLOSIONS ║
# ╚════════════════════════════════════════════════════════╝
# Arrows (normal/spectral/tipped), Trident, Ender Crystal, Ender Pearl.
#
# Arrows:
# - damage_multiplier/addition modify arrow base damage.
# - velocity_multiplier scales speed at launch.
# - remove_inaccuracy uses shooter eye direction to reduce spread.
# - apply_to_types lets you target specific arrow kinds.
#
# Trident:
# - damage_multiplier/addition modify impact damage.
#
# Ender Crystal:
# - explosion_damage_multiplier scales damage dealt by crystal explosions.
#
# Ender Pearl:
# - damage_multiplier/addition modify the self-damage after pearl teleport.
projectiles:
enabled: true
arrows:
enabled: true
damage_multiplier: 1.0
damage_addition: 0.0
velocity_multiplier: 1.0
remove_inaccuracy: false # Reduce spread using shooter eye direction
affect_mob_shooters: false # If false, only player-shot arrows are modified; mobs keep vanilla damage
apply_to_types:
normal: true
spectral: true
tipped: true
trident:
enabled: true
damage_multiplier: 1.0
damage_addition: 0.0
ender_crystal:
enabled: true
explosion_damage_multiplier: 1.0
# ╔════════════════════════════════════════════════════════╗
# ║ DAMAGE CALCULATION CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
damage_calculation:
round_damage: true # Whether the damage should be rounded
decimal_places: 2 # Number of decimal places for rounding
ignore_empty_hands: true # Whether empty-handed punches should be ignored
# ╔════════════════════════════════════════════════════════╗
# ║ METRICS CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Controls whether anonymous usage data is sent to bStats
metrics:
enabled: false # Set to false to completely disable metrics
# ╔════════════════════════════════════════════════════════╗
# ║ MESSAGES CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Use & for color codes, for example &a for green text
messages:
command:
reload_success: "&aConfiguration reloaded successfully! &eThank you for purchasing DamageModifier Premium!"
no_permission: "&cYou don't have permission to use this command."
usage: "&eUsage: /damagemodifier reload"
config.yml (legacy version)
# ██████╗ █████╗ ███╗ ███╗ █████╗ ██████╗ ███████╗
# ██╔══██╗██╔══██╗████╗ ████║██╔══██╗██╔════╝ ██╔════╝
# ██║ ██║███████║██╔████╔██║███████║██║ ███╗█████╗
# ██║ ██║██╔══██║██║╚██╔╝██║██╔══██║██║ ██║██╔══╝
# ██████╔╝██║ ██║██║ ╚═╝ ██║██║ ██║╚██████╔╝███████╗
# ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚══════╝
# ███╗ ███╗ ██████╗ ██████╗ ██╗███████╗██╗███████╗██████╗
# ████╗ ████║██╔═══██╗██╔══██╗██║██╔════╝██║██╔════╝██╔══██╗
# ██╔████╔██║██║ ██║██║ ██║██║█████╗ ██║█████╗ ██████╔╝
# ██║╚██╔╝██║██║ ██║██║ ██║██║██╔══╝ ██║██╔══╝ ██╔══██╗
# ██║ ╚═╝ ██║╚██████╔╝██████╔╝██║██║ ██║███████╗██║ ██║
# ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝
#
# DamageModifier v1.4.0 - Legacy Version (Minecraft 1.8)
# Made by wwishh <3
# For support or bugs: Discord @wwishh
# ╔════════════════════════════════════════════════════════╗
# ║ WEAPONS CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Sword damage modifier settings
sword_damage_modifiers:
enabled: true # Set to false to completely disable sword damage modifiers
# Values greater than 1.0 increase damage
# Values less than 1.0 reduce damage
# Example: 1.3 = 30% more damage
WOOD_SWORD: 1.0 # Base damage for wooden sword
STONE_SWORD: 1.1 # 10% more damage than base
IRON_SWORD: 1.2 # 20% more damage than base
GOLD_SWORD: 1.0 # Same damage as base
DIAMOND_SWORD: 5.3 # 30% more damage than base
# Axe damage modifier settings
axe_damage_modifiers:
enabled: true # Set to false to completely disable axe damage modifiers
# Works the same as sword multipliers
WOOD_AXE: 1.0 # Base damage for wooden axe
STONE_AXE: 1.1 # 10% more damage than base
IRON_AXE: 1.2 # 20% more damage than base
GOLD_AXE: 1.0 # Same damage as base
DIAMOND_AXE: 1.4 # 40% more damage than base
# Bow damage modifier settings
bow_damage_modifiers:
enabled: true # Set to false to completely disable bow damage modifiers
# Values greater than 1.0 increase arrow damage
# Values less than 1.0 reduce arrow damage
BOW: 1.0 # Base damage for regular bow
# Crossbow damage modifier settings (Note: Crossbows not available in 1.8, but kept for compatibility)
crossbow_damage_modifiers:
enabled: false # Disabled by default since crossbows don't exist in 1.8
# Works the same as bow multipliers
CROSSBOW: 1.2 # 20% more damage than bow base
# ╔════════════════════════════════════════════════════════╗
# ║ DEFENSE CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Sword blocking configuration (mainly for 1.8)
sword_block_defense:
enabled: true # Set to false to disable sword blocking defense
# Lower value = more defense
# Example: 0.5 means damage is reduced by half
multiplier: 0.5 # Damage multiplier when blocking with a sword
# ╔════════════════════════════════════════════════════════╗
# ║ DURABILITY CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Main setting to enable/disable all armor durability modifiers
armor_durability:
enabled: true # Set to false to disable all armor durability modifications
# Durability modifiers for armor
# enabled: true/false - Enables or disables the modifier
# multiplier: Value that affects durability
# - Values greater than 1.0 = more durability
# - Values less than 1.0 = less durability
armor_durability_multipliers:
LEATHER:
enabled: true
multiplier: 1.0 # Base durability for leather
CHAINMAIL:
enabled: true
multiplier: 1.2 # 20% more durability than base
IRON:
enabled: true
multiplier: 1.5 # 50% more durability than base
GOLD:
enabled: true
multiplier: 1.0 # Same durability as base
DIAMOND:
enabled: true
multiplier: 2.0 # Double durability than base
# ╔════════════════════════════════════════════════════════╗
# ║ CRITICAL HITS CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Critical hits system
critical_hits:
enabled: true # Set to false to disable ALL critical hit functionality
default_multiplier: 1.5 # Default critical hit multiplier (1.5 = 50% more damage)
chance: 0.2 # Critical hit chance (0.2 = 20% chance)
visual_effect: true # Set to false to disable the critical hit visual effect
# Weapon-specific critical multipliers (only used when critical_hits.enabled is true)
weapon_multipliers:
WOOD_SWORD: 1.5
STONE_SWORD: 1.5
IRON_SWORD: 1.5
GOLD_SWORD: 2.0 # Gold weapons do double critical damage
DIAMOND_SWORD: 1.5
WOOD_AXE: 1.5
STONE_AXE: 1.5
IRON_AXE: 1.5
GOLD_AXE: 2.0 # Gold weapons do double critical damage
DIAMOND_AXE: 1.5
BOW: 1.5 # Bow critical damage
# ╔════════════════════════════════════════════════════════╗
# ║ ENCHANTMENTS CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# This module tunes high-level enchantments for legacy servers (1.8–1.15).
#
# How it works:
# - Protection (level >= 5): reduces incoming damage by the configured fraction
# for each armor piece that has Protection. Values are cumulative and capped internally.
# - Unbreaking (level >= 5): gives a probability to cancel durability loss when damage is applied.
#
# Toggles:
# - enchantments.enabled: master toggle for the whole module.
# - enchantments.protection.enabled: toggle Protection only.
# - enchantments.unbreaking.enabled: toggle Unbreaking only.
#
# Add new levels:
# - Just add a numeric key under the corresponding section (e.g. 10: 0.10 or 15: 0.20).
# - Values for Protection are fractions (0.10 = 10% extra reduction per item).
# - Values for Unbreaking are probabilities (0.20 = 20% chance to prevent wear).
# - Keep values between 0.0 and 1.0 for sane behavior.
enchantments:
enabled: true
protection:
enabled: true
5: 0.05 # Example: 5% extra reduction per armor piece with Protection V
6: 0.06 # Example: Protection VI = 6% per piece
7: 0.07 # You can add more: 8, 9, 10, 15, etc.
unbreaking:
enabled: true
5: 0.05 # Example: 5% chance to cancel durability loss at Unbreaking V
6: 0.06 # Example: Unbreaking VI = 6% chance
7: 0.07 # You can add more: 8, 9, 10, 15, etc.
# ╔════════════════════════════════════════════════════════╗
# ║ PROJECTILES (LEGACY) ║
# ╚════════════════════════════════════════════════════════╝
# Legacy supports vanilla arrows and ender pearl damage tuning.
#
# Arrows:
# - damage_multiplier/addition modify arrow base damage.
# - velocity_multiplier scales speed at launch.
# - remove_inaccuracy uses shooter eye direction to reduce spread.
#
# Ender Pearl:
# - damage_multiplier/addition modify the self-damage after pearl teleport.
projectiles:
enabled: true
arrows:
enabled: true
damage_multiplier: 1.0
damage_addition: 0.0
velocity_multiplier: 1.0
remove_inaccuracy: false # Reduce spread using shooter eye direction
affect_mob_shooters: false # If false, only player-shot arrows are modified; mobs keep vanilla damage
# ╔════════════════════════════════════════════════════════╗
# ║ DAMAGE CALCULATION CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
damage_calculation:
round_damage: true # Whether the damage should be rounded
decimal_places: 2 # Number of decimal places for rounding
ignore_empty_hands: true # Whether empty-handed punches should be ignored
# ╔════════════════════════════════════════════════════════╗
# ║ METRICS CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Controls whether anonymous usage data is sent to bStats
metrics:
enabled: false # Set to false to completely disable metrics
# ╔════════════════════════════════════════════════════════╗
# ║ MESSAGES CONFIGURATION ║
# ╚════════════════════════════════════════════════════════╝
# Use & for color codes, for example &a for green text
messages:
command:
reload_success: "&aConfiguration reloaded successfully! &eThank you for purchasing DamageModifier Premium!"
no_permission: "&cYou don't have permission to use this command."
usage: "&eUsage: /damagemodifier reload"
📦 Installation
1) Stop your server
2) Drop the jar into `plugins/`
3) Start the server
4) Edit `config.yml`
5) Run `/damagemodifier reload`
�️ Commands
• `/damagemodifier reload` — Reloads the configuration
• Permission: `damagemodifier.reload`
📝 Configuration Examples
• `weapon_multipliers.sword.DIAMOND_SWORD: 2.0` (Double damage)
• `critical_hits.chance: 0.15` (15% critical chance)
• `shield_configuration.damage_reduction: 0.5` (50% reduction)
• `armor_durability.multipliers.DIAMOND.chestplate: 2.0` (Double durability)
• `projectiles.arrows.damage_multiplier: 1.25` (25% more arrow damage)
• `projectiles.arrows.velocity_multiplier: 1.10` (10% faster arrows)
• `projectiles.arrows.remove_inaccuracy: true` (straighter shots)
• `projectiles.trident.damage_multiplier: 1.30` (30% more trident damage)
• `ender_crystal.explosion_damage_multiplier: 0.75` (25% less explosion)
🆘 Support
Found a bug or have a suggestion? Open a discussion — happy to help.
