BuildBudget

BuildBudget

Plan survival builds without a schematic. Create named projects, add materials and counts, and see what remains to gather.

Features

• Search items by name or ID; enter whole counts or stacks such as 32s.
• Track live main inventory, hotbar and offhand availability, or enter manual totals.
• Record consumed resources and see remaining requirements and deficits.
• Pin deficits in a configurable HUD: four corners and one to ten rows.
• Choose recipes and ingredient alternatives; inspect acquisition estimates, cooking fuel, surplus, reusable seeds and returned items.
• Opt into historical observations of already-open vanilla singleplayer storage, separate from budget progress.
• Share requirements through clipboard JSON, explicit item-ID CSV import or compact text. Imports reset progress.
• Local saves with backups and read-only recovery protection. Common English and Ukrainian UI.

Installation

Version 0.2.0 beta has separate jars for these exact Minecraft releases:

Install only the jar matching your exact Minecraft release and loader in your profile's mods folder. Fabric builds require matching Fabric API; Forge builds do not. Client-side only; no server installation required.

Press B in a world to open Projects. Rebind under Options > Controls > Key Binds > BuildBudget. Create a project, add materials and choose Inventory or Manual progress.

What progress means

Progress represents currently available resources. Record consumed resources only after they leave your inventory; manual availability must also exclude consumed resources. Projects compare independently against the same inventory and do not reserve items.

Armor, nested shulker/bundle contents, crafting slots, cursor stacks and storage observations do not count toward progress. Ingredient estimates do not subtract raw inputs already carried. Alternatives need explicit choices; unsupported, dynamic or component-sensitive recipes remain terminal. Unavailable fuel timing is labeled unknown. Recipe types follow the Minecraft release. This is an estimate, not an automatic crafting tool or native schematic importer.

Storage recording is off by default and restricted to already-open supported vanilla singleplayer containers. Snapshots have timestamps and become stale; remote menus and unopened containers remain unknown.

Saves and beta status

Projects live in config/buildbudget/projects.json, with a previous-save .bak. Malformed or future-format saves are preserved and open read-only. Back up config/buildbudget before moving between profiles; item identifiers differ across Minecraft versions.

Unit/contract tests and isolated native game-client checks passed for all five targets. Authenticated multiplayer, large modpacks and separate-launcher installed-jar checks remain unverified.

License: All Rights Reserved.