CustomGenerator

========================================================================

Object Controller - User Manual

========================================================================

Version: v3. 1. 0

Author: expzzzz

Platform: BepInEx 5.x

Plugin GUID: com.dynroot.tree

------------------------------------------------------------------------

1. Overview

------------------------------------------------------------------------

This is a server-side plugin for multiplayer that spawns and drives

in-game objects based on an editable node tree. You can manually

place objects, generate large batches from text or images, brush

objects directly with your mouse, and make objects loop along a path

with custom rotations.

Spawning and driving only happen when you are the server and the game

world is generated. In single-player, no objects are spawned.

------------------------------------------------------------------------

------------------------------------------------------------------------

These keys work anywhere in the game. They can be changed in the

Settings tab.

F5          Spawn / Apply

Edit tab: apply current parameters to selected nodes

Print tab: start printing

F9          Toggle panel (show / hide the whole window)

F7          Clock pause / resume (works on all tabs except Settings)

F8          Cancel task

If printing, cancel it; otherwise clear the task state

[          Step clock back one frame (1/60 second)

]          Step clock forward one frame (1/60 second)

Backspace  Reset clock

Clock = 0, all node offsets and pause states cleared

Arrow keys, Q, E are used for fine-tuning nodes (see Edit tab).

They do not work while a text field has focus.

On the Settings tab, only F9 is captured; other hotkeys are passed

through to the game.

------------------------------------------------------------------------

3. Interface Overview

------------------------------------------------------------------------

Press F9 to open the window. It has four regions:

· Top: three tab buttons (Edit / Print / Settings); right side shows

clock status and loop toggle

· Left: tree panel, containing (top to bottom): World tree,

Staging tree, Tree operations, Time control, Print control

· Right: contents of the current tab, scrollable

· Bottom status bar: current task, world object count, selected

------------------------------------------------------------------------

4. Nodes and Trees

------------------------------------------------------------------------

4. 1 Two Trees

World tree: objects here are actually spawned and driven in-game.

Each node represents an object or a group.

Staging tree: nothing is spawned. It is a template repository for

saving your structures. Copy nodes from the world

tree to save them here; move them back when needed.

4. 2 Node Types

Every node has one of two types:

· Group node (empty prefab): does not spawn anything, only used to

organize children. Can hold any children.

· Leaf node (non-empty prefab): spawns the corresponding object.

Cannot hold children.

4. 3 Tree Panel Operations

Click              select node

Ctrl + click      add / remove from selection

Shift + click      range select (from last anchor to current,

requires same parent)

Double-click      select node and all its children

Click ▾ / ▸        collapse / expand children

Badges that may appear after a node name:

⏸        node is paused (time frozen)

node is not driven, fully controlled by game physics

node will not respawn after being destroyed

prefab name inside square brackets

4. 4 Node Properties

Name            Display name, also used in spawned object names

Prefab          Object type to spawn; empty means group node

Pos sequence    List of position keyframes

Rot sequence    List of rotation keyframes

Pivot          Rotation axis point (local coordinates)

Offset          Time offset relative to the global clock

X/Y Scale      Object scale; parent scale multiplies to children