PlayerAPI

A client-side Fabric library that exposes a clean, high-level API for player interaction, world querying, and human-like automation. Designed to be a shared foundation so other mods don't have to reimplement the same low-level mixins.

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

For Players

PlayerAPI does nothing on its own. If you downloaded this, another mod you use requires it as a dependency. Simply place the .jar in your mods folder alongside that mod.

Minecraft Version Support

This library targets one Minecraft version at a time. When it updates to a new Minecraft version, previous versions receive zero further support — no backports, no bug fixes, and a release is never published with support for multiple Minecraft versions at once. Use the PlayerAPI build that matches your Minecraft version and the mods that depend on it.

For Developers

The full design & API reference is maintained in PLAYERAPI_DOCS.md. PlayerAPI is a pure client-side library — it contains zero bot logic, just the building blocks other mods build on. The API surface:

• Forced actions — MovementActions, LookActions, InventoryActions, InteractionActions, ChatActions, SoundActions, DisplayActions.
• Rendering / ESP — EntityHighlightActions (LOS entity fill), BlockHighlightActions, BoxActions (through-wall world boxes), LineActions (through-wall guide lines).
• Read-only info — PlayerInfo, InventoryInfo, WorldInfo, TabListInfo (incl. indexed strAt/regexAt), ScoreboardInfo (sidebar).
• Human layer — HumanActions, HumanProfile for human-like input timing.
• Events (PlayerAPIEvents), Scheduler, and the shared HUD-editor framework (com.playerapi.hud — HudElement / HudTransform / HudManager / HudEditorScreen).
• Data types — immutable records ItemSnapshot (incl. stable skyblockId()), EntitySnapshot, BlockSnapshot, EffectSnapshot.
• UpdateChecker — shared GitHub-release checker (Minecraft-version aware).

Depend on it via mavenLocal() — see PLAYERAPI_DOCS.md for the coordinate, threading model, per-class reference, and version history.