FarmLedger

FarmLedger

DONUT SMP

Measure your farm’s output and estimate whether an upgrade is worth its cost.

FarmLedger is a client-side Fabric mod that tracks item collection, estimates in-game profits, and compares farming sessions. Choose an item, enter your prices, and start collecting.

Features

• Live tracking HUD: View collected items, items per hour, estimated profit per hour, and goal ETA.
• Named farm profiles: Save different items, prices, costs, and goals for your farms.
• Two measurement modes: Track ground pickups or positive inventory changes.
• Precise item matching: Distinguish items by their components, including different potion types.
• Production goals: Set targets in individual items or shulker equivalents.
• Session history: Review previous runs with their original prices and settings preserved.
• Upgrade comparisons: Compare collection rates and estimate how long an upgrade could take to repay its cost.
• HTML and CSV exports: Save readable reports or analyze your results in a spreadsheet.
• Local storage: Profiles and sessions stay in your game folder. No account or API key is needed.

Getting Started

1. Hold the output item you want to track.
2. Press J and select New.
3. Enter a farm name, selling price per item, and input cost per output item.
4. Choose your measurement mode and an optional production goal.
5. Save the profile and click Start session.
6. Collect output, then select Stop + save to record your results.

For example, if ingredients for three potions cost 9,000 total, enter 3,000 as the input cost per potion.

Controls

Key	Action
J	Open the dashboard
F7	Pause or resume tracking
F8	Toggle the HUD

Keys can be changed in Minecraft’s controls menu. You can also open the dashboard with /farmledger.

Understanding Your Results

Ground pickups counts matching items collected from the ground by your player.

Inventory gains counts increases in matching inventory items, including chest withdrawals, trades, and gifts.

FarmLedger measures observed collection. It cannot inspect unopened chests or items stored inside shulker boxes. Dropping or depositing items and collecting them again can count them again. Use consistent collection methods when comparing sessions.

All currency figures are estimates in your server’s fictional currency, based on manually entered prices—not confirmed sales or real-money earnings.

Upgrade comparisons require two matching sessions with at least 60 active seconds each. They use the later session’s unit prices for both runs and exclude changes in fixed hourly overhead.

Requirements

• Minecraft Java 26.2
• Fabric Loader 0.19.3 or newer
• Fabric API 0.158.0+26.2, or a newer release specifically for 26.2
• Java 25 or newer

Install FarmLedger and Fabric API in your client’s mods folder. No server installation is required.

Release Status and Credits

This initial build compiles against Minecraft 26.2 and passed 46 automated checks. Full in-game validation is still pending.

The code and documentation were primarily generated using OpenAI Codex under the creator’s direction. The project logo is AI-generated artwork.

Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.