com.unity.visualscripting@1.9.8

## [1.9.8] - 2025-06-11
### Fixed
- Fixed broken links to example codes in API documentation.

### Changed
- Adds alt texts to images in documentation to increase accessibility for screen readers.

Author: Unity Technologies

.signature

@@ -1 +1 @@
-{"timestamp":1747865871,"signature":"mBIRiZRXPBhykSglYyzFwsI6OCI5oqOICtBP5AHRLgfLGxPQlN+S/ZUfgd4tM15jf4oX367vLLWS1rjPQ01rHMTYr93Awangu9qR3OhJS+PUSIEu7ZDNLe15kCuW+Akz4mzXugk6MJU5rMZBXReppJwJHXcGRO/AYG2ujpGPvWxCBtd38EX0cC1j8BjrMPMFEDXZ5KyD8JC4EH1KQuFEpp+wtDpq+2h/MgCzW8yAcu6TlWNStNQk9Fyo2ePABrwYmT3BYa5lkadCEiOHB4axpatLvK4ZDELa6RuL1IZ1jbaz/vIO7yTxq5L5L7wNYFYg+IhBTmG4w5Nf2soOswNm5rSjsv+OD1e7/KhZi4M83HmfuENthrbwZwUBj1iKMof3L9kku52vuzaMjMfhEFjUCau3RhQCFLLo1SHMb94+pDgVDeHlIHjmg/NXhY6afILzSmIEhLBstTh2x6IWHohCzwgl+dZyWPgjT8OtftEn35L1KJ5WOYKIrazMITrpV/dO","publicKey":"LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQm9qQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FZOEFNSUlCaWdLQ0FZRUFzdUhXYUhsZ0I1cVF4ZEJjTlJKSAordHR4SmoxcVY1NTdvMlZaRE1XaXhYRVBkRTBEMVFkT1JIRXNSS1RscmplUXlERU83ZlNQS0ZwZ1A3MU5TTnJCCkFHM2NFSU45aHNQVDhOVmllZmdWem5QTkVMenFkVmdEbFhpb2VpUnV6OERKWFgvblpmU1JWKytwbk9ySTRibG4KS0twelJlNW14OTc1SjhxZ1FvRktKT0NNRlpHdkJMR2MxSzZZaEIzOHJFODZCZzgzbUovWjBEYkVmQjBxZm13cgo2ZDVFUXFsd0E5Y3JZT1YyV1VpWXprSnBLNmJZNzRZNmM1TmpBcEFKeGNiaTFOaDlRVEhUcU44N0ZtMDF0R1ZwCjVNd1pXSWZuYVRUemEvTGZLelR5U0pka0tldEZMVGdkYXpMYlpzUEE2aHBSK0FJRTJhc0tLTi84UUk1N3UzU2cKL2xyMnZKS1IvU2l5eEN1Q20vQWJkYnJMbXk0WjlSdm1jMGdpclA4T0lLQWxBRWZ2TzV5Z2hSKy8vd1RpTFlzUQp1SllDM0V2UE16ZGdKUzdGR2FscnFLZzlPTCsxVzROY05yNWdveVdSUUJ0cktKaWlTZEJVWmVxb0RvSUY5NHpCCndGbzJJT1JFdXFqcU51M3diMWZIM3p1dGdtalFra3IxVjJhd3hmcExLWlROQWdNQkFBRT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg"}
+{"timestamp":1749648028,"signature":"mnnweiePmYjCbJ2e26d//lo8MdKcDA5qU9aA0npSHKh8RUpfaW0Bf24OV+IW8rLxTN263CMeIKQK6+OJev6kTfAY8f5NEj8dSqtxwobXQ+eahGO+RtSM4ZzdfDz79qpH4L6rlI7CLF0lCnx+IAIBtdJRMehdbbms1bV615I5ClaIGaFgJ0U6mXwNPk+KmszZfLM4C+lm3NjVTmYmi6JK5M4KDIqUXiIHTRb06KfM6ZzYA+4XOlKhv9Yhxj0EPmdPrkcrNTQ2N51Tm8+VfLaytL1VjgLQYskQ3SaZ0uDXoPeJPzvqn4WrUFcxnv4AtBZscyJc/Jf5iptTqmrBoPyGphoXLnRQZ/nb92l9EDJ2tdgKbmJaf3l9rSvAMZWZHR6+BBcwyvwI3iSDvq/Dx4g7Z6/8f8b9OKzvEs52e39DKNF9sRH4OmxTe+/sxZwNKmsBkWz3+zzSQAuL0DgMVpNP8ZkSaN5lcn/FcVY3j9ZXtwWxtOBDkH+slRDYpVD4atG/","publicKey":"LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQm9qQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FZOEFNSUlCaWdLQ0FZRUFzdUhXYUhsZ0I1cVF4ZEJjTlJKSAordHR4SmoxcVY1NTdvMlZaRE1XaXhYRVBkRTBEMVFkT1JIRXNSS1RscmplUXlERU83ZlNQS0ZwZ1A3MU5TTnJCCkFHM2NFSU45aHNQVDhOVmllZmdWem5QTkVMenFkVmdEbFhpb2VpUnV6OERKWFgvblpmU1JWKytwbk9ySTRibG4KS0twelJlNW14OTc1SjhxZ1FvRktKT0NNRlpHdkJMR2MxSzZZaEIzOHJFODZCZzgzbUovWjBEYkVmQjBxZm13cgo2ZDVFUXFsd0E5Y3JZT1YyV1VpWXprSnBLNmJZNzRZNmM1TmpBcEFKeGNiaTFOaDlRVEhUcU44N0ZtMDF0R1ZwCjVNd1pXSWZuYVRUemEvTGZLelR5U0pka0tldEZMVGdkYXpMYlpzUEE2aHBSK0FJRTJhc0tLTi84UUk1N3UzU2cKL2xyMnZKS1IvU2l5eEN1Q20vQWJkYnJMbXk0WjlSdm1jMGdpclA4T0lLQWxBRWZ2TzV5Z2hSKy8vd1RpTFlzUQp1SllDM0V2UE16ZGdKUzdGR2FscnFLZzlPTCsxVzROY05yNWdveVdSUUJ0cktKaWlTZEJVWmVxb0RvSUY5NHpCCndGbzJJT1JFdXFqcU51M3diMWZIM3p1dGdtalFra3IxVjJhd3hmcExLWlROQWdNQkFBRT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg"}

CHANGELOG.md

@@ -2,6 +2,13 @@
 All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 
+## [1.9.8] - 2025-06-11
+### Fixed
+- Fixed broken links to example codes in API documentation.
+
+### Changed
+- Adds alt texts to images in documentation to increase accessibility for screen readers.
+
 ## [1.9.7] - 2025-05-22
 ### Fixed
 - Fixed a warning "Unable to load Unity.Android.Gradle's referenced assembly NiceIO" when scanning assemblies. [UVSB-2594](https://issuetracker.unity3d.com/product/unity/issues/guid/UVSB-2594)

DocCodeExamples.meta

@@ -0,0 +1,90 @@
+using System;
+using Unity.VisualScripting;
+using UnityEngine;
+
+class EventBusExamples
+{
+    #region CheatCodeController
+    public class CheatCodeController : MonoBehaviour
+    {
+        public const string CheatCodeActivated = "CheatCodeActivated";
+
+        static readonly KeyCode[] famousCheatCode = {
+            KeyCode.UpArrow,
+            KeyCode.UpArrow,
+            KeyCode.DownArrow,
+            KeyCode.DownArrow,
+            KeyCode.LeftArrow,
+            KeyCode.RightArrow,
+            KeyCode.LeftArrow,
+            KeyCode.RightArrow,
+            KeyCode.B,
+            KeyCode.A
+        };
+
+        int index;
+        EventHook cheatCodeHook;
+        Action<EmptyEventArgs> godModeDelegate;
+
+        // A GameObject with a ScriptMachine that holds a graph with a
+        // CheatCodeEnabled Event Node.
+        public GameObject player;
+
+        void Start()
+        {
+            // Hold a reference to the EventHook and the Delegate for the
+            // EventBus.Unregister call in the OnDestroy method.
+            cheatCodeHook = new EventHook(CheatCodeActivated);
+            godModeDelegate = _ => EnableGodMode();
+
+            EventBus.Register(cheatCodeHook, godModeDelegate);
+        }
+
+        void Update()
+        {
+            if (Input.anyKeyDown)
+            {
+                if (Input.GetKeyDown(famousCheatCode[index]))
+                {
+                    index++;
+                }
+                else
+                {
+                    index = 0;
+                }
+
+                if (index >= famousCheatCode.Length)
+                {
+                    // Triggers the EnableGodMode delegate
+                    EventBus.Trigger(CheatCodeActivated);
+
+                    // Triggers the CheatCodeEnabled Visual Scripting Node
+                    EventBus.Trigger(new EventHook(
+                        CheatCodeActivated,
+                        player.GetComponent<ScriptMachine>()));
+
+                    index = 0;
+                }
+            }
+        }
+
+        void OnDestroy()
+        {
+            EventBus.Unregister(cheatCodeHook, godModeDelegate);
+        }
+
+        void EnableGodMode()
+        {
+            Debug.Log("Cheat code has been entered. Enabling god mode.");
+        }
+    }
+    #endregion
+
+    #region CheatCodeEnabled
+    [UnitTitle("On Cheat Code Enabled")]
+    public sealed class CheatCodeEnabled : MachineEventUnit<EmptyEventArgs>
+    {
+        protected override string hookName => CheatCodeController.CheatCodeActivated;
+    }
+    #endregion
+}

DocCodeExamples/EventBusExamples.cs

@@ -0,0 +1,18 @@
+{
+    "name": "Unity.VisualScripting.DocCodeExamples",
+    "rootNamespace": "",
+    "references": [
+        "Unity.VisualScripting.Core",
+        "Unity.VisualScripting.Tests.Editor",
+        "Unity.VisualScripting.Flow"
+    ],
+    "includePlatforms": [],
+    "excludePlatforms": [],
+    "allowUnsafeCode": false,
+    "overrideReferences": true,
+    "precompiledReferences": [],
+    "autoReferenced": false,
+    "defineConstraints": [],
+    "versionDefines": [],
+    "noEngineReferences": false
+}

DocCodeExamples/EventBusExamples.cs.meta

@@ -0,0 +1,25 @@
+using Unity.VisualScripting;
+using UnityEngine;
+
+class VariableExamples
+{
+    #region PlayerController
+    public class PlayerController : MonoBehaviour
+    {
+        VariableDeclaration m_Velocity;
+        void Start()
+        {
+            var variables = GetComponent<Variables>();
+            m_Velocity = variables.declarations.GetDeclaration("velocity");
+        }
+        void Update()
+        {
+            if (Input.GetKeyDown("space"))
+            {
+                var currentVelocity = (float)m_Velocity.value;
+                m_Velocity.value = currentVelocity * 2f;
+            }
+        }
+    }
+    #endregion
+}

DocCodeExamples/Unity.VisualScripting.DocCodeExamples.asmdef

@@ -12,19 +12,19 @@ Branching nodes split the control flow based on a value.
 ### If
 The common if node uses a boolean condition. Consider them as an "if the condition is true, do something, otherwise, do something else."
 
-![](images/vs-control-if-control-node.png)
+![An If node, with True and False branches.](images/vs-control-if-control-node.png)
 
 ### Switch
 
 Branch on the value of an enum, a string, or an integer. These nodes are called Switch nodes.
 
 To switch on an enum, decide on the type of the enum. The branch output ports appears.
 
-![](images/vs-control-switch-enum-control-node.png)
+![A Switch node branching based on an enum value.](images/vs-control-switch-enum-control-node.png)
 
-To switch on a string or number, create each branch option in the graph inspector.
+To switch on a string or number, create each branch option in the Graph Inspector.
 
-![](images/vs-control-switch-string-control-node.png)
+![A Switch node branching based on string values.](images/vs-control-switch-string-control-node.png)
 
 The node is updated with each output port.
 
@@ -40,7 +40,7 @@ Select nodes are the opposite of switch nodes. You can select a single value fro
 For example, a Select On Integer node that chooses a color based on a player number.
 
 
-![](images/vs-control-select-control-node.png)
+![A Select node outputs a color based on player number input.](images/vs-control-select-control-node.png)
 
 >[!NOTE]
 > In the above example predictive debugging warns of a crash if playerNo is not within 1, 2, 3, or 4, because the Default port is not connected.
@@ -60,7 +60,7 @@ The while loop is the simplest form of loop. It repeats its body while its condi
 
 For example, the following graph generates a new random name until the result isn't contained in the names application variable.
 
-![](images/vs-control-while-loop-node.png)
+![The While Loop runs until the Get Variable's list of names and the Set Variable new name don't match.](images/vs-control-while-loop-node.png)
 
 > [!WARNING]
 > Do not create an infinite loop. If the condition is always true, the editor hangs. As loop bodies are synchronous, not parallel, there are few uses for while loops in visual scripting.
@@ -76,7 +76,7 @@ For example, the following graph outputs four messages to the console:
 *   *I love my bird*
 *   *I love my fish*
 
-![](images/vs-control-for-each-loop-node.png)
+![A For Each Loop node iterates the strings from the List node and prints each one to the console.](images/vs-control-for-each-loop-node.png)
 
 To access the key and value from dictionaries in the loop, check the Dictionary box.
 
@@ -86,7 +86,7 @@ For is a numeric loop and requires three integers: a start index, an end index,
 
 For example, this graph counts to ten by skipping odd numbers because of its step. In other words, its output is 0, 2, 4, 6, then 8.
 
-![](images/vs-control-for-loop-node.png)
+![A For Loop node's First value is 0, its Last value is 10, and moves in steps of 2.](images/vs-control-for-loop-node.png)
 
 The For loop can also be very useful when combined with the Get List Item and Count Items nodes.
 
@@ -99,15 +99,15 @@ Instead of using the For Each node that outputs each item, the graph outputs eac
 *   *I like birds*
 *   *I like horses*
 
-![](images/vs-control-for-loop-node-get-count-list-items-node.png)
+![A For Loop prints to console from a list by stepping along the list's index.](images/vs-control-for-loop-node-get-count-list-items-node.png)
 
 ### Break Loop
 
 A loop can finish early by using the Break Loop node. As soon as this node is entered, the exit port of the loop is called, no matter how many more iterations remain.
 
 For example, even though this for loop is supposed to count to 10, it stops at 5 because of the break. Its output is 0, 1, 2, 3, then 4.
 
-![](images/vs-control-break-loop-node.png)
+![A Break Loop node terminating a For Loop node before completion.](images/vs-control-break-loop-node.png)
 
 ## Exception Handling
 
@@ -117,7 +117,7 @@ The Try Catch node handles [Exceptions](https://docs.microsoft.com/en-us/dotnet/
 
 Anything that gets executed in the Try branch is considered "safe": the script continues from the Catch branch instead if it fails. The Exception port captures information about the failure when that happens. A common way of handling this is to log a warning with the exception message.
 
-![](images/vs-control-try-catch-node.png)
+![A Try Catch node outputs a log if an exception happens.](images/vs-control-try-catch-node.png)
 
 > [!NOTE] 
 > By default, this node catches all exceptions. Be specific in your handling by changing the exception type in the dropdown.
@@ -132,7 +132,7 @@ It is good practice to "fail early" by throwing as soon as something unexpected
 
 For example, to ensure damage is positive before applying it:
 
-![](images/vs-control-throw-node.png)
+![A Throw node checks a condition before allowing the flow to continue.](images/vs-control-throw-node.png)
 
 If the Custom checkbox is selected, you can pass a custom Exception object that contains more data than a simple message. Most often, this is not required. By default, the thrown exception is of type `System.Exception`.
 
@@ -164,28 +164,28 @@ Another way of implementing the same logic as the previous example: clicking Spa
 > [!NOTE]
 > Turn on relations in the toolbar as a means to visualize the flow between the toggle ports.
 
-![](images/vs-control-toggle-flow-value-node.png)
+![A Toggle Flow node starts on, and the same input can turn it on or off, depending on its current state.](images/vs-control-toggle-flow-value-node.png)
 
 ## Once
 
 The Once node executes different logic the first time it is traversed from any subsequent times. 
 
-![](images/vs-control-once-node.png)
+![A Once node sends a different string to the console depending on whether this is the first time the node is traversed.](images/vs-control-once-node.png)
 
 It can be reset by entering the Reset port.
 
 ## Cache
 
-The Cache node saves the result of an expensive operating and reuses it instead of fetching it again each time you need it.
+The Cache node saves the result of an expensive operation and reuses it instead of fetching it again each time you need it.
 
 For example, using this graph, the formula is calculated twice:
 
-![](images/vs-control-cache-node-example.png)
+![A graph that calculates the same formula each time an update event runs.](images/vs-control-cache-node-example.png)
 
 By using the Cache node, the result is saved and calculated only once, optimizing performance.
 
 
-![](images/vs-control-cache-node.png)
+![A graph that checks the cache before running the formula. If the cache has a value, the formula isn't calculated.](images/vs-control-cache-node.png)
 
 > [!NOTE] 
 > It is important to note that caching only lasts within the scope of the current flow. The value of the cache is not shared or available from another event.