{"id":97191,"date":"2026-06-05T16:48:24","date_gmt":"2026-06-05T13:48:24","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/"},"modified":"2026-06-05T16:48:24","modified_gmt":"2026-06-05T13:48:24","slug":"maceguard","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/","title":{"rendered":"MaceGuard"},"content":{"rendered":"

# \u26a1 MaceGuard
\n## \ud83c\udfaf What This Does
\nStops MaceDMG hack <\/p>\n

How it works: Calculates expected damage server-side \u2192 Compares to actual \u2192 Bans after 3 violations<\/p>\n

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.<\/p>\n

## \ud83d\udce6 Installation
\n 1. Download MaceGuard-1.0.0.jar
\n 2. Stop server
\n 3. Copy to plugins\/ folder
\n 4. Start server<\/p>\n

## \ud83d\udd11 Permissions
\nModerators – see alerts
\n– maceguard.alerts
\n– maceguard.staff<\/p>\n

Admins – full access
\n– maceguard.*<\/p>\n

### Via Luckperms
\n– \/lp group moderator permission set maceguard.alerts true
\n– \/lp group admin permission set maceguard.* true<\/p>\n

## \ud83d\udcdd Config<\/p>\n

\nSpoiler<\/summary>\n

“`
\n##############################################
\n# MaceGuard Configuration File #
\n# Advanced Mace Damage Validation System #
\n##############################################<\/p>\n

# Plugin prefix for messages
\nprefix: “&c[MaceGuard]”<\/p>\n

# Damage Validation Settings
\ndamage-validation:
\n # Enable the damage validation system
\n enabled: true<\/p>\n

# Tolerance multiplier for legitimate damage variations
\n # 1.15 = allow up to 15% over expected damage (for lag, rounding errors)
\n # Lower = stricter, Higher = more lenient
\n tolerance-multiplier: 1.15<\/p>\n

# Minimum fall distance required for smash attack bonus
\n # Vanilla is 1.5 blocks, we use 1.3 to account for client-server sync
\n min-fall-distance: 1.3<\/p>\n

# Maximum fall distance to track (blocks)
\n # Set to -1 for unlimited
\n max-fall-distance: 256<\/p>\n

# Enable server-side fall distance calculation
\n # HIGHLY RECOMMENDED: Keep this true to prevent spoofing
\n server-side-calculation: true<\/p>\n

# Recalculate damage server-side (cancel and reapply)
\n # If false, only logs violations but doesn’t prevent damage
\n cancel-invalid-damage: true<\/p>\n

# Special Mechanics Tracking
\nmechanics:
\n # Wind Charge detection
\n wind-charge:
\n enabled: true
\n # Time window to detect wind charge usage (ms)
\n detection-window: 2000
\n # Bonus fall distance to add when detected (blocks)
\n bonus-fall-distance: 7.0<\/p>\n

# Ender Pearl detection
\n ender-pearl:
\n enabled: true
\n # Time window to detect ender pearl usage (ms)
\n detection-window: 3000
\n # Whether to track pearl height for calculation
\n track-pearl-height: true<\/p>\n

# Jump Boost potion
\n jump-boost:
\n enabled: true
\n # Bonus fall distance per amplifier level (blocks)
\n bonus-per-level: 0.5<\/p>\n

# Wind Burst enchantment
\n wind-burst:
\n enabled: true
\n # Bonus fall distance per enchantment level (blocks)
\n bonus-per-level: 7.0
\n # Track consecutive smash attacks
\n track-combos: true<\/p>\n

# Density Enchantment Validation
\ndensity:
\n # Enable density enchantment validation
\n enabled: true<\/p>\n

# Maximum density level (vanilla is 5)
\n max-level: 5<\/p>\n

# Damage bonus per block fallen per level
\n # Vanilla formula: 0.5 * level * blocks
\n damage-per-block-per-level: 0.5<\/p>\n

# Validate that density is actually on the weapon
\n verify-enchantment: true<\/p>\n

# Logging Settings
\nlogging:
\n # Enable logging to files
\n enabled: true<\/p>\n

# Log all violations
\n log-violations: true<\/p>\n

# Log suspicious hits (within tolerance but high)
\n log-suspicious: true<\/p>\n

# Log all legitimate high-damage hits for monitoring
\n log-high-damage: true
\n high-damage-threshold: 50.0<\/p>\n

# Log bans
\n log-bans: true<\/p>\n

# Console output
\n console:
\n enabled: true
\n # Log level: INFO, WARNING, SEVERE
\n level: “WARNING”<\/p>\n

# File output
\n files:
\n violations: “violations.log”
\n suspicious: “suspicious.log”
\n bans: “bans.log”
\n high-damage: “high-damage.log”<\/p>\n

# Punishment System
\npunishment:
\n # Enable automatic punishments
\n auto-ban: true<\/p>\n

# Maximum violations before punishment
\n max-violations: 3<\/p>\n

# Ban duration (requires LiteBans, AdvancedBan, or compatible plugin)
\n # Format: #d = days, #h = hours, #m = minutes
\n ban-duration: “2d”<\/p>\n

# Ban reason (supports color codes with &)
\n ban-reason: “&c[MaceGuard] MaceDMG Exploit – Spoofed fall distance detected”<\/p>\n

# Reset violations after this time (minutes)
\n # Set to -1 to never reset
\n reset-violations-after: 30<\/p>\n

# Broadcast punishments
\n broadcast:
\n enabled: true
\n message:
\n – “&8&m\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501”
\n – “&c\u26a0 &fMaceGuard &7detected &c%player% &7using mace exploit”
\n – “&7Violations: &c%violations% &7| Excess Damage: &c%excess-damage%”
\n – “&7Punishment: &c%duration% ban”
\n – “&8&m\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501”<\/p>\n

# Commands to execute on punishment
\n # %player% = player name
\n # %uuid% = player UUID
\n # %violations% = violation count
\n commands:
\n – “tempban %player% 2d &c[MaceGuard] MaceDMG Exploit”
\n # Add more commands as needed
\n # – “discord send #bans %player% was banned for mace exploit”<\/p>\n

# Alerts
\nalerts:
\n # Send real-time alerts to staff
\n enabled: true<\/p>\n

# Permission required to receive alerts
\n permission: “maceguard.alerts”<\/p>\n

# Alert format
\n format: “&c[MaceGuard] &e%player% &7attempted mace exploit! &f[VL: %vl%\/%max-vl%] &7Expected: &f%expected%, &7Dealt: &c%actual%”<\/p>\n

# Hover message (Paper servers only)
\n hover:
\n – “&7Player: &f%player%”
\n – “&7Violation: &f%vl%\/%max-vl%”
\n – “&7Expected Damage: &f%expected%”
\n – “&7Actual Damage: &c%actual%”
\n – “&7Excess: &c%excess%”
\n – “&7Fall Distance: &f%fall-distance% blocks”
\n – “&7Wind Charge: %wind-charge%”
\n – “&7Ender Pearl: %ender-pearl%”
\n – “”
\n – “&eClick to teleport”<\/p>\n

# Click action
\n click-command: “\/tp %player%”<\/p>\n

# Send alerts to Discord webhook
\n discord:
\n enabled: false
\n webhook-url: “https:\/\/discord.com\/api\/webhooks\/YOUR_WEBHOOK_HERE”
\n # Minimum violations before sending to Discord
\n min-violations: 2
\n # Embed color (decimal)
\n color: 16711680 # Red<\/p>\n

# Player Warnings
\nwarnings:
\n # Send warnings to violating players
\n enabled: true<\/p>\n

# Warning message
\n message: “&c[MaceGuard] &7Invalid mace damage detected! &c[%vl%\/%max-vl%]”<\/p>\n

# Title notification
\n title:
\n enabled: true
\n title: “&c\u26a0 Warning \u26a0”
\n subtitle: “&7Mace exploit detected”
\n fade-in: 10
\n stay: 40
\n fade-out: 10<\/p>\n

# Send warning at specific violation thresholds
\n thresholds:
\n – 1
\n – 2
\n – 3<\/p>\n

# Exemptions
\nexemptions:
\n # Bypass permission
\n bypass-permission: “maceguard.bypass”<\/p>\n

# Exempt creative mode players
\n exempt-creative: true<\/p>\n

# Exempt spectator mode players
\n exempt-spectator: true<\/p>\n

# Exempt players in specific worlds
\n exempt-worlds:
\n – “creative_world”
\n – “test_world”<\/p>\n

# Exempt players in specific regions (requires WorldGuard)
\n exempt-regions:
\n – “spawn”
\n – “safezone”<\/p>\n

# Whitelist specific players (UUID or username)
\n whitelisted-players:
\n # – “069a79f4-44e9-4726-a5be-fca90e38aaf5”
\n # – “Notch”<\/p>\n

# Performance Optimization
\nperformance:
\n # Run calculations asynchronously where possible
\n async-processing: true<\/p>\n

# Thread pool size for async tasks
\n thread-pool-size: 2<\/p>\n

# Cache player data for this many ticks (20 ticks = 1 second)
\n cache-duration-ticks: 100<\/p>\n

# Maximum players to check per tick (prevents lag spikes)
\n max-checks-per-tick: 50<\/p>\n

# Cleanup interval for old data (ticks)
\n cleanup-interval-ticks: 6000 # 5 minutes<\/p>\n

# Cleanup threshold (remove data older than this in ms)
\n cleanup-threshold-ms: 300000 # 5 minutes<\/p>\n

# Debug Settings
\ndebug:
\n # Enable debug mode (verbose console output)
\n enabled: false<\/p>\n

# Debug specific players
\n debug-players:
\n # – “TestPlayer123”<\/p>\n

# Show expected vs actual damage in console
\n show-damage-calculations: false<\/p>\n

# Track all mace hits (even legitimate ones)
\n track-all-hits: false<\/p>\n

# Integration with other plugins
\nintegration:
\n # Vulcan Anti-Cheat integration
\n vulcan:
\n enabled: true
\n # Send violations to Vulcan’s log
\n log-to-vulcan: true<\/p>\n

# GrimAC integration
\n grim:
\n enabled: true
\n # Send violations to Grim’s log
\n log-to-grim: true<\/p>\n

# LiteBans \/ AdvancedBan
\n ban-plugin:
\n # Auto-detect ban plugin (LiteBans, AdvancedBan, vanilla)
\n auto-detect: true
\n # Force specific plugin: “litebans”, “advancedban”, “vanilla”
\n force: “auto”<\/p>\n

# Statistics Tracking
\nstatistics:
\n # Track player mace statistics
\n enabled: true<\/p>\n

# Track legitimate high-damage hits
\n track-high-damage: true<\/p>\n

# Track total mace hits per player
\n track-hit-count: true<\/p>\n

# Track average damage per player
\n track-average-damage: true<\/p>\n

# Advanced Options
\nadvanced:
\n # Packet validation level (higher = stricter, more CPU)
\n # Values: 1 (low), 2 (medium), 3 (high)
\n validation-level: 2<\/p>\n

# Enable packet-level validation (requires ProtocolLib)
\n packet-validation:
\n enabled: false
\n # This is experimental and may cause issues
\n use-protocollib: false<\/p>\n

# Fall distance calculation method
\n # “server” = server-side only (most secure)
\n # “client” = trust client (not recommended)
\n # “hybrid” = server with client validation
\n calculation-method: “server”<\/p>\n

# Maximum violations to store in memory
\n max-violations-stored: 1000<\/p>\n

# DO NOT EDIT
\nconfig-version: 1.0.0
\n“`<\/p>\n<\/details>\n

## Why this plugin \u2753
\n– Server side calculation based, due to which chances of bypass is minimal.<\/p>\n","protected":false},"excerpt":{"rendered":"

Anti-cheat specifically made for preventing mace hacks such as MaceDMG<\/p>\n","protected":false},"featured_media":97192,"template":"","meta":{"_minecraft_slug":"maceguard","_minecraft_project_id":"GMzVlf4R","_minecraft_author":"Kanhaiya","_minecraft_license":"MIT","_minecraft_downloads":539,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"maceguard.zip","_minecraft_size_bytes":32711,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T10:28:37.096888Z","_minecraft_date_created":"2025-12-02T05:06:42.561392Z","_minecraft_date_modified":"2025-11-29T09:02:22.143810Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/maceguard","_minecraft_icon_attachment_id":97192,"_minecraft_imported_at":"2026-06-05T13:48:25+00:00","_minecraft_import_hash":"98fd547a08fff61183fa5d830ae91e70","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-97191","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nMaceGuard - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"MaceGuard - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Anti-cheat specifically made for preventing mace hacks such as MaceDMG\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/maceguard\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/maceguard\\\/\",\"name\":\"MaceGuard - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/maceguard\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/maceguard\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/maceguard-icon-ed774f0051255558f63faa679048d397ea406fd3_96.webp\",\"datePublished\":\"2026-06-05T13:48:24+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/maceguard\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/maceguard\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/maceguard\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/maceguard-icon-ed774f0051255558f63faa679048d397ea406fd3_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/maceguard-icon-ed774f0051255558f63faa679048d397ea406fd3_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/maceguard\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"MaceGuard\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"MaceGuard - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/","og_locale":"en_US","og_type":"article","og_title":"MaceGuard - Minecraft","og_description":"Anti-cheat specifically made for preventing mace hacks such as MaceDMG","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/","name":"MaceGuard - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/maceguard-icon-ed774f0051255558f63faa679048d397ea406fd3_96.webp","datePublished":"2026-06-05T13:48:24+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/maceguard-icon-ed774f0051255558f63faa679048d397ea406fd3_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/maceguard-icon-ed774f0051255558f63faa679048d397ea406fd3_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/maceguard\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"MaceGuard"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/97191","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/97192"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=97191"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=97191"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=97191"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=97191"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}