Modding guide

Every Mod Data Asset field, and how it stacks

16 min readASA DevKit as of November 2026 (UE 5.8.1)

How ARK finds your content explains the Mod Data Asset fields you'll use on most mods. This page lists all of them: 65 you can set, plus one retired switch. For each one I say what it takes, what it does, and what happens when two mods on the same server both set it.

I also say how proven each field is. I counted which fields 156 published mods actually set. About half the fields are used by nobody. The game still merges them, but nobody has shown they work in a live game.

  • You'll learn: what every Mod Data Asset field is for, how it combines with other mods, and which ones are safe to rely on
  • Time: 20 minutes to read; use the tables as a lookup after that
  • Level: beginner to veteran; read How ARK finds your content first
  • You'll need: nothing open; the DevKit helps if you want to look at the fields as you go

How mods stack

When a server loads mods, the game builds one set of game data out of all of them. It goes through the mod list from front to back. The first mod's PrimalGameData becomes the game's. Every Mod Data Asset is then merged into it, one after another. A client builds its list from the one the server sends, in the server's order.

The merge rule depends on the kind of field:

Kind of field What the merge does What that means for two mods
A list (most fields) Adds your entries to everyone else's Both mods' entries apply. This is why mods stack.
A map (a key → value field) Adds your keys; a key that's already there is overwritten The later mod wins on a shared key. Pick keys nobody else will.
A switch (true or false) If any mod turns it on, it's on One mod can turn it on for the whole server. No mod can turn it off.
Override Server PhysX Substeps (a number) Combines the bits of every mod's number 2 from one mod and 4 from another give 6, not 4.
Default Game Mode, Override Photo Mode Class The last mod to set it wins Two mods that both set it fight, and load order decides.
Mod Name, Mod Description Kept per mod No effect on other mods.
Sparse Data Override Manager The game makes one of your class for your mod Each mod should get its own, but there's a bug: see Logic that runs on everything.

Three fields don't follow those rules:

  • Color Definitions merges by color name. A new name is added. A name that's already there is only replaced when your entry has Has Override Priority ticked and the existing one doesn't.
  • Dino Baby Setups keeps the first entry for each creature. An entry is only added when no entry with the same creature name tag exists. You can't replace a vanilla creature's baby setup this way.
  • Some fields skip the merge. Mod Custom Cosmetic Entries and the three custom-cosmetic hair lists are read on their own, earlier. Extra Resources and Extra Resources Soft aren't merged at all: they only tell the cook what to pack.

Which mod counts as "later" follows the mod list. I've read that in the code for a client. Whether a dedicated server follows its own mod list in exactly that order is something I haven't tested.

How to read the tables

  • Field is the name in the Details panel, then the code name you'll see in logs and in C++ headers.
  • Proven says how sure you can be that it works from a mod:
    • N mods: that many of the 156 mods I counted set it;
    • template: a Create Mod template fills it in, so Wildcard set it up;
    • tested: I've seen it work in PIE myself;
    • untried: the game merges it, but no mod I counted uses it. Test it before you build on it.

Identity

Field What goes in it What it does Stacks Proven
Mod Name / ModName Your mod's name Comes from the mod's folder name when you create the mod per mod 154 mods
Mod Description / ModDescription A short description Your mod's description per mod 4 mods
Mod Icon / ModIcon A texture An icon on the escape and spawn menus. Only the first mod in load order gets to show one. first mod only 4 mods

Check your Mod Name. The Create Mod templates leave it as cfeditor on both the PrimalGameData and the Mod Data Asset. About two in three mods I counted still say cfeditor. It doesn't break anything I know of, but it makes your mod harder to tell apart in logs. All five of Wildcard's own content mods set a real name.

Engrams and items

Field What goes in it What it does Stacks Proven
Additional Engram Blueprint Classes / AdditionalEngramBlueprintClasses Your engram entries (PrimalEngramEntry children) Adds them to the engram list. Not the item, the engram entry. list 50 mods
Remove Engram Blueprint Classes / RemoveEngramBlueprintClasses Vanilla engram entries Takes them out of the list list 1 mod
Remap Engrams / Remap_Engrams From → To pairs of engram entries Swaps a vanilla engram for yours everywhere list 5 mods
Remap Items / Remap_Items From → To pairs of items Swaps a vanilla item for yours everywhere list 4 mods
Additional Structure Engrams / AdditionalStructureEngrams For Class: a crafting station; Class Additions: the items it should craft Adds recipes to a station without copying it list 14 mods

Two mods remapping the same item or engram conflict. Modders report that some remaps only take effect from the first mod in load order. A remap also hides the vanilla class from any other mod looking for it by class. Prefer the "Additional" fields when you can.

Structures

Field What goes in it What it does Stacks Proven
Additional Structures to Place / AdditionalStructuresToPlace Your structures (PrimalStructure children) Lets them be placed. The first thing to check when a structure won't place. list 37 mods
Additional Structures to Build / AdditionalStructuresToBuild For Structure Item: an existing structure item; Additional Structures: extra structures it builds Gives a vanilla item more structures to build list 8 mods, template
Additional Structure Variants / AdditionalStructureVariants A structure tag, a tier and a variant tag Adds a model-only variant of a building piece list template, untried in mods

The structure template uses the second one to give the vanilla wooden door a double door. It uses the third to add a floor variant on the tag Floor_Square, tier Wood. If you use variants, keep your variant tags stable once players have built with them.

Creatures and spawns

Field What goes in it What it does Stacks Proven
Additional Dino Entries / AdditionalDinoEntries Your creature's dossier entry (PrimalDinoEntry child) Registers the creature's dossier list 4 mods, template
The NPC Spawn Entries Container Additions / TheNPCSpawnEntriesContainerAdditions A spawn container (by class or by name) and the entries and limits to add Spawns your creature alongside vanilla list 2 mods
Global NPC Random Spawn Class Weights / GlobalNPCRandomSpawnClassWeights From Class, To Classes, Weights Turns a share of one species' spawns into others list 3 mods, template
Remap NPC / Remap_NPC From → To creature pairs Swaps a creature class list tested: no effect on admin spawns
Remap NPC Spawn Entries / Remap_NPCSpawnEntries From → To spawn containers Replaces a whole spawn container list 1 mod
Additional Allow Download Dino Classes / AdditionalAllowDownloadDinoClasses Your creatures Lets them transfer on maps that limit downloads. Cryopods need it there too. list untried

Remap NPC on a Mod Data Asset didn't change cheat SpawnDino in my test. I remapped the Dodo to a Dilophosaur and still got a Dodo. Whether it changes natural spawns, I haven't tested. Survival of the Fittest sets its remaps on its PrimalGameData, not on a Mod Data Asset.

The spawn fields have a catch on four maps. Ragnarok, The Center, Valguero and Astraeos fill many zones from copies of the spawn containers that only exist in the shipped game. How to add creatures to spawns explains the second entry you need for them.

Eggs and babies

Field What goes in it What it does Stacks Proven
Additional Egg Items to Spawn / AdditionalEggItemsToSpawn Egg items More items in the wild egg drop table list untried
Additional Egg Weights to Spawn / AdditionalEggWeightsToSpawn One weight per egg item above How often each one drops list untried
Fertilized Additional Egg Items to Spawn / FertilizedAdditionalEggItemsToSpawn Fertilized egg items The same, for fertilized eggs list untried
Fertilized Additional Egg Weights to Spawn / FertilizedAdditionalEggWeightsToSpawn One weight per item above list untried
Additional Extra Egg Items / AdditionalExtraEggItems Items, with an optional creature class Chance drops when an egg is laid list untried
Dino Baby Setups / DinoBabySetups Baby settings, keyed by a creature's name tag Baby setup for a new creature first entry per creature wins untried
Dino Gestation Setups / DinoGestationSetups Gestation settings, same shape Gestation setup for a new creature list untried

The two egg lists and their weight lists are separate lists that the game reads side by side. If another mod adds items without weights, the pairs could slip out of line. I haven't tested that.

Supply crates and harvesting

Field What goes in it What it does Stacks Proven
Remap Supply Crates / Remap_SupplyCrates From → To pairs of crate structures Swaps a crate for yours everywhere list untried in my count; see below
Remap Active Event Supply Crates / Remap_ActiveEventSupplyCrates Crates with weights, for events Changes event crates list untried
Remap Resource Components / Remap_ResourceComponents From → To pairs of harvest components Changes what a tree or rock gives, and its regrowth list 1 mod

Remap Supply Crates takes crate structures, not loot sets. A modder in early 2024 remapped the loot set Blueprints and nothing changed. When they remapped the crate structures instead, the loot updated. Two other reports pull the other way. A late-2023 report had the remap crash single player on launch. Another modder couldn't get remaps to work in early 2026. Treat it as untried: test it on a dedicated server and in single player before you build on it.

Logic that runs on everything

Field What goes in it What it does Stacks Proven
Server Extra World Singleton Actor Classes / ServerExtraWorldSingletonActorClasses Your SaveGameActor children One of each is spawned per world, on the server list 87 mods, tested
Additional Default Buffs / AdditionalDefaultBuffs For Class: a character class; Buff Additions: buffs Every character of that class gets the buffs list 17 mods, template, tested
Additional Buff Post Process Effects / AdditionalBuffPostProcessEffects Post-process materials Materials a buff can switch on (screen effects) list 5 mods
Sparse Data Override Manager / SparseDataOverrideManager A SparseDataOverrideManager child Overrides class-wide values per creature or item; one per mod see below 1 mod
Additional World Buff Definitions / AdditionalWorldBuffDefinitions World buff data World-wide buffs list untried

Register the Sparse Data Override Manager on your PrimalGameData, not here. Wildcard's own DevKit documentation says there's a bug: managers set on Mod Data Assets fight over which one the game creates. Until a build fixes it, use the PrimalGameData's field (or World Settings, for a map mod). The merge code I read makes one manager per mod, so the fight is somewhere later. Sparse class data covers the manager in full.

The singleton is the most-used field of all. What I've seen in PIE:

  • It spawns on the server only. Clients only see it if you turn on replication.
  • It's saved with the world. After a restart it comes back from the save instead of being spawned again. BeginPlay still runs, with "loaded from save game" set to true.

Default buffs reached a freshly spawned player before OnShooterCharacterSpawned fired, on server and client. A creature spawned with cheat SpawnDino got them too, when the entry named PrimalDinoCharacter. A player body restored from a save didn't get them again. Plan for that if your buff must always be there.

Cosmetics, emotes and animation

Field What goes in it What it does Stacks Proven
Mod Custom Cosmetic Entries / ModCustomCosmeticEntries One entry per cosmetic: name, Cosmetic ID, Apply To Classes, skin item, structure skin Adds custom cosmetics players can apply read on its own 24 mods, including Wildcard's
Custom Cosmetic Head Hair Style Definitions / CustomCosmeticHeadHairStyleDefinitions Hair styles New head hair for custom cosmetics read on its own untried
Custom Cosmetic Facial Hair Style Definitions / CustomCosmeticFacialHairStyleDefinitions Hair styles New facial hair read on its own untried
Custom Cosmetic Eyebrows Definitions / CustomCosmeticEyebrowsDefinitions Hair styles New eyebrows read on its own untried
Additional Head Hair Style Definitions / AdditionalHeadHairStyleDefinitions Hair styles New head hair styles list untried
Additional Facial Hair Style Definitions / AdditionalFacialHairStyleDefinitions Hair styles New facial hair styles list untried
Unlockable Emotes / UnlockableEmotes Emote entries: name, description, message, group Emotes players can unlock list 2 mods
Emote Groups / EmoteGroups Group name, color and icon Groups for your emotes on the wheel list 2 mods
Additional Animations Prevent Input / AdditionalAnimationsPreventInput Animation montages Blocks player input while one plays list 1 mod
Additional Human Male Anim Sequence Overrides / AdditionalHumanMaleAnimSequenceOverrides From → To animation pairs Replaces player animations list untried
Additional Human Female Anim Sequence Overrides / AdditionalHumanFemaleAnimSequenceOverrides The same, female list untried
Additional Human Male Anim Montages Overrides / AdditionalHumanMaleAnimMontagesOverrides From → To montage pairs Replaces player montages list untried
Additional Human Female Anim Montages Overrides / AdditionalHumanFemaleAnimMontagesOverrides The same, female list untried

Cosmetics have their own walkthrough: How to make a cosmetic or skin.

Colors

Field What goes in it What it does Stacks Proven
Color Definitions / ColorDefinitions Color name, color value (linear), Has Override Priority New colors for creatures and items by name tested

I added a color on a test mod. It became color ID 101, the first one after vanilla's 100. Setting a tamed creature's region to 101 colored it on server and client.

Creatures can only use 127 color definitions in all. Vanilla uses 100, so every loaded mod together has about 27 new creature colors to share. IDs from 128 up are dyes. The field's own tooltip says to stay below index 200, but for creatures the real limit is 127. What happens past it, I haven't tested.

Because the IDs depend on load order, never store a mod color by its number. Refer to it by name: color sets do. Give your colors a prefix (MyMod_Ember) so their names never clash with another mod's.

World content: notes, item sets, missions and trading

Field What goes in it What it does Stacks Proven
Additional Named Explorer Note Entries / AdditionalNamedExplorerNoteEntries Name → note entry Defines new explorer notes by name map: later mod wins untried in my count; see below
Additional Explorer Note Spawns / AdditionalExplorerNoteSpawns A note name, a location per map, and a chest class Places note chests on named maps list untried
Additional Default Map Item Sets / AdditionalDefaultMapItemSets Item sets, a list of maps (empty means all), once or every respawn Gives players items on chosen maps list untried
Available Missions / AvailableMissions Missions Missions on every map list untried
Wants to Run Missions / bWantsToRunMissions A switch Turns missions on any mod turns it on untried
Additional Tradable Options / AdditionalTradableOptions Tradable option classes Trading options list untried
Additional Milestone Trees / AdditionalMilestoneTrees Name → milestone tree Milestone content map: later mod wins untried
Additional Milestone Complete Effects / AdditionalMilestoneCompleteEffects Name → effect The effect when a milestone completes map: later mod wins untried
Additional Skill Trees / AdditionalSkillTrees Progression tree assets Skill trees list 1 mod
Additional Skill Tree UI Data Container Classes / AdditionalSkillTreeUIDataContainerClasses Name → UI data class The UI for a skill tree map: later mod wins 1 mod

Modded explorer notes are learned by name. A modder found in early 2026 that renaming a note and cooking again made players forget it. The named entries are only reachable through an explorer note chest. A mod can't give a named note an index number, so a chest is the only way players get it.

Making sure it cooks

Field What goes in it What it does Stacks Proven
Extra Resources / ExtraResources Plain structure skins Registers them, per Wildcard's skin guide not merged 33 mods
Extra Resources Soft / ExtraResourcesSoft The same, as soft references The same not merged 2 mods

Most of those 33 mods list assets here so they get cooked. That's a habit from ASE, where the cook packed only what something pointed at. ASA's cooker packs your whole mod folder, so a singleton or a creature only admins spawn ships without being listed. What it leaves out is anything outside your mod folder. Don't list a level here: since UE 5.5 that fails the cook.

Leftovers

Field What goes in it What it does Stacks Proven
Additional Invalid Reference Redirects / AdditionalInvalidReferenceRedirects Old class → new class Lets saves find a class that no longer exists. Cryopods use it to recover creatures. list untried
Additional Player Achievements / AdditionalAppIDItems Items tied to a platform app ID Platform items; the panel name and the code name don't match list untried

Server-wide switches: leave them alone

These change the whole server, for every mod on it. Most can't be undone by another mod. They're for total conversions that own the server.

Field Stacks Proven
Default Game Mode / DefaultGameMode last mod wins 1 mod (Survival of the Fittest)
Override Photo Mode Class / OverridePhotoModeClass last mod wins untried
Prevent Photo Mode / bPreventPhotoMode any mod turns it on untried
Force Server Use Dino List / bForceServerUseDinoList any mod turns it on untried
Override Server PhysX Substeps / OverrideServerPhysXSubsteps bits combine untried
Force Enable Physics Simulation / bForceEnablePhysicsSimulation_DEPRECATED ignored by the game retired

Testing a field nobody uses

About half these fields are untried. If you want one, test it before you build a mod on it:

  1. Make a small test mod that sets only that field.
  2. Run it in PIE on your mod's own test map. Do the cache reset after every Mod Data Asset edit.
  3. Cook it and run it on a local dedicated server, then in single player. Those are different paths in the game.
  4. Add a second test mod that sets the same field, and run both. Swap their order and run again.
  5. Write down the server type, the load order, and what you saw.

If it works, tell the community Discord. You'll be the first to say so for most of these.

Common mistakes

I changed the Mod Data Asset and nothing happened

The DevKit caches the Mod Data Asset. Do the cache reset: clear the map's Primal Game Data Override, play once, put it back, play again.

I can't tell what my Mod Data Asset actually sets

Open it and turn on Show Only Modified Properties from the gear on the right of the Details panel's search bar. Modders ask for exactly this screenshot when they help: it shows every field you've set, and nothing else. Do the same on your PrimalGameData. It's how people find a game mode they cleared by accident.

My template didn't come with a Mod Data Asset

It happens to some people. Make one: right-click in the Content Browser, then Miscellaneous → Data Asset, and pick ModDataAsset. Then open your PrimalGameData and set Additional Mod Data Asset to it.

Two mods' colors swapped places

Mod color IDs depend on load order. Change the mod list and the numbers move. Refer to mod colors by name, not by ID.

My game mode or photo mode change works alone and breaks with another mod

Those fields go to the last mod in load order. Only one mod on a server can set them. If yours isn't a total conversion, take them out.

Go deeper

Sources

  • The game's compiled code, read offline on the 5.8.1 DevKit (CL 830809). UPrimalGameData::Initialize, UModDataAsset::MergeModDataAsset and UPrimalGameData::MergeModData: the merge order, the rule for each kind of field, and the Color Definitions and Dino Baby Setups exceptions. The field list and types are from the debug symbols and the game module's reflection data.
  • My count of 156 Mod Data Assets from published mods, mostly community mods: which fields each one sets. The counts are from October 2026. I don't name the mods.
  • My PIE tests on 5.8.1: the cache, default buffs, the singleton, Remap NPC against cheat SpawnDino, and a mod color at ID 101.
  • The Create Mod templates in the DevKit: which fields Wildcard's own templates fill.
  • Discord threads (open for server members):
    • Remap Supply Crates taking crate structures, not loot sets (2024-01);
    • supply drop remaps crashing single player on launch (2023-11);
    • remaps not working, and remaps hiding classes from other mods (2026-01);
    • explorer notes learned by name, and only through a chest (2026-02);
    • "Show Only Modified" to check a Mod Data Asset (2025-10);
    • making a Mod Data Asset by hand when a template leaves it out (2024-04, 2023-10);
    • color ID = definition index + 1 (2026-09).

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

Where this page's information comes from

Applies to: ASA DevKit as of November 2026 (UE 5.8.1)

the game's compiled merge code, my count of 156 published mods, my PIE tests and the community Discord (see Sources)

Esc

↑ ↓ move↵ openCtrl ↵ new tab