Trail Reserve Ledger

Trail Reserve Ledger helps Minecraft explorers keep supply reserves and review their trips.

For Minecraft Java 26.3 with Fabric Loader 0.20.1 and Fabric API 0.165.0+26.3. Client-only; no server installation of this mod is required. Java 25 or newer is required; the tested runtime is Microsoft OpenJDK 25.0.4.1+1-LTS.

HOW TO USE
Press K (rebindable in Controls). In Packing, name a preset, enter item registry IDs and reserve quantities, select Stage, then Save next preset. In Trips, name and start a trip. Counts shows departure, current/last-observed counts and net changes. Alerts provides cooldown, hysteresis and mute controls. End a trip to review its local debrief, then explicitly revise the next packing preset.

WHAT IS COUNTED
Only the 36 main inventory/hotbar slots and offhand. Armor, cursor contents, nested containers, backpacks and remote inventories are excluded. Item totals are grouped by registry ID. Net inventory decreases are not proven consumption: crafting, drops and transfers also change counts. Nothing is moved, consumed or crafted automatically.

LOCAL AND CLIENT-ONLY
Trip data is saved as bounded, schema-versioned local JSON with atomic replacement and a previous-good backup. Worlds/servers and players have separate hashed contexts. There is no telemetry, AI runtime, external service, custom networking packet, remote synchronization or advertising component. Dimensions share a ledger but conservatively pause on player replacement. Reconnect and respawn require explicit resume. If a save fails during a world switch, tracking stays paused and read-only; the K key still opens the ledger and Help provides Retry save. The previous world’s unsaved data must be saved before the new context starts.

0.1.1 VALIDATION
53 unit tests passed with no failures, errors or skips. Four live Minecraft client GameTest scenarios passed on Microsoft OpenJDK 25.0.4.1+1-LTS: actual controls/inventory/reserve alerts; death, respawn, dimension replacement, corruption recovery and world isolation; failed-save world switching and reachable recovery controls; and a separate unmodified vanilla-server connection/reconnect. Counts refresh and actual delivered reserve warnings were observed. Real keyboard navigation, narration text and the minimum 320 x 240 widget layout were tested. Audible narration and a human accessibility audit were not performed.

This 0.1.1 release is supported by the accompanying bounded test evidence. It is not a claim of universal production readiness or compatibility. Five-tick sampling can miss short changes. Arbitrary modpacks, internet proxies/anti-cheat, long sessions, every GUI scale/display and real power-loss durability are not established. Different worlds behind one server address cannot be distinguished without server cooperation. English is the supplied language. Keep backups of important local data.

PROVENANCE AND LICENSE
Substantial OpenAI Codex assistance was used for code, tests and documentation. There is no AI runtime. Original branding/code/UI are used; no competitor assets or Minecraft binaries are bundled. The scoped license permits the designated 0.1.1 binary through the author’s official CurseForge project and personal installation/use/backups. It does not grant general redistribution, modpack redistribution or a public source license. See the included LICENSE.txt.

Primarily AI-generated content is currently ineligible for public Modrinth publication. No platform approval, monetization eligibility or revenue is promised.