Skip to content

Troubleshooting

Jump to bottom
TisonK edited this page Apr 4, 2026 · 5 revisions

Troubleshooting

First step: check the log

All mod output is tagged [Soil Fertilizer] in log.txt:

  • Windows: Documents\My Games\FarmingSimulator2025\log.txt
  • Mac: ~/Library/Application Support/FarmingSimulator2025/log.txt

Search for [Soil Fertilizer] and look for ERROR or WARNING lines. You can also enable verbose output with the SoilDebug console command.

Common problems

HUD does not appear

  1. Press J to toggle — it may simply be hidden
  2. Check that Show HUD is enabled in Settings (ESC → Settings → Soil & Fertilizer)
  3. If you are a client in multiplayer, wait a few seconds after joining — the full sync may still be in progress
  4. Check log.txt for any HUD or SoilHUD error lines

Settings panel shows raw key names (e.g. sf_diff_1 instead of "Simple")

This is a translation resolution issue. Make sure you are running version 1.3.2.0 or later — this was fixed in that release.

Soil report (K key) does not open

  1. You must be on foot — the K binding is registered in the PLAYER input context
  2. If you recently got out of a vehicle, wait 1–2 seconds for the input context to switch
  3. Check log.txt for any SoilReportDialog errors

No field data in HUD — "no field detected"

  • You may be standing between fields or in a road/forest area not covered by any field polygon
  • Move toward the center of the field and wait a moment for the field scan
  • On large maps the field scan runs in the background — data may not be available for the first 10–30 seconds after load

Nutrients not depleting at harvest

  1. Check that Fertility System is enabled in Settings
  2. Check that Nutrient Cycles is enabled
  3. Check log.txt for [Soil Fertilizer] Harvest: lines — if none appear, the harvest hook may not be firing
  4. Run SoilDebug in console and harvest again to see verbose output

Nutrients not restoring when fertilizing

  1. Check that the fill type you are using is recognized (see Fertilizer Types)
  2. Custom fill types from equipment mods may not be in the profile table — check log.txt for unknown fill type warnings
  3. Check SoilFieldInfo <fieldId> before and after to confirm the values changed

Multiplayer: client settings do not match server

  1. Disconnect and reconnect — the full sync runs on join with up to 3 retry attempts
  2. On the server, run SoilShowSettings and compare with the client's soilStatus output
  3. If there is a persistent mismatch, open an issue with both log files

Dedicated server: mod not initializing

  1. Confirm the mod zip is in the server's mods folder
  2. Check the server log for [Soil Fertilizer] Initializing... — if absent, the mod did not load
  3. The GUI is intentionally disabled on dedicated servers — GUI initialization skipped in the log is normal
  4. Run soilStatus from the server console to confirm the mod is running

Soil data not saving

The mod hooks FSCareerMissionInfo:saveToXMLFile to write soilData.xml. If saving fails:

  1. Check log.txt for soil data NOT saved or save hook warnings
  2. Confirm the savegame directory is writable
  3. In multiplayer, only the server saves soil data — clients do not write soilData.xml

Reporting a bug

Please open an issue at GitHub Issues and include:

  • Your log.txt (filtered for [Soil Fertilizer] lines)
  • Mod version (visible in Mod Manager)
  • Singleplayer or multiplayer
  • Steps to reproduce

Clone this wiki locally