⚡ 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

##############################################
#        MaceGuard Configuration File        #
#   Advanced Mace Damage Validation System   #
##############################################

# Plugin prefix for messages
prefix: "&c[MaceGuard]"

# 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[MaceGuard] 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[MaceGuard] 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 alerts

permission: "maceguard.alerts"

Alert format

format: "&c[MaceGuard] &e%player% &7attempted mace exploit! &f[VL: %vl%/%max-vl%] &7Expected: &f%expected%, &7Dealt: &c%actual%"

Hover message (Paper servers only)

hover: - "&7Player: &f%player%" - "&7Violation: &f%vl%/%max-vl%" - "&7Expected Damage: &f%expected%" - "&7Actual Damage: &c%actual%" - "&7Excess: &c%excess%" - "&7Fall Distance: &f%fall-distance% blocks" - "&7Wind Charge: %wind-charge%" - "&7Ender Pearl: %ender-pearl%" - "" - "&eClick to teleport"

Click action

click-command: "/tp %player%"

Send alerts to Discord webhook

discord: enabled: false webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE" # Minimum violations before sending to Discord min-violations: 2 # Embed color (decimal) color: 16711680 # Red

Player Warnings

warnings:

Send warnings to violating players

enabled: true

Warning message

message: "&c[MaceGuard] &7Invalid mace damage detected! &c[%vl%/%max-vl%]"

Title notification

title: enabled: true title: "&c⚠ Warning ⚠" subtitle: "&7Mace exploit detected" fade-in: 10 stay: 40 fade-out: 10

Send warning at specific violation thresholds

thresholds: - 1 - 2 - 3

Exemptions

exemptions:

Bypass permission

bypass-permission: "maceguard.bypass"

Exempt creative mode players

exempt-creative: true

Exempt spectator mode players

exempt-spectator: true

Exempt players in specific worlds

exempt-worlds: - "creative_world" - "test_world"

Exempt players in specific regions (requires WorldGuard)

exempt-regions: - "spawn" - "safezone"

Whitelist specific players (UUID or username)

whitelisted-players: # - "069a79f4-44e9-4726-a5be-fca90e38aaf5" # - "Notch"

Performance Optimization

performance:

Run calculations asynchronously where possible

async-processing: true

Thread pool size for async tasks

thread-pool-size: 2

Cache player data for this many ticks (20 ticks = 1 second)

cache-duration-ticks: 100

Maximum players to check per tick (prevents lag spikes)

max-checks-per-tick: 50

Cleanup interval for old data (ticks)

cleanup-interval-ticks: 6000 # 5 minutes

Cleanup threshold (remove data older than this in ms)

cleanup-threshold-ms: 300000 # 5 minutes

Debug Settings

debug:

Enable debug mode (verbose console output)

enabled: false

Debug specific players

debug-players: # - "TestPlayer123"

Show expected vs actual damage in console

show-damage-calculations: false

Track all mace hits (even legitimate ones)

track-all-hits: false

Integration with other plugins

integration:

Vulcan Anti-Cheat integration

vulcan: enabled: true # Send violations to Vulcan's log log-to-vulcan: true

GrimAC integration

grim: enabled: true # Send violations to Grim's log log-to-grim: true

LiteBans / AdvancedBan

ban-plugin: # Auto-detect ban plugin (LiteBans, AdvancedBan, vanilla) auto-detect: true # Force specific plugin: "litebans", "advancedban", "vanilla" force: "auto"

Statistics Tracking

statistics:

Track player mace statistics

enabled: true

Track legitimate high-damage hits

track-high-damage: true

Track total mace hits per player

track-hit-count: true

Track average damage per player

track-average-damage: true

Advanced Options

advanced:

Packet validation level (higher = stricter, more CPU)

Values: 1 (low), 2 (medium), 3 (high)

validation-level: 2

Enable packet-level validation (requires ProtocolLib)

packet-validation: enabled: false # This is experimental and may cause issues use-protocollib: false

Fall distance calculation method

"server" = server-side only (most secure)

"client" = trust client (not recommended)

"hybrid" = server with client validation

calculation-method: "server"

Maximum violations to store in memory

max-violations-stored: 1000

DO NOT EDIT

config-version: 1.0.0

</details>

## Why this plugin ❓
- Server side calculation based, due to which chances of bypass is minimal.