Add Incite Visual Scripting to applications by zedwick · Pull Request #120 · overte-org/community-apps

zedwick · 2026-04-29T12:49:57Z

Incite is the new virtual scripting language for Overte!

The aim of this project is to make it possible to build scripts from within Overte, in desktop or VR, which work in the client and on the domain server, either standalone or attached to entities.

You can create a graph and populate it with nodes, and when connected together they form a script.

This PR contains three projects in one:

Libincite
- A module which is designed to work independently of Overte, enabling other scripting interfaces to be implemented outside of Overte; for example a web UI.
- It is designed to function outside of Overte, but has only been tested with Node.js.
- It should be considered unsupported when used in projects outside of the Incite app, at-least until Incite exits beta.
Libtactile
- A complete 3D in-world UI framework for creating 3D user interfaces built out of Overte's entities.
- This module is designed as a generic Overte API so any script will be able to create UIs easily.
- Currently implements a renderer for rendering as 3D entities. However is designed to support custom renderers, for example a renderer for drawing as an image on a flat canvas entity is possible.
The Incite app
- When installed on the Overte Interface, this connects together the above modules with the Overte API to create graphs and renderer them in-world based on user interaction.

Current status:

Can create a fully executable graph from scripts
Can create an executable graph visually within Overte, including creating a graph, adding nodes and connecting outputs to inputs on nodes.
Can delete the graph.

Whilst this is still a work in progress, most of the core features of visual scripting are now in place. It still needs a lot of iterating, fine tuning, and expansion.

Usage:

Open the context menu
Select Create Graph
Open context menu and add nodes
Connect nodes by first clicking on the output (right, blue) port, then clicking on the input (left, green) port of the next node.
Once your script is complete, you can execute it from the context menu or with the keyboard shortcut ctrl+e.

Overte-Incite-Connecting_nodes-2026-10-11.webm

Future work:

Implement saving to both the client and domain server, depending on context where each graph will be used.
Allow freely moving nodes visually around the graph plane
UI art rework
animations in UI
Expanding nodes to cover the full Overte scripting API
Support moving nodes between multiple graphs
Node groups
Infinite more ideas

ada-tv

I know this is WIP, just some tips

In JSDoc, number, boolean, and string are lowercase. Capitalised Number, Boolean, and String are different types that are very rarely used. Object and Array<T> are capitalised.

* libtactile is a generic module for creating UIs in Overte * Tactile documents can be rendered in world as 3d entities * Tactile architecturally supports creating other types of renderers, for example rendering to a flat plane canvas entity or rendering to export as an image * InciteRezzer and GraphRez connect Incite graphs to Tactile rendering * Removes older InciteRenderer * tests for checking execution of incite graphs

Co-authored-by: Ada <ada+github@thingvellir.net>

zedwick

Thanks for the tips, Ada.

… Incite. * Improve cleanup when deleting a graph * Fixed ReferenceError regression when starting incite

* Fix element positioning * Tactile: Add TextElement element type

…during layout, use absolute coordinates in TactileRenderer

* Fix elements with no good candidate positions being rendered perfectly over the first element * Use element width/height when calculating overlap

…Layout

…nts; Incite nodes got styled

* Tactile: Adjust default alpha/zDepth values. * Tactile: Add new GridElement * Layouts and TactileDocuments are now invisible by default

…outs

* Make a connection by clicking on the output port of one and then the input port of another. * Add ColumnLayout, GridElement, LineElement, RowLayout, TactileStore, TactileDocumentManager

…ionally * No longer size children equally * GridLayout will expand to fit its given preferred size if the total size required by its children is smaller. * TactileElements are no longer grabbable.

…tar or local.

* Click the connected input port to remove the connection * Fix connection IDs in libincite * Render element removals in libtactile

Pure nodes are those whose output will never change when the input values do not change, and which have no side-effects. This will be used to avoid executing nodes which do not need to be re-executed.

* IDs must be unique across both input and output ports within the same node. * IDs must be a number * NOTE: IDs are not yet used.

* PortResult contains an output port's value and associated date * NodeResult contains the node's PortResults and other metadata * ExecutionFrame records the log of activity; NodeResults etc. * ExecuitionReel contains recent ExecutionFrames for debugging and playback

RTUnreal

Noticed this during some changes I wanted to do.

…in TactileRenderer

Incite orientation

some Incite fixes

Co-authored-by: Ada <ada+github@thingvellir.net>

Add Incite Visual Scripting to applications

673d1af

ada-tv reviewed Apr 29, 2026

View reviewed changes

zedwick and others added 6 commits May 28, 2026 14:29

Apply suggestions from code review

2f015fd

Co-authored-by: Ada <ada+github@thingvellir.net>

Incite: Update comments in Node.js

3b3753b

camel-case properties and JSDoc improvements

9ca7404

Incite: Improve Signal JSDocs

0a22e70

Incite: Unbreak tests after broken tests were used to test

7b40081

zedwick commented May 29, 2026

View reviewed changes

Comment thread applications/incite/libincite/Signal.js Outdated

Comment thread applications/incite/incite_app.js Outdated

Comment thread applications/incite/libincite/Nodes/Node.js

Comment thread applications/incite/libincite/Signal.js

Comment thread applications/incite/libincite/Graph.js

zedwick added 11 commits May 29, 2026 22:20

Incite: Introduce FloatingLayout to Tactile, used to render graphs in…

64589ef

… Incite. * Improve cleanup when deleting a graph * Fixed ReferenceError regression when starting incite

Incite: label rendered nodes

d1d2106

* Fix element positioning * Tactile: Add TextElement element type

Incite/Tactile: Set correct relative coordinates for TactileElements …

19eb227

…during layout, use absolute coordinates in TactileRenderer

Incite: Render FloatingLayout with margins

432bed8

* Fix elements with no good candidate positions being rendered perfectly over the first element * Use element width/height when calculating overlap

Incite/Tactile: Include margins when measuring the size of a Floating…

248e590

…Layout

Incite WIP; Column/Row layouts for Tactile, support for styling eleme…

de2b1ce

…nts; Incite nodes got styled

Incite: Improved depth/offset rendering of Tactile elements.

bd681f6

Incite: Add Grid as graph plane

82143db

* Tactile: Adjust default alpha/zDepth values. * Tactile: Add new GridElement * Layouts and TactileDocuments are now invisible by default

Incite: Display correct number of ports on nodes, improvements to lay…

94a6a02

…outs

Allow making connections between nodes

eede0cd

* Make a connection by clicking on the output port of one and then the input port of another. * Add ColumnLayout, GridElement, LineElement, RowLayout, TactileStore, TactileDocumentManager

Incite: Tactile: rerender when element color changes.

a1831d1

zedwick force-pushed the incite branch from a4e9146 to a1831d1 Compare June 19, 2026 23:12

zedwick added 9 commits July 2, 2026 20:34

Incite;Tactile: Size child elements of Row and Column layouts proport…

4fde75d

…ionally * No longer size children equally * GridLayout will expand to fit its given preferred size if the total size required by its children is smaller. * TactileElements are no longer grabbable.

Incite/Tactile: Add ButtonElement

e1a4457

Slight Refactor

d19e3ed

Incite: Allow executing from context menu

c150c5e

Incite: Number node should output a number

60ebe06

Incite: Execute graph on Ctrl+e

d55ba5c

Allow setting which context to render tactileelements in; domain, ava…

f92cea6

…tar or local.

Incite: Delete connection from the UI.

2cae0d6

* Click the connected input port to remove the connection * Fix connection IDs in libincite * Render element removals in libtactile

Incite: Mark nodes as pure

a378676

Pure nodes are those whose output will never change when the input values do not change, and which have no side-effects. This will be used to avoid executing nodes which do not need to be re-executed.

zedwick added 3 commits August 21, 2026 17:31

Incite: Nodes should have unique IDs per port

0d56983

* IDs must be unique across both input and output ports within the same node. * IDs must be a number * NOTE: IDs are not yet used.

Incite: Use port IDs and validate port data

8fade39

RTUnreal reviewed Oct 5, 2026

View reviewed changes

Comment thread applications/incite/libtactile/renderer/TactileRenderer.js Outdated

RTUnreal and others added 19 commits October 7, 2026 10:49

incite: normalize orientation naming and fix orientation calculation …

9dcbba2

…in TactileRenderer

incite: make some slight ux improvements and add orientations

d1c1b4e

Merge pull request #1 from RTUnreal/incite_orientation

7b67c82

Incite orientation

Document NodePort

a55f948

Document Node class

d0de302

Document NodeResult class

045ef79

Document PortResult class

51069af

incite: change names for result creation

ff1f897

incite: fix incorrect naming

4fef5a3

Merge pull request #2 from RTUnreal/incite_fixes

4658df9

some Incite fixes

Incite: Document libincite/NodeRegistry class

c15aae3

Document InciteStore class and incite module

42cf969

Document GraphManager class

5680bc3

Document GraphBuilder class

6787c84

Document GraphBuilder class

942c72d

Documentation improvements

e76ef50

Improve documentation for type definitions on Graph class

a98475b

Update applications/incite/NodeRenderer.js

450b517

Co-authored-by: Ada <ada+github@thingvellir.net>

Disable Incite in More app

650e09c

zedwick marked this pull request as ready for review October 9, 2026 22:15

RTUnreal approved these changes Oct 9, 2026

View reviewed changes

Replace @return with @returns in Incite

4275acc

RTUnreal approved these changes Oct 9, 2026

View reviewed changes

zedwick added CR approved QA approved This pull request has been successfully tested labels Oct 9, 2026

zedwick merged commit bd08fc4 into overte-org:master Oct 9, 2026

Navigation Menu

Repository navigation

Add Incite Visual Scripting to applications - #120

Add Incite Visual Scripting to applications#120
zedwick merged 51 commits into
overte-org:masterfrom
zedwick:incite

zedwick commented Apr 29, 2026 •

edited

Loading

Uh oh!

ada-tv left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

zedwick left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

RTUnreal left a comment

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

zedwick commented Apr 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ada-tv left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

zedwick left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

RTUnreal left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

zedwick commented Apr 29, 2026 •

edited

Loading