GE10 Script - SplineToolkit

The SplineToolkit is a comprehensive GIANTS Editor script that consolidates a wide range of spline-related tools into one package. Almost all functions offer a real-time preview directly in the editor viewport.

Base Tools

The Base Tools form the foundation of the toolkit, providing essential tools for spline and terrain editing. Spline points can be projected directly onto the terrain, shifted vertically or horizontally, and the terrain height can be precisely matched to the spline. Additionally, terrain textures and foliage can be painted along a spline, and the Resample Spline function allows for adjusting the number of control points as needed.

Place Objects

The Place Objects feature allows for flexible placement of objects along a spline or distribution across a defined area. Placement can be done sequentially in the order of the SourceObjects or randomly from the available selection. A wide range of parameters such as distance, height type, rotation, and offset provide precise control over the result.

Place Fence

Place Fence enables the fast and structured creation of fence systems along a spline, with a clear list of base game fences including preview images. Fences can be imported directly, and animated gates can be positioned using a slider. The animation data is automatically written to the configuration file, ensuring gates work correctly in-game via a trigger. A built-in XML viewer and the "Validate Fences" function allow for full verification of all entries for errors and inconsistencies.

Export as .OBJ

The export tool allows splines to be exported as .OBJ files using two different methods, optimizing the workflow between GIANTS Editor and Blender. Additional parameters control the density and format of the exported points.

Generate Street

The road generator allows for the creation of complete road meshes directly inside the GIANTS Editor, including correct UVs and a selection of base game road textures. A real-time preview displays the result immediately in the viewport before the mesh is finalized. Matching traffic splines can optionally be generated automatically.

Installation

1. Navigate to the GIANTS Editor AppData path. Default: "C:\Users\[USER]\AppData\Local\GIANTS Editor 64bit 10.0.XX\scripts\"
2. Copy the file "SplineToolkit.lua" and the folder "imgFence"/"imgRoads" from the prefab into the Script folder of the GIANTS Editor.
3. The script will then be available in the GIANTS Editor via the menu bar under “Scripts”.

Hotfix Update 2.0.1

• [Base Tools] = Clear Foliage now correctly clears all foliage layers.
• [Base Tools] = Set Terrain Height: Fixed spike/gap artifacts.
• [Base Tools] = Set Terrain Height: Configurable pixel resolution via SplineToolkit.TERRAIN_METER_PER_PIXEL_LOAD_FROM_MAP and SplineToolkit.TERRAIN_METER_PER_PIXEL_CUSTOM.

Update 2.0

• [General] = A real-time preview has been integrated directly into the editor for nearly all tools.
• [General] = Various minor bug fixes and general code optimizations applied.
• [Base Tools] = SetTerrainHeight now reads the map's pixel grid to ensure improved height adjustment when using a non-default map configuration.
• [Place Objects] = Area mode completely rebuilt; the previous width algorithm has been removed and replaced with a significantly more precise approach.
• [Place Objects] = Simplified UI: Two modes (Straight / Area) via radio buttons; Sequential vs. Random placement as a dedicated selection option.
• [Place Fence] = Fences can now be imported directly, including automatic transfer of all animation data into the configuration file.
• [Place Fence] = Gates can be positioned along the spline via a slider and are automatically registered as AnimatedObjects, allowing them to open normally via a trigger in-game.
• [Place Fence] = Added per-gate status indicator and a built-in XML viewer/editor with "Validate Fences" function for full verification of all fence and gate entries.
• [Place Fence] = Fence groups are now identified via UserAttributes instead of fixed names, making the structure more robust.
• [Gen. Street] = Fixed an issue where UV wrapping exceeded the maximum possible tile count.
• [Gen. Street] = Road mesh generation reworked and optimized.
• [Gen. Street] = Real-time preview of the generated road integrated directly into the editor.

Update 1.1.1

• [Base Tools] = Added a Clear Foliage button and removed the option from the foliage layer list.
• [Base Tools] = Fixed an issue with Clear Foliage where an incorrect invisible layer was applied.
• [Place Object] = Added Place Type "... with Width". Allows objects to be placed randomly within a defined width.
• [Place Object] = Added Set Height Type "... + Follow Axis". Allows connected objects to be placed almost seamlessly, even on uneven terrain.
• [Gen. Street] = Added four additional textures to the list.
• [Gen. Street] = Added a confirmation dialog when overwriting an existing road group.

Update 1.1

• [Base Tools] = UI slightly improved and new functions "Set Foliage" and "Resample Spline" added.
• [Gen. Street] = Added texture options.
• [Place Fence] = 'Spline Type' selection removed - now automatically read from the spline.

Hotfix 1.0.1

• Fix: [Place Fence] - Fences are now placed at terrain height instead of spline height.
• Fix: [Place Object] - Side offset now works correctly.