Log inGet started
World

Builtin Library

Branchmain
Branchesmainpublish
Commita26cdab9a3

README.md

procgen.adjust

Changes a live generator in place: the entity's Generator component takes new values for the graph's inputs, or another output, and cooks again where it stands. It is the live-entity counterpart of procgen.tweak, which pictures a graph without touching the scene, and the call to reach for while iterating on something procgen.spawn stood in the scene.

  • entity names the entity carrying the Generator, by id or name.
  • params is merged into the generator's current param overrides: each key overrides the graph input of the same name, and the keys it leaves out keep the values they had.
  • output names a declared output of the graph; the generator then plays the part of the graph that output depends on (Generator.output).

The change queues a cook on the generator's runner and the call returns at once, so a heavy graph goes on cooking across frames after it answers: procgen.cooks and procgen.generators show its progress, and procgen.cancel stops it.

tools.use("procgen", "adjust", { entity = "Box", params = { width = 3 } })

Part of procgen.toolbox, called as tools.use("procgen", "adjust", ...) (zero procgen adjust in the engine shell). Returns { entity, params, output, cooking }: the entity's id, the param overrides it now holds, its selected output (empty for none), and whether its cook was still in flight when the call returned.