⚡ MaceGuard
? 功能说明
阻止 MaceDMG 作弊行为
工作原理:在服务器端计算预期伤害 → 与实际伤害进行对比 → 违规 3 次后封禁
更精准的封禁——采用服务器端跌落计算,额外支持密度(Density)和风爆(Wind Burst)附魔、风弹跳跃、加速药水以及末影珍珠落地检测。更多详情请查看下方配置。
? 安装步骤
- 下载 MaceGuard-1.0.0.jar
- 停止服务器
- 将其复制到 plugins/ 文件夹中
- 启动服务器
? 权限
Moderators - 查看警报
- maceguard.alerts
- maceguard.staff
Admins - 完全访问权限
通过 Luckperms 设置
- /lp group moderator permission set maceguard.alerts true
- /lp group admin permission set maceguard.* true
? 配置文件
Spoiler
##############################################
# MaceGuard Configuration File #
# Advanced Mace Damage Validation System #
##############################################
# 消息插件前缀
prefix: "&c[MaceGuard]"
# 伤害验证设置
damage-validation:
# 启用伤害验证系统
enabled: true
# 合法伤害波动的容错乘数
# 1.15 = 允许最多比预期伤害高 15%(用于处理延迟、舍入误差等)
# 数值越低越严格,越高越宽松
tolerance-multiplier: 1.15
# 触发猛击攻击加成所需的最小跌落距离
# 原版为 1.5 格,我们使用 1.3 以考虑客户端与服务器同步问题
min-fall-distance: 1.3
# 追踪的最大跌落距离(格)
# 设置为 -1 表示无限制
max-fall-distance: 256
# 启用服务器端跌落距离计算
# 强烈建议保持为 true 以防止欺骗
server-side-calculation: true
# 在服务器端重新计算伤害(取消并重新应用)
# 如果为 false,仅记录违规行为但不阻止伤害
cancel-invalid-damage: true
# 特殊机制追踪
mechanics:
# 风弹检测
wind-charge:
enabled: true
# 检测风弹使用的时间窗口(毫秒)
detection-window: 2000
# 检测到时的额外跌落距离加成(格)
bonus-fall-distance: 7.0
# 末影珍珠检测
ender-pearl:
enabled: true
# 检测末影珍珠使用的时间窗口(毫秒)
detection-window: 3000
# 是否追踪珍珠高度以用于计算
track-pearl-height: true
# 加速药水
jump-boost:
enabled: true
# 每个增益等级增加的额外跌落距离(格)
bonus-per-level: 0.5
# 风爆附魔
wind-burst:
enabled: true
# 每个附魔等级增加的额外跌落距离(格)
bonus-per-level: 7.0
# 追踪连续猛击攻击
track-combos: true
# 密度附魔验证
density:
# 启用密度附魔验证
enabled: true
# 最大附魔等级(原版为 5)
max-level: 5
# 每下落一格每等级的伤害加成
# 原版公式:0.5 * 等级 * 格数
damage-per-block-per-level: 0.5
# 验证武器上是否实际拥有该附魔
verify-enchantment: true
# 日志设置
logging:
# 启用文件日志记录
enabled: true
# 记录所有违规行为
log-violations: true
# 记录可疑命中(在容差范围内但伤害较高)
log-suspicious: true
# 记录所有合法的高伤害命中以供监控
log-high-damage: true
high-damage-threshold: 50.0
# 记录封禁
log-bans: true
# 控制台输出
console:
enabled: true
# 日志级别:INFO, WARNING, SEVERE
level: "WARNING"
# 文件输出
files:
violations: "violations.log"
suspicious: "suspicious.log"
bans: "bans.log"
high-damage: "high-damage.log"
# 惩罚系统
punishment:
# 启用自动惩罚
auto-ban: true
# 触发惩罚前的最大违规次数
max-violations: 3
# 封禁时长(需要 LiteBans、AdvancedBan 或兼容插件)
# 格式:#d = 天, #h = 小时, #m = 分钟
ban-duration: "2d"
# 封禁理由(支持 & 颜色代码)
ban-reason: "&c[MaceGuard] MaceDMG 利用漏洞 - 检测到伪造的跌落距离"
# 在此时间后重置违规次数(分钟)
# 设置为 -1 表示永不重置
reset-violations-after: 30
# 广播惩罚信息
broadcast:
enabled: true
message:
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- "&c⚠ &fMaceGuard &7检测到 &c%player% &7使用了战锤利用漏洞"
- "&7违规次数: &c%violations% &7| 超额伤害: &c%excess-damage%"
- "&7惩罚: &c%duration% 封禁"
- "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
# 执行惩罚时运行的命令
# %player% = 玩家名称
# %uuid% = 玩家 UUID
# %violations% = 违规计数
commands:
- "tempban %player% 2d &c[MaceGuard] MaceDMG Exploit"
# 根据需要添加更多命令
# - "discord send #bans %player% was banned for mace exploit"
# 警报
alerts:
# 向工作人员发送实时警报
enabled: true
# 接收警报所需的权限
permission: "maceguard.alerts"
# 警报格式
format: "&c[MaceGuard] &e%player% &7尝试使用战锤利用漏洞! &f[违规等级: %vl%/%max-vl%] &7预期伤害: &f%expected%, &7实际伤害: &c%actual%"
# 悬停消息(仅限 Paper 服务器)
hover:
- "&7玩家: &f%player%"
- "&7违规: &f%vl%/%max-vl%"
- "&7预期伤害: &f%expected%"
- "&7实际伤害: &c%actual%"
- "&7超额伤害: &c%excess%"
- "&7跌落距离: &f%fall-distance% 格"
- "&7风弹: %wind-charge%"
- "&7末影珍珠: %ender-pearl%"
- ""
- "&e点击传送"
# 点击动作
click-command: "/tp %player%"
# 将警报发送到 Discord Webhook
discord:
enabled: false
webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE"
# 发送到 Discord 前的最小违规次数
min-violations: 2
# 嵌入颜色(十进制)
color: 16711680 # 红色
玩家警告
warnings:
向违规玩家发送警告
enabled: true
警告消息
message: "&c[MaceGuard] &7检测到无效的战锤伤害!&c[%vl%/%max-vl%]"
标题通知
title:
enabled: true
title: "&c⚠ 警告 ⚠"
subtitle: "&7检测到战锤漏洞利用"
fade-in: 10
stay: 40
fade-out: 10
在特定违规阈值时发送警告
thresholds:
- 1
- 2
- 3
豁免设置
exemptions:
绕过权限
bypass-permission: "maceguard.bypass"
豁免创造模式玩家
exempt-creative: true
豁免旁观模式玩家
exempt-spectator: true
豁免特定世界中的玩家
exempt-worlds:
- "creative_world"
- "test_world"
豁免特定区域中的玩家(需要 WorldGuard)
exempt-regions:
- "spawn"
- "safezone"
白名单特定玩家(UUID 或用户名)
whitelisted-players:
# - "069a79f4-44e9-4726-a5be-fca90e38aaf5"
# - "Notch"
性能优化
performance:
尽可能异步运行计算
async-processing: true
异步任务的线程池大小
thread-pool-size: 2
缓存玩家数据的持续时间(以刻为单位,20 刻 = 1 秒)
cache-duration-ticks: 100
每刻检查的最大玩家数量(防止卡顿)
max-checks-per-tick: 50
旧数据清理间隔(以刻为单位)
cleanup-interval-ticks: 6000 # 5 分钟
清理阈值(移除早于此时间的数据,单位为毫秒)
cleanup-threshold-ms: 300000 # 5 分钟
调试设置
debug:
启用调试模式(详细的控制台输出)
enabled: false
调试特定玩家
debug-players:
# - "TestPlayer123"
在控制台中显示预期与实际伤害对比
show-damage-calculations: false
追踪所有战锤命中(包括合法的命中)
track-all-hits: false
与其他插件集成
integration:
Vulcan 反作弊集成
vulcan:
enabled: true
# 将违规行为发送到 Vulcan 的日志
log-to-vulcan: true
GrimAC 集成
grim:
enabled: true
# 将违规行为发送到 Grim 的日志
log-to-grim: true
LiteBans / AdvancedBan
ban-plugin:
# 自动检测封禁插件(LiteBans, AdvancedBan, 原版)
auto-detect: true
# 强制指定插件:"litebans", "advancedban", "vanilla"
force: "auto"
统计追踪
statistics:
追踪玩家战锤统计数据
enabled: true
追踪合法的高伤害命中
track-high-damage: true
追踪每位玩家的战锤命中总数
track-hit-count: true
追踪每位玩家的平均伤害
track-average-damage: true
高级选项
advanced:
数据包验证级别(数值越高越严格,但更消耗 CPU)
值:1(低),2(中),3(高)
validation-level: 2
启用数据包级别验证(需要 ProtocolLib)
packet-validation:
enabled: false
# 这是实验性功能,可能会导致问题
use-protocollib: false
下落距离计算方法
"server" = 仅服务器端(最安全)
"client" = 信任客户端(不推荐)
"hybrid" = 服务器结合客户端验证
calculation-method: "server"
内存中存储的最大违规记录数
max-violations-stored: 1000
请勿编辑
config-version: 1.0.0
</details>
## 为什么选择这个插件 ❓
- 基于服务器端计算,因此绕过检测的可能性极小。
⚡ 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
- Download MaceGuard-1.0.0.jar
- Stop server
- Copy to plugins/ folder
- Start server
? Permissions
Moderators - see alerts
- maceguard.alerts
- maceguard.staff
Admins - full access
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧