FS25 Visual Mud Tracks – Version 0.31.0.0
PFLANZEN-, WURZEL- UND BODENVERDICHTUNGSSYSTEM

NEU ERFASST
- konkrete Pflanzenart
- Wachstumsstufe
- berechnete Wurzeldichte
- Oberbodenverdichtung 0–100 %
- Verdichtungshärte 0–100 %
- Unterbodenverdichtung 0–100 %
- vorherige Bearbeitungsintensität 0–100 %
- gespeicherte Bewässerungsmenge für die Rainstar-Schnittstelle

EINFLUSS AUF DIE RILLENTIEFE
Lockerer, frisch bearbeiteter Boden erzeugt tiefere Rillen.
Hohe Verdichtungshärte und Unterbodenverdichtung erhöhen die Tragfähigkeit
und reduzieren das weitere Einsinken.
Eine ausgeprägte Wurzelmatte stabilisiert die Oberfläche.
Pflanzenart und Wachstumsstufe bestimmen die Wurzeldichte.

VERDICHTUNG
Jede erfolgreiche Überfahrt erhöht:
- Oberbodenverdichtung
- Verdichtungshärte
- bei hoher Radlast zusätzlich Unterbodenverdichtung

Nasser Boden verdichtet sich stärker.
Eine hohe Wurzeldichte reduziert den Verdichtungszuwachs leicht.

BODENBEARBEITUNG
Pflügen, Grubbern und andere Bodenbearbeitung:
- entfernen weiterhin die sichtbaren Terrainrillen
- setzen die Oberbodenhärte passend zum neuen Bodenzustand zurück
- speichern die Bearbeitungsintensität
- Pflügen reduziert die Unterbodenverdichtung leicht
- Grubbern reduziert die Unterbodenverdichtung nur gering

FELDINFO
Unter der normalen Feldinfo erscheint:
Verdichtungshärte: XX % – locker/mittel/hart

PERSISTENTE DATEIEN
visualMudTracksPersistentTracks.xml
- Spurrillen und Tiefen

visualMudTracksSoilState.xml
- Oberbodenverdichtung
- Verdichtungshärte
- Unterbodenverdichtung
- Bearbeitungsintensität
- letzte Pflanzen-/Wurzeldaten
- Rainstar-Bewässerungsspeicher

RAINSTAR-API
Global verfügbar:
VisualMudTracksSoilAPI

API_VERSION:
VisualMudTracksSoilAPI.API_VERSION

Bodendaten lesen:
local data =
    VisualMudTracksSoilAPI
        .getSoilDataAtWorldPosition(x, z)

Rückgabewerte:
data.cropName
data.cropTitle
data.fruitTypeIndex
data.growthState
data.growthNormalized
data.rootDensity
data.surfaceCompaction
data.compactionHardness
data.subsoilCompaction
data.tillageIntensity
data.irrigationStorageMm
data.wetness
data.rutDepth
data.groundCategory

Einzelwert:
VisualMudTracksSoilAPI
    .getCompactionHardnessAtWorldPosition(x, z)

Bewässerung melden:
local accepted, affectedCells =
    VisualMudTracksSoilAPI
        .addIrrigationAtWorldPosition(
            x,
            z,
            amountMm,
            radiusMeter
        )

Die gemeldete Bewässerungsmenge erhöht die lokale effektive Feuchte und
nimmt mit der Spielzeit wieder ab.

MULTIPLAYER
Der Server berechnet und speichert die Verdichtung.
Härte, Unterbodenverdichtung, Bearbeitungsintensität und Wurzeldichte werden
kompakt zusammen mit den bestehenden Terrainpaketen übertragen.

AUTOR
Sherman


NEU IN VERSION 0.27.0.0
- Rekursive Initialisierung des Bodenfaktors korrigiert.
- Verdichtungshärte wird zuverlässig in der normalen Feldinfo ergänzt.
- Die Feldinfo nutzt die tatsächliche Spielerposition des FieldInfoDisplay.
- Feldinfo wird nach dem Hinzufügen der Zeile sofort neu skaliert.
- Jede Bodenbearbeitungszelle wird sofort serverseitig an alle Clients übertragen.
- Bodenzustände werden auch ohne sichtbare Terrainrille synchronisiert.
- Später beitretende Spieler erhalten alle gespeicherten Boden- und Bearbeitungszellen.
- Der komplette Client-Bodensnapshot wird beim Vollabgleich sauber ersetzt.
- Gemeinsamer Bearbeitungsstatus aller Multiplayer-Spieler bleibt serverautoritativ.


NEU IN VERSION 0.28.0.0
- Verdichtungs-Zielbereiche je Feld- und Kulturzustand.
- Walzen als flächige Rückverfestigung statt pauschaler Schadverdichtung.
- Pflug, Grubber, Scheibenegge, Kreiselegge und Tiefenlockerer unterschiedlich bewertet.
- Tiefenlockerung wirkt nur bei passender Bodenfeuchte vollständig.
- Wiederholtes Pflügen in gleicher Tiefe kann eine Pflugsohle aufbauen.
- Mehrfachüberfahrten mit abnehmendem zusätzlichen Verdichtungszuwachs.
- Schlupf und starke Lenkbewegungen erhöhen Strukturschaden.
- Dauerhafte Wurzelgesundheit von 0 bis 100 Prozent.
- Wirksame Wurzeldichte = natürliche Wurzeldichte × Wurzelgesundheit.
- Mehrfache oder schwere Überfahrten können Wurzeln dauerhaft schädigen.
- Eigenständiger Strukturschaden von 0 bis 100 Prozent.
- Langsame biologische Erholung durch lebende Wurzeln und passende Feuchtigkeit.
- Separate Datei visualMudTracksAdvancedSoil.xml.
- Erweiterte Feldinfo mit Verdichtung, Unterboden, Wurzelgesundheit,
  Bodenstruktur, Zielbereich und bei Bedarf Pflugsohle.
- Feldinfo-Kapazität wird erweitert, wenn andere Mods bereits Zusatzzeilen belegen.
- Erweiterte Rainstar-API für Wurzelgesundheit, Strukturschaden,
  Zielbereich und Arbeitsgerätewirkungen.


NEU IN VERSION 0.29.0.0
- Feldinfo vollständig auf die bewährte PlayerHUDUpdater-Methode umgestellt.
- Verwendet dieselbe Technik wie Realistic Water & Soil Management:
  PlayerHUDUpdater.fieldAddFarmland + Utils.appendedFunction + box:addLine.
- Alte Abhängigkeit von FieldInfoDisplay:addCustomText entfällt für die eigentliche Anzeige.
- Verdichtungshärte wird direkt unter der normalen Feldinfo ergänzt.
- Zusätzlich werden Unterboden, Wurzelgesundheit, Bodenstruktur,
  Zielbereich und bei Bedarf Pflugsohle angezeigt.
- Spielerposition wird wie im Rainstar-Mod über g_localPlayer,
  kontrolliertes Fahrzeug oder Spieler-RootNode ermittelt.
- Die Anzeige funktioniert neben den Feldinfo-Zeilen von
  Realistic Water & Soil Management.


NEU IN VERSION 0.30.0.0
- Serverseitige Fruchtschädigung innerhalb der tatsächlichen Radspur.
- Verwendet die native Fahrzeugfunktion destroyFruitArea.
- Erste Wachstumsstufe ist besonders empfindlich.
- Zweite Wachstumsstufe besitzt erhöhte Empfindlichkeit.
- Spätere Wachstumsstufen reagieren mit normaler Empfindlichkeit.
- Gras, Klee und Luzerne besitzen eine höhere Überfahrtsresistenz.
- Hackfrüchte und Gemüse reagieren empfindlicher.
- Pflanzenschaden abhängig von Radlast, Bodenfeuchte, Schlupf,
  Kurvenfahrt, Mehrfachüberfahrten, Wurzelgesundheit und Strukturschaden.
- Leichte erste Überfahrt auf trockenem Boden beschädigt überwiegend die
  Wurzeln und erzeugt nicht sofort eine vollständig leere Fahrspur.
- Mittlerer Schaden dünnt den Bestand zellenweise aus.
- Schwerer Schaden entfernt die Pflanze vollständig in der Reifenfläche.
- Pflanzen werden nicht auf Wachstumsstufe 0 zurückgesetzt und wachsen daher
  nicht automatisch als unbeschädigter Bestand erneut auf.
- Multiplayer bleibt serverautoritär; die normale FS25-Fruchtkarte überträgt
  die sichtbare Zerstörung.
- Neuer API-Wert cropDamage und Funktion
  getCropDamageAtWorldPosition(x, z).


NEU IN VERSION 0.31.0.0
- Vollständige Vorprüfung vor jeder erweiterten Fruchtschädigung.
- Option „Spiel-Einstellung übernehmen“ beachtet die globale LS25-Fruchtzerstörung.
- Option „Erweiterte Visual-Mud-Tracks-Schädigung“ arbeitet unabhängig von der Spieleinstellung.
- Option „Vollständig deaktiviert“ verhindert jede Mod-Fruchtschädigung.
- Pflegebereifung wird über Reifenbreite und erkennbare Reifenbezeichnungen erkannt.
- Pflegebereifungsmodi: kein Schaden, nur bei starkem Schlupf, reduziert oder normal.
- Aktive KI-Helfer können von der Fruchtschädigung ausgeschlossen werden.
- Erkennbare Fahrzeug- und Gerätesperren gegen Fruchtzerstörung werden beachtet.
- Alle Optionen befinden sich im Visual-Mud-Tracks-Einstellungsmenü.
