Версия Api Bridge 1.2.3 Майнкрафт Мода

Список изменений

v1.2.3 — RLE Depth-Map + Sparse Inventory

viewport_blocks now uses RLE compression — Previously 288 ints (144 flat [depth, blockId] pairs). Now consecutive identical rays are merged into runs: [[count, depth, blockId], ...]. Typical scene: ~40-60% fewer tokens vs. flat format. Empty state returns [].
inventory.slots now sparse — Previously 41 fixed [item_id, count] entries (82 ints + JSON overhead). Now only non-empty slots are included, each as [slot_index, item_id, count]. Empty state returns []. Early-game saving: ~6-15 token vs 165.

viewport_blocks now returns [depth, blockId] pairs — Previously a flat depth-only array (144 ints). Now each of the 144 rays produces two values: depth (1–32 = distance to nearest solid) and the numeric block ID of that surface block (0 if clear). Total 288 ints.
AI can now distinguish stone vs. dirt vs. water at each ray without a separate API call.

Fixed stride in viewport_blocks doc — Index formula corrected from depth * 288 to depth * 144 (each depth layer has 16×9 = 144 cells, not 288).
viewport_entities no longer pads empty slots — Removed 16-slot fixed-size padding. Returns only actual visible entities (0–16 elements).

Registry Dump Endpoints — Two new runtime endpoints for resolving numeric IDs:
- GET /api/registry/entities — Dumps id → "minecraft:name" from BuiltInRegistries.ENTITY_TYPE
- GET /api/registry/items — Dumps id → "minecraft:name" from BuiltInRegistries.ITEM
- AI agents can call these once per session for accurate ID lookup, eliminating hardcoded tables.

world.time clamping — Observation now returns dayTime % 24000 (range 0–24000) as documented, instead of raw tick value. Fixes ObservationProvider.java:143.
viewport_entities FOV filtering — Entities are now filtered by the player's actual field of view (frustum cone). Previously all entities within 48 blocks were included regardless of direction. Fixes ObservationProvider.java:363-371.
Entity ID table in docs — Both OBSERVATION_SCHEMA.md and AI_AGENT_GUIDE.md entity type ID tables updated to match the real Minecraft 1.21.11 registry order (from BuiltInRegistries.ENTITY_TYPE).
API.md doc updates — Added documentation for registry endpoints; updated viewport_entities description to clarify frustum filtering.