Class AIBehaviorNode

Namespace

FishMMO.Shared

Assembly

FishMMO.Shared.dll

Abstract base class for all behavior tree nodes. Nodes are ScriptableObject assets so designers can build trees entirely in the Unity inspector without code.

Behavior trees sit above the state machine layer and decide which BaseAIState the NPC should transition to. The state machine then handles the actual movement, combat, and animation logic.

Node types:

• AISelector — Tries children left-to-right, returns first success.
• AISequence — Runs children left-to-right, fails on first failure.
• AIInverter — Inverts the child's result.
• AIRepeater — Repeats the child a configurable number of times.
• AIConditionNode — Leaf that checks an AIAbilityCondition.
• AIStateTransitionNode — Leaf that transitions to a BaseAIState.

public abstract class AIBehaviorNode : ScriptableObject

Inheritance

object

Object

ScriptableObject

AIBehaviorNode

Derived

AIAdoptGroupTargetNode

AICompositeNode

AIConditionNode

AIGroupInCombatNode

AIHasTargetNode

AIInverter

AIIsDeadNode

AIRepeater

AIStateTransitionNode

Inherited Members

ScriptableObject.SetDirty()

ScriptableObject.CreateInstance(string)

ScriptableObject.CreateInstance(Type)

ScriptableObject.CreateInstance<T>()

Object.GetEntityId()

Object.GetInstanceID()

Object.GetHashCode()

Object.Equals(object)

Object.InstantiateAsync<T>(T)

Object.InstantiateAsync<T>(T, Transform)

Object.InstantiateAsync<T>(T, Vector3, Quaternion)

Object.InstantiateAsync<T>(T, Transform, Vector3, Quaternion)

Object.InstantiateAsync<T>(T, int)

Object.InstantiateAsync<T>(T, int, Transform)

Object.InstantiateAsync<T>(T, int, Vector3, Quaternion)

Object.InstantiateAsync<T>(T, int, ReadOnlySpan<Vector3>, ReadOnlySpan<Quaternion>)

Object.InstantiateAsync<T>(T, int, Transform, Vector3, Quaternion)

Object.InstantiateAsync<T>(T, int, Transform, Vector3, Quaternion, CancellationToken)

Object.InstantiateAsync<T>(T, int, Transform, ReadOnlySpan<Vector3>, ReadOnlySpan<Quaternion>)

Object.InstantiateAsync<T>(T, int, Transform, ReadOnlySpan<Vector3>, ReadOnlySpan<Quaternion>, CancellationToken)

Object.InstantiateAsync<T>(T, InstantiateParameters, CancellationToken)

Object.InstantiateAsync<T>(T, int, InstantiateParameters, CancellationToken)

Object.InstantiateAsync<T>(T, Vector3, Quaternion, InstantiateParameters, CancellationToken)

Object.InstantiateAsync<T>(T, int, Vector3, Quaternion, InstantiateParameters, CancellationToken)

Object.InstantiateAsync<T>(T, int, ReadOnlySpan<Vector3>, ReadOnlySpan<Quaternion>, InstantiateParameters, CancellationToken)

Object.Instantiate(Object, Vector3, Quaternion)

Object.Instantiate(Object, Vector3, Quaternion, Transform)

Object.Instantiate(Object)

Object.Instantiate(Object, Scene)

Object.Instantiate<T>(T, InstantiateParameters)

Object.Instantiate<T>(T, Vector3, Quaternion, InstantiateParameters)

Object.Instantiate(Object, Transform)

Object.Instantiate(Object, Transform, bool)

Object.Instantiate<T>(T)

Object.Instantiate<T>(T, Vector3, Quaternion)

Object.Instantiate<T>(T, Vector3, Quaternion, Transform)

Object.Instantiate<T>(T, Transform)

Object.Instantiate<T>(T, Transform, bool)

Object.Destroy(Object, float)

Object.Destroy(Object)

Object.DestroyImmediate(Object, bool)

Object.DestroyImmediate(Object)

Object.FindObjectsOfType(Type)

Object.FindObjectsOfType(Type, bool)

Object.FindObjectsByType(Type, FindObjectsSortMode)

Object.FindObjectsByType(Type, FindObjectsInactive, FindObjectsSortMode)

Object.FindObjectsByType(Type)

Object.FindObjectsByType(Type, FindObjectsInactive)

Object.DontDestroyOnLoad(Object)

Object.DestroyObject(Object, float)

Object.DestroyObject(Object)

Object.FindSceneObjectsOfType(Type)

Object.FindObjectsOfTypeIncludingAssets(Type)

Object.FindObjectsOfType<T>()

Object.FindObjectsByType<T>(FindObjectsSortMode)

Object.FindObjectsOfType<T>(bool)

Object.FindObjectsByType<T>(FindObjectsInactive, FindObjectsSortMode)

Object.FindObjectOfType<T>()

Object.FindObjectOfType<T>(bool)

Object.FindFirstObjectByType<T>()

Object.FindAnyObjectByType<T>()

Object.FindFirstObjectByType<T>(FindObjectsInactive)

Object.FindAnyObjectByType<T>(FindObjectsInactive)

Object.FindObjectsByType<T>()

Object.FindObjectsByType<T>(FindObjectsInactive)

Object.FindObjectsOfTypeAll(Type)

Object.FindObjectOfType(Type)

Object.FindFirstObjectByType(Type)

Object.FindAnyObjectByType(Type)

Object.FindObjectOfType(Type, bool)

Object.FindFirstObjectByType(Type, FindObjectsInactive)

Object.FindAnyObjectByType(Type, FindObjectsInactive)

Object.ToString()

Object.name

Object.hideFlags

object.Equals(object, object)

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

Fields

EditorComment

[TextArea(1, 3)]
[Tooltip("Designer note — has no runtime effect.")]
public string EditorComment

Field Value

string

EditorPosition

[HideInInspector]
public Vector2 EditorPosition

Field Value

Vector2

MAX_EVALUATION_DEPTH

Maximum node depth a tree may descend to in one evaluation.

public const int MAX_EVALUATION_DEPTH = 64

Field Value

int

Remarks

Generous enough that no sane hand-authored tree reaches it, small enough that hitting it costs nothing. A tree deeper than this is a cycle, not a design.

Properties

DepthExceeded

True when the evaluation in progress has descended past MAX_EVALUATION_DEPTH, which means the tree contains a cycle.

public static bool DepthExceeded { get; }

Property Value

bool

Methods

Ascend()

Leaves a child node.

protected static void Ascend()

BeginEvaluation()

Resets the depth counter at the start of a tree evaluation.

public static void BeginEvaluation()

EndEvaluation()

Clears evaluation state once a tree evaluation finishes.

public static void EndEvaluation()

Evaluate(AIController)

Evaluate this node for the given NPC. Called once per behavior tree tick (not every frame).

public abstract AINodeResult Evaluate(AIController controller)

Parameters

controller AIController

The AI controller of the evaluating NPC.

Returns

AINodeResult

The result of this node's evaluation.

EvaluateChild(AIBehaviorNode, AIController)

Evaluates a child node with depth accounting.

protected static AINodeResult EvaluateChild(AIBehaviorNode child, AIController controller)

Parameters

child AIBehaviorNode

The child to evaluate. Null returns Failure.

controller AIController

The AI controller of the evaluating NPC.

Returns

AINodeResult

The child's result, or Failure when the depth limit was hit.

TryDescend()

Enters a child node, refusing to descend when the depth limit has been reached.

protected static bool TryDescend()

Returns

bool

True when it is safe to descend.

Remarks

Composite and decorator nodes call this before evaluating a child. Returning false turns a cyclic tree into a failed evaluation — the NPC falls back to its state machine — instead of a stack overflow that takes the server process down with it.