FS25_lsfmHoseSystem

Inhalt

• Überblick
• Aufbau des Mods
• settings.xml
• Stationsarten
• Kupplungstypen
• Station-XML Referenz
• Trailer-XML Referenz
• Connector-Bibliothek
• Selbst verbaute Anschlüsse
• FillTypes und Kategorien
• Bedienung
• Einbauanleitung
• Testplan
• Wartung und Regeln
• Fehlersuche
• Savegame-Verhalten
• Lokalisierung

Überblick

Das Modsystem erweitert platzierbare Pumpstationen um einen sichtbaren, fest gefärbten GIANTS-Connection-Hose-Schlauch. Der Schlauch wird an vorbereitete Connector-Nodes von Trailern gekoppelt und kann je nach Pumprichtung Flüssigkeiten von der Station in den Trailer oder vom Trailer zurück in die Station bewegen.

Aufbau des Mods

Die aktive Logik liegt im Placeable-Script:

scripts/placeables/PlaceableLSFMHoseStation.lua

Fahrzeuganschlüsse, Runtime-Konfiguration und Schlauchlogik liegen in:

scripts/vehicles/LSFMHoseTrailerConnection.lua
scripts/vehicles/LSFMHoseConnectorConfigurator.lua
scripts/placeables/PlaceableLSFMHoseStation.lua
scripts/shared/LSFMHoseSystemSettings.lua
settings.xml
gui/LSFMHoseConnectorToolbar.xml
shared/assets/connectors/connectors.xml
shared/assets/connectors/connectors.i3d

Typische Modstruktur:

FS25_lsfmHoseSystem/
├─ modDesc.xml
├─ settings.xml
├─ scripts/
│  ├─ placeables/
│  │  └─ PlaceableLSFMHoseStation.lua
│  ├─ vehicles/
│  │  ├─ LSFMHoseTrailerConnection.lua
│  │  └─ LSFMHoseConnectorConfigurator.lua
│  └─ shared/
│     └─ LSFMHoseSystemSettings.lua
├─ gui/
│  └─ LSFMHoseConnectorToolbar.xml
├─ shared/
│  └─ assets/
│     └─ connectors/
│        ├─ connectors.xml
│        └─ connectors.i3d
├─ placeables/
│  └─ hoseStation/
│     ├─ hoseStation.xml
│     ├─ hoseStation.i3d
│     ├─ hoseStationMini.xml
│     └─ hoseStationMini.i3d
├─ vehicles/
│  └─ *.xml
├─ sounds/
│  └─ hoseAttachDetach.ogg
└─ translations/
   ├─ l10n_de.xml
   └─ l10n_en.xml

modDesc.xml

Die modDesc.xml registriert die Placeable-Spezialisierung, die StoreItems und die Input-Actions. Da dort schnell neue Fahrzeuge hinzukommen, sollte diese Datei nie blind mit einer alten Version überschrieben werden.

settings.xml

Globale Mod-Einstellungen liegen in settings.xml im Mod-Hauptordner. Diese Datei ist für Werte gedacht, die nicht jedes Mal im Script hart geändert werden sollen.

<lsfmHoseSystemSettings>
    <debug trailerConnections="false" placeableStations="false"/>

    <transferSpeeds>
        <hoseCoupling type="perrot" loadingLitersPerSecond="500" unloadingLitersPerSecond="500"/>
        <hoseCoupling type="camLock" loadingLitersPerSecond="100" unloadingLitersPerSecond="100"/>
    </transferSpeeds>
</lsfmHoseSystemSettings>

Stationsarten

placeables/hoseStation/hoseStation.xml

placeables/hoseStation/hoseStationMini.xml

Kupplungstypen

Der Kupplungstyp trennt große Gülleanschlüsse von kleinen CamLock-Anschlüssen. FillTypes verhindern zwar viele falsche Kombinationen, aber nicht jede reale technische Verwechslung. Deshalb sollte der Kupplungstyp zusätzlich sauber gesetzt werden.

Station-XML Referenz

Die Station wird über den Block <lsfmHoseStation> in der Placeable-XML konfiguriert. Die wichtigsten Attribute sind unten gruppiert.

Beispiel: große Güllestation

<lsfmHoseStation
    activationTrigger="activationTrigger"
    hoseEndTrigger="hoseEndTrigger"
    stationDockNode="stationDockNode"
    hoseStartNode="hoseStartNode"
    hoseRestNode="hoseRestNode"
    hoseConnectorNode="hoseConnector"
    disconnectedHoseVisualNode="disconnectedHoseVisual"
    leverNode="lever"
    leverOpenRotation="0 0 -90"
    searchRadius="30"
    hoseCouplingType="perrot"
    flowProfile="slurryMedium"
    hoseDiameterMm="100"
    maxFlowLitersPerMinute="3500"
    fillTypes="LIQUIDMANURE DIGESTATE"
    useGiantsConnectionHoseVisual="true"
    giantsHoseDiameter="0.14"
    giantsHoseUvScaleMultiplier="0.45" />

Beispiel: Mini-/CamLock-Station

<lsfmHoseStation
    activationTrigger="activationTrigger"
    hoseEndTrigger="hoseEndTrigger"
    stationDockNode="stationDockNode"
    hoseStartNode="hoseStartNode"
    hoseRestNode="hoseRestNode"
    hoseConnectorNode="hoseConnector"
    disconnectedHoseVisualNode="disconnectedHoseVisual"
    leverNode="lever"
    leverOpenRotation="0 -90 0"
    searchRadius="10"
    hoseCouplingType="camLock"
    flowProfile="liquidSmall"
    hoseDiameterMm="75"
    maxFlowLitersPerMinute="1500"
    fillTypes="WATER MILK LIQUIDFERTILIZER HERBICIDE DIESEL DEF"
    useGiantsConnectionHoseVisual="true"
    giantsHoseDiameter="0.08"
    giantsHoseUvScaleMultiplier="1" />

Nodes

Verbindung und Suche

HUD, Richtung und Pumpe

Die realistische Durchflussrate wird sowohl beim Befüllen als auch beim Abladen über den Schlauch angewendet. Beim Standard-Abladen über die Fahrzeug-Entladefunktion begrenzt das Script die tatsächlich bewegte Menge nachträglich auf die Schlauchrate. Die aktuell aktiven Überladegeschwindigkeiten können zusätzlich global in settings.xml pro Kupplungstyp getrennt für Laden und Abladen überschrieben werden.

Schlauchoptik

Hebelanimation

Trailer-XML Referenz

Fahrzeuge bekommen einen <lsfmHoseSystem>-Block. Jeder Connector beschreibt einen realen Schlauchanschluss am Fahrzeug. Mehrere Connectoren pro Trailer sind erlaubt, zum Beispiel links und rechts am T-Stück.

Beispiel: Güllefass mit T-Stück links/rechts

<lsfmHoseSystem>
    <connectors>
        <connector node="lsfmHoseConnectorLeft"
                   visualNode="lsfmHoseConnectorLeftVisual"
                   extraVisualNode="distributor"
                   hoseCouplingType="perrot"
                   fillUnitIndex="1"/>

        <connector node="lsfmHoseConnectorRight"
                   visualNode="lsfmHoseConnectorRightVisual"
                   extraVisualNode="distributor"
                   hoseCouplingType="perrot"
                   fillUnitIndex="1"/>
    </connectors>
</lsfmHoseSystem>

i3dMappings

Alle im XML genannten Nodes müssen in <i3dMappings> vorhanden sein. Ein typisches Mapping sieht so aus:

<i3dMapping id="distributor" node="0>0|8|0" />
<i3dMapping id="lsfmHoseConnectorLeftVisual" node="0>0|8|1" />
<i3dMapping id="lsfmHoseConnectorLeft" node="0>0|8|1|0" />
<i3dMapping id="lsfmHoseConnectorRightVisual" node="0>0|8|2" />
<i3dMapping id="lsfmHoseConnectorRight" node="0>0|8|2|0" />

Freigabe für selbst verbaute Anschlüsse

Der Ingame-Konfigurator wird nicht mehr bei jeder beliebigen FillUnit angeboten. Standardmäßig werden nur passende Flüssigkeits-FillUnits freigegeben. Ein Fahrzeug kann zusätzlich explizit erlaubt oder gesperrt werden.

<lsfmHoseConnectorConfigurator allow="true" />

<lsfmHoseConnectorConfigurator allow="false" />

Alternativ kann die Freigabe auch direkt am HoseSystem-Block stehen:

<lsfmHoseSystem allowConnectorConfiguration="true">
    ...
</lsfmHoseSystem>

• allow="true" erlaubt die Konfiguration auch bei Spezialfällen, die nicht über den Standard-FillType-Filter fallen.
• allow="false" sperrt die Konfiguration auch dann, wenn eine passende FillUnit vorhanden wäre.
• Bereits gespeicherte selbst verbaute Anschlüsse bleiben bearbeitbar, damit sie verschoben oder abgebaut werden können.

Connector-Bibliothek

Die auswählbaren Anschlüsse für den Ingame-Konfigurator liegen in shared/assets/connectors/connectors.xml und greifen auf shared/assets/connectors/connectors.i3d zu. Die Namen der Nodes in der i3d müssen eindeutig sein, damit Connector, Kupplungsteil und Schlauchziel sauber gefunden werden.

Beispiel

<connectors defaultI3dFilename="connectors.i3d">
    <connector name="perrot"
               system="perrot"
               label="Perrot Var. 01"
               nodeName="perrot_var01"
               connectionVisualNodeName="coupling_perrot2"
               connectorNodeName="perrot_var01_couplingNode"
               couplerConnectionNodeName="coupling_perrot2_connectorNode"
               targetNodeName="coupling_perrot2_hoseNode"
               mountedVisualVisibleAfterMount="false" />
</connectors>

Selbst verbaute Anschlüsse

Fahrzeuge ohne vorbereiteten <lsfmHoseSystem>-Connector können im Spiel nachgerüstet werden, wenn sie eine passende FillUnit besitzen oder per Fahrzeug-XML freigegeben wurden. Die Aktion erscheint als einziger Eintrag in der F1-Hilfe: Schlauchanschluss konfigurieren.

Standard-Freigabe

Ohne XML-Override werden nur diese FillTypes für den Konfigurator akzeptiert:

• WATER
• MILK
• LIQUIDFERTILIZER
• HERBICIDE
• LIQUIDMANURE
• DIGESTATE

DIESEL und DEF sind absichtlich nicht im Standardfilter, damit normale Traktoren nicht wegen ihrer Verbrauchs- FillUnits als konfigurierbar erkannt werden.

Ablauf im Spiel

1. Zu Fuß zum passenden Fahrzeug gehen.
2. In der F1-Hilfe Schlauchanschluss konfigurieren auslösen.
3. Der exklusive Konfigurationsmodus startet mit freier Editor-Kamera.
4. In der Werkzeugleiste rechts den Connector-Typ wählen.
5. Den Anschluss über die X/Y/Z-Gizmoachsen positionieren und drehen.
6. Mit Anschluss montieren speichern oder mit Konfiguration abbrechen verwerfen.

Bearbeiten und abbauen

Ist bereits ein selbst verbauter Anschluss vorhanden, öffnet dieselbe F1-Aktion den Bearbeitungsmodus. Die Werkzeugleiste wechselt dann auf Anschluss speichern und zeigt zusätzlich Anschluss abbauen. Beim Abbrechen wird die vorherige Position wiederhergestellt.

Werkzeugleiste

Die Werkzeugleiste basiert auf GIANTS-GUI-Elementen und liegt als eigene XML unter gui/LSFMHoseConnectorToolbar.xml. Während der Konfiguration werden die früheren F1-Aktionen für Montieren, Typwechsel und Abbrechen nicht mehr verwendet; die Bedienung erfolgt über Maus und Toolbar.

FillTypes und Kategorien

Das Script liest sowohl direkte fillTypes als auch fillTypeCategories. Dadurch funktionieren auch Tanks, die ihre erlaubten Inhalte nur über Kategorien wie SLURRYTANK definieren.

Station

<lsfmHoseStation fillTypes="LIQUIDMANURE DIGESTATE" />

<lsfmHoseStation fillTypeCategories="SLURRYTANK" />

Trailer-FillUnit

<fillUnit fillTypeCategories="SLURRYTANK"
          capacity="15000"
          allowAILoading="true" />

Für den regulären Einbau ist die Kombination aus FillType-Prüfung und Kupplungstyp die sauberste Variante:

• FillTypes bestimmen, ob die Flüssigkeit technisch passt.
• Kupplungstypen bestimmen, ob das Schlauchsystem physisch passt.
• fillUnitIndex bestimmt, welche Kammer betroffen ist.

Bedienung

Die manuelle Farbwahl wurde entfernt. Perrot-Schläuche nutzen standardmäßig Schwarz, CamLock-Schläuche standardmäßig Blau.

Werkzeugleiste im Konfigurationsmodus

• Anschluss: Connector-Variante per linkem/rechtem Button wechseln.
• Anschluss montieren: neuen Runtime-Connector speichern.
• Anschluss speichern: vorhandenen Runtime-Connector nach Bearbeitung speichern.
• Anschluss abbauen: vorhandenen Runtime-Connector entfernen.
• Konfiguration abbrechen: neuen Connector verwerfen oder Änderungen am vorhandenen Connector zurücksetzen.

Extra Einbauanleitung

Diese Anleitung beschreibt den sauberen Einbau einer neuen Station oder eines neuen Trailers in das Schlauchsystem.

A. Neue Station einbauen

1. i3d vorbereiten: Lege mindestens activationTrigger, hoseEndTrigger, stationDockNode, hoseStartNode, hoseRestNode, hoseConnector und optional disconnectedHoseVisual sowie lever an.
2. Nodes sichtbar mappen: Trage alle Nodes in den i3dMappings der Station-XML ein. Namen müssen exakt mit den Attributen in <lsfmHoseStation> übereinstimmen.
3. Kupplung wählen: Große Güllestation mit hoseCouplingType="perrot", dünne Station mit hoseCouplingType="camLock".
4. FillTypes setzen: Nutze fillTypes oder fillTypeCategories. Bei gemischten Flüssigkeiten vorher prüfen, ob das Szenario im Spiel wirklich sinnvoll ist.
5. Schlauchoptik einstellen: Setze giantsHoseDiameter, giantsHoseUvScaleMultiplier, Durchhang und Straightening-Werte passend zur Station.
6. StoreItem ergänzen: Falls die Station neu ist, in der modDesc.xml als StoreItem ergänzen. Die Datei nicht blind überschreiben, weil dort oft neue Fahrzeuge eingetragen werden.

B. Neuen Trailer einbauen

1. Connector-Position festlegen: Baue die Connectoren direkt in die Trailer-i3d. Bei Heckanschlüssen ist ein T-Stück mit linkem und rechtem Anschluss sinnvoll.
2. Visuals vorbereiten: Erstelle pro Seite ein eigenes visualNode. Das gemeinsame T-Stück oder der Verteiler kann als extraVisualNode von beiden Seiten genutzt werden.
3. Connector-Node setzen: Die eigentliche node sitzt dort, wo das Schlauchende andocken soll. Die Ausrichtung sollte zur erwarteten Schlauchrichtung passen, damit Winkelprüfungen sauber arbeiten.
4. XML-Block einfügen: Füge <lsfmHoseSystem> mit einem oder mehreren <connector>-Einträgen in die Fahrzeug-XML ein.
5. FillUnit zuordnen: Setze fillUnitIndex auf die passende Tank-FillUnit. Das ist besonders wichtig bei Fahrzeugen mit mehreren Kammern.
6. Kupplungstyp setzen: Güllefässer verwenden perrot, Universal-/Milch-/Wasser- oder Flüssigdünger-Tanks verwenden je nach Anschluss camLock.
7. i3dMappings ergänzen: Alle neuen Nodes in <i3dMappings> ergänzen.

C. Sauberes XML-Beispiel für einen Trailer

<lsfmHoseSystem>
    <connectors>
        <connector node="lsfmHoseConnectorLeft"
                   visualNode="lsfmHoseConnectorLeftVisual"
                   extraVisualNode="lsfmHoseConnectorTVisual"
                   hoseCouplingType="perrot"
                   fillUnitIndex="1"/>

        <connector node="lsfmHoseConnectorRight"
                   visualNode="lsfmHoseConnectorRightVisual"
                   extraVisualNode="lsfmHoseConnectorTVisual"
                   hoseCouplingType="perrot"
                   fillUnitIndex="1"/>
    </connectors>
</lsfmHoseSystem>

D. Einbau in einen externen Mod

Wenn ein Trailer in einem anderen Mod liegt, kann dessen XML ebenfalls mit <lsfmHoseSystem> erweitert werden. Entscheidend ist, dass die Connector-Nodes in der i3d dieses Fahrzeugs existieren und die FillUnit/Fülltypprüfung mit der Station kompatibel ist.

Testplan nach Änderungen

1. Spiel starten und Log auf Lua-Errors prüfen.
2. Station im Shop kaufen und platzieren.
3. Passenden Trailer in den Suchbereich fahren.
4. Prüfen, ob der Anschluss-HUD-Helfer angezeigt wird.
5. Schlauch verbinden und auf sichtbaren Schlauch, Hebel, T-Stück und Visuals achten.
6. Station zu Anhänger pumpen und prüfen, ob der Trailer gefüllt wird.
7. Pumprichtung wechseln und prüfen, ob Anhänger zu Station funktioniert.
8. Trailer-zu-Trailer verbinden, Pumprichtung wechseln und beide Richtungen testen.
9. Prüfen, ob unpassende Systeme abgelehnt werden, z.B. perrot an camLock.
10. Schlauchfarben prüfen: Perrot schwarz, CamLock blau.
11. settings.xml-Geschwindigkeiten testweise ändern und prüfen, ob Laden/Abladen pro Kupplungssystem angepasst wird.
12. Bei einem geeigneten Fahrzeug ohne festen Connector die Ingame-Konfiguration starten, Anschluss montieren, Savegame neu laden und Verbindung testen.
13. Im Savegame prüfen, ob lsfmHoseSystem.xml für selbst montierte Anschlüsse geschrieben wird.
14. Dedicated-Server/MP: selbst montierten Anschluss speichern, Server neu starten, Client neu verbinden und prüfen, ob der Anschluss geladen und sichtbar/benutzbar ist.
15. Bearbeitungsmodus eines selbst verbauten Anschlusses testen: verschieben, speichern, abbrechen und abbauen.
16. Bei einem normalen Traktor ohne passenden Flüssigkeits-FillType prüfen, dass Schlauchanschluss konfigurieren nicht erscheint.
17. Bei einem per XML gesperrten Fahrzeug mit allow="false" prüfen, dass die Konfiguration nicht angeboten wird.
18. Log erneut auf Fehler, Warnungen und unerwartete Einträge aus dem Schlauchscript prüfen.

Wartung und Regeln

• Vor Änderungen im installierten Modordner immer ein Backup anlegen.
• hoseStation.i3d nicht überschreiben.
• Manuelle Stationsnodes wie hoseConnector, lever und disconnectedHoseVisual erhalten.
• hoseStationMini.xml nicht auf alte Schlauchdurchmesser oder alte UV-Werte zurücksetzen.
• modDesc.xml nie blind überschreiben, weil neue Trailer/StoreItems dort manuell ergänzt werden.
• Debug-Schalter und globale Überladegeschwindigkeiten bevorzugt über settings.xml pflegen, nicht hart im Script ändern.
• Sichtbare Ingame-Texte neutral halten und nicht unnötig mit Modnamen versehen.
• Die manuelle Schlauch-Farbwahl nicht wieder einbauen; Perrot bleibt schwarz, CamLock blau.
• Keine Back-Connector-Sonderblockade und keine Back-Sondertoleranz wieder einbauen. Das wurde verworfen.
• Für Heckanschlüsse T-Stück am Trailer verwenden und linke/rechte Connectoren sauber getrennt mappen.
• Feste Connectoren bleiben für vorbereitete Fahrzeuge die sauberste Linie; der Runtime-Konfigurator ist der separate Nachrüstweg für geeignete oder explizit freigegebene Fahrzeuge.
• Connector-IDs in connectors.xml nach Savegame-Nutzung nicht umbenennen.
• Den Standard-FillType-Filter für den Konfigurator nicht um DIESEL oder DEF erweitern, solange Kraftstoffanschlüsse nicht als eigenes System behandelt werden.

Fehlersuche

Trailer wird nicht erkannt

• Ist requireTrailerConnectorNodes="true" gesetzt und hat der Trailer wirklich <lsfmHoseSystem>?
• Sind alle i3dMappings vorhanden?
• Passt hoseCouplingType zwischen Station und Trailer?
• Passt der FillType oder die FillTypeCategory der Station zur Trailer-FillUnit?
• Ist der Trailer innerhalb von searchRadius und Verbindungskorridor?

Schlauchanschluss konfigurieren erscheint nicht

• Der Spieler muss zu Fuß sein und nah genug am Fahrzeug stehen.
• Das Fahrzeug darf keinen festen vorbereiteten <lsfmHoseSystem>-Connector haben.
• Ohne XML-Override muss eine FillUnit einen passenden Flüssigkeits-FillType unterstützen.
• Erlaubte Standard-FillTypes sind WATER, MILK, LIQUIDFERTILIZER, HERBICIDE, LIQUIDMANURE und DIGESTATE.
• Für Spezialfälle <lsfmHoseConnectorConfigurator allow="true" /> setzen.
• Zum Sperren eines Fahrzeugs <lsfmHoseConnectorConfigurator allow="false" /> setzen.

Selbst verbauter Connector verbindet falsch

• In connectors.xml prüfen, ob connectorNodeName, couplerConnectionNodeName und targetNodeName auf die richtigen Nodes zeigen.
• targetNodeName ist die Hose-Endposition; connectionVisualNodeName ist nur das sichtbare Kupplungsteil.
• Bei Güllefässern mit vorhandener Optik mountedVisualVisibleAfterMount="false" verwenden, damit nur das Kupplungsteil beim Verbinden eingeblendet wird.
• Node-Namen in connectors.i3d eindeutig halten, keine doppelt benannten hoseNode- oder connectorNode-Kinder verwenden.

Selbst verbauter Connector wird nicht gespeichert oder geladen

• Nach dem Speichern prüfen, ob im Savegame lsfmHoseSystem.xml erzeugt wurde.
• Die Datei muss Fahrzeugblöcke mit uniqueId und mindestens einem connector enthalten.
• Auf Dedicated Servern nach Neustart zusätzlich mit neu verbundenem Client testen, weil die Connectoren über den Fahrzeug-Initialstream an Clients gesendet werden.
• Bei XML-Schema-Fehlern prüfen, ob die aktuelle Version von LSFMHoseConnectorConfigurator.lua mit dem Schema für lsfmHoseSystem.xml geladen ist.

Schlauch sieht falsch aus

• giantsHoseDiameter bestimmt den Durchmesser.
• giantsHoseUvScaleMultiplier beeinflusst die Rillen-/Texturstreckung.
• giantsHoseSagFactor, giantsHoseExtraLength und Straightening-Werte bestimmen Durchhang und Bogen.
• Bei Mini-Station auf die dünneren Werte achten.

Pumpen funktioniert nur in eine Richtung

• Pumprichtung prüfen: Station zu Anhänger, Anhänger zu Station oder aktiver Trailer zu gekoppeltem Trailer.
• Station muss den FillType annehmen können.
• Trailer-FillUnit muss Inhalt enthalten, wenn zurück zur Station gepumpt wird.
• Station/Ziel muss genügend freien Speicher oder passenden Trigger haben.
• Bei ungewohnter Geschwindigkeit die Werte in settings.xml für den jeweiligen Kupplungstyp prüfen.

Standard-Entladefunktion stört

• Bei aktiver Schlauchverbindung und Pumprichtung Station zu Anhänger sollte normales Abladen blockiert sein.
• Bei Pumprichtung Anhänger zu Station muss das Entladen zur Station weiterhin möglich bleiben.
• Discharge-Visuals und TipAnimation können je nach Fahrzeug zusätzlich über Fahrzeug-Spezialisierungen auftreten.

Debugging

Debug-Logging ist in der Release-Konfiguration abgeschaltet, damit die Log nicht durch Such-, Kompatibilitäts- und Transfermeldungen gefüllt wird. Für gezielte Fehlersuche können die Schalter in settings.xml getrennt aktiviert werden: trailerConnections für Trailer-zu-Trailer und Fahrzeug-Suchlogik, placeableStations für platzierbare Schlauchstationen. Bei Stationen kann zusätzlich debug="true" in der Station-XML genutzt werden.

Savegame-Verhalten

Die manuelle Schlauchfarbwahl ist entfernt. Die festen Standardfarben werden beim Laden aus dem jeweiligen Kupplungssystem abgeleitet: Perrot nutzt Schwarz, CamLock nutzt Blau.

Selbst verbaute Fahrzeuganschlüsse werden weiterhin im Vehicle-Savegameblock mitgeschrieben. Erfasst werden Connector-Typ, FillUnit, lokale Position, Rotation und Montagezustand.

<lsfmTrailerHose>
    <connectorConfigurations>
        <connector couplingType="camlock_var02"
                   fillUnitIndex="1"
                   translation="0 1 -2"
                   rotation="0 0 0"
                   mounted="true" />
    </connectorConfigurations>
</lsfmTrailerHose>

Zusätzlich schreibt der Mod eine eigene Datei im Savegame:

lsfmHoseSystem.xml

Diese Datei ordnet selbst montierte Anschlüsse über die stabile vehicle.uniqueId dem jeweiligen Fahrzeug zu. Das ist vor allem für Dedicated Server wichtig, weil die Runtime-Connectoren dort zuverlässig geladen werden müssen, auch wenn der normale Vehicle-Savepfad nicht ausreicht.

<lsfmHoseSystem>
    <connectorConfigurations>
        <vehicle uniqueId="vehicle-123" filename="...">
            <connector couplingType="camlock_var02"
                       fillUnitIndex="1"
                       translation="0 1 -2"
                       rotation="0 0 0"
                       mounted="true" />
        </vehicle>
    </connectorConfigurations>
</lsfmHoseSystem>

Lokalisierung

Texte für den Anschluss-Helfer und die Bedienung sollten über translations/l10n_de.xml und translations/l10n_en.xml gepflegt werden. Die sichtbaren Texte bleiben neutral, damit sie auch in anderen Modpacks nicht wie ein Fremdkörper wirken.

Wichtige l10n-Keys:

• ui_lsfmHoseConnectionAssistTitle
• ui_lsfmHoseConnectionAssistFits
• ui_lsfmHoseConnectionAssistFitsShort
• ui_lsfmHoseConnectionAssistMoveBack
• ui_lsfmHoseConnectionAssistMoveForward
• action_lsfmHoseConfigureConnector
• ui_lsfmHoseConnectorToolbarTitle
• ui_lsfmHoseConnectorTypeLabel
• action_lsfmHoseMountConnector
• action_lsfmHoseSaveConnector
• action_lsfmHoseRemoveConnector
• action_lsfmHoseConnectorCancel
• status_lsfmHoseConnectorConfigStarted
• status_lsfmHoseConnectorMounted
• status_lsfmHoseConnectorSaved
• status_lsfmHoseConnectorRemoved
• status_lsfmHoseConnectorEditStarted
• status_lsfmHoseConnectorEditCancelled
• status_lsfmHoseConnectorConfigCancelled

Kurzer Merksatz

Station definiert System, Schlauch und erlaubte Flüssigkeiten. Trailer definiert feste Anschlusspositionen oder gespeicherte Runtime-Anschlüsse, Visuals, Kupplungstyp und FillUnit. Nur wenn Flüssigkeit, Kupplung und Zielnode zusammenpassen, wird verbunden.

Stand: 07.06.2026. Diese Dokumentation beschreibt den aktuellen Arbeitsstand des FS25_lsfmHoseSystem-Mods.