Unfallschaden - v1.0.0.0
=========================================

Beschreibung
------------
Dieser Script-Mod erweitert das Schadenssystem des Landwirtschafts-Simulators 25. Fahrzeuge, Anhänger und Geräte können nach stärkeren Zusammenstößen zusätzlichen Schaden erhalten. Der Mod nutzt dabei das vorhandene Schadenssystem des Spiels. Es gibt keine sichtbaren Verformungen, aber der normale Schadenswert des Fahrzeugs steigt und kann wie gewohnt repariert werden.

Was der Mod macht
-----------------
Der Mod überwacht benutzbare Fahrzeuge im Spiel und prüft, ob ein stärkerer Aufprall stattgefunden hat. Schaden entsteht nur, wenn ein Aufprall plausibel erkannt wird. Dazu werden unter anderem Geschwindigkeit, Geschwindigkeitsverlust, Richtungsänderung und ein bestätigter Kontakt mit einem fremden Kollisionsobjekt berücksichtigt.

Erkannt werden unter anderem:
- frontale Zusammenstöße mit Gebäuden, Wänden, Bäumen oder anderen Hindernissen
- schräge und seitliche Aufpralle
- Aufpralle schwerer oder langsamer Maschinen, zum Beispiel Mähdrescher
- Zusammenstöße zwischen benutzbaren Fahrzeugen, Anhängern und Geräten

Gegenschaden bei Fahrzeugen und Geräten
---------------------------------------
Wenn zwei benutzbare Fahrzeuge, Anhänger oder Geräte zusammenstoßen, kann auch das getroffene Objekt Schaden erhalten. Beispiel: Fährst du mit einem Traktor in einen zweiten Traktor, erhält der fahrende Traktor den berechneten Unfallschaden. Der getroffene Traktor erhält denselben zusätzlichen Schadenswert, sofern er im Spiel ein eigenes Schadenssystem besitzt.

Das gilt auch für separat stehende Anhänger oder Geräte mit eigenem Schadenssystem. Eigene angehängte Geräte oder Anhänger des gerade gefahrenen Fahrzeugverbands werden nicht als zweiter Unfallteilnehmer gewertet, damit Rangieren und normale Gespannbewegungen nicht fälschlich doppelt bestraft werden.

Was keinen zusätzlichen Schaden erhält
--------------------------------------
Statische Hindernisse werden nicht beschädigt. Gebäude, Wände, Bäume, Terrain, Wasserflächen, Map-Grenzen und typische Interaktionsbereiche dienen nur als Unfallhindernis. Sie erhalten selbst keinen Schaden.

KI-Verkehr und sonstige Objekte, die vom Spiel nicht als beschädigbares Fahrzeug, Anhänger oder Gerät mit Giants-Schadenssystem geführt werden, erhalten ebenfalls keinen Gegenschaden.

Schutz vor Fehlauslösungen
--------------------------
Der Mod soll normale Fahrmanöver nicht bestrafen. Deshalb werden langsames Rangieren, reines Bremsen ohne Kontakt, eigene Fahrzeugteile, angehängte Geräte des eigenen Gespanns, Map-Grenzen und typische Interaktionstrigger herausgefiltert. Außerdem gibt es nach einem Schadensereignis eine kurze Sperrzeit, damit ein einzelner Aufprall nicht mehrfach hintereinander berechnet wird.

Mehrspieler
-----------
Die Schadensberechnung läuft serverseitig. Im Einzelspieler entspricht das dem lokalen Spiel. Im Mehrspieler berechnet der Host beziehungsweise Server den Unfallschaden; Clients schreiben keinen eigenen Schaden. Der Schadenswert wird über das vorhandene Giants-Schadenssystem gespeichert und synchronisiert.

Installation
------------
Lege die ZIP-Datei unverändert in den mods-Ordner des Landwirtschafts-Simulators 25 und aktiviere den Mod beim Start des Spielstands. Ein Entpacken ist nicht erforderlich.

Einstellungen
-------------
Die wichtigsten technischen Werte stehen am Anfang der Datei scripts/FSCollisionDamage.lua. Dort können erfahrene Nutzer unter anderem Mindestgeschwindigkeit, Schadenshöhe, Sperrzeit und die Gegenschaden-Funktion anpassen. Für normales Spielen ist keine Änderung erforderlich.

Hinweise
--------
Der Mod ersetzt keine echte Crash-Physik. Die Erkennung hängt davon ab, wie Fahrzeuge, Geräte und Kartenobjekte ihre Kollisionsformen im Spiel bereitstellen. Ein Objekt kann nur dann Gegenschaden erhalten, wenn es im Spiel als beschädigbares Fahrzeug, Anhänger oder Gerät mit eigenem Schadenssystem erkennbar ist.
