LS25 Tutorial

Hallo zusammen,

da aktuell viele konvertierte Mods über Bots auf den Seiten landen und im GIANTS-TestRunner durchfallen, hier eine kurze Anleitung zur Selbsthilfe, wie ihr die häufigsten Fehler in 2 Minuten selbst behebt:

1. Fehler: ModDescCheck / descVersion außerhalb des Bereichs

• Problem: Mod lädt nicht oder hat falsche Version.
• Lösung: Öffnet die modDesc.xml. Ändert ganz oben descVersion="..." auf 108 ab. Fügt <multiplayer supported="true"/> unter dem Author ein.

2. Fehler: Textfehler / Beschreibung enthält Tabulatoren

• Problem: Das Testtool bricht ab, weil Einrückungen mit der Tab-Taste gemacht wurden.
• Lösung: Sucht die betroffene Zeile in der modDesc.xml (z. B. beim Titel oder der Beschreibung). Löscht die unsichtbaren Leerzeichen am Zeilenanfang komplett und rückt sie stattdessen mit der normalen Leertaste ein. Nutzt für Beschreibungen immer das Format <de><![CDATA[ Hier dein Text ]]></de>.

3. Fehler: MipMapCheck (Fehlende Mipmaps / Texturflimmern)

• Problem: Texturen flimmern in der Distanz.
• Lösung: Öffnet die betroffene .dds-Datei im kostenlosen Programm Paint.NET. Drückt Speichern unter (Strg + Shift + S), überschreibt die Datei und setzt im nächsten Fenster zwingend den Haken bei „Mipmaps generieren“.

Mit diesen drei Schritten bekommt ihr fast jeden fehlerhaften Konvertierungs-Mod im TestRunner von Rot auf Grün!

🔴 Wenn der TestRunner sofort abbricht: Die "Showstopper" (XML-Tod & Syntax-Fehler)

Es gibt Fehler, die ignoriert das Spiel nicht mehr. Wenn eines der folgenden Probleme auftritt, bricht der TestRunner die Prüfung sofort mit einem Fehler ab, weil die Datei für die Engine nicht mehr lesbar ist.

1. Der XML-Tod (Ungültige Zeichen & fehlende End-Tags)

Eine XML-Datei (wie modDesc.xml oder die Fahrzeug-XML) funktioniert wie eine geöffnete Klammer: Jedes geöffnete Element muss wieder sauber geschlossen werden.

• Der Fehler: Der Modder schreibt <title><en>Mein Mod</en> und vergisst das schließende </title>. Oder er verwendet Sonderzeichen wie & (z.B. Verkauf & Einkauf) direkt im Text, ohne es als XML-Code zu maskieren.
• Das passiert beim Abbruch: Der TestRunner meldet einen Parse Error oder Syntax Error. Er kann die Datei nicht weiter einlesen und bricht den kompletten Test ab.
• Die Reparatur: Nutze ein Programm wie Notepad++. Wenn du dort eine XML öffnest, zeigt dir das Programm farbige Linien. Wenn eine Linie rot ist oder das Ende fehlt, repariere das Tag. Sonderzeichen im Text gehören zwingend in eine CDATA-Umgebung: <![CDATA[ Verkauf & Einkauf ]]>.

2. Der Bindestrich-Fluch in Dateinamen (Strenges LS25-Namensverbot)

Dies ist einer der häufigsten Gründe, warum Mods aus dem LS22 im neuen LS25 sofort komplett durchfallen.

• Der Fehler: Der Mod-Ordner oder Dateien im Mod enthalten Bindestriche (-), Umlaute (ä, ö, ü) oder Leerzeichen. (Beispiel: FS25_AMAZONE-6003 oder mein-trecker.xml).
• Das passiert beim Abbruch: Der TestRunner bricht sofort beim Laden der ZIP-Datei ab. Der LS25 erlaubt in Dateinamen und Ordnerstrukturen ausschließlich Kleinbuchstaben, Zahlen und Unterstriche (_). Bindestriche führen zum sofortigen Abbruch der Datenerfassung.
• Die Reparatur: Alle Bindestriche im Mod-Namen und in den darin liegenden Dateien konsequent durch Unterstriche _ ersetzen. Achtung: Wenn du eine Datei umbenennst (z.B. von mein-trecker.xml zu mein_trecker.xml), musst du diesen Pfad natürlich auch in der modDesc.xml anpassen!

3. Ungültige Anführungszeichen (Copy-Paste-Fehler)

Wenn Modder Texte aus dem Internet oder aus Word-Dokumenten in ihre XML-Dateien kopieren, schleppt das oft unsichtbare Formatierungsfehler ein.

• Der Fehler: Statt den geraden, XML-konformen Anführungszeichen "" rutschen durch Copy-Paste die typischen typografischen (schrägen) Anführungszeichen „“ oder “” in die Datei (z.B. title=„John Deere“).
• Das passiert beim Abbruch: Das Testtool erkennt das Attribut nicht mehr als Text an. Für die Engine ist die XML an dieser Stelle syntaktisch „tot“ – Abbruch wegen ungültigem Token.
• Die Reparatur: Lösche die schrägen Anführungszeichen im Texteditor heraus und tippe sie manuell über die Tastatur (Shift + 2) neu ein, damit sie absolut gerade sind.
• Tipp für Modder & Fehlersuche (KI als Helfer nutzen):
• Falls der GIANTS TestRunner bei euren Tests mal komplett abblockt oder ein dickes FEHLGESCHLAGEN ausspuckt, müsst ihr nicht verzweifeln oder den Mod direkt in die Tonne treten.
• Nutzt einfach eine KI zur Unterstützung!
• Wenn der TestRunner abbricht (z. B. durch stopTestOnParseError=true), kopiert einfach das komplette Log und füttert eine KI damit. Sie kann:
• Syntax-Fehler sofort aufspüren: Sie sagt euch auf die Spalte genau, wo ein unmaskiertes &, ein Umlaut oder eine fehlende Klammer (>) die XML zerschießt.
• Das XML-Schema auslesen: Sie erkennt sofort, welche neuen LS25-Elemente (wie z. B. fehlende Höhenangaben bei <size> oder das zwingend erforderliche <foliageBending>) dem TestRunner noch fehlen.
• Altlasten filtern: Sie zeigt euch genau, welche veralteten Zeilen (wie die alten Performance-Speicherpuffer *BufferMemoryUsage) gelöscht werden müssen.
• Das spart extrem viel Zeit beim Konvertieren und Optimieren. Probiert es beim nächsten roten Log einfach mal aus – es lohnt sich und bringt eure Mods schnell auf Platin-Zustand!

• ---

Tipp für Modder & Fehlersuche (KI als Helfer nutzen):

Falls der GIANTS TestRunner bei euren Tests mal komplett abblockt oder ein dickes FEHLGESCHLAGEN ausspuckt, müsst ihr nicht verzweifeln oder den Mod direkt in die Tonne treten.

Nutzt einfach eine KI zur Unterstützung!

Wenn der TestRunner abbricht (z. B. durch stopTestOnParseError=true), kopiert einfach das komplette Log und füttert eine KI damit. Sie kann:

• Syntax-Fehler sofort aufspüren: Sie sagt euch auf die Spalte genau, wo ein unmaskiertes &, ein Umlaut oder eine fehlende Klammer (>) die XML zerschießt.
• Das XML-Schema auslesen: Sie erkennt sofort, welche neuen LS25-Elemente (wie z. B. fehlende Höhenangaben bei <size> oder das zwingend erforderliche <foliageBending>) dem TestRunner noch fehlen.
• Altlasten filtern: Sie zeigt euch genau, welche veralteten Zeilen (wie die alten Performance-Speicherpuffer *BufferMemoryUsage) gelöscht werden müssen.

Das spart extrem viel Zeit beim Konvertieren und Optimieren. Probiert es beim nächsten roten Log einfach mal aus – es lohnt sich und bringt eure Mods schnell auf Platin-Zustand!