NoNameMod’s PlayerAPI

PlayerAPI

一个客户端 Fabric 前置库，提供简洁的高级 API，用于玩家交互、世界查询和类人自动化。它旨在作为共享基础，让其他模组无需重复实现相同的底层 mixin。

GitHub： https://github.com/noname-mods/PlayerAPI

玩家须知

PlayerAPI 本身不会执行任何操作。如果你下载了它，说明你使用的另一个模组需要将它作为依赖项。只需将 .jar 放入 mods 文件夹，与该模组放在一起即可。

Minecraft 版本支持

此前置库一次只支持一个 Minecraft 版本。更新到新的 Minecraft 版本后，旧版本将不再获得任何支持——不会移植回旧版本，不会修复错误，也不会发布同时支持多个 Minecraft 版本的版本。请使用与你的 Minecraft 版本及依赖它的模组相匹配的 PlayerAPI 构建版本。

开发者须知

完整的设计与 API 参考文档维护在 PLAYERAPI_DOCS.md 中。PlayerAPI 是纯客户端前置库——其中完全不包含机器人逻辑，只提供其他模组构建功能所需的基础组件。API 包含：

• 强制操作 — MovementActions、LookActions、InventoryActions、InteractionActions、ChatActions、SoundActions、DisplayActions。
• 渲染 / ESP — EntityHighlightActions（视线范围内实体填充）、BlockHighlightActions、BoxActions（隔墙显示的世界空间方框）、LineActions（隔墙显示的引导线）。
• 只读信息 — PlayerInfo、InventoryInfo、WorldInfo、TabListInfo（包括带索引的 strAt/regexAt）、ScoreboardInfo（侧边栏）。
• 拟人化层 — HumanActions、HumanProfile，用于模拟类人输入时序。
• 事件（PlayerAPIEvents）、Scheduler，以及共享的 HUD 编辑器框架（com.playerapi.hud — HudElement / HudTransform / HudManager / HudEditorScreen）。
• 数据类型 — 不可变记录 ItemSnapshot（包括稳定的 skyblockId()）、EntitySnapshot、BlockSnapshot、EffectSnapshot。
• UpdateChecker — 共享的 GitHub 发布版本检查器（可识别 Minecraft 版本）。

添加依赖：通过 mavenLocal() 添加——坐标、线程模型、各类参考和版本历史请参阅 PLAYERAPI_DOCS.md。