GE10 Skript - Placeable XML Editor (Prefab*)

Mit diesem GIANTS-Editor-Skript lässt sich spielend einfach eine Placeable-XML erstellen und bearbeiten.
Das Skript erkennt automatisch die zugehörige placeable.xml, sofern sie sich im selben Ordner befindet und den gleichen Namen wie die .i3d-Datei trägt. Sind bereits Einträge vorhanden, werden alle unterstützten Parameter ausgelesen und im Tool zur Bearbeitung bereitgestellt.

Installation:
1.) Suchen Sie den Installationspfad des GIANTS Editors. Standardmäßig: "C:\Program Files\GIANTS Software\GIANTS_Editor_10.X.X\"
2.) Kopieren Sie das Skript "PlaceableXMLEditor.lua" und "iconBigDefault.png" aus dem Prefab in den Script-Ordner des GIANTS Editors.
3.) Das Skript steht anschließend im GIANTS Editor über die Menüleiste unter „Skripte“ zur Verfügung.

Verwendung:
1.) Starten Sie das Skript bei einem Objekt, das Sie als Placeable erstellen möchten.
2.) Das Skript erkennt automatisch, ob sich das Objekt innerhalb einer Mod befindet, und schaltet in diesem Fall den Tab „Add in modDesc.xml“ frei. Dort kann der Pfad zur modDesc.xml angegeben werden, um die Placeable-XML automatisch in die ModDesc einzutragen.
3.) Es ist möglich, Areas automatisch erstellen zu lassen. Legen Sie hierzu den Offset-Wert (in Metern) fest, wählen Sie das Objekt aus, von dem die Areas generiert werden sollen, und klicken Sie auf den entsprechenden Button.
4.) Stellen Sie anschließend alle gewünschten Parameter nach Ihren Anforderungen ein.
5.) Wählen Sie im Bereich „I3D Mappings“ die Nodes aus, die in den I3D-Mappings der XML gespeichert werden sollen. Bei Bedarf kann der Szenegraph über den „Aktualisieren“-Button neu eingelesen werden.
6.) Klicken Sie abschließend oben auf „GENERATE“ oder „UPDATE“, um die placeable.xml zu erstellen oder zu aktualisieren.

INFO:
Derzeit ist es noch nicht möglich, sämtliche Placeable-Spezialisierungen wie z. B. sellingStation, buyingStation, husbandries usw. direkt im Tool zu erstellen. Das Skript kann jedoch als Grundlage dienen, um eine XML zu erzeugen, in die Spezialisierungen nachträglich manuell ergänzt werden können.
Das PlaceableIcon wird aktuell leider nur angezeigt wenn es sich um eine .PNG handelt. .DDS wird vom Giants Editor in den Scripts (noch) nicht unterstützt!

Das Skript ändert ausschließlich Parameter, die auch im Tool konfigurierbar sind. Bereits vorhandene XML-Einträge, die nicht vom Skript unterstützt werden, bleiben vollständig erhalten und werden weder entfernt noch überschrieben.

Hotfix 20.02.2026:
- iconBigDefault.png hinzugefügt
- Pfad "PlaceableXMLEditor.PLACEABLE_ICON_EMPTY_PATH" angepasst
- Custom AreaNames werden im nächsten regulären Update möglich sein. Aktuell werden nur exakt diese Namen akzeptiert:
# testAreaStart01, testAreaEnd01
# clearAreaStart01, clearAreaWidth01, clearAreaHeight01
# levelAreaStart01, levelAreaWidth01, levelAreaHeight01
# indoorAreaStart01, indoorAreaWidth01, indoorAreaHeight01
# tipOcclusionUpdateAreaStart01, tipOcclusionUpdateAreaEnd01