Flood Guard

插件

· 作者 grasstouchingdev

保护你的服务器免受任何破坏机器的侵害。

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

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

!!! 请阅读说明 | 需要进行少量配置。 !!!

FloodGuard

针对 Paper 服务器的服务端防护,用于抵御自动化的流体、TNT、红石、飞行机器、爆炸及方块类恶意破坏行为。

FloodGuard 监控可疑的自动化操作,并提供可配置的检测、遏制、警报以及可选的回滚功能,无需安装客户端模组。

平台: Paper 1.21+ Java: 21+ 环境: 服务端 许可证: GPL-3.0

特性

FloodGuard 结合了事件监控、机器检测、行为分析、可配置限制、员工警报以及可选的回滚功能。

支持的防护领域包括:

  • 飞行机器
  • TNT 机器及自动化 TNT 系统
  • TNT 复制机制
  • TNT 矿车
  • 基于水的机器及洪水泛滥
  • 基于熔岩的机器及熔岩浇筑
  • 细雪
  • 活塞及移动方块结构
  • 发射器及自动化触发器
  • 红石时钟及重复激活
  • 大规模或异常的方块移动
  • 重复爆炸
  • 其他可配置的破坏模式

检测机制不会将普通玩家活动视为恶意行为。管理员可以配置阈值、检测类别、世界范围以及响应措施。

飞行机器

FloodGuard 可以监控基于活塞的移动结构,并识别通常与自动化机器相关的模式。

检测可以使用以下因素:

  • 活塞活动
  • 黏液块和蜂蜜块的连接
  • 侦测器控制的移动
  • 重复的移动模式
  • 移动方块结构
  • 机器尺寸
  • 机器移动频率
  • 附近的爆炸载荷
  • 附近的流体源

当超过配置的阈值时,FloodGuard 可以遏制该机器,取消相关激活,通知工作人员,并记录检测结果。

TNT 防护

FloodGuard 可以监控自动化 TNT 系统及可疑的爆炸结构。

示例包括:

  • 附着在移动机器上的 TNT
  • 自动化 TNT 发射器
  • 重复 TNT 系统
  • 基于 TNT 的破坏机器
  • 可疑的 TNT 发射器
  • 自动化爆炸机制
  • TNT 矿车系统

可能的响应措施包括:

  • 取消危险激活
  • 阻止机器继续运行
  • 移除配置的危險方块或实体
  • 防止配置的爆炸发生
  • 通知工作人员
  • 记录检测结果

TNT 复制

FloodGuard 可以检测与自动化 TNT 复制及自动化 TNT 生产相关的可配置模式。

检测可能会考虑以下组合:

  • 活塞
  • 黏液块
  • 蜂蜜块
  • TNT
  • 侦测器
  • 红石时钟
  • 重复激活模式
  • 机器移动

检测基于行为而非依赖单个方块或布局。这允许管理员根据其服务器调整保护阈值。

TNT 矿车

FloodGuard 可以监控可疑的 TNT 矿车活动。

防护可以涵盖:

  • TNT 矿车炮台
  • 自动化爆炸轨道系统
  • 重复的 TNT 矿车攻击
  • 红石控制的 TNT 矿车系统

根据配置,FloodGuard 可以取消危险激活,移除爆炸实体,停止关联机器,并警告工作人员。

水防护

FloodGuard 可以限制基于水的自动化破坏行为。

防护可以检测或响应以下内容:

  • 自动化水机器
  • 飞行水机器
  • 基于发射器的洪水
  • 大型自动化瀑布
  • 重复的水源放置
  • 移动机器周围的流体活动

管理员可以配置检测半径和传播限制。

示例:

water:
  enabled: true
  detection-radius: 5
  spread-limit: 2

FloodGuard 可以选择停止关联机器,限制进一步扩散,移除配置的水源方块,并通知工作人员。

熔岩防护

由于大型自动化熔岩系统会损坏建筑并产生大量的方块更新活动,因此可以单独监控熔岩。

可能的检测内容包括:

  • 熔岩机器
  • 自动化熔岩浇筑
  • 熔岩洪水系统
  • 基于发射器的熔岩系统
  • 附着在移动机器上的熔岩
  • 异常的熔岩传播

配置的响应措施可能包括限制传播、停止关联机器活动、移除选定的水源方块,并警告工作人员。

细雪

细雪可以作为独立的防护类别进行处理。

检测系统设计为可扩展的,以便在不重写整个防护系统的情况下集成额外的基于方块的流体或传播机制。

自定义流体

FloodGuard 可以为兼容的其他插件或服务器 API 提供的自定义流体暴露配置选项。

示例:

fluids:
  custom:
    ExamplePlugin:
      - ExampleFluid

自定义流体支持取决于已安装的服务器和插件所暴露的 API 和事件。FloodGuard 不应假设每个第三方流体的行为都与原版水或熔岩完全相同。

方块防护

FloodGuard 可以监控通常用作自动化破坏机器组件的基于方块的机制。

支持的监控内容可能包括:

  • 活塞
  • 侦测器
  • 发射器
  • 投掷器
  • 中继器
  • 比较器
  • 红石激活
  • 移动结构
  • 自动化方块放置
  • 自动化方块交互

目标是在不干扰正常农场、门、运输系统或其他合法红石建筑的前提下,识别破坏性行为。

红石检测

FloodGuard 可以监控高频红石活动,而无需将每个红石电路都视为恶意行为。

潜在信号包括:

  • 快速活塞激活
  • 侦测器循环
  • 中继器时钟
  • 比较器时钟
  • 重复的发射器激活
  • 重复的机器周期
  • 异常的激活频率
  • 大型自动化机制

除非超过配置的检测阈值,否则正常的农场和红石建筑应保持功能正常。

机器分析

FloodGuard 应在采取破坏性保护动作之前评估多个信号。

可能的输入包括:

结构 移动 红石 流体 爆炸物 频率 尺寸 重复次数 潜在伤害

随后可为机器分配一个可配置的风险评分。

示例:

[FloodGuard]

检测到威胁 玩家:ExamplePlayer 类型:自动化 TNT 机器 风险:95 操作:机器已遏制 世界:生存模式 位置:1250, 72, -430

风险评分旨在通过结合多个指标而非依赖单一规则来减少误报。

防护操作

防护响应是可配置的。

根据检测到的威胁,FloodGuard 可以:

取消激活 停止机器活动 限制流体传播 阻止配置的爆炸 移除配置的爆炸方块 移除配置的爆炸实体 通知工作人员 记录事件 排队支持的回滚操作

每个防护模块应在可行情况下暴露其自身的配置。

警报

FloodGuard 提供可配置的工作人员通知。

警报可发送至:

控制台 操作员 拥有 floodguard.notify 权限的用户 支持的外部集成

示例:

[FloodGuard] 检测到威胁

玩家:ExamplePlayer 类型:飞行 TNT 机器 风险:95 操作:机器已禁用 位置:生存模式 1250 72 -430

统计信息

FloodGuard 可以维护有界统计信息以记录检测到的活动。

可能的统计项包括:

总检测次数 TNT 检测次数 飞行机器检测次数 流体检测次数 爆炸检测次数 已遏制的机器数量 发送的警报数量 回滚操作次数

使用以下命令查看统计信息:

/floodguard stats 回滚

FloodGuard 可选择性地跟踪由检测到的威胁引起的受支持的方块变更。

可使用可配置项限制回滚存储:

时间窗口 区块限制 存储限制 保留设置

回滚应针对大型服务器进行优化,且不应存储无限的历史数据。

仍需定期维护服务器备份。

管理

FloodGuard 通过命令和可选的仅限管理员的 GUI 提供管理控制。

命令 命令 描述 /floodguard status 显示防护状态 /floodguard stats 显示检测统计信息 /floodguard reload 重新加载配置 /floodguard toggle 切换配置的防护 /fg 命令别名

权限 权限 描述 floodguard.admin 完全管理访问权限 floodguard.notify 接收防护警报 floodguard.bypass 绕过配置的防护

仅信任的管理员应获得 floodguard.bypass 权限。

管理员 GUI

可选的 GUI 仅限于拥有所需管理权限的用户使用。

GUI 可暴露以下控件:

防护模块 检测类别 检测阈值 机器半径 TNT 半径 流体半径 风险设置 世界排除项 警报设置 回滚设置 性能限制 统计信息 调试模式

通过 GUI 进行的更改应使用与手动配置编辑相同的经过验证的配置系统。

敏感操作在执行前应要求确认。

清理积水

FloodGuard 可为仅管理员使用的命令提供支持,用于移除指定 Y 轴高度上方的水源方块。

示例:

/floodguard remove-water <height>

该实现应满足以下要求:

  • 需要管理员权限
  • 需要有效的 Y 轴高度参数
  • 仅在允许的世界中生效
  • 根据配置规则定位水源方块
  • 避免无限制的整个世界扫描
  • 提供进度或完成反馈
  • 遵守服务器性能限制

具体命令行为可能因最终实现而有所不同。

世界控制

可以为选定的世界禁用保护功能。

示例:

worlds: disabled: - creative - testing

这允许服务器在生产世界中保持保护启用,同时在专用的测试世界中解除限制。

配置

示例配置如下:

enabled: true debug: false

protection: flying-machines: true tnt: true tnt-duplication: true tnt-minecarts: true water: true lava: true powder-snow: true explosions: true redstone-machines: true

detection: machine-radius: 5 tnt-radius: 5 fluid-radius: 5

actions: stop-machine: true cancel-explosion: true notify-staff: true rollback: true

worlds: disabled: []

fluids: custom: {}

实际配置可能包含更多选项,具体取决于已安装的版本。```

性能

FloodGuard 旨在适用于多人在线服务器,包括玩家数量较多且自动化程度较高的服务器。

该实现应优先采用:

  • 基于事件驱动的检测机制
  • 缓存的机器数据
  • 有界集合(Bounded collections)
  • 有限的区块访问
  • 在 API 安全的前提下进行异步处理
  • 计划性清理任务
  • 可配置的扫描限制
  • 有界的回滚存储

FloodGuard 应避免持续扫描整个世界或仅为后台检测而加载区块。

保护逻辑还应避免不必要的:

  • 同步重型计算
  • 重复的方块搜索
  • 无界的内存增长
  • 线程创建
  • 持久化存储的增长

兼容性

FloodGuard 针对以下环境:

Minecraft Java Edition Paper 1.21+ Java 21+

FloodGuard 是一个 Paper 插件,不提供原生的 Bedrock 服务器支持。

与第三方插件的兼容性取决于这些插件所暴露的 API 和事件。

安装

  1. 安装 Paper 1.21+。
  2. 安装 Java 21 或更高版本。
  3. 将 FloodGuard.jar 放入服务器的 plugins 目录中。
  4. 启动服务器一次。
  5. 停止服务器。
  6. 编辑 plugins/FloodGuard/config.yml 文件。
  7. 再次启动服务器。

建议在向生产世界部署激进的保护或回滚设置之前,先在服务器副本上测试配置。

局限性

FloodGuard 使用可配置的检测和行为分析机制。它不能保证完美检测每一种可能的红石机器、漏洞利用、恶意破坏设计或未来的 Minecraft 机制。

检测准确性取决于以下因素:

  • Minecraft 版本
  • Paper API 的行为
  • 机器设计
  • 插件交互
  • 配置的阈值
  • 可用的事件和服务器数据

新的 Minecraft 机制可能需要更新检测模块。

因此,在实时服务器上启用限制性设置之前,应使用现有的农场、红石系统、运输系统和其他自动化设施对 FloodGuard 进行测试。

隐私

FloodGuard 仅应保留配置的保护、日志记录、统计和回滚功能所需的信息。

保留期限应可配置。

除非服务器管理员明确启用并配置此类功能,否则插件不得将服务器数据传输到外部服务。

开发

FloodGuard 旨在采用模块化架构,以便在不替换整个检测引擎的情况下扩展各个保护模块。

实现应优先考虑:

  • 可维护性
  • 可测试性
  • 清晰的模块边界
  • 防御性错误处理
  • 受限的资源使用
  • 版本感知的 Minecraft 集成
  • 清晰的配置验证

项目状态

FloodGuard 旨在成为:

  • 生产就绪
  • 模块化
  • 可扩展
  • 完全可配置
  • 文档完善
  • 抗错误
  • 针对多人游戏环境优化

随着 Minecraft 和 Paper 机制的演进,未来版本可能会扩展功能。

许可证

FloodGuard 根据 GNU 通用公共许可证 v3.0 (GPL-3.0) 授权。

您可以根据 GPL-3.0 使用、修改和重新分发 FloodGuard。

完整许可证文本:

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源