SafeTPFirewall

插件

· 作者 Nunotaba_Shinobu

中文 | 这是一个用于服务器的安全插件,可防止管理员因误输入或使用 TAB 补全 tp 命令而意外传送所有实体。

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

最新 1.4.0 · 26.2 · Folia / Paper

一键开服(送7天)

SafeTPFirewall

English | 中文说明 below

Paper / Folia 服务器高危实体传送安全确认插件。

功能特性

  • 拦截涉及 @e(包括嵌套的 execute ... run tp)的 tp / teleport 命令(不拦截 @a)
  • 支持玩家聊天、控制台、RCON
  • 实际执行前需输入 /y 进行确认;30 秒后自动取消
  • 也可输入 /n 进行取消
  • 操作日志记录:所有关键操作(拦截/确认/执行/取消/超时)均写入审计日志

审计日志

  • 文件路径:plugins/SafeTPFirewall/audit/audit-YYYY-MM-DD.log(每日滚动,追加模式,线程安全)
  • 日志内容:时间戳 | 操作类型 | 发起者 | 详情
    • 操作类型:INTERCEPT、CONFIRM、EXECUTED、EXEC_FAILED、CANCEL、TIMEOUT、EXPIRED
    • 发起者:玩家显示为 player:name(UUID),控制台/RCON 显示来源名称
  • 控制台日志同步输出开关和总开关位于 config.yml 的 audit: 配置节中
  • 升级注意:当旧版 config.yml 不包含 audit: 区块时,默认启用;如需更改配置,请手动添加或删除旧配置并重启以重新生成

Folia 兼容性

  • plugin.yml 声明了 folia-supported: true
  • 所有调度均通过 Scheduler 包装器进行:运行时检测 Folia 并自动切换
    • Folia:Bukkit.getGlobalRegionScheduler() / entity.getScheduler()(玩家命令在玩家所在区域线程上执行)
    • Paper:传统 Bukkit.getScheduler()
  • 由玩家发起的确认命令在玩家区域线程上执行;控制台/RCON 使用全局区域线程
  • 超时检查每 1 秒运行一次(自 v1.3 起正确连接;此前仅在 /y、/n 时懒检查)

安装

  1. 将 SafeTPFirewall.jar 放入服务器的 plugins/ 目录
  2. 重启服务器
  3. 检查日志以确认 SafeTPFirewall enabled

构建(联网环境)

mvn clean package
# 输出:target/SafeTPFirewall.jar

构建(离线/无网络)

确保你拥有 Paper API jar 包(可从 下载,或使用本地 Maven 仓库):

javac -cp paper-api-1.21.1.jar -d out \
  src/main/java/com/example/safetp/*.java
jar --create --file SafeTPFirewall.jar --main-class com.example.safetp.SafeTPFirewall -C out .

演示

误输入:

/tp @e ~ ~ ~

插件响应:

[SafeTP] 检测到高危实体传送命令!
30 秒内输入 /y 确认执行,或输入 /n 取消:
原始命令: /tp @e ~ ~ ~

输入 /y → 执行;无输入/错误输入/超时 → 拦截 ✅

命令方块 / Function 说明

Paper 未提供命令方块/function 执行前的进程内事件。正确的防护方式如下:

  1. 在活动期间临时禁用危险的 function
  2. 或在 paper.yml 中限制 command-blocks 的等级
  3. 插件提供了 log-command-block-only 开关用于审计日志记录

配置

编辑 plugins/SafeTPFirewall/config.yml 以调整超时时长、来源开关等设置。


中文说明

适用于 Paper / Folia 服务端的高危实体传送安全确认插件。

功能

  • 拦截涉及 @e 的 tp / teleport 命令(包括嵌套的 execute ... run tp;不拦截 @a)
  • 支持玩家聊天、控制台及 RCON
  • 需输入 /y 确认后才会真正执行,30 秒超时自动取消
  • 也可输入 /n 进行取消
  • 操作留痕:所有关键操作(拦截/确认/执行/取消/超时)均写入审计日志

操作留痕(审计日志)

  • 文件路径:plugins/SafeTPFirewall/audit/audit-YYYY-MM-DD.log(按天滚动,追加写入,线程安全)
  • 记录内容:时间戳 | 操作类型 | 发起者 | 详情
    • 操作类型:INTERCEPT(拦截)、CONFIRM(确认)、EXECUTED(执行成功)、EXEC_FAILED(执行失败)、CANCEL(取消)、TIMEOUT(超时)、EXPIRED(确认时已超时)
    • 发起者:玩家显示为 player:名字(UUID),控制台/RCON 显示来源名称
  • 控制台日志同步输出开关及总开关详见 config.yml 中的 audit: 配置块
  • 升级用户注意:若旧版 config.yml 中不存在 audit: 块,则按默认值(开启)生效;如需修改配置,可手动添加或删除旧 config 后重启以生成新配置

Folia 兼容

  • plugin.yml 已声明 folia-supported: true
  • 调度全部通过 Scheduler 封装实现:运行时探测 Folia,自动切换模式
    • Folia:使用 Bukkit.getGlobalRegionScheduler() / entity.getScheduler()(玩家命令在玩家所在 region 线程执行)
    • Paper:使用旧版 Bukkit.getScheduler()
  • 由玩家发起的确认命令将在玩家所在的 region 线程执行,控制台/RCON 则走全局 region 线程
  • 超时检查每 1 秒调度一次(v1.3 起真正接入,此前仅在收到 /y、/n 时惰性检查)

安装

  1. 将 SafeTPFirewall.jar 放入服务端的 plugins/ 目录
  2. 重启服务端
  3. 查看日志确认出现 SafeTPFirewall 已启用

构建(有魔法网络)

mvn clean package
# 产物:target/SafeTPFirewall.jar

构建(无魔法网络 / 离线)

确保拥有 Paper API jar(可从 下载,或使用本地 Maven 仓库中的版本):

javac -cp paper-api-1.21.1.jar -d out \
  src/main/java/com/example/safetp/*.java
jar --create --file SafeTPFirewall.jar --main-class com.example.safetp.SafeTPFirewall -C out .

效果演示

手滑输入:

/tp @e ~ ~ ~

插件响应:

[SafeTP] 检测到高危实体传送命令!
30 秒内输入 /y 确认执行,或输入 /n 取消:
原始命令: /tp @e ~ ~ ~

输入 /y → 执行;不输/输错/超时 → 不执行 ✅

配置

编辑 plugins/SafeTPFirewall/config.yml 可调整超时时间、来源开关等。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源