SomeFreeze

插件

· 作者 SomeOneDay

适用于 Paper 1.16.5 的作弊检测(冻结)插件。版主可召唤疑似玩家进行限时审查,在专用检查聊天频道中沟通,检测 AnyDesk ID,追踪挂机行为,并记录审查结果(可选 MySQL 存储)。

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

最新 1.0.1 · 1.16.5 · Bukkit / Paper

一键开服(送7天)

SomeFreeze

一款面向 Paper 1.16.5 的作弊检测(冻结)插件。管理员可以传唤可疑玩家进行限时审查,在私密检查频道中沟通,检测 AnyDesk ID,追踪挂机状态,并记录检查结果,支持可选的 MySQL 存储。

依赖项

  • Paper 1.16.5(或兼容的 Spigot 分支)
  • Java 8+
  • ProtocolLib(可选,推荐)—— 通过客户端视角数据包改进 AFK 检测。构建前请将 ProtocolLib.jar 放入 libs/ 目录,或在服务器运行时安装它。

构建

mvn clean package

输出:target/SomeFreeze-1.0.1.jar

命令

主命令:/freeze
别名:/sfreeze、/проверка

命令 描述 权限
/freeze <player> 对某玩家开始作弊检测 somefreeze.use
/freeze 以清白状态结束当前活动中的检测 somefreeze.use
/freeze <player> (再次) 如果你正在检测该玩家,则再次执行此命令将以清白状态结束检测 somefreeze.use
/freeze checkafk [player] 检查某玩家是否处于挂机状态(默认为你当前检测的目标玩家) somefreeze.checkafk
/freeze history <player> 显示某玩家的最近 15 条检测记录 somefreeze.history
/freeze finish <reason> 以配置好的原因结束检测(并执行关联的命令) somefreeze.finish
/freeze time stop 暂停封禁倒计时(例如在共享 AnyDesk 后) somefreeze.time
/freeze time start 恢复封禁倒计时 somefreeze.time

权限

权限 描述 默认值
somefreeze.use 开始/结束检测 op
somefreeze.checkafk 使用 /freeze checkafk op
somefreeze.history 查看检测历史 op
somefreeze.finish 带原因结束检测 op
somefreeze.time 暂停/恢复计时器 op
somefreeze.notify 接收检测通知 op
somefreeze.bypass 忽略冻结限制(移动、物品栏等) false
somefreeze.admin 授予上述所有权限 op

检测流程

  1. 开始 — 管理员运行 /freeze <player>。嫌疑人被冻结在原地,传送至配置的检查位置(可选),并与该管理员绑定至本次会话。
  2. 限制 — 在被冻结期间,玩家无法移动、打开物品栏、进行交互、丢弃物品、受到伤害或执行大多数命令(与聊天相关的命令和 /freeze 除外)。拥有 somefreeze.bypass 权限的玩家不受影响。
  3. 计时器 — 倒计时运行(默认 7 分钟)。管理员会看到一个显示剩余时间的 BossBar。当时间归零时,会通过 on-time-expire 触发可配置的命令(例如封禁)。
  4. 提醒 — 按可配置的间隔,嫌疑人会收到聊天指令、一个可选的可点击 AnyDesk 链接以及标题/副标题覆盖层。
  5. AnyDesk — 如果嫌疑人在聊天中发布了一个 9-10 位的 ID(正则表达式可配置),管理员将收到通知并记录活动。
  6. 私聊 — 检查期间公共聊天被取消;管理员与嫌疑人之间的消息通过私聊路由,并提供可选的复制到剪贴板按钮。
  7. 计时器控制 — /freeze time stop 暂停倒计时(屏幕共享后很有用);/freeze time start 恢复倒计时。
  8. 结束 — /freeze 或 /freeze <same player> 标记玩家为清白,恢复其保存的位置,并保存历史记录。/freeze finish <reason> 应用配置的结果和命令。
  9. 断开连接 — 如果嫌疑人在活跃检查期间退出,会自动运行 reasons.left 命令(例如因离开而封禁)。

AFK 检测

插件全局跟踪玩家活动:

  • 物品栏点击、拖拽和关闭
  • 快捷栏槽位更改
  • 视角旋转(位置不变的运动)
  • ProtocolLib 查看数据包(启用时)

设置:

  • settings.afk-threshold-seconds — 在此无活动时间后,/freeze checkafk 报告 AFK(默认 30 秒)
  • settings.freeze-block-afk-seconds — 超过此无活动时间的玩家不能被呼叫进行检查(默认 180 秒 / 3 分钟)

在活跃检查期间,也会按会话跟踪无活动状态。

检查历史

每次完成的检查都会记录目标、管理员、状态、原因和时间戳。

  • YAML(默认):plugins/SomeFreeze/history.yml
  • MySQL:在配置中启用;使用 HikariCP(已嵌入 JAR 中)

使用 /freeze history <player> 查看(最近 15 条记录)。

配置

设置 (settings)

键 描述 默认值
check-duration-seconds 过期后自动执行操作前的等待时间 420(7分钟)
reminder-interval-seconds 聊天/标题提醒的间隔时间 5
teleport-on-freeze 将嫌疑人传送至检查坐标 true
world, x, y, z, yaw, pitch 检查室的位置 world @ 0.5, 100, 0.5
restore-location 完成后将玩家返回到检查前的位置 true
execute-commands-as-moderator 以管理员身份执行封禁/命令(备用:控制台) true
anydesk-pattern 用于检测聊天中 AnyDesk ID 的正则表达式 \d{9,10}
afk-threshold-seconds checkafk 命令的闲置阈值 30
freeze-block-afk-seconds 如果玩家处于此时长的 AFK 状态,则阻止 /freeze 命令 180
afk.track-inventory 追踪背包活动 true
afk.track-hotbar 追踪快捷栏变化 true
afk.track-look 追踪视角旋转 true
afk.look-sensitivity 计为活动的最小视角变化量 2.0
afk.use-protocollib 使用 ProtocolLib 获取视角数据包 true

消息 (messages)

所有插件消息均支持占位符(见下文)。值得注意的部分包括:

  • freeze-chat — 在开始冻结及每次提醒时发送给嫌疑人的消息行
  • anydesk-link — 附加在第二条聊天消息后的可点击链接
  • freeze-title / freeze-subtitle — 标题覆盖层(支持渐变)
  • moderator-bossbar — 用于管理者的 BossBar 标题、颜色、样式和进度条
  • private-chat-format-sender / private-chat-format-receiver — 私聊格式(发送者/接收者)
  • private-chat-copy — 私聊消息旁边的复制按钮

结束原因 (reasons)

reasons 下的每个条目定义:

  • display — 显示在 /freeze finish 成功消息中
  • status — 保存到历史记录中
  • commands — 选择该原因时执行的命令(支持占位符)

默认键名:cheats、refuse、ignore、left、clean。

时间到期 (on-time-expire)

当计时器耗尽且未被暂停(如果尚未结束)时执行的命令。

消息颜色

配置字符串中支持以下格式:

  • 传统颜色代码:&a、&c 等
  • 十六进制颜色:&#FF5555 或 #FF5555
  • 渐变色:<gradient:#FF0000:#FFFF00>文本</gradient>

占位符

{player}、{target}、{moderator}、{time_left}、{time}、{reason}、{status}、{anydesk}、{date}、{prefix}、{message}

MySQL

mysql:
  enabled: true
  host: localhost
  port: 3306
  database: minecraft
  username: root
  password: password
  table-prefix: sf_

当 enabled: false 时,历史记录将存储在 plugins/SomeFreeze/history.yml 中。

on-time-expire / 原因命令示例

on-time-expire:
  commands:
    - "ban {target} Failed check within 7 minutes"

reasons:
  cheats:
    display: "&cCheats"
    status: "Banned (cheats)"
    commands:
      - "ban {target} Cheats during check"
  clean:
    display: "&aClean"
    status: "Clean"
    commands: []

命令可以加或不加 / 前缀;它们将以管理者身份(或在离线/设置禁用的情况下以控制台身份)执行。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源