https://github.com/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.
https://github.com/w33zl/ge-object-distributor
farming-simulator fs22 giants-editor lua modding mods
Last synced: 2 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/w33zl/ge-object-distributor
- Owner: w33zl
- Created: 2022-02-27T09:55:39.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-08-07T12:40:52.000Z (almost 2 years ago)
- Last Synced: 2025-04-09T23:55:44.313Z (2 months ago)
- Topics: farming-simulator, fs22, giants-editor, lua, modding, mods
- Homepage:
- Size: 1.76 MB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# 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](https://www.facebook.com/w33zl). If you want to support me you can become my [Patron](https://www.patreon.com/wzlmodding) or buy me a [Ko-fi](https://ko-fi.com/w33zl) :heart:
[](https://ko-fi.com/X8X0BB65P) [](https://patreon.com/wzlmodding?)
## 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](https://github.com/w33zl/GE-Object-Distributor/releases/download/v0.9.3-beta/GE_Object_Distributor_v0.9.3beta.zip) (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](UserGuide.pdf) 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.
[](https://user-images.githubusercontent.com/7383510/155886155-06960e07-97cc-4f29-99a6-a7c666f1512d.png)
This is the expected output after running the script:
[](https://user-images.githubusercontent.com/7383510/155886191-02ee1173-9856-4077-a12c-39628c475059.png)
### 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.
[](https://user-images.githubusercontent.com/7383510/155885817-5b571e68-5280-4692-bc9d-f6e099cd0d2a.png)
## 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
[](https://user-images.githubusercontent.com/7383510/155886264-90170bf3-77a3-4f93-8b11-e7fffaf338f0.png)
Please refer to the [user guide](UserGuide.pdf) for more details.