Skip to content

v5.0.0

Latest
Latest

Choose a tag to compare

View all tags
@S2NX7 S2NX7 released this 09 Mar 13:31
· 19 commits to master since this release
5.0.0
8e14f53
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

I’m not completely certain whether jumping straight to 5.x.x is ideal, but I decided to continue the versioning scheme that was previously used here.

To make it easier to ask questions, get help, or share suggestions, a Discord server has been created for the project.

Feel free to join the community here:

Discord Banner

This release mainly focuses on improving the Visual Scripting editor UI and workflow.

Note

You can find the options for these in Edit > Preferences > Visual Scripting > Customisation.

Vertical Flow

This enables you to have vertical graphs with a more compact node style.
image

Warning

To avoid introducing dependencies such as Harmony, this implementation replaces some Unit Widgets internally.

If you use custom widgets, enabling New Unit UI in Edit > Preferences > Visual Scripting > Customisation may break them.

To fix this:

  • Inherit from the Community Addons Unit Widget instead of the default Visual Scripting widget.

If you do not use custom widgets, you can enable this feature without issues.

Portal Connections

Portal connections allow you to visually hide value connections to reduce spaghetti graphs.

How to use

  1. Hold Alt while creating a value connection.
  2. Once the connection is completed, it automatically becomes a Portal Connection.

Alternatively:

  • Add a ValueReroute node
  • Enable "Enable Portal" in the Graph Inspector
  • Connect the input and it will convert into a Portal Connection.

Note

This only works with Value Reroutes you cannot do it with Flow Reroutes.

image

New Unit Style

Adds an optional simplified node style, inspired by the look of Bolt 2.

image

New Toolbar Style

Adds an alternative toolbar layout closer to the Bolt 2 UI.

When enabled:

  • Toolbar buttons float above the canvas
  • The breadcrumb navigation style is restored
  • A search bar is added

The search bar uses the same system as the Node Finder, meaning it supports both simple and advanced search queries.

Currently the search mode (Contains / Starts With) is not configurable.

image

Graph Minimap

Adds a minimap to help navigate large graphs.

The minimap displays:

  • All graph elements
  • Their positions
  • Their colours

You can also click elements in the minimap to jump directly to them in the graph.

Note

On very large graphs the minimap may have a impact on editor performance.

image

New Variable UI

You can enable the New Variable UI which draws the Variables as Foldouts allowing you to minimize them. You can also Enable the variable Quickbar which creates a variable of that type by just clicking the button you can also right click for a list of that type, Its a helpful shortcut.

The "Other" option opens the Type Builder, which supports creating many types including arrays and generics.

Generics are not officially supported by Visual Scripting, so extra care may be required on AOT platforms.

image

New Collections UI

Lists and Dictionaries have been given a similar UI to the Variables which you can toggle on and off. With the collection items it does try to display helpful info as the header for the item so it's easier to keep track of each value.

image

Added Inspectors

Added inspectors for Vector 2 int and Vector 3 int.

Variable Renaming Improvements

Renaming a variable in the Variables tab now attempts to automatically rename all matching variables across:

  • Graph
  • Scene
  • Project

(depending on the variable scope).

Note

Only variables without a connected Name input will be renamed.
If the name input is connected (including literals), it will not be modified.

You can also:

  • Select a variable unit
  • Press F2
  • Rename that variable everywhere it appears.
Rename.Example.mp4

Improved Flow Value Info

Hovering over flow values now displays more contextual information.

Examples:

  • Hovering over a Color value shows the actual color.
  • For custom classes, the system attempts to display useful fields in the tooltip.

Additional Context Options

When New Unit UI is enabled:

  • Selection → Subgraph options are available directly in the Unit context menu.

A Find option is also available in the context menu, which opens the Node Finder and searches for matching:

  • Variable Units
  • Trigger Custom Event
  • Custom Event
  • Nester Units (Subgraph / State)

Code Generation Improvements

Several improvements were made to the C# preview and code generation system.

Changes

  • Graph variables now appear as private fields in the preview

    • During compilation they remain public but hidden, ensuring compatibility with machine variable nodes.

  • The generation system was rewritten to use a CodeWriter class instead of returning raw strings.

  • Clicking code in the preview now highlights the entire block generated by a unit, instead of separate fragments.

  • Editor performance for the C# preview has been improved.

Project Structure Improvements

The internal file structure of the project has been reorganized to improve clarity.

Files have been moved into more relevant folders so that related functionality is grouped together. This should make the codebase easier to navigate.

Note

This change does not affect functionality.

Assets 2
Loading