Singularity/Library/PackageCache/com.unity.visualscripting@1.../Documentation~/vs-live-edit-runtime.md
2024-05-06 11:45:45 -07:00

42 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Live edit during runtime
Live editing in visual scripting goes beyond adjusting values in real-time. Live editing also includes the ability to add and remove nodes as well as connectors; you can code while the game is playing and immediately affect the gameplay.
Remember that:
- Changes you make to embed graphs are **reverted** when you exit play mode; they live inside components.
- Changes you make to graphs are **saved** when you exit play mode; they live inside assets.
- Graph variables are saved when not in an embed graph.
- The following variables are not saved:
- Object
- Scene
- App
- Saved
> [!NOTE]
> If youve used an embed graph and do not want to lose your modifications, copy all the changes you made to the embed graph before exiting Play mode. Paste them back in when in edit mode. You cant do this for any changed variables.
As a visual aid, connectors in Live mode display their execution flow with animated directional droplets going in the direction of execution. The speed and number of droplets does not represent the frequency or speed of execution.
## To adjust the graph during runtime
With a graph open do any or all of the following:
- In the Inspector, click in any field to change a components value. The values are not persistent and wont save when you leave Play mode.
- Right-click in an empty spot in the graph and add a node.
- Connect nodes.
- Delete any connectors.
- Add an extension.
- Add and link Debug nodes.
- Change values directly in a node.
> [!TIP]
> Select any GameObject that contains a script graph to see and work with the values of the selected GameObject during runtime.
> [!NOTE]
> When you modify anything after a Start event during runtime you wont get the update on the GameObject during that session. You need to restart the session for Unity to execute the new logic after the start event.
The changes you make to a graph are instantly shared across all instances of that saved graph asset.