Settings Reference
All Fresh settings are accessible from the Fresh Menu (Right Shift + F) → Settings tab. Settings are saved per savegame and synced in multiplayer.
Note: This documentation was generated with AI assistance and may contain inaccuracies. If you spot an error, please open an issue.
Global Settings
| Setting | Default | Options | Description |
|---|---|---|---|
| Enable Expiration | On | Off / On | Toggles all aging and expiration. When off, products never age or expire. |
| Show Warnings | On | Off / On | Show expiry warnings in info boxes when looking at storages and vehicles. |
| Show Age Display | On | Off / On | Show color-coded age distribution bars when near storages. |
| Warning Threshold | 24 hours | 6h / 12h / 24h / 48h / 72h | Info box text turns yellow when a product expires within this time. Items with shorter shelf lives may always show as expiring. |
| Storage Class Aging | On | Off / On | When enabled, goods age at different rates depending on storage type (Exposed ages fastest, Frozen slowest). When disabled, all storages age at the same baseline rate. |
With expiration disabled, all aging mechanics are paused. Existing batch ages are preserved and resume aging when re-enabled.
Difficulty Presets
The difficulty preset scales all shelf lives at once. Select a preset from the Settings tab.
| Preset | Multiplier | Effect |
|---|---|---|
| Very Easy | ×4 | All shelf lives quadrupled. Strawberries last 4 months instead of 1. |
| Easy | ×2 | All shelf lives doubled. Forgiving pace for learning the mechanic. |
| Normal | ×1 | Default values from the Shelf Life Table. Research-based realism. |
| Hard | ×0.5 | All shelf lives halved. Demanding logistics for experienced players. |
| Custom | varies | Unlocks individual per-product controls. No global multiplier applied. |
Tip: To adjust a single product's shelf life, select the Custom preset. This unlocks the Expiration sub-tab for individual editing. Note that switching to Custom resets all values to Normal defaults — your current preset multiplier is not preserved.
How Presets Interact with Custom Settings
- Selecting a preset (Very Easy through Hard) applies that multiplier to all products. The Expiration and Benefit Limit tabs hide preset-controlled products and show a message: "All products are managed by the selected preset. Switch to Custom to edit individually."
- Selecting Custom reveals all products in the Expiration tab for individual editing. All products start at their Normal-difficulty (×1) defaults — if you were on Easy (×2) or Very Easy (×4), that multiplier is not preserved. You'll need to manually adjust any products you want to differ from the Normal baseline.
- Switching from Custom back to a preset discards any per-product changes and applies the preset multiplier to the mod defaults.
Expiration Settings (Per Product)
Requires Custom difficulty. When a preset is active, preset-controlled products are hidden. Switch the difficulty to Custom to reveal all products for individual editing. See Difficulty Presets above.
Located in the Settings tab → Expiration sub-tab.
Each perishable product has a configurable shelf life:
| Option | Meaning |
|---|---|
| Do not expire | Product never expires (removed from tracking) |
| 1 month - 5 years | Time before expiration in Sheltered storage |
Available values: 1, 2, 3, 4, 5, 6, 9 months, 1 year, 1.5 years, 2 years, 3 years, or 5 years.
Products are listed alphabetically. Each product shows a tooltip with its source (basegame, DLC name, or mod name).
Benefit Limit Settings (Per Product)
Located in the Settings tab → Benefit Limit sub-tab. Controls the maximum storage class that benefits each product.
| Option | Meaning |
|---|---|
| Sheltered | No benefit from Indoor, Cooled, or Frozen storage |
| Indoor | No benefit from Cooled or Frozen storage |
| Cooled | No benefit from Frozen storage |
| Frozen | Benefits from all storage classes |
See the Storage Classes Guide for how this interacts with storage type.
Storage Class Settings
Located in the Settings tab → Storage sub-tab. Override the automatically detected storage class for specific storages.
Each tracked storage shows:
- Its name and location
- The detected (automatic) storage class
- An override dropdown to change the class
Vehicles appear in the list as soon as they are on the map, even when empty. This lets you configure storage class overrides before loading any goods.
A special Loose Items entry covers all bales, pallets, and big bags not placed in a dedicated storage. Overriding this entry applies to all loose items at once.
Use this when automatic detection doesn't match your setup - for example, if a mod building provides refrigerated storage but Fresh detects it as Indoor.
Reset to Defaults
A Reset to Defaults button at the bottom of the Settings tab restores all settings to the mod's original values:
- Difficulty returns to Normal
- All per-product shelf lives return to mod defaults
- All max benefit classes return to mod defaults
- All storage class overrides are cleared
- Global settings (warnings, age display, threshold) return to defaults
A confirmation dialog appears before the reset takes effect. This action cannot be undone.
Settings Dependencies
Some settings depend on others:
Enable Expiration → All other settings (only when Expiration is On)
Difficulty Preset → Expiration tab product list (hidden when preset controls them)
Storage Class Aging → Benefit Limit tab + Storage tab (visible only when On)
→ Shelf Life tab display (per-class table when On, simple list when Off)
Dependent settings are greyed out or hidden when their parent setting is disabled.