https://github.com/thecodingdad-tisonk/fs25_soilfertilizer
Realistic soil nutrient management for Farming Simulator 25. Track N/P/K, pH, and organic matter per field — with crop-specific depletion, fertilizer replenishment, weather effects, and seasonal cycles.
https://github.com/thecodingdad-tisonk/fs25_soilfertilizer
agriculture farming-simulator farming-simulator-25 fertilizer fs25 fs25-mod game-mod giants-engine lua modding nutrients simulation soil
Last synced: about 1 hour ago
JSON representation
Realistic soil nutrient management for Farming Simulator 25. Track N/P/K, pH, and organic matter per field — with crop-specific depletion, fertilizer replenishment, weather effects, and seasonal cycles.
- Host: GitHub
- URL: https://github.com/thecodingdad-tisonk/fs25_soilfertilizer
- Owner: TheCodingDad-TisonK
- License: other
- Created: 2026-02-01T00:47:29.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-03T02:49:19.000Z (9 days ago)
- Last Synced: 2026-04-03T03:20:58.468Z (9 days ago)
- Topics: agriculture, farming-simulator, farming-simulator-25, fertilizer, fs25, fs25-mod, game-mod, giants-engine, lua, modding, nutrients, simulation, soil
- Language: Lua
- Homepage: https://discord.gg/8FcgxwJ3dM
- Size: 37.5 MB
- Stars: 34
- Watchers: 5
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌾 FS25 Soil & Fertilizer
### *Realistic Nutrient Management*
[](https://github.com/TheCodingDad-TisonK/FS25_SoilFertilizer/releases)
[](https://github.com/TheCodingDad-TisonK/FS25_SoilFertilizer/releases/latest)
[](https://creativecommons.org/licenses/by-nc-nd/4.0/)
> *"Applied liquid fertilizer three seasons straight because the yield looked fine. Then I checked the pH — it was sitting at 5.4. The nutrients I'd been pouring in couldn't even be absorbed. One application of lime later and the next harvest told the whole story."*
**In base FS25, every field is born equal and stays that way forever. This mod remembers.**
Each field builds its own history. Nitrogen drops after a heavy wheat crop. Rain washes potassium out of sandy ground. Fallow fields slowly breathe back to life. The numbers you see in the HUD aren't arbitrary — they're the consequence of every harvest, every storm, and every bag of fertilizer you did or didn't apply.
`Singleplayer` • `Multiplayer (server-authoritative)` • `Persistent saves` • `26 languages`
> [!TIP]
> Want to be part of our community? Share tips, report issues, and chat with other farmers on the **[FS25 Modding Community Discord](https://discord.gg/Th2pnq36)**!
---
## ✨ Features
### 🧪 Per-Field Soil Chemistry
Five values tracked independently for every field on the map:
| | Nutrient | Role | Depleted By |
|---|---|---|---|
| 🟢 | **Nitrogen (N)** | Growth and leaf mass | Harvest, rain leaching, fall season |
| 🔵 | **Phosphorus (P)** | Root development and energy | Harvest |
| 🟡 | **Potassium (K)** | Water regulation and yield quality | Harvest, rain leaching |
| 🟤 | **Organic Matter (OM)** | Soil structure and nutrient buffering | Builds slowly via manure and plowing |
| ⚗️ | **pH** | Unlocks nutrient availability | Rain acidification — raised by lime and plowing |
All five values persist in your save. A field that's been growing canola for three seasons without lime will feel different from one you've been managing carefully.
### 🌾 Crop-Specific Extraction
Different crops take different amounts from your soil. Push the same field too hard and it shows.
| Crop | N drain | P drain | K drain | Notes |
|---|---|---|---|---|
| 🥔 Potato | ●●●●● | ●●●● | ●●●●● | Extreme K demand — must rotate |
| 🟣 Sugar Beet | ●●●●○ | ●●●○○ | ●●●●● | Heaviest K of any crop |
| 🌻 Sunflower | ●●●●○ | ●●●○○ | ●●●●○ | Moderate-high all round |
| 🌼 Canola | ●●●●○ | ●●●○○ | ●●●●○ | High N demand, oilseed crop |
| 🫘 Soybean | ●●●●● | ●●●○○ | ●●●○○ | Highest N — partial fixation assumed |
| 🌽 Maize | ●●●●○ | ●●●○○ | ●●●●○ | Large biomass, needs N and K |
| 🌾 Wheat | ●●●○○ | ●●○○○ | ●●●○○ | Moderate — manageable with rotation |
| 🌾 Barley / Oats / Rye | ●●●○○ | ●●○○○ | ●●●○○ | Light feeders, good rotation crops |
| 🫛 Peas / Beans | ●●●●○ | ●●●○○ | ●●●●○ | Legumes — still need balanced soil |
### 🐛 Field Health System
Three pressure scores (0–100) track threats to each field independently. Left unchecked they reduce your yield at harvest. Treat them with the right product and the pressure drops within a few days.
| Pressure | Source | Treatment | Resets naturally | Max penalty |
|----------|--------|-----------|-----------------|-------------|
| 🌿 **Weed** | Grows daily — peaks without tillage | `HERBICIDE` spray | Any tillage / plowing | −30% |
| 🐞 **Pest** | Insects — peaks in summer | `INSECTICIDE` spray | Harvest disperses population | −20% |
| 🍄 **Disease** | Fungal — driven by rain | `FUNGICIDE` spray | 3+ dry days cause natural decay | −25% |
All three are visible in the HUD and the full Soil Report. Each can be toggled off in settings.
### 💊 Fertilizer Types
Six nutrient products, each with a different job:
| Fertilizer | N | P | K | Organic Matter | Notes |
|---|---|---|---|---|---|
| **Liquid Fertilizer** | ●●●○○ | ●●○○○ | ●●●○○ | — | Fast-acting, balanced NPK |
| **Solid Fertilizer** | ●●●●○ | ●●●○○ | ●●●○○ | — | Higher N/P, granular |
| **Manure** | ●●○○○ | ●●○○○ | ●●●○○ | ✓ builds | Slow-release, builds OM over time |
| **Slurry** | ●●●○○ | ●●○○○ | ●●●●○ | ✓ builds | Liquid organic, strong K |
| **Digestate** | ●●●○○ | ●●○○○ | ●●●●○ | ✓ builds | Biogas byproduct, well-rounded |
| **Lime** | — | — | — | — | Only raises pH — but nothing else works properly without it |
> [!NOTE]
> Organic matter builds slowly with manure, slurry, and digestate — it takes many seasons to accumulate meaningfully. Soil with high OM buffers pH swings and slows nutrient loss from rain.
### 🌦️ Environmental Effects
The mod isn't just about what you put in — it's about what the world takes out.
| Effect | What happens |
|---|---|
| 🌧️ **Rain leaching** | Nitrogen and potassium wash out during heavy rain. Phosphorus binds tightly and barely moves. |
| 🍂 **Fall nitrogen loss** | Biological activity slows in autumn, pulling N levels down naturally. |
| 🌱 **Spring nitrogen boost** | Microbial activity picks back up in spring, recovering a small amount of N. |
| 🌧️ **pH acidification** | Rain is slightly acidic. Ignore liming long enough and your soil will show it. |
| 🌾 **Fallow recovery** | Fields left unplanted for 7+ days slowly recover nutrients on their own. |
| 🚜 **Plowing bonus** | Aerates soil, nudging pH toward neutral and boosting organic matter mixing. |
### 📊 Soil HUD
A compact overlay shows the current field's soil status while you're working. Colour-coded indicators make problems visible at a glance:
🟢 **Green** — healthy, no action needed | 🟡 **Amber** — getting low, plan ahead | 🔴 **Red** — depleted, yield is being affected
Fully customisable: 5 positions, 4 colour themes, 5 transparency levels, 3 font sizes, and a compact mode that shrinks to one line per nutrient.
### 📋 Full Farm Soil Report
Press **`K`** to open a full farm overview sorted by urgency — the fields that need the most attention appear at the top. Each row shows N/P/K, pH, OM, weed and pest pressure, and an overall status badge. Click **►** on any row to open a field detail view with a complete breakdown, yield forecast, and specific treatment recommendations.
---
## ⚙️ Settings
Open via **ESC → Settings → Game Settings → Soil & Fertilizer**.
| Setting | Options | What it does |
|---|---|---|
| **Enable mod** | On / Off | Stops all simulation when off |
| **Fertility system** | On / Off | Toggles the entire nutrient and pH simulation |
| **Nutrient cycles** | On / Off | Enables crop depletion and natural recovery |
| **Fertilizer costs** | On / Off | Adds running costs to fertilizer application |
| **Notifications** | On / Off | Pop-up alerts when fields get critically low |
| **Seasonal effects** | On / Off | Spring boost and fall nitrogen loss |
| **Rain effects** | On / Off | Leaching and pH acidification from rain |
| **Plowing bonus** | On / Off | Whether plowing improves OM and pH |
| **Weed pressure** | On / Off | Track weed competition per field — apply herbicide to reduce |
| **Pest pressure** | On / Off | Track insect pest populations per field — apply insecticide to reduce |
| **Disease pressure** | On / Off | Track crop disease per field — apply fungicide to reduce |
| **Difficulty** | Simple / Realistic / Hardcore | Scales depletion rate — 0.7× / 1× / 1.5× |
| **HUD enabled** | On / Off | Show or hide the soil overlay |
| **HUD position** | 5 presets | Top-right, top-left, bottom-right, bottom-left, centre-right |
| **HUD colour theme** | 4 themes | Green / Blue / Amber / Mono |
| **HUD transparency** | Clear → Solid | 5 levels from 25% to 100% opacity |
| **HUD font size** | Small / Medium / Large | Scales all HUD text |
| **Compact mode** | On / Off | One line per nutrient instead of full bars |
> [!NOTE]
> In multiplayer, settings are **server-authoritative** — the host's settings are pushed to all clients on join. Clients cannot override locked settings.
---
## 🖥️ Console Commands
Open the developer console with **`~`** and type `soilfertility` for the full list.
| Command | Arguments | Description |
|---|---|---|
| `SoilEnable` / `SoilDisable` | — | Toggle the mod on or off |
| `SoilSetDifficulty` | `1` `2` `3` | Simple / Realistic / Hardcore |
| `SoilSetFertility` | `true` / `false` | Toggle fertility simulation |
| `SoilSetNutrients` | `true` / `false` | Toggle nutrient cycles |
| `SoilSetFertilizerCosts` | `true` / `false` | Toggle fertilizer costs |
| `SoilSetNotifications` | `true` / `false` | Toggle alert popups |
| `SoilSetSeasonalEffects` | `true` / `false` | Toggle seasonal N changes |
| `SoilSetRainEffects` | `true` / `false` | Toggle rain leaching and acidification |
| `SoilSetPlowingBonus` | `true` / `false` | Toggle plowing OM/pH bonus |
| `SoilFieldInfo` | `` | Detailed soil readout for one field |
| `SoilFieldForecast` | `` | Yield forecast and treatment recommendations for one field |
| `SoilListFields` | — | List all tracked fields with current soil values |
| `SoilShowSettings` | — | Print current settings to log |
| `SoilResetSettings` | — | Reset everything to defaults |
| `SoilSaveData` | — | Force-save soil state now |
| `SoilDebug` | — | Toggle verbose debug logging |
---
## 🔌 Mod Integrations
All integrations are detected automatically at runtime and fail gracefully if the mod isn't installed.
| Mod | Behaviour |
|---|---|
| **Precision Farming DLC** | Compatible — both mods run independently. No conflicts. |
| **FS25_SeasonalCropStress** | Soil pH and organic matter influence evapotranspiration rates per field. |
| **FS25_NPCFavor** | NPC neighbour favour quests can reference your fields' soil state. |
---
## 🛠️ Installation
**1. Download** `FS25_SoilFertilizer.zip` from the [latest release](https://github.com/TheCodingDad-TisonK/FS25_SoilFertilizer/releases/latest).
**2. Copy** the ZIP (do not extract) to your mods folder:
| Platform | Path |
|---|---|
| 🪟 Windows | `%USERPROFILE%\Documents\My Games\FarmingSimulator2025\mods\` |
| 🍎 macOS | `~/Library/Application Support/FarmingSimulator2025/mods/` |
**3. Enable** *Realistic Soil & Fertilizer* in the in-game mod manager.
**4. Load** any career save — soil data initialises automatically on first load.
---
## 🎮 Quick Start
```
1. Load your farm — the soil HUD appears in the top-right corner
2. Drive to any field — nutrient values update as you move
3. Amber or red values → that field needs fertilizer or lime
4. Apply lime first — it unlocks the full value of everything else
5. Apply fertilizer → watch N/P/K climb in real time
6. Press K → open the full farm soil report sorted by urgency
7. Let a field go fallow for a season → it slowly recovers on its own
8. At harvest → healthy soil means the full yield you worked for
```
> [!TIP]
> Fields start slightly acidic and with moderate nutrients — matching the base game's starting state. Lime first, then fertilize. Nutrients in acidic soil have reduced availability no matter how much product you apply.
---
## ⚠️ Known Limitations
| Issue | Details |
|---|---|
| 🌱 **Base game lime indicator** | The base game's "needs liming" flag is a separate system from our pH tracking. Both update when you apply lime through the sprayer, but the indicators can show different states until the field is treated. Workaround: disable the base game's liming requirement in **Settings → Farming → Liming** to rely solely on our HUD. |
| 🌐 **Multiplayer** | Soil simulation runs on the server only. Clients receive synced state on join and after each harvest or fertiliser event. |
| 🔬 **Precision Farming** | Compatible — both mods track nutrients independently. No conflicts. |
---
## 🤝 Contributing
Found a bug? [Open an issue](https://github.com/TheCodingDad-TisonK/FS25_SoilFertilizer/issues/new/choose) — the template will walk you through what to include.
Want to contribute code? PRs are welcome on the `development` branch. See `CLAUDE.md` in the repo root for architecture notes and naming conventions.
---
## 📝 License
This mod is licensed under **[CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/)**.
You may share it in its original form with attribution. You may not sell it, modify and redistribute it, or reupload it under a different name or authorship. Contributions via pull request are explicitly permitted and encouraged.
**Author:** TisonK · **Version:** 1.5.2.0
© 2026 TisonK — See [LICENSE](LICENSE) for full terms.
---
*Farming Simulator 25 is published by GIANTS Software. This is an independent fan creation, not affiliated with or endorsed by GIANTS Software.*
*Your soil remembers everything.* 🌱