Index of every page on this site: llms.txt
All skills
jame581 avatar

/limboai

@426e8ab
by Jan Mesarčjame581/godotprompter979 stars
63
Run it yourself

Use when using the LimboAI addon — behavior trees and hierarchical state machines (C++ GDExtension) with a visual editor, BTTask subclassing, and a blackboard

Use this Skill: https://skilld.dev/gh/jame581/godotprompter/limboai

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referenceshsm.md

≈1.5k tokens on demand. Your agent reads this file only when SKILL.md points to it.

LimboAI — Advanced HSM Patterns

Deep-dive reference for LimboHSM + LimboState + BTState. Load when you need any-state transitions, guard callables, nested HSMs, or HSM + BT bridging via BTState.


Any-state transitions

Use hsm.ANYSTATE as from_state to define a transition that fires from any active state:

GDScript

# From any state, dispatch "stunned" → go to StunnedState
hsm.add_transition(hsm.ANYSTATE, stunned_state, &"stunned")
hsm.add_transition(hsm.ANYSTATE, dead_state, &"died")

C#

_hsm.AddTransition(_hsm.ANYSTATE, _stunnedState, "stunned");
_hsm.AddTransition(_hsm.ANYSTATE, _deadState, "died");

Guard callables

A guard prevents a transition from firing unless the callable returns true:

GDScript

func _has_enough_health() -> bool:
    return agent.health > 0.0

func _ready() -> void:
    hsm.add_transition(idle_state, move_state, &"movement_started",
        _has_enough_health)

C#

private bool HasEnoughHealth() => _agent.Health > 0f;

public override void _Ready()
{
    _hsm.AddTransition(_idle, _move, "movement_started",
        Callable.From(HasEnoughHealth));
}

Fluent (single-file) setup

Create states programmatically without scene-tree nodes — useful for procedural or data-driven characters:

GDScript

func _init_hsm() -> void:
    var hsm := LimboHSM.new()
    add_child(hsm)

    var idle := LimboState.new().named("Idle") \
        .call_on_enter(func(): $AnimationPlayer.play("idle")) \
        .call_on_update(_idle_update)
    var move := LimboState.new().named("Move") \
        .call_on_enter(func(): $AnimationPlayer.play("walk")) \
        .call_on_update(_move_update)

    hsm.add_child(idle)
    hsm.add_child(move)
    hsm.add_transition(idle, move, &"movement_started")
    hsm.add_transition(move, idle, &"movement_ended")
    hsm.initialize(self)
    hsm.set_active(true)

C#

// The chained builders (Named(), CallOnEnter(), CallOnUpdate()) are bound methods, so the
// module build's C# API has them too; this version sets Name and connects the signals directly.
private void InitHsm()
{
    var hsm = new LimboHsm(); // C# name of LimboHSM
    AddChild(hsm);

    var idle = new LimboState { Name = "Idle" };
    idle.Connect(LimboState.SignalName.Entered,
        Callable.From(() => GetNode<AnimationPlayer>("AnimationPlayer").Play("idle")));
    idle.Connect(LimboState.SignalName.Updated,
        Callable.From((double d) => IdleUpdate(d)));

    var move = new LimboState { Name = "Move" };
    move.Connect(LimboState.SignalName.Entered,
        Callable.From(() => GetNode<AnimationPlayer>("AnimationPlayer").Play("walk")));
    move.Connect(LimboState.SignalName.Updated,
        Callable.From((double d) => MoveUpdate(d)));

    hsm.AddChild(idle);
    hsm.AddChild(move);
    hsm.AddTransition(idle, move, "movement_started");
    hsm.AddTransition(move, idle, "movement_ended");
    hsm.Initialize(this);
    hsm.SetActive(true);
}

Nested HSMs

A LimboHSM that is a direct child of another LimboHSM is a sub-state: the parent drives it. A LimboHSM under a plain LimboState (or any non-HSM parent) is its own root — you call initialize() and set_active(true) on it yourself (works from v1.8.1; v1.8.0 failed with "initialize() must be called on the root HSM").

GDScript

var combat := LimboHSM.new()          # sub-state of the main HSM
combat.add_child(LimboState.new().named("Melee"))
hsm.add_child(combat)
hsm.add_transition(idle, combat, &"enemy_seen")

var wrapper := LimboState.new()       # plain state, so this HSM is a separate root
var aim_hsm := LimboHSM.new()
hsm.add_child(wrapper)
wrapper.add_child(aim_hsm)
# ... add aim_hsm's states and transitions, then:
aim_hsm.initialize(self)
aim_hsm.set_active(true)

C#

var combat = new LimboHsm();          // sub-state of the main HSM
combat.AddChild(new LimboState { Name = "Melee" });
hsm.AddChild(combat);
hsm.AddTransition(idle, combat, "enemy_seen");

var wrapper = new LimboState();       // plain state, so this HSM is a separate root
var aimHsm = new LimboHsm();
hsm.AddChild(wrapper);
wrapper.AddChild(aimHsm);
// ... add aimHsm's states and transitions, then:
aimHsm.Initialize(this);
aimHsm.SetActive(true);

BTState — bridging HSM and behavior trees

BTState is a LimboState that runs a BehaviorTree resource. When the BT returns SUCCESS it dispatches success_event; on FAILURE it dispatches failure_event. Use it to embed a BT inside an HSM state slot:

GDScript

func _ready() -> void:
    var hsm := LimboHSM.new()
    add_child(hsm)

    var patrol := BTState.new()
    patrol.behavior_tree = preload("res://ai/trees/patrol.tres")
    patrol.set_scene_root_hint(self)  # call before initialize()
    # patrol.success_event = &"patrol_done"  # default is &"success"

    hsm.add_child(patrol)
    hsm.initial_state = patrol
    hsm.initialize(self)
    hsm.set_active(true)

C#

public override void _Ready()
{
    var hsm = new LimboHsm();
    AddChild(hsm);

    var patrol = new BTState();
    patrol.BehaviorTree = GD.Load<BehaviorTree>("res://ai/trees/patrol.tres");
    patrol.SetSceneRootHint(this);  // call before Initialize()

    hsm.AddChild(patrol);
    hsm.InitialState = patrol;
    hsm.Initialize(this);
    hsm.SetActive(true);
}

Dispatching events

Any state or external code can dispatch events. Events propagate from the leaf state up to the root:

GDScript

# From inside a LimboState subclass:
dispatch(EVENT_FINISHED)           # use per-state shorthand
dispatch(&"stunned", damage_info)  # named event with cargo

# From outside (e.g. the agent script):
hsm.dispatch(&"player_spotted")

C#

// From inside a LimboState subclass:
Dispatch(EVENTFINISHED);
Dispatch("stunned", damageInfo);

// From outside:
_hsm.Dispatch("player_spotted");

dispatch() returns true if an event was consumed by a transition. Unhandled events are silently ignored.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning6d3 checks · Risk SAFE
  • Gen Agent Trust Hub7d

    This skill provides documentation and implementation examples for the LimboAI Godot addon. It covers behavior trees, blackboard variables, and hierarchical state machines with both GDScript and C# examples. All external links and download instructions refer to the official and legitimate project resources.

  • Socket6d

    No alerts

  • Snyk7d

    Risk: MEDIUM · 1 issue

Signed by skilld at 426e8ab. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 6 days ago.

Activeupdated last week

README badge

README badge for jame581/godotprompter/limboai