Skip to content
SkillModel-led2,537 tokens in use

unreal-behavior-trees

Unreal Engine 5.8 NPC AI for your coding agent: Behavior Trees, Blackboards, EQS and StateTree, decorators with Observer Aborts and custom C++ BTTask nodes.

9,684 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/unreal/unreal-behavior-trees
npx skills add gamedev-skills/awesome-gamedev-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing unreal-behavior-trees costs

113tokens idle
2,537tokens in use
4,158tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter8/15
  • Structure25/25
  • Examples12/15
  • Output15/15
  • Size15/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance96
  • Community60
  • Maturity24
  • Momentum40

This skill gives an agent a method for building NPC decision-making in Unreal Engine 5.8. A Behavior Tree reads a Blackboard, decorators gate branches, services keep keys fresh, EQS picks locations or targets, and the AIController runs the tree. It also says when StateTree is the better fit.

It covers the failures people search for: AI that never starts, MoveTo that fails at once, trees that ignore a key change because Observer Aborts is None, and custom tasks that misbehave with several NPCs because they keep state in member variables.

What You Get

  • An eight-step workflow from project discovery to verification
  • A C++ AIController pattern that runs the tree and sets Blackboard values
  • A reactive priority tree layout showing how Observer Aborts Both behaves
  • A reference on writing custom BTTask nodes, instant and latent, with per-AI node memory, AbortTask, services and decorators
  • A gotcha list for navmesh, key typos, shared node state and stripped EQS assets

Common Use Cases

  • Fixing an enemy that just stands there or a MoveTo that fails instantly
  • Building a combat, investigate and patrol tree driven by Blackboard keys
  • Writing a custom C++ task that waits a random time and cancels cleanly when aborted
  • Choosing between a Behavior Tree and StateTree for a new AI

What Makes It Unique

The skill is pinned to Unreal Engine 5.8 and compares Behavior Trees with StateTree, including the plugins StateTree needs and the task that runs a StateTree inside a branch. It insists on proof: a headless functional test that checks a Blackboard key or distance, with reading asset files not counting as a test. It leaves engine-neutral behavior tree code to a separate skill.

Under The Hood

The agent loads the SKILL.md, and the custom task reference only when it writes a C++ node. It runs shell commands in your project: find and grep to list AI assets and classes, the engine build script to compile, and the editor command line to validate assets and run automation tests headless. It writes C++ source and may suggest editor steps for you to do. It does not fetch web pages itself. An optional Epic editor connection can inspect assets live if you have it installed.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers