w33zl / GE-Object-Distributor

At the heart of it, Object Distributor is a script for Giants Editor that will replace any number of objects with any custom object, similar to an advanced search and replace.

GE Object Distributor

At the heart of it, Object Distributor is a script for Giants Editor that will replace any number of objects with any custom object, similar to an advanced search and replace. The script can be used to place trees, light poles or other objects on a map. This is especially useful in combination with a random/procedurally generated collection of objects (destination markers).

The script gives control of the rotation and tilt of the replaced object and also support different kinds of randomization (e.g. rotation and angle of trees or placing rocks of different sizes).

Like the work I do?

I love to hear you feedback so please check out my Facebook. If you want to support me you can become my Patron or buy me a Ko-fi ❤️

Features

• Use tilt/angle/rotation from target or use random values (see settings)
• Random tilt/angle (X & Z axis)
• Fixed tilt/angle offset (X & Z axis)
• Random rotation (Y axis)
• Randomly choose source object from a collection of objects (e.g. different sized objects)

Installation

1. Download the latest release (zip archive)
2. Extract the contents to a temporary place
3. Copy the entire "WZL Object Distributor" folder to the "%LocalAppData%\GIANTS Editor 64bit 9.0.2\scripts\" folder (you might need to change the version number if using a different version of Giants Editor)
   • Optionally you could also drag-and-drop the "WZL Object Distributor" folder onto the supplied shortcut (only works if you are using version 9.0.2)
4. (Re)start Giants Editor

Prepare (getting started)

The script requires a node (transform group) with two child nodes ("source" and "target"). You can either set this up manually or use the supplied Configure Node script (recommended).

Please refer to the user guide for detailed explanation.

This is the expected node structure:

- "Main node"
  - source
    - (one or more sourece objects)
  - target
    - (one or more target objects/destination markers)

Note: The name of the main node doesn't matter, however "source" and "target" must have these exact names (unless specifically configured otherwise, see "Configure" section below) *

Automatically configure node via the script

If using the script the child nodes "source" and "target" will be automatically created along with different settings available.

This is the expected output after running the script:

Configure

After running the Configure Node script you should have a number of settings/configurations on your main node. These settings control the behaviour of the Distribute Objects script.

Usage (replace objects)

1. Add one (or more) source objects as childs to the "source" node
2. Add one (or more) target objects as childs to the "target" node
3. Select the main node
4. Execute Distribute Objects script.
5. Check the log for errors and warnings

Please refer to the user guide for more details.