1.0.0.0 GE10 Skript - TreeGenerator (Prefab*)

GE10 Skript - TreeGenerator (Prefab*)

Mit diesem praktischen Skript für den GIANTS Editor 10 lässt sich ein kompletter Wald automatisch erstellen.
Der Random Tree Generator bietet eine einfache Möglichkeit, Bäume aus einem vorhandenen Pool zufällig in
einer definierten Fläche zu platzieren – unter Berücksichtigung von Mindestabständen,
Terrain-Anpassung und zufälliger Rotation.

Das Tool erlaubt es, einen beliebigen Bereich (treeArea) als Waldfläche zu definieren und automatisch mit Bäumen aus einem treePool zu füllen.
Dabei können Dichte, Mindestabstand, Höhenanpassung und Rotation individuell eingestellt werden.

Ein besonderer Fokus liegt auf der Benutzerfreundlichkeit:
- Einfache Konfiguration über eine grafische Oberfläche
- Echtzeit-Fortschrittsanzeige während der Generierung
- Alle Bäume werden automatisch in einer Gruppe (autoForest_X) zusammengefasst
- Übersichtliche Statusmeldungen und Fehlerhinweise

Für maximale Kontrolle bietet das Skript zahlreiche Einstellungsmöglichkeiten:

Dichte (trees/m²):
Legt fest, wie viele Bäume pro Quadratmeter generiert werden. Höhere Werte erzeugen dichtere Wälder.

Mindestabstand (m):
Definiert den minimalen Abstand zwischen zwei Bäumen. Verhindert Überlappungen und sorgt für natürliche Verteilung.

Max Versuche pro Baum:
Gibt an, wie oft versucht wird, einen passenden Platz für einen Baum zu finden. Höhere Werte erhöhen die Erfolgschance bei dichten Wäldern.

Zufällige Rotation:
Aktiviert eine zufällige Drehung jedes Baumes um die eigene Achse. Sorgt für mehr Abwechslung.

An Terrain anpassen:
Passt die Höhe jedes Baumes automatisch an die Terrain-Oberfläche an. Verhindert schwebende oder im Boden versunkene Bäume.

Höhen-Offset (m):
Versetzt die Bäume vertikal. Positive Werte heben sie an, negative senken sie ab.

Das Tool richtet sich sowohl an Einsteiger als auch an erfahrene Modder und ermöglicht eine erhebliche Beschleunigung
beim Aufbau von Wäldern und Waldflächen auf eigenen Karten.

____________________________________________________

Installation:

1.) Navigieren Sie zum Installationsverzeichnis des GIANTS Editors.
Standardmäßig: "C:\Users\User\AppData\Local\GIANTS Editor 64bit 10.0.11+"

2.) Kopieren Sie die Datei "TreeGenerator.lua" in den Script-Ordner des GIANTS Editors.
"C:\Users\User\AppData\Local\GIANTS Editor 64bit 10.0.11+\scripts\"

3.) Das Skript steht anschließend im GIANTS Editor über die Menüleiste unter „Skripte“ zur Verfügung.

____________________________________________________

Vorbereitung der Szene:

Bevor Sie das Skript nutzen können, muss Ihre Szene folgende Struktur aufweisen:

Root
├── terrain
├── treeArea (TransformGroup mit Cubes oder anderem)
├── point1
├── point2
├── point3
└── point4 ...
└── treePool (TransformGroup mit Baum-Modellen)
├── treeOak01
├── treeSpruce01
├── treeBirch01
└── ...

Die treeArea definiert die Fläche, in der Bäume generiert werden. Jeder Cube dieser Gruppe repräsentiert einen Eckpunkt des Polygons.
Mindestens drei Punkte werden benötigt.

Der treePool enthält die Vorlage-Bäume, aus denen zufällig ausgewählt wird. Je mehr verschiedene Bäume, desto abwechslungsreicher wird der Wald.

____________________________________________________

Fehlerbehebung:

"treeArea not found!"
> Die TransformGroup "treeArea" existiert nicht in der Szene.

"treePool not found!"
> Die TransformGroup "treePool" existiert nicht in der Szene.

"No trees in treePool!"
> Der treePool enthält keine Baum-Modelle.

"treeArea needs at least 3 points!"
> Die treeArea enthält weniger als 3 Punkte.

"No trees generated!"
> Die Fläche ist zu klein oder die Dichte zu niedrig.