Laderverwiegung 1.2.0.23
Autor: Trucker_Ugly

Unterstuetzt automatisch alle Standard- und Modfahrzeuge, die korrekt in den
LS25-Kategorien Radlader, Teleskoplader, Frontlader-Fahrzeuge oder Kompaktlader
eingetragen sind. Traktoren mit angebautem Frontlader werden bewusst ausgeschlossen.
Passende Standard- und Mod-Anbaugeraete werden ueber ihre Laderkategorie erkannt.

Erstkalibrierung je Material und Anbaugeraet:
1. Material aufnehmen bzw. Palette oder Ballen sicher aufnehmen.
2. Anbaugeraet vollstaendig anziehen und unter 10 Prozent Hubhoehe beginnen.
3. Beim Anheben den ersten Messpunkt bei 10 Prozent und den zweiten bei 70 Prozent passieren.
4. Danach auf 55 Prozent absenken. Jetzt erscheinen Netto und Brutto und der Mod
   speichert Tara, Fuelltyp und Volumengewicht fuer diese Material-/Werkzeugkombination.

Folgewiegungen:
- Bei weiteren Ladungen mit demselben Material und Anbaugeraet muss nicht erneut
  kalibriert werden. Anbaugeraet vollstaendig anziehen, unten beginnen und beim
  Anheben den einzelnen Wiegepunkt bei 55 Prozent passieren.
- Bei einem neuen Material oder einem anderen Anbaugeraet wird automatisch wieder
  die vollstaendige Folge 10 Prozent -> 70 Prozent -> absenken auf 55 Prozent verlangt.
- Die gespeicherten Kalibrierungen bleiben waehrend der laufenden Spiel-/Arbeitssitzung
  erhalten, auch wenn der Motor zwischenzeitlich ausgeschaltet wird.

Optionaler 40,8-t-Beladeassistent:
- Mit Alt+L (frei belegbar) ein- oder ausschalten. Der Assistent ist standardmaessig
  eingeschaltet und speichert danach die persoenliche Einstellung lokal.
- Beim Abladen einer Schaufel in einen LKW oder Anhaenger erkennt er automatisch
  das komplette zusammengekuppelte Gespann und dessen echtes Gesamtgewicht.
- Ab 40.800 kg wird das Abladen gestoppt, die Schaufel eingezogen und der Hubarm
  angehoben. Abladen auf den Boden oder in stationaere Silos bleibt unbeeinflusst.

Speicherbare Grundposition:
- Hubarm, Schaufelneigung und bei Hochkippschaufeln auch die Kippfunktion in die
  gewuenschte Stellung bringen und mit Alt+Umschalt+A speichern.
- Mit Alt+A fahren Hubarm und Anbaugeraet automatisch in diese Stellung zurueck.
- Die Position wird je Lader-/Anbaugeraetekombination gespeichert und bleibt nach
  einem Neustart erhalten. Ein erneutes Alt+A oder eine manuelle Hydraulikbewegung
  bricht die automatische Rueckfahrt ab.
- Die 40,8-t-Sicherheitsabschaltung hat Vorrang vor der Grundpositionsfahrt.

Ladeauftrag und Rechnung:
- Jede abgeschlossene Messung wird in der Liste des aktuellen Ladeauftrags gespeichert.
- Mit "Wiegungen an Invoices uebergeben" werden alle Einzelmessungen samt Material,
  Einzelgewicht, Anzahl und Gesamtgewicht in einen bearbeitbaren Rechnungsentwurf von
  FS25_Invoices (Squallqt) eingefuegt. Als letzte Position folgt automatisch der erkannte
  Produktverkauf mit der aufsummierten echten Spielmenge in Litern und dem aktuellen
  Spielpreis je 1.000 Liter.
- Bei mehreren Materialien wird fuer jedes erkannte Produkt eine eigene Literposition erstellt.
- Empfaenger und Preise werden anschliessend im Invoices-Fenster festgelegt.
- "Wiegeauftrag zuruecksetzen" leert die Liste fuer den naechsten LKW/Auftrag.
- FS25_Invoices muss beim Laden des Spielstands unter Mods/DLC separat aktiviert sein.
  Nur die Installation der ZIP-Datei reicht nicht aus.

Fahrzeugwaage:
1. LKW mit Anhaenger oder Sattelzug vollstaendig auf eine originale bzw.
   kompatible Fahrzeugwaage fahren und abstellen. Die erste Wiegung darf leer oder
   bereits voll beladen erfolgen.
2. Zu Fuss rechts neben das Wiegehaus zum Bedienpunkt gehen und mit R oeffnen.
   Im Auswahlfenster "Fahrzeug wiegen" waehlen.
3. Das Kennzeichen manuell eingeben und die angezeigte Erstwiegung bestaetigen.
   Die erkannte Zugmaschine-/Anhaenger-Kombination wird mit diesem Kennzeichen verknuepft.
4. Weitere Spieler koennen auf derselben Waage eigene Erstwiegungen mit anderen
   Kennzeichen beginnen, ohne bereits offene Wiegungen zu ueberschreiben.
5. Dieselbe Fahrzeugkombination be- oder entladen und erneut auf die Waage fahren.
6. Wieder am Bedienpunkt R druecken und dasselbe Kennzeichen eingeben. Der Mod
   prueft Kennzeichen und komplette Fahrzeugkombination. Danach werden Wiegung 1,
   Wiegung 2, die vorzeichenbehaftete Differenz, Material und echte Liter angezeigt.
   Leer -> voll ergibt einen positiven Wert, voll -> leer einen Minuswert.
7. Ergebnis pruefen und zwischen Verkaufsrechnung und Ankaufsquittung waehlen.
   Die Ankaufsquittung verwendet den Vorschlagsmodus von Invoices: Der eigene Hof
   ist Kaeufer/Zahler und der Lieferantenhof ist Aussteller/Empfaenger. In beiden
   Faellen oeffnet sich ein bearbeitbarer Entwurf. Ein ueber den Fahrzeugeigentuemer
   eindeutig erkannter Kunden- bzw. Lieferantenhof
   ist bereits vorausgewaehlt. Preis, Rabatt und Steuer koennen vor dem manuellen
   Versand geprueft bzw. geaendert werden. Fahrzeugname und Kennzeichen stehen in
   der Wiegeposition der Rechnung. Es wird nichts automatisch versendet.

Ueberschreitet eine der beiden Fahrzeugwiegungen 40.000 kg, erscheint ein deutlicher
Ueberladungshinweis. Gesamtgewicht und Ueberschreitung werden auch in den Rechnungs-
oder Quittungsentwurf aufgenommen.

Die Fahrzeugwaage prueft, ob bei beiden Wiegungen dieselbe Zugmaschine sowie
dieselben Anhaenger bzw. Auflieger verwendet werden. Sitzungen sind je Waage und
Kennzeichen getrennt, damit mehrere Spieler sie auf einem Dedicated Server parallel
nutzen koennen. Nach abgeschlossener Zweitwiegung wird nur das zugehoerige Kennzeichen
freigegeben; alle anderen offenen Erstwiegungen bleiben bestehen. Ueber R und
"Offene Wiegung suchen / loeschen" kann ein Kennzeichen auch ohne Fahrzeug auf der
Waage gesucht, kontrolliert und nach Bestaetigung geloescht werden. Danach ist eine
neue Erstwiegung mit demselben Kennzeichen sofort moeglich.

Wiegefenster anpassen:
- Alt+M (frei belegbar) aktiviert Mauszeiger und Bearbeitungsmodus.
- Am Eckpunkt oben links wird das Fenster mit gedrueckter linker Maustaste verschoben.
- Am neuen Eckpunkt unten rechts wird das komplette Fenster proportional groesser
  oder kleiner gezogen. Position und Groesse werden fuer diesen Spieler lokal gespeichert.
- Unter Einstellungen -> Allgemeine Einstellungen -> Laderverwiegung kann jeder Spieler
  seine eigene HUD-Farbe waehlen. Diese Auswahl wird nicht auf andere Spieler uebertragen.

Standardtasten (im Steuerungsmenue frei belegbar):
- Alt+W: Wiegefenster ein-/ausblenden
- Alt+M: Verschiebemodus ein-/ausschalten; am farbigen Punkt mit linker Maustaste ziehen
- Alt+L: 40,8-t-Beladeassistent ein-/ausschalten
- Alt+Umschalt+A: aktuelle Grundposition speichern
- Alt+A: gespeicherte Grundposition anfahren / Fahrt abbrechen
- Alt+I: Wiegungen an Invoices uebergeben
- Alt+R: Wiegeauftrag zuruecksetzen

Das Fahrzeugdisplay in der Innenansicht wird nicht veraendert.
Multiplayer und Dedicated Server werden unterstuetzt.

Aenderungen 1.2.0.6:
- Eindeutige Meldung, wenn FS25_Invoices zwar installiert, im aktuellen Spielstand
  aber nicht aktiviert ist.
- Zusaetzliche Protokollierung der an Invoices uebergebenen Fahrzeugwaagen-Produkte
  mit echter Liter-, Gewichts- und Preisangabe.
- Das originale GIANTS-Bedienpunktsymbol wird ueber den aufgeloesten Spielpfad geladen.

Aenderungen 1.2.0.7:
- Alle vier Mod-Netzwerkereignisse werden nun explizit registriert. Dadurch funktionieren
  Radlader-Messergebnisse, Historie und Fahrzeugwaagen-Dialoge auf Dedicated Servern.
- Messung, Anzeige und Tasten des Radladers sind strikt an das lokal gesteuerte Fahrzeug
  gebunden. In LKW sowie bei Ladern anderer Spieler erscheint kein fremdes Wiegefenster mehr.
- Waagenantworten werden nur vom Server akzeptiert und nur an den anfragenden Spieler gesendet.

Aenderungen 1.2.0.11:
- Die vollstaendige Laderkalibrierung ist nur noch einmal je Material und Anbaugeraet
  in der laufenden Sitzung erforderlich. Folgeladungen werden direkt bei 55 Prozent gewogen.
- Beim Materialwechsel wird automatisch eine neue Kalibrierung bei 10, 70 und 55 Prozent verlangt.
- Die Fahrzeugwaage oeffnet einen bearbeitbaren Invoices-Rechnungsentwurf und sendet
  auch bei erkanntem Kunden keine Rechnung mehr automatisch.

Aenderungen 1.2.0.12:
- Manuelle Kennzeicheneingabe bei jeder Erst- und Zweitwiegung an der Fahrzeugwaage.
- Mehrere Fahrzeuge koennen gleichzeitig eigene offene Leerwiegungen an derselben
  Waage besitzen, ohne sich gegenseitig zu ueberschreiben.
- Kennzeichen und intern erkannte Zugmaschine-/Anhaenger-Kombination muessen bei der
  Zweitwiegung zusammenpassen.
- Fahrzeugname und Kennzeichen werden in den bearbeitbaren Invoices-Entwurf uebernommen.

Aenderungen 1.2.0.13:
- Erst- und Zweitwiegung funktionieren in beiden Richtungen. Bei einer Anlieferung
  von voll nach leer wird die Gewichtsdifferenz als Minuswert angezeigt und dokumentiert.
- Material und echte Liter werden auch beim Entladen aus der Differenz beider
  Fahrzeugzustaende erkannt und positiv als Produktmenge an Invoices uebergeben.
- Neue Kennzeichensuche am Bedienpunkt zum Anzeigen und manuellen Loeschen offener
  Erstwiegungen; funktioniert auch bei leerer Wiegeplattform und auf Dedicated Servern.
- Der interne Fuelltyp AIR wird nicht mehr als abrechenbares Produkt uebernommen.

Aenderungen 1.2.0.14:
- Das ZIP wird mit LS25-kompatiblen Pfadtrennern erstellt. Dadurch koennen
  Register.lua, alle Wiegescripte und die Sprachdateien wieder geladen werden.
- Keine Aenderung an der in 1.2.0.13 geprueften Radlader- oder LKW-Wiegelogik.

Aenderungen 1.2.0.15:
- Motor-Diesel, DEF, elektrische Ladung und Druckluft werden nicht mehr als
  transportierte Produkte an Invoices uebergeben.
- Diesel und andere Fuelltypen in echten Tankanhaengern oder separaten
  Ladetanks bleiben weiterhin als abrechenbare Ladung erhalten.
- Dedicated-Livetest bestaetigt Radladerwiegung, beide LKW-Wiegerichtungen,
  negative Differenz sowie Kennzeichensuche und manuelles Loeschen.

Aenderungen 1.2.0.16:
- Optionaler 40,8-t-Beladeassistent mit automatischer Erkennung des beladenen
  LKW-/Anhaengergespanns, Ablade-Stopp sowie Rueckzug und Anheben der Schaufel.
- 40-t-Ueberladungswarnung an der Fahrzeugwaage und sichtbarer Ueberladungsvermerk
  im Invoices-Beleg.
- Auswahl zwischen Verkaufsrechnung und Ankaufsquittung. Die Ankaufsquittung nutzt
  den Invoices-Vorschlagsmodus mit korrekt vertauschten Kaeufer-/Lieferantenrollen.

Aenderungen 1.2.0.17:
- Die Abschlussdaten der Fahrzeugwaage werden auf drei feste Zeilen verdichtet und
  stehen damit vollstaendig oberhalb der Auswahl fuer Rechnung oder Ankaufsquittung.
- Der 40,8-t-Beladeassistent ist nach dem Update einmalig eingeschaltet; eine danach
  manuell gespeicherte Aus-Einstellung bleibt erhalten.
- Zusaetzliche Zielerkennung ueber das direkte GIANTS-Abladeobjekt, dessen Trefferobjekt
  und als Rueckfall ueber den naechsten passenden Fahrzeugtank unter der Schaufel.
- Erkannte Fahrzeuggespanne und ein ausgefuehrter Ablade-Stopp werden im Spielprotokoll
  eindeutig festgehalten, damit Dedicated-Server-Tests sofort auswertbar sind.

Aenderungen 1.2.0.18:
- Auf Dedicated-Clients wird das Gespanngewicht aus der dort unveraenderten
  Fahrzeug-Physikmasse plus den synchronisierten Fuellmengen aller angekuppelten
  Fahrzeuge und den echten Spieldichten berechnet.
- Der Gewichtsstand folgt waehrend des Abladevorgangs zusaetzlich sofort der gemessenen
  Abnahme des Schaufelinhalts. Verzoegerte Netzwerk-Fuellstaende koennen den Stopp bei
  40.800 kg dadurch nicht mehr verhindern.
- Das Protokoll zeigt Fahrzeugmasse, Fuellmasse, Gesamtgewicht und Abladezustand getrennt.

Aenderungen 1.2.0.19:
- Das trockene Leergewicht jeder erkannten Zugmaschinen-/Anhaengerkombination wird
  einmalig aus Fahrzeugphysik und aktueller Fuellmasse bestimmt und pro Gespann gespeichert.
- Danach wird das Gesamtgewicht dauerhaft als Leergewicht plus aktuelle Fuellmasse
  berechnet. Die GIANTS-Begrenzung der physikalischen Komponentenmasse kann die
  Anzeige damit nicht mehr auf einen festen Wert zuruecksetzen.
- Ein Regressionstest bildet mehrere aufeinanderfolgende Kalk-/Steinschaufeln nach:
  Trotz bei 39.877 kg eingefrorener Physik steigt das Ergebnis weiter bis 59.079 kg
  und loest beim ersten Ueberschreiten von 40.800 kg den Ablade-Stopp aus.

Aenderungen 1.2.0.20:
- Die automatische Schaufelbewegung wird je erkanntem ueberladenem Gespann nur einmal
  gestartet. Nach Rueckzug und Anheben bleibt die manuelle Hydrauliksteuerung frei.
- Eine leere Schaufel kann keine erneute 40,8-t-Grenzausloesung und keine wiederholte
  Hinweismeldung mehr verursachen, auch wenn der GIANTS-Abladestrahl das Gespann
  weiterhin als Ziel meldet.
- Ein erneuter Schutzvorgang ist erst bei einer tatsaechlich gefuellten Schaufel und
  nach erneutem Anfahren des Abladebereichs moeglich.

Aenderungen 1.2.0.21:
- Eine Grundposition fuer Hubarm, Anbaugeraeteneigung und eine vorhandene interne
  Hochkippfunktion kann je Lader-/Anbaugeraetekombination dauerhaft gespeichert werden.
- Alt+A faehrt die gespeicherte Stellung automatisch an. Ein zweiter Tastendruck oder
  eine manuelle Hydraulikbewegung bricht die Fahrt sofort ab.
- Alle neuen Aktionen sind im LS25-Steuerungsmenue frei belegbar. Die 40,8-t-
  Sicherheitsabschaltung bleibt vorrangig und wurde funktional nicht veraendert.

Aenderungen 1.2.0.22:
- Erfolgreich gespeicherte Erstwiegungen und weitere positive Rueckmeldungen der
  Fahrzeugwaage erscheinen als gruene LS25-Infomeldung.
- Eine Ueberschreitung von 40.000 kg erscheint bei der Erst- und Zweitwiegung
  zusaetzlich als rote LS25-Warnmeldung. Der Ueberladungsvermerk im Dialog und
  im Invoices-Beleg bleibt erhalten.

Aenderungen 1.2.0.23:
- Die Kennzeicheneingabe der Such-/Loeschfunktion besitzt nur noch eine kurze
  Ueberschrift; Eingabetext und Erklaerung ueberlagern sich nicht mehr.
- Ein zweiter Eckpunkt unten rechts skaliert das komplette Radlader-Wiegefenster
  proportional zwischen 70 und 150 Prozent.
- Im Einstellungsmenue gibt es eine persoenliche HUD-Farbauswahl mit elf Farbschemata.
  Farbe, Groesse und Position werden lokal je Spieler gespeichert und nicht synchronisiert.
