State Ledger

In the dairy year

A year of soil maps, milk clocks, and wage books is a lot of files. A crash mid-save should not orphan one chapter and keep another. The ledger writes the suite’s shared state as one atomic pass.

Winter only matters if spring is still there when you reload.

The feel

Companions register a slice of state. The host writes one master file. A late joiner still gets its data. A pure multiplayer client has no save folder, so the host is the truth.

If the ledger is absent, companions keep their own XML. The farm still loads. You just lose the single-write belt.

The Farm Tablet keeps its own save on purpose. It is a desk, not a migrant into the ledger.

How it works

This is mod 1 in the load order. Without it, each companion writes its own file in the same save window. A crash or force-quit mid-window can corrupt the later files and lose a year. The ledger batches everything into one write and one load.

The file is <savegame>/RealisticFarming_MasterState.xml. One <module> block per registered companion. The host writes it inside the career save hook. A root save version sits on the file. Each companion keeps its own schema version inside its block.

A companion may register more than one module (a roster and a hire hall, for example) so a bad write in one cannot corrupt the other. Registration works before or after the master file is parsed. Each module is delivered its data exactly once.

If one companion’s save callback errors, that block is omitted and every other companion still saves.

Per-player local settings (HUD position, transparency, font size) must not go through the ledger. They would overwrite every player’s prefs with the last writer. Those stay in each mod’s own local file, or in Settings Hub’s local file.

There are no settings. Install it and leave it loaded.

Console: slStatus lists registered modules and their load state.

How you use it

• Put it in the mods folder on the host.
• You will not configure a story here. You will notice the year surviving a bad exit.

The outs

Settings, weather, labour, dairy, and other companions can hand persistence over when they are ready. Until they do, own-XML still works.

What you need

Optional bedrock. Recommended on any long dairy save, especially multiplayer. Not a master pack.