Piggy Admin

模组

· 作者 porkyoot

一款服务器端管理模组,旨在帮助管理反作弊设置并主持服务器

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

最新 2.0.1 · 1.21.1 · Fabric

一键开服(送7天)

build test

Piggy Admin

一款旨在帮助管理和强制执行兼容的客户端模组(如 Piggy Build 和 Piggy Inventory)设置的服务器端管理模组。目前,它作为管理反作弊选项、日志记录和检测的中心点,但未来将扩展以包含更多管理工具。


⚠️ 免责声明

这是一个个人项目。 它按原样提供,可能会导致问题。

  • 无支持: 不要指望获得常规支持或错误修复。
  • 无 Forge 移植版: 没有计划将此模组移植到 Forge。
  • 使用风险自负。

如果您想贡献修复或功能,请随意 Fork 该项目或提交 Pull Request!


功能

?️ 反作弊执行

  • 集中控制:配置您的服务器上是否允许“作弊”功能(如快速放置、工具切换)。
  • 自动同步:当玩家加入时,服务器的反作弊配置会自动发送到其客户端。
  • 严格执行:如果服务器禁用作弊,客户端端的覆盖将被忽略,确保公平竞争。
  • 细粒度控制:单独启用/禁用特定功能(例如,允许工具切换但禁止快速放置)。

?️ 高级 X-Ray 检测

Piggy Admin 使用多层启发式引擎来检测可疑的挖掘模式,同时避免分支挖矿带来的误报。

  • 矿石缓存管理器:异步跟踪有价值矿石的位置,使用高效的 ConcurrentHashMap,将对主线程的影响降至最低。
  • 向量相关性:使用 HeuristicsMathUtil 计算玩家的视线向量与不可见矿石距离之间的数学相关性。
  • 混合检测器:结合原始挖掘比率与对“可疑转向”和“直达矿石路径”的语义分析。
  • 灵敏度级别:从 LOW(宽松)到 PARANOID(严格),可通过 xraySensitivity 进行配置。
  • 管理员警报:实时通知管理员,并提供可点击的传送链接以跳转到嫌疑人的坐标。

? 法医数据与归因

该模组充当了针对恶意破坏的强大调查工具。

  • 爆炸归因:追踪 TNT 的真正所有者,即使是由燧石和铁锹、火球或其他实体点燃的。
  • 苦力怕所有权:识别故意点燃苦力怕(使用燧石和铁锹)以摧毁领土的玩家。
  • 熔岩与火灾责任:流体流动和方块火势蔓延的专业跟踪器。即使原始源方块已消失,模组也会维护谁放置它的历史记录。
  • 发射器跟踪:在发射器级别的自定义 mixins 将所有发射的投射物或桶操作归因于放置或最后与发射器交互的玩家。
  • 交互式通知:AdminNotifier 向 OP 发送丰富的、可悬停的聊天组件,允许直接从警报中进行即时“责任追究查询”。

? 审核引擎

  • AI 驱动审核:集成 Google Gemini AI 以自动过滤有毒或不适宜的聊天和告示牌文本。
  • 动态规则系统:定义自定义审核规则和类别(例如,脏话、骚扰、仇恨言论)。
  • 性能优化:包括高性能缓存和速率限制系统,以最小化 API 延迟并优雅地处理免费 tier API 限制。
  • 混合检查:结合快速的本地 Regex 检查与来自 Gemini 的深度语义分析。
  • 分类日志:所有被阻止的消息都按其特定类别记录,以便轻松审查。

? Gemini AI 设置

要使用 AI 审核功能,您需要一个 Google Gemini API 密钥。

  1. 获取 API 密钥:访问 Google AI Studio 并创建一个免费的 API 密钥。
  2. 配置模组:
    • 启动服务器一次以生成配置文件。
    • 打开 config/piggy-admin-server.json。
    • 将您的密钥粘贴到 "geminiApiKey" 字段中。
    • 设置 "moderationEnabled": true。
  3. 高级选项:
    • geminiModel:默认为 gemini-1.5-flash(推荐用于速度和成本)。
    • geminiSystemPrompt:您可以在此处自定义 AI 的“个性”和严格程度。

[!NOTE] Gemini 的免费 tier 有速率限制(每分钟约 15 次请求)。模组内置了缓存和速率限制器,以优雅地处理这些限制,而不会导致服务器卡顿。

? 历史与日志

  • 告示牌历史:追踪谁放置了告示牌以及上面写了什么。
  • 聊天历史:记录所有聊天消息以供管理员审查。
  • 爆炸日志:详细的 TNT 放置、点燃和爆炸日志,尽可能包括玩家归因。
  • 责任追究工具:检查现有的告示牌/方块,查看谁与之交互过以及何时交互。
  • 持久存储:历史数据在服务器重启后依然存在(保存至 config/piggy-admin-history.json)。

命令

所有命令都需要 OP 等级 2 或更高。

通用管理

  • /piggy cheats <allow|forbid>:全局允许或禁止所有玩家的“作弊”功能。
  • /piggy feature list:列出所有可控功能及其当前状态。
  • /piggy feature <id> <enable|disable>:启用或禁用特定功能(例如 flexible_placement, tool_swap)。
  • /piggy sync:手动触发将所有管理设置和审核规则同步到所有连接的客户端。

调查与日志记录

  • /blame: 观察一个方块或告示牌并运行此命令,以查看其交互历史。

    • 支持对象:火焰、熔岩、告示牌、容器以及爆炸区域。
  • /logs <玩家>: 查看某位玩家的分类历史记录(聊天、告示牌、火焰、爆炸、管理)。

    • 可点击传送:日志条目包含坐标,你可以点击这些坐标以前往现场进行调查。
  • /piggy xray <clear|stats>:管理 X 射线启发式缓存或查看当前玩家排名。


配置

该模组会在 config/piggy-admin-server.json(服务器端)生成一个配置文件。

{
  "allowCheats": false,
  "features": {
    "flexible_placement": true,
    "fast_place": false,
    "tool_swap": true
  },
  "xrayCheck": true,
  "xrayMaxRatio": 0.15,
  "xrayMinBlocks": 20,
  "moderationEnabled": true,
  "geminiApiKey": "YOUR_KEY",
  "geminiModel": "gemini-1.5-flash"
}
  • "allowCheats": false: 强制所有已连接客户端禁用受限功能。
  • "allowCheats": true: 允许客户端使用其本地设置。
  • "features": 对各个功能进行细粒度控制。
  • "xrayMaxRatio": 稀有矿石占总方块的最大允许比例(默认 15%)。
  • "xrayMinBlocks": X-Ray 检测激活前最少挖掘的方块数(默认 20)。
  • "xrayCheck": 切换 X-Ray 检测系统。
  • "moderationEnabled": 切换 AI 和正则表达式审查引擎。
  • "geminiApiKey": 你的 Google Gemini API 密钥。
  • "geminiModel": 要使用的 Gemini 模型(默认:gemini-1.5-flash)。

依赖与安装

要求

  • Minecraft: ~1.21.1
  • Fabric Loader: >=0.18.1
  • Java: >=21

必需模组

安装方法

  1. 从 Releases 下载 .jar 文件。
  2. 为 Minecraft 1.21.1 安装 Fabric Loader。
  3. 将 piggy-admin jar 文件(连同 Fabric API 和 Piggy Lib)放入服务器的 mods 文件夹中。
  4. 启动服务器!

待办事项 / 未来功能

  • 检测 XRay:实现启发式算法/检查机制,以检测使用 XRay 资源包或模组的玩家。
  • 审查告示牌文本:添加工具来检查和过滤告示牌上的文本,以防止不当内容。

灵感来源

本模组受到以下项目的启发:

  • ItemSwapper - 提供了服务端物品管理和交换机制的概念。

许可证: CC0-1.0

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源