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:
- Make a small test mod that sets only that field.
- Run it in PIE on your mod's own test map. Do the cache reset after every Mod Data Asset edit.
- Cook it and run it on a local dedicated server, then in single player. Those are different paths in the game.
- Add a second test mod that sets the same field, and run both. Swap their order and run again.
- 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
- How ARK finds your content: the fields most mods use, with examples, and the "doesn't show up" checklist.
- Changing vanilla content without replacing it: when a remap is right and when it isn't.
- Game data and registration: the PrimalGameData's fields and the spawn containers.
- How to run global logic: the singleton in full.
- Load order and name collisions: where the order comes from, and the names that must be unique across mods.
Sources
- The game's compiled code, read offline on the 5.8.1 DevKit (CL 830809).
UPrimalGameData::Initialize,UModDataAsset::MergeModDataAssetandUPrimalGameData::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)