Modding guide

How ARK finds your content

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

Nothing you make in the DevKit exists in the game until something tells ARK about it. That something is a pair of assets every mod has: the PrimalGameData and the Mod Data Asset. If your item, engram, structure or creature "doesn't show up in game", the answer is almost always on this page.

This page shows how the pair works and which field takes which kind of content. It also covers how mods stack, and the caching bug that makes everyone think their setup is broken.

  • You'll learn: where each kind of content is registered, and why it sometimes doesn't show up
  • Time: about 15 minutes to read; two minutes to register each new piece of content
  • Level: beginner, after your first mod
  • You'll need: a mod made with the Create Mod wizard, and the asset you want to register

Your first mod walks through the Create Mod wizard. The asset can be an engram entry, a structure, a creature, a buff or a singleton.

The process

  1. Leave the PrimalGameData alone, apart from three fields. Everything else goes in the Mod Data Asset.

    Show me how
    • The PrimalGameData (PGD) is the blue Blueprint named PrimalGameData_BP_<YourMod>. It's a child of Wildcard's PrimalGameDataARKNX_BP, so it inherits the whole game's data.
    • Its parent chain is PrimalGameDataARKNX_BP → PrimalGameData_BP → BASE_PrimalGameData_BP → COREMEDIA_PrimalGameData_BP → CORE_PrimalGameData. The inherited Engram Blueprint Classes list already holds 889 vanilla engrams.
    • Don't edit, remove or reorder anything you inherited. Modders report that editing that master engram list breaks the whole engram screen.
    • The three fields you do set on it are Mod Name (ModName), Mod Description (ModDescription) and Additional Mod Data Asset (AdditionalModDataAsset). The last one points at your Mod Data Asset.
    • The Mod Data Asset (MDA) is the pink data asset named ModDataAsset_<YourMod>. It's a plain data asset of class ModDataAsset, with 66 fields.
    • The MDA opens in a second, where the PGD takes ages. It's also the part designed to stack with other mods.
    • Keep one PGD per mod. A modder found that the cook picks up whichever PGD it finds first in the mod folder. A spare "dummy" PGD can ship instead of yours.
  2. Put each piece of content in the array made for it. The table in Which field takes what lists them. Most "doesn't show up" problems are content in the wrong array.

    Show me how

    Open the Mod Data Asset and find the field with the Details panel's search box. Click + on the array and pick your class, then save the asset.

    The panel shows field names with spaces ("Additional Engram Blueprint Classes"). The table gives that name and the code name (AdditionalEngramBlueprintClasses). The code name is what you'll see in Blueprint nodes and in other people's notes.

  3. Point your test map at your PGD. That's what makes Play In Editor load your mod.

    Show me how

    Open your mod's test map (TestMapArea_<YourMod>), then Window → World Settings. Search for "game data" and check Primal Game Data Override (PrimalGameDataOverride, on PrimalWorldSettings).

    The Create Mod templates already set it to the mod's own PGD on both maps they create. A map that names no PGD here loads no mod data at all. That's why the DevKit's stock test map never shows your content (lessons §3).

    Since the UE 5.5 DevKit, a modder reports that setting the override on an official map (The Island, Scorched Earth) no longer loads the mod in PIE. I haven't confirmed this on 5.8.1 yet. Test on your own test map.

  4. Reset the cache after every change to the Mod Data Asset or the PGD. This is the cache trap below. It's the cause nine times out of ten.

  5. Test in Play In Editor, then on a dedicated server. Play In Editor (PIE) is the green Play button. If your content isn't there, work through the checklist.

Which field takes what

These are the Mod Data Asset fields people actually use, grouped by what you're adding. The names and types come from the game's compiled class. What goes in each comes from the Create Mod templates, or from modders where I say so.

Engrams and items

Field: panel name / code name Put this in it Notes
Additional Engram Blueprint Classes / AdditionalEngramBlueprintClasses Your engram entries: PrimalEngramEntry children, named EngramEntry_… Not the item, not the structure. Every item template registers its engrams here.
Remove Engram Blueprint Classes / RemoveEngramBlueprintClasses Vanilla engram entries to take out of the list
Remap Engrams / Remap_Engrams From class → To class pairs Replaces a vanilla engram with yours everywhere.
Remap Items / Remap_Items From class → To class pairs Replaces a vanilla item everywhere. Two mods remapping the same item conflict.
Additional Structure Engrams / AdditionalStructureEngrams For Class = a crafting station; Class Additions = the item classes it should craft Modders report it takes items, not engram entries. It's the way to add recipes to a vanilla station without copying it.

Structures

Field Put this in it Notes
Additional Structures To Place / AdditionalStructuresToPlace Your structure Blueprints: PrimalStructure children Modders check this first when a structure won't place or equip.
Additional Structures To Build / AdditionalStructuresToBuild For Structure Item = an existing structure item; Additional Structures = extra structures it can build The structure template uses it to give the vanilla wooden door item a double door.
Additional Structure Variants / AdditionalStructureVariants For Structure Tag + variant entries Variants keyed by a structure tag. I haven't tested it.

The item side of a structure isn't in the MDA. The item and the structure point at each other directly; the table below shows which fields.

Creatures and spawns

Field Put this in it Notes
Additional Dino Entries / AdditionalDinoEntries Your creature's dossier entry: a PrimalDinoEntry child Both creature templates fill it.
The NPC Spawn Entries Container Additions / TheNPCSpawnEntriesContainerAdditions A spawn container, by class or by class string with an "exact string" switch. Then the spawn entries and limits to add. Spawns your creature alongside vanilla on maps that use that container.
Global NPC Random Spawn Class Weights / GlobalNPCRandomSpawnClassWeights From Class, To Classes, Weights, plus an event name and an exact-match switch Turns a share of one species' spawns into others. The creature template turns Stegos into its custom Stego or a Stego, 50/50.
Remap NPC / Remap_NPC From creature → To creature Replaces the creature everywhere. It clashes with any other mod that touches it.
Remap NPC Spawn Entries / Remap_NPCSpawnEntries From container → To container Replaces a map's whole spawn container.

Modders point out that a creature you only spawn by admin command or from code needs none of these. It only needs Extra Resources (below), so it gets cooked. For the three spawn routes and their costs, see tutorials §7.

Logic that runs on everything

Field Put this in it Notes
Additional Default Buffs / AdditionalDefaultBuffs For Class = a character class; Buff Additions = buffs every instance gets The Default Buff template uses the player pawn class. Stacks across mods since v36, March 2024.
Server Extra World Singleton Actor Classes / ServerExtraWorldSingletonActorClasses Your SaveGameActor children One of each is spawned per world on the server. It's the home for global mod logic (lessons §1).
Sparse Data Override Manager / SparseDataOverrideManager A SparseDataOverrideManager child One per mod. Register it on your PrimalGameData, not here: Wildcard's documentation says managers on Mod Data Assets currently fight (Sparse class data).

Cosmetics

Field Put this in it
Mod Custom Cosmetic Entries / ModCustomCosmeticEntries One entry per cosmetic: descriptive name, Cosmetic ID (unique within your mod), Apply To Classes, Mod Skin Item, Mod Skin Structure (structure skins only), Cosmetic Apply As Item Skin

How to fill them in: tutorials §1.

Making sure it cooks

Field Put this in it
Extra Resources / ExtraResources, and the soft version ExtraResourcesSoft Plain structure skins, which Wildcard's skin guide registers here. You don't need it to get an asset cooked.

ASA's cooker packs your whole mod folder, referenced or not, so an asset you only spawn by path from code still ships. Listing those here was the ASE rule. Keep everything your mod uses inside its own folder, and never list a level here: since UE 5.5 that fails the cook. More in lessons §1.

Server-wide switches: leave them alone

These change the whole server, for every mod on it. A general mod should never set them. They're for total conversions and map packs that own the server.

Switch Code name
Default Game Mode DefaultGameMode
Override Server PhysX Substeps OverrideServerPhysXSubsteps
Prevent Photo Mode bPreventPhotoMode
Override Photo Mode Class OverridePhotoModeClass
Force Server Use Dino List bForceServerUseDinoList

The rest

The MDA also has fields for eggs: Additional Egg Items To Spawn and its weights, the fertilized versions, and Additional Extra Egg Items. There are fields for baby and gestation setups, explorer notes, emotes, color definitions, hair styles and human animation overrides.

There are more for skill and milestone trees, missions, world buffs, map item sets, tradable options, buff post-process effects and reference redirects. Remaps cover supply crates and resource components. Every Mod Data Asset field lists them all, says how each stacks with other mods, and which ones no published mod I know of has used yet.

How the pieces connect

This asset Field Points at
Your test map's World Settings Primal Game Data Override your PGD
Your PGD Additional Mod Data Asset your MDA
Your MDA Additional Engram Blueprint Classes your engram entries
An engram entry Blue Print Entry (BluePrintEntry) the item it unlocks
A weapon item Weapon Template (WeaponTemplate) the weapon actor
A structure item Structure To Build (StructureToBuild) the structure
A structure Consumes Primal Item (ConsumesPrimalItem) and Pickup Gives Item (PickupGivesItem) its item
Your MDA Additional Structures To Place the structure
Your MDA Additional Default Buffs buffs, per character class
Your MDA Server Extra World Singleton Actor Classes your singletons

To check the PGD-to-MDA link without opening the slow PGD, right-click the PGD and open the Reference Viewer. The MDA should hang off it.

How mods stack: the merge rules

When a server runs several mods, the game merges every mod's data into one set. I read these rules from the game's compiled merge function. README §4 and lessons §1 go further.

  • Arrays append: Your engrams, structures, default buffs and spawn additions are added to everyone else's. That's why the "Additional…" arrays are the safe way to add things.
  • Maps overwrite on a duplicate key, and the later mod wins. A map here is a key → value field. The MDA's maps are Additional Named Explorer Note Entries, Additional Milestone Trees, Additional Milestone Complete Effects and Additional Skill Tree UI Data Container Classes. Use keys nobody else will pick.
  • Booleans OR: If any mod turns a switch on, it's on for the whole server.
  • Default Game Mode goes to whichever mod merges last.

Modders report a few more things on top of that:

  • Two stacking bugs are fixed. Default buffs on the same class from several mods were fixed in v36, March 2024. Additional structures on the same class were fixed in v59, July 2024. Older threads saying "only the first mod's buff works" are out of date.
  • Some remaps only take effect from the first mod in load order. Load order is the order of the server's mod list.
  • Two mods with the same root folder name can't run together; only the first loads.
  • Two mods with the same Blueprint file name confuse spawn commands, which pick by path alphabetically.

The cache trap

The DevKit reads your Mod Data Asset once, when your mod first loads in a session, and keeps that copy. Add an engram, save, press Play, and PIE still runs the old list. People take this for a broken setup.

Modders have reported it since early 2024, when they said Wildcard knew about it. It still happens in my own PIE tests on 5.8.1 (lessons §3).

Two ways out:

  1. Reset the override. This is the fast way.
    1. Open your test map's World Settings and clear Primal Game Data Override (set it to None).
    2. Press Play, wait until you're in, press Esc.
    3. Put your PGD back in Primal Game Data Override.
    4. Press Play again. Your changes are there.
  2. Restart the DevKit. It's slower, but some modders find the reset crashes their kit. A restart always works.

You only need this after editing the MDA or the PGD. Edits to an item, engram entry or creature Blueprint show up on the next Play without it.

The cache also hides removals. A modder found that removing an engram from the game's engram list at runtime stuck across PIE sessions until the reset.

The cache is a DevKit problem. A cooked mod on a server loads fresh data every start.

It doesn't show up in game: a checklist

Check these in order. The first two are the cause nine times out of ten.

  1. Did you reset the cache after your last MDA or PGD edit? See above.
  2. Is it in the right array? Engram entries go in Additional Engram Blueprint Classes, and structures in Additional Structures To Place. Items for a vanilla station go in Additional Structure Engrams. An item or structure put where the engram entry belongs does nothing.
  3. Does your test map name your PGD in Primal Game Data Override? Is it your own test map, not an official one?
  4. Does your PGD point at your MDA? Hand-copied PGDs often still point at a template's MDA. Check with the Reference Viewer.
  5. Is everything linked to everything else? The engram points at the item through Blue Print Entry. The item points at the weapon or structure. The structure points back at the item through Consumes Primal Item and Pickup Gives Item.
  6. For engrams: is it a new PrimalEngramEntry, not a child or copy of a vanilla engram entry? Level 0 engrams sort to the very bottom of the list, so use level 1 or more. Is Can Be Manually Unlocked on, or another way to unlock it set up?
  7. Does it work with cheat giveitem but not in the engram list? Then the item is fine and the registration isn't.
  8. On a server: does the server log show your mod loading? Look for UShooterEngine::LoadGameMods with N mods and Initialize Primal Game Data Override. More in Reading ARK's logs.
  9. Only spawned or loaded by path? Add it to Extra Resources, or the cook leaves it out.
  10. Another mod touching the same class? Test with your mod alone, then with the other mod first and last.

Common mistakes

My engram doesn't appear, but cheat giveitem works

The engram entry isn't in Additional Engram Blueprint Classes, or the MDA cache is stale. Add it, reset the cache and test again.

The engram screen broke after I added my engram

You edited the master Engram Blueprint Classes list your PGD inherited. Undo that edit, or recreate the PGD as a fresh child of PrimalGameDataARKNX_BP. Then register your engram in the MDA instead.

My structure's preview shows but it won't place, or the item won't equip

It's missing from Additional Structures To Place, the cache is stale, or the item and structure don't point at each other. Modders' checklist also covers placement boxes and snap points. That part is on How to make a custom structure.

My mod works alone and breaks with another mod

Both mods remap or overwrite the same thing: a remap entry, a map key, a server-wide switch or the same root folder name. Move from remaps to the "Additional…" arrays where you can.

It works in PIE and is missing in the cooked mod

Something reached only by path from code isn't in Extra Resources. Or a second PGD in your folder was cooked instead of yours. See When a cook or upload fails.

Check it worked

  • In PIE, press the engram key. Your engram is at its level, unlockable, and the item crafts.
  • Use cheat giveitem with your item's path to check the item on its own. Right-click the asset → Copy Reference gets the path.
  • On a dedicated server, the log shows your mod in LoadGameMods. The server reaches Server: "<name>" has successfully started!.

Watch

Go deeper

Sources

  • DevKit files, checked 2026-11-05 (conf. B). The field lists of the native ModDataAsset (66 fields) and PrimalGameData classes. The structs ClassAddition, BuffAddition, ClassRemapping, ClassRemappingWeight, NPCSpawnEntriesContainerAdditions, StructureToBuildAddition, StructureVariantAddition and CustomCosmeticModObjectSkinEntry, from the game module's reflection data. PrimalWorldSettings.PrimalGameDataOverride. The PGD, MDA and maps of every Create Mod template (BlankMod, CreatureTemplate, DefaultBuff, FlyerTemplate, NewOutfitMod, NewStructureMod, RangedWeaponMod and the Advanced versions). The parent chain and engram list of /Game/PrimalEarth/CoreBlueprints/PrimalGameDataARKNX_BP. The structure item and structure field names.
  • The merge rules: README §4, read from the compiled UPrimalGameData::MergeModData (conf. B). Which MDA fields are maps is from the same check.
  • My own notes: lessons §1 and lessons §3, including the cache in my PIE tests on 5.8.1 (conf. B). The LoadGameMods and Initialize Primal Game Data Override. lines are from real server logs (conf. B).
  • Discord threads (open for server members; conf. D unless noted):
    • the cache reset write-up (2024-03);
    • "Updates to ModDataAsset are not reflected in PIE", where modders said Wildcard knew (2024-02); threads still pointed to the same workaround in 2025-10;
    • the override on official maps no longer loading in PIE since UE 5.5, not checked on 5.8.1 (2025-06);
    • which array takes engram entries and which takes items (2023-11, 2024-10);
    • default buffs stacking, fixed v36 (2024-03);
    • additional structures stacking, fixed v59 (2024-07);
    • every spawn source a mod can use (2024-09);
    • the "Structure Won't Place/Equip" checklist (2024-04);
    • editing the PGD's master engram list breaking the engram screen (2023-11 to 2024-11);
    • the cook picking up a spare "dummy" PGD (2024-02);
    • admin-only creatures needing only Extra Resources (2025-10);
    • an engram removed at runtime sticking across PIE sessions until the cache reset (2024-08).
  • Videos as listed in Watch (conf. D). Jeremy Stieglitz's is official (conf. A, Feb 2024).

Community knowledge from the ARK Modding Community Discord (discussions from November 2023 to October 2025), found with Overseer.

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 files and community knowledge (see Sources)

Look something up in engrams

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

Browse all engrams

Look something up in items

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

Browse all items

Look something up in structures

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

Browse all structures

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 spawn tables

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

Browse all spawn tables

Look something up in buffs and status effects

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

Browse all buffs and status effects

Esc

↑ ↓ move↵ openCtrl ↵ new tab