Modding guide

How taming works for your creature

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

Taming a creature of your own comes down to the method, the food, how long it stays down, and how good the tame is. It's mostly numbers in two assets, the creature and its dino settings class. Setup takes me about an hour; tuning takes a few test tames.

  • You'll make: a creature that tames by knockout or by hand-feeding, on the foods and timings you choose
  • Time: about an hour, plus test tames
  • Level: beginner to intermediate (you've made a creature variant)
  • You'll need: your creature, and a vanilla creature that tames the way yours should

Before you start: make the creature first (How to make a custom creature). For the player's side, see taming methods.

How a tame works

A wild creature must become tameable first. In a knockout tame, its torpor fills and it falls unconscious. In a passive tame, it stays awake and takes food from your hand.

Each bite adds affinity. When affinity reaches the required amount, it's tamed. Each bite also lowers taming effectiveness, the tame's quality. It decides the bonus levels and stats.

The process

  1. Pick the method. Two switches on the creature choose knockout, passive, or no taming.

    Show me how
    Method Can Be Tamed Prevent Sleeping Tame Support Waking Tame Vanilla example
    Knockout on off off Rex, Dodo
    Passive (hand-feeding) on on on Lystrosaurus
    None off bosses, the Alpha Rex

    Prevent Sleeping Tame is class-wide sparse data: set it in Class Defaults. A creator turns a knockout creature passive, and back, with just these switches (Episode 16).

    For special tames there's also Disable Default Dino Taming (step 9). I haven't tested what it turns off.

  2. Set how much affinity it needs. That's a base amount plus an amount per wild level.

    Show me how
    Creature Required Tame Affinity Per Base Level
    Dino_Character_BP (the base) 10,000 5
    Dodo 450 22.5
    Lystrosaurus 2,000 22.5
    Rex 3,450 150
    Quetzal 6,850 300

    As I read it, a level 150 Rex needs about 3,450 + 150 × 150 = 25,950 affinity. The server's TamingSpeedMultiplier speeds that up, so test with default settings first.

  3. Give it a diet. The diet is a dino settings class. Make a child of the parent's, and point Dino Settings Class at it.

    Show me how

    The Rex uses DinoSettings_Carnivore_Huge_Rex, on native PrimalDinoSettings. Food Effectiveness Multipliers is the main food list. Extra Food Effectiveness Multipliers adds to it, so a child can add foods without retyping the list. The Rex's entries:

    Field Raw meat Raw prime meat Exceptional Kibble (extra list)
    Food Item Parent PrimalItemConsumable_RawMeat …_RawPrimeMeat PrimalItemConsumable_Kibble_Base_XLarge
    Untamed Food Consumption Priority 3 0.3 1
    Affinity Override 50 150 400
    Affinity Effectiveness Multiplier 1 1 0
    Food Effectiveness Multiplier 5 2.5 0.888
    Health Effectiveness Multiplier −1 0 0
    • Food Item Parent matches children too. One entry for raw meat covers every child of raw meat.
    • Untamed Food Consumption Priority decides what a wild creature eats first. Modders report that 0 means it's never eaten while wild.
    • Foods it refuses have every multiplier at 0, like the Rex's berries. The Lystrosaurus's Stimberry has a food value of −10.
    • The base list starts with "Super Test Meat" at 100,000 affinity: a debug food that tames almost at once.
    • Taming Affinity No Food Decrease Percentage Speed drains affinity while it goes hungry.

    A creator walks through a creature's dino settings at 26:01 in Episode 13.

  4. Set each food's affinity. Affinity Override sets the affinity per item. The other fields scale or replace it.

    Show me how

    How modders explain the maths:

    • If Affinity Override is set, that's the affinity per item.
    • Otherwise, Affinity Effectiveness Multiplier scales the food's own value.
    • A matching entry in the extra list overrides or multiplies the main one.
    • The item's Global Tame Affinity Multiplier, a class-wide item setting, scales the result.

    The Rex's Exceptional Kibble entry has override 400 and multiplier 0, and it works. So the override wins.

    To see the real number, call Get Affinity Increase For Food Item on the creature with the food item. Community taming calculators don't know your values; trust this node.

    Your own taming food: make it a child of PrimalItemConsumable_Kibble_Base or a vanilla food. One modder's food was refused until they did.

  5. Tune taming effectiveness. It drops with every bite, and with every hit while it's down.

    Show me how
    Setting (creature) What it does Value
    Tame Ineffectiveness By Affinity how fast effectiveness falls as affinity fills Rex 1.25; base 2,000
    Taming Ineffectiveness Modifier Increase By Damage Percent the loss when it's hurt while unconscious 8
    Taming Food Consume Interval seconds between bites while unconscious 1.4
    Force Perfect Tame always 100% off

    Modders found the loss comes per bite. A food with a high affinity needs fewer bites, so it gives a better tame.

    Effectiveness then scales the tame bonus in the status component: Taming Max Stat Multipliers. The flat part is Taming Max Stat Additions. Creature stats has both.

  6. Set its torpor, for a knockout tame. Torpor is stat 2 in the status component. You set its maximum and how fast it drains.

    Show me how
    Setting Where Rex Giganotosaurus
    Max Status Values, index 2 status component 1,550
    Recovery Rate Status Value, index 2 status component −0.1 −25
    Knocked Out Torpidity Recovery Rate Multiplier status component 7.25 4.8
    Can Be Torpid creature on
    • It wakes too fast: make the torpidity recovery rate less negative. I haven't measured how the knocked-out multiplier combines with it.
    • Server drain: WildDinoTorporDrainMultiplier scales every wild creature's drain.
    • What knocks it out: damage types. As I read its settings, the tranquilizer dart's DmgType_ProjectileWithImpactFX_Tranq doubles torpor from its damage, and adds 2.5 × damage as torpor over 5 seconds. See How to make a weapon.
    • Immune to tranqs, but not to your own torpor: use a child of DinoCharacterStatusComponent_BP_TorpidityControl. Its Allow Torpidity Increase switch turns torpor on and off at runtime. The Acrocanthosaurus's status component is one. Can Be Torpid off blocks your own torpor too.
    • To add torpor from a buff, apply damage with a torpor-only damage type.
    • To wake it, set torpor low and let it wake. Forcing the sleeping state off left one modder's creature impossible to knock out again.
  7. Set up hand-feeding, for a passive tame. A few creature settings control the feeding.

    Show me how
    Setting What it does Default Lystrosaurus
    Waking Tame Feed Interval seconds between feedings; lower is faster 15 30
    Waking Tame Food Affinity Multiplier extra affinity for hand-fed food 1.6
    Waking Tame Max Distance how close the player must be 400

    A passive carnivore still attacks unless its AI is calm. A creator gives a passive Allosaurus a herbivore's AI controller (Episode 16, 3:20). Creature AI has the details.

    To react to each feeding, turn on Use BP Fed Waking Tame Event and override BP Fed Waking Tame Event.

  8. Decide what happens once it's tamed. Buffs, AI and tame limits live on the creature.

    Show me how
    • Default Tamed Buffs adds buffs once tamed, for tame-only behavior (buffs).
    • Tamed AI Controller Override swaps the AI controller once tamed.
    • BP Setup Tamed fires when it's tamed and when a tame loads. Set up tame-only parts there.
    • Max Tamed Amount Per Tribe limits how many a tribe can own. −1 means no limit.
  9. Build your own taming mechanic, if you want one. Override the taming events, then call Tame Dino yourself.

    Show me how
    Event or function Use it for
    BSetupDinoTameable / BPUnsetupDinoTameable starting and ending your tameable state
    BPUntamedConsumeFoodItem reacting to each bite
    BPIsValidFoodItemForConsumption (with its Use BP switch) your own food rules
    BPDinoTooltipCustomTamingProgressBar, BPOverrideTamingDescriptionLabel the taming bar and its text
    SetCharacterStatusTameable, TameDino putting it in the tameable state; finishing the tame

    Modders use the tooltip function to fix the taming bar on custom tames; it switches to "taming" after the first bite. A creator replaces a vanilla special tame at 6:46 in Episode 16. They copy the vanilla Blueprint; I'd make a child.

  10. Test it fast, then test it for real. Commands skip the waiting. A real tame checks your numbers.

    Show me how

How the pieces connect

This asset Field Points at
Creature Dino Settings Class its dino settings (the diet)
Dino settings Food Item Parent in each entry a food item, and its children
Creature status component torpor, its drain, the tame bonus
Weapon or attack damage type the torpor it adds

The settings that matter

What you're looking for Field Where
Tameable at all; method Can Be Tamed; Prevent Sleeping Tame, Support Waking Tame creature
Affinity needed Required Tame Affinity, …Per Base Level creature
Foods and their affinity Food Effectiveness Multipliers, Extra… dino settings
Torpor and its drain Max Status Values, Recovery Rate Status Value (index 2) status component
Hand-feeding speed Waking Tame Feed Interval creature

The full lists are in the reference: creatures and creature stats.

Common mistakes

It won't eat my food while knocked out

The food isn't in its diet, or its priority or multipliers are 0. Add it to the extra list. Or reparent your food to the kibble base (steps 3 and 4).

"Put taming food in the last slot" never shows

The test map is using an old PrimalGameData. Clear it in World Settings, save, then set it again. That's the cache trap in How ARK finds your content.

It wakes up too soon, or tranqs don't knock it out

Its torpor drains too fast. Or Can Be Torpid is off, or a torpidity-control component blocks torpor (step 6).

The tame takes far too long, or one bite tames it

Compare Required Tame Affinity with your food's override. Then check the server's taming speed (step 2).

My passive tame attacks me

It still has a carnivore's AI. Give it a calm AI controller (step 7).

The taming bar says the wrong thing on my custom tame

Override the taming bar function. See step 9.

Check it worked

  1. In PIE, wild ones at a few levels need the bites you expect.
  2. It refuses foods it shouldn't eat, and prefers the ones you prioritized.
  3. Knockout: it stays down long enough at your highest level. Passive: you can feed it on your interval.
  4. Effectiveness ends where you expect, and the tame gets its bonus levels and stats.
  5. Repeat on a local dedicated server, and restart it once. See Works in PIE, not on a server and Reading ARK's logs.

Watch

Go deeper

Sources

  • DevKit files, read offline on 2026-11-06: Every class, field and value here: the base, Rex, Dodo, Lystrosaurus, Quetzal and Alpha Rex creatures with their sparse class data; the base, Rex and Lystrosaurus dino settings; the Rex, Giganotosaurus, Acrocanthosaurus and torpidity-control status components; the kibble, Exceptional Kibble and Super Test Meat items; the tranq dart's damage type; the reflected settings, events and C++ defaults of PrimalDinoCharacter, PrimalCharacter, PrimalDinoSettings and PrimalItem; and the command database.
  • What modders report, from the ARK Modding Community Discord: the affinity maths and food priority (February and October 2025); a custom food reparented to kibble (May 2026); effectiveness per bite (April 2025); the feed interval (January 2025); passive taming at runtime (November 2023); torpor drain and torpidity control (July 2025 to August 2026); adding torpor and the stuck sleeping state (June 2024, August 2025); the taming bar (April 2024).
  • Server settings TamingSpeedMultiplier and WildDinoTorporDrainMultiplier: the ARK Wiki's server configuration page (CC BY-NC-SA 4.0).
  • Videos listed under Watch: creators' tutorials, not checked against the kit.
  • Community knowledge from the ARK Modding Community Discord (discussions from November 2023 to August 2026, mainly #asa-general, #asa-blueprints, #asa-graphs and #asa-devkit-issues), found with Overseer. Threads that helped (they open for server members): the affinity maths (February 2025), custom food not eaten (October 2025), a custom taming food (May 2026), effectiveness per bite (April 2025), knocked out for longer (July 2025), blocking normal torpor (August 2026), adding torpor (August 2025), the custom taming bar (April 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 creatures, dino settings and damage types, 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 console commands

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

Browse all console commands

Esc

↑ ↓ move↵ openCtrl ↵ new tab