Time Guard

In the dairy year

Wages hit every day. Milk contracts settle on a clock. Tax waits for the year. Fuel prices move with the calendar. If every mod invents its own “day”, the books lie.

Winter at the Cockpit only works if the year had one clock.

The feel

Time Guard reads the in-game calendar and republishes hour, day, month, and year. It normalises days-per-month in one place, so a game month carries the same economic weight on any save. It invites a companion to register a settle callback. Then it steps back.

It never mints money. The owner of the wage, the tax, the milk cheque, or the fuel bill writes the money on the server. That fence is the point.

How it works

It listens to the game’s own calendar events (day, period, hour) and republishes four economic ticks: hour, day, month, year. Companions subscribe to the tick they need.

It also holds an accrue-and-settle scheduler. A companion registers a settlement callback with a flow class (calendar, usage, event, or simulation) and a first-period policy (prorate, full, or skip). The callback runs once, on the host, at the right calendar moment, and survives a save/reload without double-paying.

simulation is for state that must evolve across skipped days with no forfeit. Nothing that writes money may register under it.

A helper scales a per-day rate by days-per-month so a 9-day month and a 24-day month do not silently change the year’s bite. Usage and event flows are not scaled that way.

State Ledger persists the accrual cursors when present. Otherwise it writes RealisticFarming_TimeGuard.xml. Network Sync publishes the calendar context to clients. Settings Hub can hold the enable toggle. Master HUD is not required. The Farm Tablet reads the context directly.

Console: tgStatus shows the clock, who is subscribed, and which accruals are registered.

How you use it

• Install it with the cores on a dedicated host.
• You will not “play” this mod. You will notice when the year stays in time.

The outs

Tax, Income, Fuel, Worker Costs, Dairy, Pro Staff fees, organic transition, and other calendar work subscribe here. If Time Guard is missing they degrade carefully. They must not double-bill.

What you need

Optional bedrock. Strongly recommended for any economy chapter. Not required to open a single companion.