ATS-StockAlert

ATS-StockAlert is a BepInEx mod for Against the Storm that warns you when your stock of a good drops below its in-game global production limit.

What it does

Displays goods that have a production limit set in the Recipes menu, and shows their current/max stock in a compact, movable, hideable HUD in the bottom-right corner.

Stock below production limit that cannot be produced further (after current in-progress productions), are now marked in red.

It can also optionally auto-adjust production limits for all goods you currently have a recipe for, based on the number of people consuming them and an adjustable multiplier.

It can also optionally auto-adjust the Purging Fire production limit in blight posts to the number of existing cysts plus one.

It can also optionally queue a chosen race for a worker slot by Ctrl+clicking a race portrait, so the slot auto-fills the next time it becomes empty and a matching free villager becomes available.

It can also optionally show how much of each insufficient ingredient is currently sitting in non-warehouse buildings in the ingredient selection wheel.

It can also optionally show a persistent alert when you have idle builders, and optionally pause with an alert 3 seconds before a season ends so you can check trade routes.

It can also optionally highlight recipe buildings in the world when they have an enabled recipe for goods that are currently under threshold:

red when the building can help, but has no workers assigned
yellow when the building can help, has at least one worker, but is not fully staffed
normal white vanilla icon when the building is unmanned but none of its recipes are currently under threshold

When a good is marked red because it cannot continue production after current in-progress productions, these building indicators can also extend to gathering/source posts that can provide its missing ingredients.

Integrated Builder Icon mod made by ~DGH into my mod with some changes:

the exclamation marker for builders that are idling
the hammer icon for all other builders

Newly triggered shortages go at the top of the list.

Options for movable, hideable, building indicators, builder status icons, idle builders alert, queued worker assignments, ingredient wheel building stock, season ending trade routes alert, Purging Fire auto-adjust, and production limit multiplier are available in the F8 settings window.

If a good has no production limit, it is ignored by the mod.

Usage

Set a global production limit for a good in the Recipes menu.
When your current stock drops below that limit, the good appears in the Stock Alert HUD.
Press F8 to open the Stock Alert settings window.
Optional: enable auto-adjust in the F8 window to make the mod set eligible global production limits for you.
Optional: enable Purging Fire auto-adjust in the F8 window to make blight posts keep that limit at existing cysts + 1.
Optional: enable building shortage indicators in the F8 window to spot where extra staffing would help with current shortages.
Optional: enable builder status icons in the F8 window to distinguish idle free builders from busy free builders.
Optional: enable queued worker assignments in the F8 window, then Ctrl+click a race portrait to reserve that race for a worker slot until the next vacancy.
Optional: enable ingredient wheel building stock in the F8 window to show how much of each insufficient ingredient is currently sitting in non-warehouse buildings.

Auto-adjust option

off by default
when enabled, the mod checks how many alive villagers can consume a good and sets that good's global production limit to consumers x multiplier
the multiplier is editable in the F8 window from 1.0 to 9.0
values round up to the next whole number
only goods for recipes you currently have available in the settlement are adjusted
disabling the option stops further automatic changes, but does not restore previous manual limits

Purging Fire auto-adjust option

off by default
when enabled, the mod sets the Purging Fire production limit in blight posts to existing cysts + 1
disabling the option stops further automatic changes, but does not restore the previous manual limit

Queued worker assignments

off by default
when enabled, Ctrl+clicking a race portrait queues that race for the worker slot, whether or not a free villager of that race is currently available
the queued race appears to the left of the normal worker slot icon
clicking the queued icon lets you change or clear the queued race
queued workers only auto-fill when the slot becomes empty and a matching free villager becomes available
if multiple slots are waiting for the same race, the oldest queue is filled first
queues last only for the current session

Ingredient wheel building stock

off by default
when enabled, the ingredient wheel shows how much of each insufficient ingredient is currently sitting in non-warehouse buildings
the extra amount appears in parentheses after the normal available/needed value

Requirements

Against the Storm
BepInEx 5
ATS API 3.7.0 or newer

Credits

Builder status icon feature adapted from BuilderIcon source by ~DGH

Build

Update StormPath in StockAlert.csproj to match your game install, then build the project.