MaceGuard

# ⚡ MaceGuard ## 🎯 What This Does Stops MaceDMG hack How it works: Calculates expected damage server-side → Compares to actual → Bans after 3 violations More accurate bans - using server side fall calculations additionaly supports with density and wind burst enchantments, windcharge jumps, jump boost potions and enderpearl catches. Check config below for more details. ## 📦 Installation 1. Download MaceGuard-1.0.0.jar 2. Stop server 3. Copy to plugins/ folder 4. Start server ## 🔑 Permissions Moderators - see alerts - maceguard.alerts - maceguard.staff Admins - full access - maceguard.* ### Via Luckperms - /lp group moderator permission set maceguard.alerts true - /lp group admin permission set maceguard.* true ## 📝 Config <details> <summary>Spoiler</summary> ``` ############################################## # MaceGuard Configuration File # # Advanced Mace Damage Validation System # ############################################## # Plugin prefix for messages prefix: "&c" # Damage Validation Settings damage-validation: # Enable the damage validation system enabled: true # Tolerance multiplier for legitimate damage variations # 1.15 = allow up to 15% over expected damage (for lag, rounding errors) # Lower = stricter, Higher = more lenient tolerance-multiplier: 1.15 # Minimum fall distance required for smash attack bonus # Vanilla is 1.5 blocks, we use 1.3 to account for client-server sync min-fall-distance: 1.3 # Maximum fall distance to track (blocks) # Set to -1 for unlimited max-fall-distance: 256 # Enable server-side fall distance calculation # HIGHLY RECOMMENDED: Keep this true to prevent spoofing server-side-calculation: true # Recalculate damage server-side (cancel and reapply) # If false, only logs violations but doesn't prevent damage cancel-invalid-damage: true # Special Mechanics Tracking mechanics: # Wind Charge detection wind-charge: enabled: true # Time window to detect wind charge usage (ms) detection-window: 2000 # Bonus fall distance to add when detected (blocks) bonus-fall-distance: 7.0 # Ender Pearl detection ender-pearl: enabled: true # Time window to detect ender pearl usage (ms) detection-window: 3000 # Whether to track pearl height for calculation track-pearl-height: true # Jump Boost potion jump-boost: enabled: true # Bonus fall distance per amplifier level (blocks) bonus-per-level: 0.5 # Wind Burst enchantment wind-burst: enabled: true # Bonus fall distance per enchantment level (blocks) bonus-per-level: 7.0 # Track consecutive smash attacks track-combos: true # Density Enchantment Validation density: # Enable density enchantment validation enabled: true # Maximum density level (vanilla is 5) max-level: 5 # Damage bonus per block fallen per level # Vanilla formula: 0.5 * level * blocks damage-per-block-per-level: 0.5 # Validate that density is actually on the weapon verify-enchantment: true # Logging Settings logging: # Enable logging to files enabled: true # Log all violations log-violations: true # Log suspicious hits (within tolerance but high) log-suspicious: true # Log all legitimate high-damage hits for monitoring log-high-damage: true high-damage-threshold: 50.0 # Log bans log-bans: true # Console output console: enabled: true # Log level: INFO, WARNING, SEVERE level: "WARNING" # File output files: violations: "violations.log" suspicious: "suspicious.log" bans: "bans.log" high-damage: "high-damage.log" # Punishment System punishment: # Enable automatic punishments auto-ban: true # Maximum violations before punishment max-violations: 3 # Ban duration (requires LiteBans, AdvancedBan, or compatible plugin) # Format: #d = days, #h = hours, #m = minutes ban-duration: "2d" # Ban reason (supports color codes with &) ban-reason: "&c MaceDMG Exploit - Spoofed fall distance detected" # Reset violations after this time (minutes) # Set to -1 to never reset reset-violations-after: 30 # Broadcast punishments broadcast: enabled: true message: - "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" - "&c⚠ &fMaceGuard &7detected &c%player% &7using mace exploit" - "&7Violations: &c%violations% &7| Excess Damage: &c%excess-damage%" - "&7Punishment: &c%duration% ban" - "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" # Commands to execute on punishment # %player% = player name # %uuid% = player UUID # %violations% = violation count commands: - "tempban %player% 2d &c MaceDMG Exploit" # Add more commands as needed # - "discord send #bans %player% was banned for mace exploit" # Alerts alerts: # Send real-time alerts to staff enabled: true # Permission required to receive