Modding guide

How to make a custom creature

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

There are two very different jobs behind "a custom creature". A variant is a child of a vanilla creature with its own name, stats, colors, taming and spawns. It reuses the parent's mesh, animations and AI, and the first one takes me an afternoon. A creature from scratch has its own model, skeleton and animations. That's weeks of work, and nobody in the community has written the whole pipeline down. Part 1 walks the variant step by step. Part 2 is my outline of the from-scratch pipeline.

  • You'll make: a variant of a vanilla creature with its own name, stats, colors, taming, saddle and spawns
  • Time: an afternoon for a variant; weeks for a creature from scratch
  • Level: beginner for Part 1 (you've made your first mod); experienced for Part 2
  • You'll need: a mod set up and registered, and the vanilla creature closest to yours

Before you start:

  • Have your mod project with its test map, PrimalGameData and Mod Data Asset linked. Your first mod covers that. Read How ARK finds your content too.
  • Pick the vanilla creature closest to yours. The database shows every creature's class, stats, foods and saddle: /ark/browse/creatures, for example the Rex.
  • For Part 2, you'll also need a rigged, animated model from Blender or Maya, and time.

Part 1: a variant of a vanilla creature

  1. Make a child of the vanilla creature's character Blueprint. Right-click <Species>_Character_BP → Create Child Blueprint Class, and save it in your mod folder. Don't copy it.

    Show me how

    The Rex's chain is Rex_Character_BP → Dino_Character_BP → native PrimalDinoCharacter, the C++ class every creature comes from. Wildcard builds its own variants the same way. The Astraeos lightning Rex is a child of the corrupted Rex, which is a child of the Rex. The Eden Thylacoleo is a child of the Thylacoleo.

    Copies break in ways that are hard to see. Modders report copied creatures spawning at almost no health. Others attacked and turned but never walked, until the AI controller was reassigned.

    To test, start PIE, right-click your Blueprint in the content browser and use the spawn option. Or type cheat summon <YourClass>_C in the console.

    One caution from my own notes: a subclass is a different class. Other mods' class checks, and breeding with the vanilla species, won't treat it as the original (lessons §8). If you only want to change one thing on every vanilla Rex, a buff is often better than a new creature.

  2. Name it. There are two fields: the name players see, and the tag saddles check.

    Show me how
    Field Rex value What it does
    DescriptiveName Rex the display name
    DinoNameTag Rex the tag equipment checks; the Rex saddle's EquipRequiresExplicitOwnerTags is ["Rex"]

    Keep the parent's tag if the vanilla saddle should fit your variant. Change it if your variant gets its own saddle (step 7).

  3. Change its stats in its own status component. A creature's stats live in a status component, not on the character. Make a child of the parent's status component, change the numbers, and add it with a higher priority so it wins over the inherited one.

    Show me how

    The Rex uses DinoCharacterStatusComponent_BP_Rex → DinoCharacterStatusComponent_BP → native PrimalDinoStatusComponent. Every stat array has 12 slots, in this order. Here they are with the Rex's MaxStatusValues:

    Index Stat Rex base Index Stat Rex base
    0 Health 1100 6 Temperature not used
    1 Stamina 420 7 Weight 500
    2 Torpidity 1550 8 Melee damage (C++ default)
    3 Oxygen 150 9 Movement speed (C++ default)
    4 Food 3000 10 Temperature fortitude not used
    5 Water not used 11 Crafting skill not used

    The other arrays that matter:

    • AmountMaxGainedPerLevelUpValue: per wild level. The Rex gains 20% health per level.
    • AmountMaxGainedPerLevelUpValueTamed.
    • TamingMaxStatAdditions and TamingMaxStatMultipliers: the tame bonus.
    • CanLevelUpValue, and DontUseValue (the "not used" slots above).

    Steps: right-click the parent's status component class → Create Child Blueprint Class, and change the values. In your creature, Add Component → your status component. Set its Character Status Component Priority above the inherited one. That's how the kit does it too. The aggressive Dimorphodon adds a child of the Dimorphodon's status component at priority 10, and the dragon-boss Dimorphodons use 20.

    Speed also lives elsewhere: MaxWalkSpeed on the movement component, and TamedWalkingSpeedModifier, UntamedWalkingSpeedModifier and TamedRunningSpeedModifier (0.75 on the Rex) on the character.

  4. Set its colors. A color set says which colors each region can roll. A per-region switch turns regions off, and a master switch turns coloring on at all.

    Show me how
    Field Where What it does
    RandomColorSetsMale, RandomColorSetsFemale character a PrimalColorSet class; its ColorSetDefinitions give each region a name and a list of color names
    PreventColorizationRegions[0–5] character 1 turns a region off
    bUseColorization character the master switch; off means no dyeable colors at all
    ColorSetIntensityMultipliers character brightness per region

    A real example: the Thylacoleo sets PreventColorizationRegions 1 to 3 to 1, so it only uses three regions. Its Eden variant sets them back to 0 and uses its own color set. The Rex's color set defines regions 0, 1, 4 and 5 ("main", "spine", "back", "belly").

    • If a region stays gray, modders find it's switched off in PreventColorizationRegions, or the mesh's colorization mask has nothing in that channel.
    • If your child ignores its color set, check bUseColorization is still on in the child.
    • To change colors from a graph, use ForceUpdateColorSets on the server, never material parameters. Random color IDs must come from 1 to 100 and 128 to 254 (lessons §8). Color IDs and names are in the database: /ark/browse/colors.
  5. Set up taming. How much affinity it needs lives on the character. What it eats lives in its dino settings class.

    Show me how
    Field Where Rex value
    bCanBeTamed character on (C++ default)
    RequiredTameAffinity, RequiredTameAffinityPerBaseLevel character 3450, +150 per level
    TameIneffectivenessByAffinity character 1.25
    DinoSettingsClass character DinoSettings_Carnivore_Huge_Rex (native PrimalDinoSettings)
    FoodEffectivenessMultipliers, ExtraFoodEffectivenessMultipliers dino settings one entry per food: FoodItemParent, AffinityEffectivenessMultiplier, AffinityOverride, FoodEffectivenessMultiplier, UntamedFoodConsumptionPriority

    FoodItemParent matches children too, so raw meat covers raw fish. Modders report that a food with UntamedFoodConsumptionPriority 0 is never eaten while taming. For your own foods, make a child of the dino settings class.

    Passive taming uses bPreventSleepingTame, which is sparse class data, plus bSupportWakingTame. The Lystrosaurus has both turned on, so it's a good one to copy. How taming works covers the rest.

    To control torpor, the kit has a ready status component, DinoCharacterStatusComponent_BP_TorpidityControl. Modders use a child of it to block normal torpor but allow their own.

  6. Set up breeding. Choose eggs or live birth, and set the mating rules. Most of these became class-wide in

    Show me how
    Field What it does Example
    bUseBabyGestation live birth instead of eggs on for the Thylacoleo, off for the Rex
    FertilizedEggItemsToSpawn, EggItemsToSpawn the fertilized and unfertilized egg items the Rex's egg classes
    FemaleMatingTime how long mating takes 120 on the Rex
    NewFemaleMinTimeBetweenMating, NewFemaleMaxTimeBetweenMating cooldown 64,800 to 172,800 s (C++ defaults)
    RandomMutationChance, RandomMutationRolls, RandomMutationGivePoints mutations 0.025, 3, 2 (C++ defaults)

    Incubation belongs to the egg item, not the parent (lessons §8).

    The 2025 sparse class data change: Since about May 2025, these values sit in PrimalDinoCharacter's sparse class data: one copy per class, not per creature. The old per-creature members are now marked deprecated in the kit.

    • Set them in your child's Class Defaults and they work.
    • Setting them from a graph at runtime changes every creature of that class. That broke many breeding mods. The editor labels those setters "CLASS GLOBAL".
    • For per-creature changes, modders use the Sparse Data Override Manager registered in the Mod Data Asset. It only covers some properties.
    • The other way out: subtract from the creature's next allowed mating time instead of changing the class's timers.
  7. Give it a saddle. The saddle item names the creature by tag. The rider attaches to a socket on the skeleton.

    Show me how
    • Make a child of a vanilla saddle. The Rex saddle's chain is PrimalItemArmor_RexSaddle → PrimalItemArmor_SaddleGeneric → PrimalItemArmorGeneric → PrimalItem_Base.
    • Set EquipRequiresExplicitOwnerTags to your creature's DinoNameTag.
    • The saddle's mesh, socket, scale and offset are in ActorClassAttachmentInfos → ItemAttachmentInfos on the item. A huge or misplaced saddle means wrong values there.
    • The rider sits on RiderSocket, which the Rex's skeleton has.
    • For a creature you can ride without a saddle, modders point at the character's "Rider Dont Require Saddle" setting. They say some of these values only apply after you stop and restart PIE.
    • Register the saddle's engram like any other (How ARK finds your content).
  8. Adjust its behavior, if you want. Aggression and attacks come mostly from the AI controller.

    Show me how

    The Rex's AIControllerClass is Rex_AIController_BP → Dino_AIController_BP → native PrimalDinoAIController. On it: BehaviourTree (Dino_BT), HasEnemyTree (DinoAttack_BT), NoEnemyTree (DinoSeek_BT), AttackRange 1200, AttackDestinationOffset 850, NaturalTargetingRange 6500. On the character: TargetingTeamNameOverride (Carnivores_High), bIsCarnivore, and AttackInfos with the MeleeSwingSockets each attack uses.

    Giving a carnivore a herbivore's controller calms it. A herbivore with a carnivore's team and controller fights (tutorials §7). Melee damage needs a MeleeSwing notify that runs on the dedicated server (lessons §8).

  9. Add it to spawns without replacing the map's. Use the Mod Data Asset. Never edit a map's spawn tables.

    Show me how
    Route What it does Cost
    Remap NPC replaces the vanilla creature everywhere conflicts with every other mod that touches that creature
    Global NPC Random Spawn Class Weights ("piggyback") a share of a vanilla creature's spawns become yours; list the vanilla one again with its own weight works on any map that spawns the vanilla creature
    The NPC Spawn Entries Container Additions adds an entry to a vanilla spawn container you need the container's name (/ark/browse/spawns)

    Each piggyback weight is that creature's own chance; they don't have to add up to 1 (tutorials §7).

    • If it should only be admin-spawned, put it in the Mod Data Asset's Extra Resources so it gets cooked, and skip spawn entries.
    • Some Island species sit in nested containers. Modders couldn't get variants added there to spawn.
    • Test spawns on a dedicated server. Single-player stasis makes the counts misleading.
  10. Test it. Spawn it wild and tamed in PIE, then on a local dedicated server.

    Show me how

    Check its stats in the inventory screen against your status component. Check its colors over a few spawns, a tame with each food, a mating pair, the saddle, and a ride. Then do the same on a local dedicated server with a separate client, including a server restart. See Check it worked.

Part 2: a creature from scratch (the short version)

Note

This is the short version. The full walk-through, step by step, is How to make a creature from scratch. The asset chain in the table below is confirmed: I read it off the Rex in the kit.

The asset chain a creature needs, as the Rex has it:

Asset The Rex's Points at
Character Blueprint Rex_Character_BP (child of Dino_Character_BP) its mesh component, status component, AI controller, dino settings
Mesh component (CharacterMesh0, a PrimalDinoMeshComponent) SkeletalMesh = Rex_New, AnimClass = Rex_Anim_BP
Skeletal mesh Rex_New Skeleton = Rex_Skeleton, PhysicsAsset = Rex_PhysicsAsset, PostProcessAnimBlueprint = Rex_PPAnimBP
Animation Blueprint Rex_Anim_BP → DinoBlueprintBase → native PrimalDinoAnimInstance
Skeleton sockets RiderSocket, MeleeSocket1–6, DragSocket, PoopSocket, HeadSocket, LookOffsetSocket and more

And here's the order I'd work in:

  1. Model and rig. Build it at real size with a clean root bone. The cheapest route modders report is to rig your model to an existing ARK skeleton whose animations you want. Then they play with no retargeting at all.

  2. Import the skeletal mesh, with a new skeleton or the existing one you rigged to. Import it with the same root rotation as its animations. Otherwise it turns 90 degrees when an animation plays.

  3. Make a physics asset and assign it on the mesh. Ragdoll on death needs it, plus death handling in the animation Blueprint.

  4. Add sockets to the skeleton, named like the Rex's: the rider, melee hit points, drag, poop, head. I haven't confirmed which of these the game strictly requires; the names come from the Rex.

  5. Make the animations. The character's fields tell you what a creature needs:

    • an attack montage per entry in AttackInfos;
    • FallAsleepAnim, WildUnsleepAnim, TamedUnsleepAnim;
    • DeathAnimations, one per movement state, and HurtAnim;
    • SleepConsumeFoodAnim, WakingConsumeFoodAnim, BabyCuddledAnimation, PoopAnimation;
    • plus idle, walk and run.

    To reuse animations made for another skeleton, use UE5's IK Rig and IK Retargeter. Then use Duplicate and Retarget Animation Assets.

  6. Make the animation Blueprint. Create a new animation Blueprint on your skeleton, then reparent it to one of the kit's DinoBlueprintBase classes. The kit has 55 of them: DinoBlueprintBase, DinoBlueprintBase_RootBoneName, DinoBlueprintBase_RootTransform, and swimmer, flyer (_GroundAndFlying), climber and strafe versions. Pick the one the vanilla creature closest to yours uses, and read that creature's graph. Modders report the skeleton needs the death slot and group the base expects, or death animations don't play.

  7. Make the character Blueprint. Make it a child of Dino_Character_BP, or of a specialized base such as Dino_Character_BP_Climber or Dino_Character_BP_DivingFlyer. Both exist in the kit. Don't use a vanilla species as the parent unless you want its logic. Set the mesh component's skeletal mesh and AnimClass, and the name fields from step 2. Size the capsule to the body: modders find a mismatched capsule tilts the creature.

  8. Add a status component. Add a child of DinoCharacterStatusComponent_BP and fill the 12 stats (Part 1, step 3).

  9. Set up an AI controller. Make a child of Dino_AIController_BP. Set attack range and destination offset to suit the body size, or it attacks from too far or never reaches its target.

  10. Set up death and drops. Use DeathInventoryTemplates and DeathHarvestingComponent on the character, as the Rex does. A creator's tutorial covers drops (Episode 24).

  11. Add taming, breeding, a saddle, colors and spawns, the same as Part 1, steps 4 to 9. Your colorization mask decides the six color regions: its red, green, blue, yellow, cyan and magenta channels, in that order for regions 0 to 5 (materials).

What I haven't worked out yet, and what you'd be the first to document: which sockets and animation slots the C++ code requires, flying and swimming movement settings on a new skeleton, and ground IK. Saddle meshes rigged to a new skeleton are open too: "failed to merge bones" is an unanswered question on the Discord.

How the pieces connect

This asset Field Points at
Your creature parent class the vanilla <Species>_Character_BP (variant) or Dino_Character_BP (from scratch)
Creature status component (added, higher priority) your DinoCharacterStatusComponent_BP child
Creature DinoSettingsClass the dino settings class with its foods
Creature AIControllerClass an AI controller class
Creature RandomColorSetsMale / Female a PrimalColorSet class
Creature FertilizedEggItemsToSpawn the egg item (which owns incubation)
Creature mesh component SkeletalMesh, AnimClass the mesh and its animation Blueprint
Saddle item EquipRequiresExplicitOwnerTags the creature's DinoNameTag
Mod Data Asset spawn fields (step 9) or Extra Resources your creature

The settings that matter

What you're looking for Field Where
Base stats MaxStatusValues status component
Stats per level AmountMaxGainedPerLevelUpValue (wild), …Tamed status component
Which status component wins Character Status Component Priority the component, on the creature
Display name / saddle tag DescriptiveName / DinoNameTag creature
Colors RandomColorSetsMale/Female, PreventColorizationRegions, bUseColorization creature
Taming foods FoodEffectivenessMultipliers dino settings class
Affinity needed RequiredTameAffinity creature
Eggs or live birth bUseBabyGestation, FertilizedEggItemsToSpawn creature (sparse class data)
Aggression, attack range AIControllerClass, AttackRange, TargetingTeamNameOverride creature, AI controller

Common mistakes

My variant has the parent's stats

Your status component isn't winning. Its Character Status Component Priority isn't higher than the inherited one, or you changed the parent's component instead of a child. In one creator's own test, boosted stats didn't apply in PIE, and the video left it unresolved (Episode 5, 9:45). Check the priority first.

Some color regions stay gray, or it ignores my color set

A region is switched off in PreventColorizationRegions, or bUseColorization is off. Or the mesh has no colorization mask in that channel. Step 4 has the details.

The vanilla saddle doesn't fit, or my saddle won't equip

The saddle's EquipRequiresExplicitOwnerTags must match the creature's DinoNameTag (step 7).

It attacks and turns but never walks to its target

It's usually a copied creature. Reassign the AI controller, then check AttackRange and AttackDestinationOffset. Better still, make it a child.

My breeding change affects every creature of that class

You set a sparse class data value at runtime. Set it in Class Defaults, or use the Sparse Data Override Manager (step 6).

It won't eat its food while taming

UntamedFoodConsumptionPriority is 0 on that food entry. Give it a higher priority (step 5).

It doesn't spawn in the wild

It isn't in any spawn field of the Mod Data Asset, or PIE is using the cached Mod Data Asset. It may sit in a nested Island container. Or the test map's low creature cap is the cause, since only the closest biome refills. Test on a dedicated server.

Check it worked

  1. In PIE, it spawns at the level you ask for, with your stats (open its inventory) and your name.
  2. Several spawns roll colors only from your set, in the regions you enabled.
  3. It eats your taming foods and tames. It accepts its saddle, and the rider sits right.
  4. A pair mates and gives the egg or baby you set.
  5. Wild, it behaves as you meant: it flees, ignores you, or attacks.
  6. Repeat 1 to 5 on a local dedicated server with a separate client. Restart the server, and check tames keep their stats and colors. Watch the server log for your class name. Check FailedWaterDinoSpawns.log for water spawns that failed to place. See Reading ARK's logs.

Watch

Go deeper

Sources

  • DevKit files, read offline on 2026-11-05: Every class, field, value and chain on this page comes from these, including the Part 2 asset chain and the field names in its steps 5 to 10: /Game/PrimalEarth/Dinos/Rex/ (Rex_Character_BP, Rex_AIController_BP, Rex_Anim_BP, Rex_New, Rex_Skeleton), /Game/PrimalEarth/CoreBlueprints/ (Dino_Character_BP, DinoCharacterStatusComponent_BP, …_Rex, …_TorpidityControl, DinoColorSet_Rex), /Game/PrimalEarth/Dinos/BaseBPs/DinoSettings_Carnivore_Huge_Rex, the Thylacoleo and its Eden variant, the aggressive and dragon-boss Dimorphodons, the Astraeos lightning Rex, PrimalItemArmor_RexSaddle, the DinoBlueprintBase* animation classes, and the native constructor defaults of APrimalDinoCharacter and its sparse class data.
  • Modding lessons and What the video tutorials teach in this section: subclass cautions, color IDs, incubation and melee notifies (lessons §8); swapping AI controllers and piggyback weights (tutorials §7, from creators' tutorials).
  • What modders report, from the ARK Modding Community Discord:
    • copied creatures spawning at almost no health, or not walking until the AI controller is reassigned (2024–2026);
    • gray color regions (2024–2026), and bUseColorization off in a child (November 2024);
    • foods with UntamedFoodConsumptionPriority 0 never eaten (October 2025);
    • a child of the torpidity-control status component (2025);
    • sparse class data making breeding values class-wide, the "CLASS GLOBAL" setters and the Sparse Data Override Manager (May 2025);
    • huge or misplaced saddles (2024); riding without a saddle and restarting PIE (March 2024);
    • the three spawn routes (2024–2025, with creators' tutorials); variants in nested Island containers (2026);
    • Part 2: rigging to an existing skeleton (November 2023); matching root rotation; physics assets and ragdoll (October 2025); IK retargeting; reparenting the animation Blueprint (2024–2026); the death slot and group (May 2026); capsule tilt (January 2024); color mask channels; "failed to merge bones" (still open).
  • Videos listed under Watch: creators' tutorials, not checked against the kit. bSupportWakingTame first came from one of them; it's confirmed on the Lystrosaurus in the kit.
  • Community knowledge from the ARK Modding Community Discord (discussions from November 2023 to October 2026, mainly #asa-general, #asa-blueprints, #asa-animation and #asa-devkit-issues), found with Overseer. Threads that helped (they open for server members): re-skin, colour regions and test spawning (February 2026), sparse data makes breeding values class-wide (May 2025), reparenting an animation Blueprint for a custom creature (September 2024), the full list of spawn sources (September 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 creature assets, the community Discord and creators' videos (see Sources)

Look something up in creatures

1,551 rows, each with its own page. Search by name or any detail, or start from a category.

Browse all creatures

Look something up in colors and dyes

227 rows, each with its own page. Search by name or any detail, or start from a category.

Browse all colors and dyes

Look something up in spawn tables

486 rows, each with its own page. Search by name or any detail, or start from a category.

Browse all spawn tables

Esc

↑ ↓ move↵ openCtrl ↵ new tab