MaceGuard

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper purpur spigot

标签： management technology utility

⚡ 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

Spoiler ``` ############################################## # 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 ```

Why this plugin ❓

• Server side calculation based, due to which chances of bypass is minimal.