Added Label property to Ports.

Forge/Statescript/Node.cs

@@ -226,13 +226,15 @@ internal virtual void Update(double deltaTime, GraphContext graphContext)
 	/// </summary>
 	/// <typeparam name="T">The type of port to create.</typeparam>
 	/// <param name="index">The index of the port.</param>
+	/// <param name="label">The editor-facing label for the port.</param>
 	/// <returns>The created port.</returns>
-	protected static T CreatePort<T>(byte index)
+	protected static T CreatePort<T>(byte index, string label = "")
 		where T : Port, new()
 	{
 		return new T
 		{
 			Index = index,
+			Label = label,
 		};
 	}
 

Forge/Statescript/Nodes/ActionNode.cs

@@ -40,8 +40,8 @@ internal override IEnumerable<int> GetReachableOutputPorts(byte inputPortIndex)
 	/// <inheritdoc/>
 	protected override void DefinePorts(List<InputPort> inputPorts, List<OutputPort> outputPorts)
 	{
-		inputPorts.Add(CreatePort<InputPort>(InputPort));
-		outputPorts.Add(CreatePort<EventPort>(OutputPort));
+		inputPorts.Add(CreatePort<InputPort>(InputPort, "Execute"));
+		outputPorts.Add(CreatePort<EventPort>(OutputPort, "Done"));
 	}
 
 	/// <inheritdoc/>

Forge/Statescript/Nodes/ConditionNode.cs

@@ -47,9 +47,9 @@ internal override IEnumerable<int> GetReachableOutputPorts(byte inputPortIndex)
 	/// <inheritdoc/>
 	protected override void DefinePorts(List<InputPort> inputPorts, List<OutputPort> outputPorts)
 	{
-		inputPorts.Add(CreatePort<InputPort>(InputPort));
-		outputPorts.Add(CreatePort<EventPort>(TruePort));
-		outputPorts.Add(CreatePort<EventPort>(FalsePort));
+		inputPorts.Add(CreatePort<InputPort>(InputPort, "Condition"));
+		outputPorts.Add(CreatePort<EventPort>(TruePort, "True"));
+		outputPorts.Add(CreatePort<EventPort>(FalsePort, "False"));
 	}
 
 	/// <inheritdoc/>

Forge/Statescript/Nodes/EntryNode.cs

@@ -45,7 +45,7 @@ internal override IEnumerable<int> GetReachableOutputPorts(byte inputPortIndex)
 	/// <inheritdoc/>
 	protected override void DefinePorts(List<InputPort> inputPorts, List<OutputPort> outputPorts)
 	{
-		outputPorts.Add(CreatePort<SubgraphPort>(OutputPort));
+		outputPorts.Add(CreatePort<SubgraphPort>(OutputPort, "Start"));
 	}
 
 	/// <inheritdoc/>

Forge/Statescript/Nodes/ExitNode.cs

@@ -31,7 +31,7 @@ internal override IEnumerable<int> GetReachableOutputPorts(byte inputPortIndex)
 	/// <inheritdoc/>
 	protected override void DefinePorts(List<InputPort> inputPorts, List<OutputPort> outputPorts)
 	{
-		inputPorts.Add(CreatePort<InputPort>(InputPort));
+		inputPorts.Add(CreatePort<InputPort>(InputPort, "Stop"));
 	}
 
 	/// <inheritdoc/>

Forge/Statescript/Nodes/State/EffectNode.cs

@@ -52,7 +52,7 @@ public class EffectNode : StateNode<EffectNodeContext>
 	protected override void DefinePorts(List<InputPort> inputPorts, List<OutputPort> outputPorts)
 	{
 		base.DefinePorts(inputPorts, outputPorts);
-		outputPorts.Add(CreatePort<EventPort>(OnEffectEndPort));
+		outputPorts.Add(CreatePort<EventPort>(OnEffectEndPort, "OnEffectEnd"));
 	}
 
 	/// <inheritdoc/>

Forge/Statescript/Nodes/State/TimerNode.cs

@@ -35,7 +35,7 @@ public class TimerNode : StateNode<TimerNodeContext>
 	protected override void DefinePorts(List<InputPort> inputPorts, List<OutputPort> outputPorts)
 	{
 		base.DefinePorts(inputPorts, outputPorts);
-		outputPorts.Add(CreatePort<EventPort>(OnTimerEndPort));
+		outputPorts.Add(CreatePort<EventPort>(OnTimerEndPort, "OnTimerEnd"));
 	}
 
 	/// <inheritdoc/>

Forge/Statescript/Nodes/StateNode.cs

@@ -134,12 +134,12 @@ protected virtual void OnUpdate(double deltaTime, GraphContext graphContext)
 	/// <inheritdoc/>
 	protected override void DefinePorts(List<InputPort> inputPorts, List<OutputPort> outputPorts)
 	{
-		inputPorts.Add(CreatePort<InputPort>(InputPort));
-		inputPorts.Add(CreatePort<InputPort>(AbortPort));
-		outputPorts.Add(CreatePort<EventPort>(OnActivatePort));
-		outputPorts.Add(CreatePort<EventPort>(OnDeactivatePort));
-		outputPorts.Add(CreatePort<EventPort>(OnAbortPort));
-		outputPorts.Add(CreatePort<SubgraphPort>(SubgraphPort));
+		inputPorts.Add(CreatePort<InputPort>(InputPort, "Begin"));
+		inputPorts.Add(CreatePort<InputPort>(AbortPort, "Abort"));
+		outputPorts.Add(CreatePort<EventPort>(OnActivatePort, "OnActivate"));
+		outputPorts.Add(CreatePort<EventPort>(OnDeactivatePort, "OnDeactivate"));
+		outputPorts.Add(CreatePort<EventPort>(OnAbortPort, "OnAbort"));
+		outputPorts.Add(CreatePort<SubgraphPort>(SubgraphPort, "Subgraph"));
 	}
 
 	/// <inheritdoc/>

Forge/Statescript/Port.cs

@@ -16,4 +16,9 @@ public abstract class Port
 	/// Gets or sets the index of this port.
 	/// </summary>
 	public byte Index { get; set; }
+
+	/// <summary>
+	/// Gets or sets the editor-facing label for this port.
+	/// </summary>
+	public string Label { get; set; } = string.Empty;
 }

docs/statescript/nodes/README.md

@@ -75,6 +75,12 @@ Carries **both** regular messages and disable-subgraph signals. Used by the Entr
 
 Receives messages from connected output ports and notifies the owning node.
 
+## Port Labels
+
+Port labels are defined by the runtime node, not by editor-specific discovery code. Built-in nodes already provide labels for their standard ports automatically.
+
+If a custom node adds extra flow ports, create them with `CreatePort<T>(index, "Label")` so editor integrations can surface the intended port name consistently without plugin-specific hard-coding.
+
 ## Graph Construction
 
 Nodes are added to a graph with `AddNode()` and wired together with `AddConnection()`:

docs/statescript/nodes/state/README.md

@@ -78,6 +78,18 @@ public class WaitForTagNode : StateNode<WaitForTagNodeContext>
 
 Use `DeactivateNode(graphContext)` for simple deactivation, or `DeactivateNodeAndEmitMessage(graphContext, portIds)` to emit custom event port messages before deactivation.
 
+If your state node defines additional event or subgraph ports, override `DefinePorts`, call `base.DefinePorts(...)`, and create each custom port with an explicit label:
+
+```csharp
+protected override void DefinePorts(List<InputPort> inputPorts, List<OutputPort> outputPorts)
+{
+    base.DefinePorts(inputPorts, outputPorts);
+    outputPorts.Add(CreatePort<EventPort>(OnFinishedPort, "OnFinished"));
+}
+```
+
+That label becomes the canonical port name surfaced by editor integrations such as Forge for Godot.
+
 ## Built-in State Nodes
 
 | Node | Description |

docs/statescript/subgraphs.md

@@ -150,6 +150,8 @@ Entry → TimerA(10s)
 
 Custom state nodes can define additional Subgraph ports and control them independently while the node remains active. This is one of the most powerful patterns in Statescript.
 
+When defining extra Event or Subgraph ports for these nodes, assign explicit labels with `CreatePort<T>(index, "Label")`. Editor integrations use those runtime labels when rendering custom ports.
+
 For example, a combat stance node could have two Subgraph ports, one for each stance. While active, the node switches between stances by disabling one subgraph and activating the other:
 
 ```

docs/statescript/templates/action-node-template.md

@@ -19,6 +19,8 @@
 |-------|------|------|-------------|
 | 0 | Output | Event | Emits after execution. |
 
+> Port names should match the labels defined in code via `CreatePort<T>(index, "Label")`.
+
 ## Parameters
 
 **Input Properties:**

docs/statescript/templates/condition-node-template.md

@@ -20,6 +20,8 @@
 | 0 | True | Event | Emits if the test returns `true`. |
 | 1 | False | Event | Emits if the test returns `false`. |
 
+> Port names should match the labels defined in code via `CreatePort<T>(index, "Label")`.
+
 ## Parameters
 
 **Input Properties:**

docs/statescript/templates/state-node-template.md

@@ -26,6 +26,7 @@
 | {4+} | {Custom} | {Event or Subgraph} | {Description of additional ports.} |
 
 > Remove the custom port rows if the node defines no additional ports beyond the standard four.
+> Port names should match the labels defined in code via `CreatePort<T>(index, "Label")`.
 
 ## Parameters