不再维护。
一款轻量级 Minecraft 插件,通过利用**“告示牌翻译漏洞”**来检测作弊客户端。
⚠️ 重要通知
兼容性: 此插件仅适用于 1.20.x 及更高版本。
大多数现代作弊客户端已修复此漏洞。DirtyDetect 对 较旧或维护较少 的客户端效果最佳。
? 工作原理
当玩家加入服务器时,Dirty Detect 会立即向其发送一个修改告示牌的包。作弊客户端将其内部操作(如打开模组菜单、切换功能等)绑定到真实的键盘按键上(例如:右 Shift - 打开模组菜单)。
由于这些键位绑定是在客户端内部注册的,作弊客户端会自动响应该告示牌包并触发其绑定的按键(例如 右 Shift)。原版 Minecraft 客户端绝不会在未受提示的情况下发送此类响应。
Dirty Detect 拦截此响应:如果返回的是真实按键而非无响应,则该玩家会被立即标记,并触发配置好的动作。
注意: 大多数现代且积极维护的作弊客户端已修复此行为。Dirty Detect 对 较旧或更新频率较低 的客户端最为有效。
✨ 特性
- ? 自动检测作弊客户端,基于告示牌翻译“漏洞”
- ? 可配置的提醒 - 向拥有特定权限节点的玩家发送警告,或向所有在线玩家广播
- ⚙️ 可配置的检测动作 - 对检测到的玩家执行任意命令
- ?️ 自定义前缀 - 用于所有插件消息
- ? 命令自定义 - 根据您的喜好重命名或别名化插件命令
- ♻️ 热重载 - 无需重启服务器即可应用配置更改
?️ 命令
| 命令 |
描述 |
权限 |
/dirtydetect reload |
重新加载插件配置 |
dirtydetect.reload |
/dirtydetect version |
显示当前插件版本 |
dirtydetect.version |
? 权限
| 权限 |
描述 |
默认值 |
dirtydetect.reload |
允许使用重载命令 |
OP |
dirtydetect.bypass |
豁免玩家免受检测 |
OP |
⚙️ 配置
# ─────────────────────────────────────────────────────────────────
#
# MiniMessage 格式说明: https://docs.advntr.dev/minimessage/format.html
#
# ─────────────────────────────────────────────────────────────────
prefix: "<gray>[<#ff6060>Dirty Detect<gray>]<reset>"
staff-permission: "dirtydetect.staff"
# true -> 惩罚公告发送给所有在线玩家
# false -> 仅拥有 staff-permission 权限的玩家可见
broadcast-to-all: true # 默认值为 true
# 占位符: %player%, %mod%
messages:
punished: " <white>玩家 <yellow>%player%</yellow> 被发现正在使用 \
<red>%mod%</red> 并已受到惩罚。"
alert: " <gold>[警报] <white>玩家 <yellow>%player%</yellow> 可能正在 \
使用 <gold>%mod%</gold>。"
punish:
command: "ban %player% [Dirty Detect] Hacked client detected (%mod%)."
mods:
Wurst:
key: "key.wurst.gui"
Meteor:
key: "key.meteor.openGui"
LiquidBounce:
key: "key.liquidbounce.panel"
Aristois:
key: "key.aristois.panel"
Future:
key: "key.future.clickgui"
alert:
mods:
OptiFine:
key: "key.zoom"
? 安装
- 从 Releases 页面下载最新的
DirtyDetect.jar。
- 将
.jar 文件放入服务器的 plugins/ 文件夹中。
- 启动或重启服务器 -> 插件将在
plugins/DirtyDetect/ 内生成默认的 config.yml。
- 根据需要编辑
config.yml(通知模式、检测命令、前缀、模组列表等)。
- 运行
/dirtydetect reload 以应用更改而无需重启服务器。
No longer maintained.
A lightweight Minecraft plugin that detects hack clients by exploiting the Sign Translation 'Vulnerability'.
⚠️ Important Notice
Compatibility: This plugin only works on versions 1.20.x and newer.
Most modern hack clients have patched this vulnerability. DirtyDetect works best against older or less maintained clients.
? How It Works
When a player joins the server, Dirty Detect immediately sends them a sign change packet. Hack clients bind their internal actions (such as opening a mod menu, toggling features, etc.) to real keyboard keys (for example: Right Shift - opens the mod menu).
Because these keybinds are registered inside the client, the hack client automatically responds to the sign packet with its bound key (e.g. Right Shift). A vanilla Minecraft client would never send such a response unprompted.
Dirty Detect intercepts this response: if a real key is returned instead of nothing, the player is immediately flagged and the configured action is triggered.
Note: Most modern, actively maintained hack clients have patched this behavior. Dirty Detect is most effective against older or less frequently updated clients.
✨ Features
- ? Automatic hack client detection via the Sign Translation 'Vulnerability'
- ? Configurable notifications - alert players with a specific permission node, or broadcast to all online players
- ⚙️ Configurable detection action - runs any command on the detected player
- ?️ Custom prefix for all plugin messages
- ? Command customization - rename or alias plugin commands to your liking
- ♻️ Live reload - apply config changes without restarting the server
?️ Commands
| Command |
Description |
Permission |
/dirtydetect reload |
Reloads the plugin configuration |
dirtydetect.reload |
/dirtydetect version |
Displays the current plugin version |
dirtydetect.version |
? Permissions
| Permission |
Description |
Default |
dirtydetect.reload |
Allows use of the reload command |
OP |
dirtydetect.bypass |
Exempts a player from being detected |
OP |
⚙️ Configuration
# ─────────────────────────────────────────────────────────────────
#
# MiniMessage format: https://docs.advntr.dev/minimessage/format.html
#
# ─────────────────────────────────────────────────────────────────
prefix: "<gray>[<#ff6060>Dirty Detect<gray>]<reset>"
staff-permission: "dirtydetect.staff"
# true -> punishment announcements are sent to ALL online players
# false -> only players with the staff-permission see them
broadcast-to-all: true # Default true
# Placeholders: %player%, %mod%
messages:
punished: " <white>Player <yellow>%player%</yellow> was caught using \
<red>%mod%</red> and has been punished."
alert: " <gold>[ALERT] <white>Player <yellow>%player%</yellow> may be \
using <gold>%mod%</gold>."
punish:
command: "ban %player% [Dirty Detect] Hacked client detected (%mod%)."
mods:
Wurst:
key: "key.wurst.gui"
Meteor:
key: "key.meteor.openGui"
LiquidBounce:
key: "key.liquidbounce.panel"
Aristois:
key: "key.aristois.panel"
Future:
key: "key.future.clickgui"
alert:
mods:
OptiFine:
key: "key.zoom"
? Installation
- Download the latest
DirtyDetect.jar from the Releases page.
- Place the
.jar file into your server's plugins/ folder.
- Start or restart your server -> the plugin will generate a default
config.yml inside plugins/DirtyDetect/.
- Edit
config.yml to your liking (notification mode, detection command, prefix, mods, etc.).
- Run
/dirtydetect reload to apply any changes without a restart.
评论 0
登录后参与评分
还没有评论,来抢沙发吧