MaceGuard

插件

· 作者 Kanhaiya

专为防止如 MaceDMG 等战锤作弊而设计的反作弊系统

0 本站下载 0 关注 更新于 11 个月前

最新 2.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

⚡ MaceGuard

? 功能说明

阻止 MaceDMG 作弊行为

工作原理:在服务器端计算预期伤害 → 与实际伤害进行对比 → 违规 3 次后封禁

更精准的封禁——采用服务器端跌落计算,额外支持密度(Density)和风爆(Wind Burst)附魔、风弹跳跃、加速药水以及末影珍珠落地检测。更多详情请查看下方配置。

? 安装步骤

  1. 下载 MaceGuard-1.0.0.jar
  2. 停止服务器
  3. 将其复制到 plugins/ 文件夹中
  4. 启动服务器

? 权限

Moderators - 查看警报

  • maceguard.alerts
  • maceguard.staff

Admins - 完全访问权限

  • maceguard.*

通过 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>

## 为什么选择这个插件 ❓
- 基于服务器端计算,因此绕过检测的可能性极小。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源