Modding guide

How to change creature behavior and AI

9 min readASA DevKit as of November 2026 (UE 5.8.1); ASE where noted

Who a creature fights, how close it gets, when it runs and what it does once tamed are mostly settings. Here I change them, add a new attack and take over targeting from Blueprint. A first pass takes me about an hour. A new attack with its own animation takes longer.

  • You'll make: a creature with its own aggression, ranges, tamed behavior and a new attack
  • Time: about an hour for settings; an afternoon for a new attack
  • Level: intermediate (you've made a creature variant)
  • You'll need: your creature (How to make a custom creature) and the vanilla creature that behaves closest to yours

How a creature decides

Three pieces work together. Change the right one and the rest keeps working.

  • The AI controller decides when to look for targets, chase, flee or wander. The creature names it in AI Controller Class.
  • The attack list, Attack Infos on the creature, holds each attack's animation, range and damage.
  • The team, Targeting Team Name Override on the creature, decides who counts as an enemy.

An AI controller is an actor that possesses the creature and drives it. ARK's is mostly C++ logic with settings on top. It runs Unreal behavior trees: graphs of small tasks such as "find a wander point". Every setting is listed in Creature AI; this page is the order I use them in.

The process

  1. Make a child of the vanilla controller and point your creature at it. Never edit the vanilla controller, and don't copy it.

    Show me how
    • In your creature's Class Defaults, search AI Controller Class. The Rex uses Rex_AIController_BP. Most vanilla controllers are children of Dino_AIController_BP.
    • Right-click that controller → Create Child Blueprint Class, save it in your mod folder, and set your creature's AI Controller Class to it.
    • A different parent gives a whole new temperament. A Stego's controller makes a Dodo fight back; a Dodo's calms a carnivore (tutorials §7).
    • A copied creature sometimes attacks and turns but never walks. Reassigning the controller fixes it; a child creature avoids it (How to make a custom creature).
  2. Choose who it fights. Aggression comes from the controller and the team together. Set both.

    Show me how
    You want Controller Creature team
    Hostile Use Overlap Target Check on a carnivore team, like the Raptor's Carnivores_Medium
    Neutral, fights back Use Overlap Target Check off, Has Enemy Tree DinoAttack_BT a herbivore team
    Skittish, runs Use Overlap Target Check off, Has Enemy Tree DinoFlee_BT as the Dodo
    • Teams are defined in PrimalGameData. Modders found the wild teams there, with switches like targeting only players.
    • Natural Targeting Range is how far a wild one looks: 6,500 on the Rex, 4,000 on the Raptor.
    • Wild Targeting Desire Multiplier Classes and Values tune its taste. They pair up by index.
  3. Fit the ranges to the body. Range is checked twice: by the controller, then by each attack. Both must fit, or it bites thin air or never arrives.

    Show me how
    Setting Where Rex Raptor
    Attack Range controller 1,200 300
    Attack Destination Offset (where it stops) controller 850 200
    Attack Interval controller 0.6 0.2
    Attack Range each Attack Infos entry 1,200 350
    Attack Offset (reach ahead of the body) each Attack Infos entry 600 60
    Melee Swing Radius each Attack Infos entry 300 75

    Units are centimeters. Scale them with the capsule: double the size, double these to start.

  4. Set wandering and fleeing. Wander distances keep it near home; flee thresholds decide when it gives up.

    Show me how
    • Wander Random Distance Amount and Wander Fixed Distance Amount: 2,500 and 600 on the base controller, 600 and 500 on the Dodo. Dont Wander makes guards stand still.
    • Flee Health Percentage on the creature (0.15 by default), Flee On Critical Health on the controller.
    • Flee From Attack Time Limit and Cool Down Time: the Dodo runs for 15 seconds, then waits 30.
    • There's no leash setting. For a hard limit, call Set Hard Limit Wild Dino To Volume on the server (reference).
  5. Decide its tamed behavior separately. A tame runs the same controller, with its owner's orders on top. Use the tamed settings, not the wild ones.

    Show me how
    • Tamed Targeting Range: how far a tame looks when its stance allows.
    • Tamed No Enemy Tree: its own idle behavior. The Gacha and Bog Spider set one.
    • Tamed AI Controller Override on the creature: a whole controller once tamed.
    • Skip Tamed and Skip Untamed on each attack. The Raptor's pounce skips untamed raptors.
    • From a graph: Force Set Tamed Aggression Level sets the stance; Tamed Process Order gives a whistle's order.
  6. Add a new attack. An attack is one Attack Infos entry plus a montage, an animation asset that can carry events. The damage comes from a notify inside that montage.

    Show me how

    Copy an existing entry. The Rex has three: Bite, Roar and Bite (AI). Its bite:

    Field Rex bite
    Attack Animations Rex-Bite2_Montage (one picked by Attack Animation Weights)
    Melee Swing Sockets MeleeSocket1 to 4, where the hit trace runs
    Melee Damage Amount, Melee Damage Type 62, DmgType_Melee_Dino_Carnivore_Rex
    Attack State Type Class DinoAttackStateMelee; ranged, ramming and grab states sit beside it in CoreAI
    Attack Weight 0.5, how often AI picks it
    Skip AI off; on means riders only
    • Make the montage from your animation, in the same slot the vanilla creature's montages use. Modders traced an attack that never played to a missing slot.
    • Add a MeleeSwing notify state over the frames that hit. Tick Trigger on Dedicated Server, or it does no damage on a server (lessons §8).
    • Extra conditions: tick Use Blueprint Can Attack on the entry and override Blueprint Can Attack. The Raptor does this for every attack. For logic as it fires, use BP Do Attack with Use BP Do Attack.
    • Several MeleeSwing notifies in one montage all hit. Modders report only the first shows damage numbers.
  7. Override targeting from Blueprint, if settings aren't enough. Override an event on your controller and turn on its switch. Without the switch, the event never runs.

    Show me how
    To change Override Switch
    How much it wants each target BP Get Targeting Desire Use BP Targeting Desire
    Which target it finally picks BP Update Best Target Use BP Update Best Target
    Something to do when it picks one BP Notify Target Set Notify BP Target Set
    • Pass the incoming value through for targets you don't care about. Returning 0 for everything makes a creature that never fights.
    • Check the target's team before you return it.
    • To aim it at one target from outside, call Set Target on its controller, on the server. ZenRowe's ASE tower series does this; it's kinder to other mods than swapping trees.
  8. Pause or stop the AI when you need to. Use the lightest switch that does the job.

    Show me how
    You want Use
    No new targets Not Allowed To Find Targets on the controller
    No targeting and no following Prevent Targeting and Movement on the creature
    Frozen solid Immobilize on the creature
    The tree paused for a scripted moment Pause Brain Component, then Resume Brain Component
    • Modders found Pause Brain Component didn't stop a tame following; Prevent Targeting and Movement did. A new follow target took effect after Restart Brain Component.
    • Tree settings are read-only at runtime. Modders report Run Behavior Tree runs beside the vanilla tree, not instead. Swapping controllers at runtime is mixed: one buff swap worked, another new controller never started.
  9. Test it wild, tamed and on a server. AI runs on the server only.

    Show me how

    Watch it hunt, wander and flee in PIE, then tame it and try each stance. Repeat on a local dedicated server (Testing your mod): melee notifies and Blueprint targeting are the likeliest to change there.

Behavior trees or settings: what modders actually use

Vanilla answers this. The kit has 566 AI controllers. Only 180 add any Blueprint logic, and the most common override, BP Get Targeting Desire, appears in 100 of them. 173 swap the Has Enemy Tree; just 55 set their own top-level tree.

So I work in this order: settings, then targeting events, then a tree swap. The vanilla trees live in /Game/PrimalEarth/CoreAI/. Read DinoAttack_BT and DinoSeek_BT before writing your own, and build on their blackboard, Dino_BB.

Note

Nobody in the community has published a full custom behavior tree for ASA. Treat one as research, and test it on a dedicated server early.

How the pieces connect

This Field Points at
Creature AI Controller Class, Tamed AI Controller Override your controllers
Creature Targeting Team Name Override a team in PrimalGameData
Creature Attack Infos → Attack Animations your montages
Montage MeleeSwing notify state the frames that deal damage
Controller Behavior Tree, Has Enemy Tree, No Enemy Tree trees in CoreAI or your own

Everything else hangs off these five links.

The settings that matter

What you're after Setting
Hostile or neutral Use Overlap Target Check, Has Enemy Tree, the team
Reach Attack Range and Attack Destination Offset, plus each attack's range
Tamed only Tamed Targeting Range, Tamed No Enemy Tree, Tamed AI Controller Override

The rest, with vanilla values, are in Creature AI.

Common mistakes

My creature just stands there

It may be a copied creature: reassign the controller. On your own map, there may be no nav mesh, the walkable surface AI paths over; add a Nav Mesh Bounds Volume. Or Dont Wander is on.

It never attacks, or attacks thin air

The ranges don't fit the body (step 3). An attack with Skip AI on is for riders only.

It plays the attack but does no damage

Modders list three causes: no MeleeSwing notify, no swing radius, or no damage type. On a server only, the notify isn't set to trigger there (step 6).

My tame attacks me or my tribe

A targeting override returns a target without checking its team (step 7). Or it was never truly tamed: modders found setting the team alone leaves it acting wild. Use the game's tame node with the player's controller.

It walks into walls or gets stuck on rocks

Its capsule doesn't fit the mesh, or the nav mesh doesn't reach there. Compare Move Around Blockade Additional Width and Ignore Move Around Blockade with a vanilla creature your size.

My override event never fires

Its switch is off (step 7).

It behaves in PIE but not on a server

AI runs on the server; client-side logic never reaches it (Works in PIE, not on a server).

Check it worked

  1. Wild, it targets what you meant, from about the distance you set.
  2. It closes in and its attacks land.
  3. It flees at the health you set and wanders without leaving its area.
  4. Tamed, it follows, stays put on Passive, and fights on Aggressive or when ordered.
  5. All of that holds on a local dedicated server with a separate client.

Watch

Go deeper

Sources

  • DevKit files, read offline on 2026-11-06 (UE 5.8.1): the controller settings, the base, Rex, Raptor and Dodo controllers, the Rex's and Raptor's Attack Infos, the FDinoAttackInfo fields, Immobilize, bPreventTargetingAndMovement and TamedProcessOrder, and the CoreAI trees. The counts come from all 566 official PrimalDinoAIController Blueprints.
  • My other pages: lessons §8 (MeleeSwing on dedicated servers) and tutorials §7 (controller swaps, teams, ZenRowe's targeting list).
  • What modders report: copied creatures that won't walk; the causes of no damage; montage slots; multi-hit damage numbers; disabling and restarting the brain; read-only trees and runtime swaps; nav meshes; a team change that isn't a tame; wild teams in PrimalGameData.
  • Videos under Watch: creators' tutorials, not checked against the kit. ZenRowe's is ASE-era.
  • Community knowledge from the ARK Modding Community Discord (discussions from February 2024 to September 2026), found with Overseer. Threads (they open for server members): MeleeSwing, radius and damage type (February 2024), a montage that never plays (October 2025), multi-hit damage numbers (May 2025), aggression via the controller (May 2024), a copied creature fixed by its controller (September 2026), tree swap limits (January 2026), disabling AI (April 2025), restarting the brain (January 2025), nav meshes (November 2025), a team change isn't a tame (December 2024), wild teams (November 2024).
Where this page's information comes from

Applies to: ASA DevKit as of November 2026 (UE 5.8.1); ASE where noted

the DevKit's own AI controllers, creatures and behavior trees, the community Discord and creators' videos (see Sources)

Esc

↑ ↓ move↵ openCtrl ↵ new tab