ClientGuard
ClientGuard 检测并移除运行黑名单客户端模组的玩家。其检测机制旨在快速且尽可能保持静默。
内置经过测试的检测探针,支持 Wurst、Meteor Client、Freecam、Baritone、XRay Mod 和 PlayerESP。可通过配置文件或 /cg probe 命令随时添加更多探针。
工作原理
每个作弊客户端都会在其唯一的翻译键下注册按键绑定(例如 key.wurst.zoom)。当玩家加入时,ClientGuard 会在其脚下放置一个隐藏告示牌,其中打包了这些作为可翻译组件的按键,并在客户端打开告示牌编辑器后立即关闭它。客户端会将告示牌回传给服务器——如果任何按键被解析为可读标签(例如 Zoom),则说明该模组存在。
整个交互过程发生在加载屏幕上。玩家仅会看到一秒钟的告示牌编辑器界面。
功能特性
- 警告系统 — 在首次检测到作弊行为时可向玩家发出警告,然后再执行操作;被警告的状态在重连后依然保留,防止玩家通过重新登录来重置状态
- 可配置的操作 — 在检测到作弊时运行任意控制台命令,包括来自其他插件的命令(如封禁、临时封禁等)
- 按探针覆盖设置 — 为单个探针设置不同的操作或切换警告开关
- 自动重新扫描 — 以可配置的间隔定期重新扫描所有在线玩家
- 加入时扫描 — 带有可配置的延迟,以处理高延迟连接
- 手动扫描 — 使用
/cg scan <player> 或 /cg scan-all 对整个服务器进行扫描
- 扫描冷却时间 — 防止工作人员对同一玩家频繁滥用扫描
- 绕过检测 — 当玩家的客户端未响应扫描时,向工作人员发出警报
- 检测音效 — 发现不允许的模组时,向在线工作人员播放提示音
- 豁免权限 — 受信任的工作人员或建造者可以完全排除在扫描之外
- 检测历史 — 每次扫描结果都会被记录,并通过
/cg history <player> 查看
- 实时配置 — 无需重启即可在游戏中切换任何设置或管理探针
- 抑制效果 — 在扫描期间可选地施加失明和缓慢效果(完全可配置)
- 无依赖项 — 开箱即用,兼容任何 Paper 1.21+ 服务器
命令
| 命令 |
描述 |
/cg scan <player> |
手动扫描指定玩家 |
/cg scan-all |
立即扫描所有在线玩家 |
/cg history <player> |
查看玩家的检测日志 |
/cg history clear <player> |
清除玩家的历史记录 |
/cg status |
显示当前插件状态和配置 |
/cg set <flag> <value> |
实时切换任何检测标志位 |
/cg probe <list/add/remove/toggle> |
管理检测探针 |
/cg reload |
重新加载 config.yml |
注意事项
启用此选项并在执行扫描时,存在一个可能导致你被困在失明和缓慢效果中的 Bug。我会尝试修复这个问题,如果有机会的话,也会更新到 26.1 版本。
ClientGuard
ClientGuard detects and removes players running blacklisted client-side mods. The detection is designed to be quick and mostly silent.
Ships with tested probes for Wurst, Meteor Client, Freecam, Baritone, XRay Mod, and PlayerESP. Additional probes can be added at any time via config or the /cg probe command.
How It Works
Every cheat client registers its keybindings under unique translation keys (e.g. key.wurst.zoom). When a player joins, ClientGuard silently places a hidden sign below them packed with those keys as translatable components, opens the sign editor on the client, and immediately closes it. The client echoes the sign back to the server — if any keys were resolved to readable labels (e.g. Zoom), the mod is present.
The entire exchange happens on the loading screen. Players only see a sign editor for a split second.
Features
- Warn system — optionally warn players on first detection before the action fires; warned state survives reconnects so players cannot relog to reset it
- Configurable actions — run any console command on detection, including commands from other plugins (ban, tempban, etc.)
- Per-probe overrides — set a different action or toggling warnings for individual probes
- Auto re-scan — periodically re-scan all online players on a configurable interval
- Scan on join with a configurable delay to handle high-latency connections
- Manual scan with
/cg scan <player> or /cg scan-all for the whole server
- Scan cooldown to prevent staff from spamming scans on the same player
- Bypass detection — alerts staff when a player's client doesn't respond to the scan
- Detection sound — plays an alert sound to online staff when a dissallowed mod is found
- Exempt permission — trusted staff or builders can be excluded from scanning entirely
- Detection history — every scan result is logged and viewable with
/cg history <player>
- Live config — toggle any setting or manage probes in-game without a restart
- Suppression — optional blindness + slowness applied during the scan window (fully configurable)
- No dependencies — runs on any Paper 1.21+ server out of the box
Commands
| Command |
Description |
/cg scan <player> |
Manually scan a player |
/cg scan-all |
Scan every online player at once |
/cg history <player> |
View a player's detection log |
/cg history clear <player> |
Wipe a player's history |
/cg status |
Show current plugin status and config |
/cg set <flag> <value> |
Toggle any detection flag live |
/cg probe <list/add/remove/toggle> |
Manage detection probes |
/cg reload |
Reload config.yml |
Notes
There is a bug where you can get stuck with blindness and slowness if you choose to enable this option when doing a scan. I'll try to fix this and also update to 26.1 if I find a chance.
评论 0
登录后参与评分
还没有评论,来抢沙发吧