Piggy Lib

Piggy Lib

这只是Piggy's Mods的一个库,没什么特别的。

基础库

构建 发布

Piggy Lib

一个共享库,为所有 Piggy 模组提供核心基础设施和高性能工具。它集中管理通用系统,以确保一致性、稳定性和反作弊合规性。


⚡ 中央 Piggy 操作队列

Piggy 套件中最关键的组件。所有玩家交互(点击槽位、放置方块、使用物品)都必须通过此队列进行路由。

  • 有状态操作:交互被封装在 IAction 对象中(例如 InteractBlockAction、MoveItemAction)。
  • 验证优于假设:操作在数据包发送时并不被视为“完成”。它们使用 onExecute 阶段来触发,并使用 verify 阶段来轮询是否成功(例如,检查物品是否确实移动到了目标槽位)。
  • 速率限制与 CPS:全局每秒点击次数(CPS)限制器遵循可配置的服务器规则。常规操作(整理)会被限流,而保命操作(MLG)使用 ActionPriority.HIGHEST 来绕过限制器。
  • 数据包捆绑:在安全的情况下,将相关交互分组到单 tick 执行中,以最大限度地减少网络开销。

📊 性能与遥测

PerfMonitor

一个用于跟踪服务器端健康状况和网络状况的稳健工具。

  • 动态 TPS 跟踪:实时计算服务器每秒 tick 数。
  • 延迟计算:提供稳定、平滑的 ping 数据,供 piggy-build 用于抢占式操作触发。

元操作会话

一个用于诊断复杂故障的精密遥测引擎。

  • 上下文日志记录:在操作前后捕获物品栏状态、玩家位置和世界元数据。
  • 取证报告:为失败的操作(例如物品栏整理失败或 MLG 失误)生成详细的 JSON/Markdown 报告。
  • 丰富格式:使用 PiggyTelemetryFormatter 提供交互式、可点击的聊天组件,供管理员审查。

🎒 物品栏 API

InventorySearcher

一个模块化、高性能的引擎,用于在多个容器中查找物品。

  • 基于条件的搜索:按类型、标签、NBT 或自定义谓词筛选物品。
  • 多槽位解析:处理涉及拆分堆叠或“巨型堆叠”(>64 个物品)的复杂搜索。

🎨 UI 与配置

  • 统一径向菜单:标准化的 GenericRadialMenuScreen,用于一致的选择界面。
  • YACL 配置封装:一种简化的工厂模式,用于使用 Yet Another Config Lib 构建美观、分类的配置界面。
  • 反作弊反馈:HUD 叠加层和浮动通知,在功能受到服务器限制时告知玩家。

依赖项

许可证

CC0-1.0