Minecraft API

Two live globals plus domain libraries around them.

if player then
    local pos = player:position()
    print(("hp %.1f at %.0f %.0f %.0f"):format(player:health(), pos.x, pos.y, pos.z))
end

for _, e in ipairs(world:entities("minecraft:ender_pearl")) do
    print(e:id(), e:distance())
end

player and world

Both re-resolve on every access, so after a respawn or dimension change the next read already returns the new object. Guard for nil on the title screen:

module:event("tick", function()
    if not player then return end
    if player:health() < 8 then
        hud.notify("Low HP", ("%.1f left"):format(player:health()), "error")
    end
end)

Your player is a normal entity with extras: self-only readers (food, xp_level, attack_cooldown, …) and direct control — set_velocity, jump, set_position, set_rotation, raycast. See entity handle.

Static data (items, translations) lives in game. World coordinates use vec3 everywhere.

Live handles

Handles are thin wrappers. Every colon-call re-reads the game, so a handle from last tick already answers with this tick’s state.

Exception: text components are snapshots — built by text or copied from the game (e:display_name(), item:tooltip()).

Server-synced state