Modding guide

How to add creatures to spawns without replacing a map's tables

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

Your creature spawns in the wild next to the vanilla ones. Nothing of the map's own spawns is removed, and other mods that touch the same areas keep working. You do it all from your Mod Data Asset. The first time takes me about an hour, and most of that is testing on a server.

  • You'll make: wild spawns for your creature on the official maps, added alongside vanilla
  • Time: about an hour the first time, mostly testing
  • Level: intermediate (you've made a creature)
  • You'll need: a working creature, a registered mod, and a way to run a local dedicated server

Before you start:

If you only want the steps, read the numbered list and skip the rest.

How wild spawning works

A map is covered in spawn zones. Each zone points at one spawn container: a small asset that lists spawn groups and how often each one is picked. When the zone wants another creature, it picks a group by weight and spawns it.

A spawn entry is one of those groups. "Dodo Spawn (1-5)" on The Island's beach is one entry with five Dodos, each with its own chance to appear. A spawn limit caps how much of a zone one species may fill.

On top of that sit class weights. They don't add spawns; they turn a share of one species into another as it spawns. That's how Alphas appear on The Island.

Your mod can touch this at three points:

Route Mod Data Asset field What it does Use it when
Add to a container The NPC Spawn Entries Container Additions adds your entries and limits to a vanilla container you want your creature alongside vanilla. My default.
Piggyback on a species Global NPC Random Spawn Class Weights turns a share of one species' spawns into yours your creature is a variant of a vanilla one
Replace Remap NPC, Remap NPC Spawn Entries swaps a creature or a whole container everywhere almost never; it breaks other mods

I use the first route unless I have a reason not to. The steps below follow it.

The process

  1. Pick the containers your creature belongs in. Find them in the database by biome and creature. Each map has its own set, so a creature for every map needs an addition per map.

    Show me how
    • Search /ark/browse/spawns for a creature that lives where yours should. For a mid-size land predator on The Island, DinoSpawnEntriesGrassland is a good start. Its rows show every group, weight and limit.
    • Container names follow a pattern: DinoSpawnEntries<Biome> on The Island, SE_DinoSpawnEntries<Biome> on Scorched Earth, and map-specific suffixes elsewhere (_Gen2, _PGM for procedural maps).
    • Check where the container is used. Each container's page has a "Where it spawns" table: how many spawn zones on each map use it. More zones means more places your creature can turn up. The Island's Jungle and Deep Water containers each fill over 100 zones; some cave containers fill one.
    • Ragnarok, The Center, Valguero and Astraeos use copies you can't see. Many of their zones use a _Generic copy of the container, such as DinoSpawnEntriesBeach_Generic. The copies are only in the cooked game, not in the DevKit. They fill 64% of The Center's zones and about a third of Ragnarok's and Valguero's. An addition to DinoSpawnEntriesBeach doesn't reach them. Modders add a second addition with the _Generic name typed into the class string. The container's page names its copy and the zones it fills.
  2. Add an entry to NPC Spawn Entries Container Additions. Point it at the container by name, with Use Exact String ticked. A name doesn't load the map's assets into your mod, and it works for DLC maps too.

    Show me how

    Open your Mod Data Asset, search for "container additions" and click +. Each element has five fields:

    Field Code name Set it to
    Spawn Entries Container Class SpawnEntriesContainerClass leave it at None
    Spawn Entries Container Class String SpawnEntriesContainerClassString the container's name, without _C: DinoSpawnEntriesGrassland
    Use Exact String bSpawnEntriesContainerClassStringUseExactString on
    Additional NPC Spawn Entries AdditionalNPCSpawnEntries your spawn entries (step 3)
    Additional NPC Spawn Limits AdditionalNPCSpawnLimits your limits (step 4)

    This is how Wildcard adds the Carcharodontosaurus to the Giganotosaurus containers in the game's own data: by string DinoSpawnEntriesGigant, exact string on. Wildcard also uses the string with exact string off for a couple of containers. I haven't tested how loosely that matches, so I keep it on.

    Picking the class directly also works, but it's a hard reference. Modders note it ties your mod to that map's content.

  3. Write your spawn entry: who spawns, in what group, and how often. Give the group a name and your creature. Then set each member's chance and offset, and the entry's weight.

    Show me how

    The fields of one entry (struct NPCSpawnEntry), with The Island beach's Dodo group as the example:

    Field Code name Dodo group What it does
    An Entry Name AnEntryName Dodo Spawn (1-5) a label; vanilla puts the group size in brackets
    NPCs To Spawn NPCsToSpawn Dodo × 5 one element per group member
    NPCs To Spawn Strings NPCsToSpawnStrings empty the same by class name, for creatures you can't reference
    NPCs Spawn Percentage Chance NPCsToSpawnPercentageChance 1, 0.7, 0.6, 0.25, 0.2 each member's chance to appear, 0 to 1
    NPCs Spawn Offsets NPCsSpawnOffsets Y 680, 0, −680, −340, 340 each member's position in the group, in cm
    Entry Weight EntryWeight 0.425 how often this group is picked (see Weights and limits)
    Manual Spawn Point Spread Radius ManualSpawnPointSpreadRadius 650 how far the group spreads, in cm
    Group Spawn Offset GroupSpawnOffset Z 35 lifts the group off the ground

    Fill the creature, chance and offset arrays to the same length, in the same order, as vanilla does. The first member should have a chance of 1, so a picked group always spawns something.

    An entry also has per-member level offsets and multipliers, a color set, water height limits and minimum distances from structures and players. Leave them empty unless you need them; levels come from the map and the zone.

  4. Add a spawn limit for your creature. Without one, a lucky zone can fill up with it. A limit says what share of a zone's creatures may be yours.

    Show me how

    One element in Additional NPC Spawn Limits (struct NPCSpawnLimit):

    Field Code name Example
    NPC Class NPCClass your creature
    NPC Class String NPCClassString or its class name with _C
    Max Percentage Of Desired Num To Allow MaxPercentageOfDesiredNumToAllow 0.1 = at most 10% of that zone

    Vanilla values to compare: the beach allows Dodos up to 0.6; the Grassland container caps the Rex at 0.15. The limit counts per zone, not across the whole map. Wildcard's Carcharodontosaurus addition uses 0.5 inside a container that only holds big predators.

  5. (Optional) Piggyback on a vanilla species for a variant. Add an element to Global NPC Random Spawn Class Weights. A share of that species' spawns turns into yours, on every map that spawns it.

    Show me how

    One element (struct ClassRemappingWeight):

    Field Code name Example
    From Class FromClass Stego_Character_BP
    To Classes ToClasses Stego_Character_BP, then your Stego
    Weights Weights 1, 0.1
    Active Event ActiveEvent None, or an event name so it only runs during that event
    Exact Match bExactMatch on, so it doesn't catch other mods' children of the Stego

    List the vanilla creature again in To Classes with its own weight, or every Stego becomes yours. The weights are relative: 1 against 0.1 gives yours about one spawn in eleven. They don't have to add up to 1. SlayerXtreme's Episode 17 corrects Episode 15 on that point.

    Wildcard's own Birthday Dodos use this field: Dodo 0.75, Birthday Dodo 0.25, Active Event Birthday, exact match on. The Creature template does Stego 50/50 with its custom Stego.

  6. Make sure the creature registers and cooks. Add its dossier entry, then reset the Mod Data Asset cache before you test.

    Show me how
    • Additional Dino Entries takes your PrimalDinoEntry child, as in the creature templates.
    • A class you pick in a spawn entry is referenced from your Mod Data Asset. A creature reached only by a class string isn't, so put it in Extra Resources too.
    • A creature you only spawn by command or from your own code needs no spawn fields at all, only Extra Resources.
    • The cache reset is on How ARK finds your content.
  7. Test on a local dedicated server, on the maps you added to. PIE runs your own test map, not the official maps' spawn zones. Single-player stasis makes spawn counts misleading too.

    Show me how
    • Run a local dedicated server on The Island (and each map you target) with your mod. A cooked test build works before publishing; lessons §3 has the -dev project ID route.
    • For the test build only, raise your entry weight so you don't need luck. Put it back before you upload.
    • cheat DestroyWildDinos wipes the wild creatures; they respawn over time. Then fly over the biome you targeted.
    • On test maps with a low creature cap, only the zones nearest you refill after a wipe. That looks like broken spawns and isn't.
    • Water creatures that fail to place are listed in the server's FailedWaterDinoSpawns.log, with coordinates.
    • The full checklist is in Check it worked.

Weights and limits

Weights and limits are where most "it never spawns" and "it's everywhere" reports come from. I read them like this.

Entry weight is a share of the container's total. The Island's Grassland container has 26 groups with weights adding up to 2.184. Its Rex group weighs 0.125, so about 5.7% of picks there are a Rex group. Add an entry with weight 0.1 and your share is 0.1 out of 2.284, about 4.4%. Every vanilla share drops a little.

Per-member chance trims the group. A group of three with chances 1, 0.5 and 0.25 averages 1.75 creatures. The database's "share" column ignores this, so treat it as a rough guide.

The limit is a ceiling, not a rate. A 0.1 limit never makes your creature more common. It stops it from passing 10% of that zone's creatures, however lucky the rolls.

Class weights apply after the pick. A Grassland Rex group can still come out as an Alpha. The Island's World Settings turn about 1 Rex in 55 into one. One entry in The Island's Mountain container even carries its own weights inside the entry.

How the pieces connect

This asset Field Points at
Your Mod Data Asset The NPC Spawn Entries Container Additions a vanilla container, by name
That addition Additional NPC Spawn Entries your creature class (or class string)
That addition Additional NPC Spawn Limits your creature, with its cap
Your Mod Data Asset Global NPC Random Spawn Class Weights a vanilla species → itself + your creature
Your Mod Data Asset Additional Dino Entries your creature's dossier entry
Your Mod Data Asset Extra Resources creatures reached only by string
A map's World Settings NPC Random Spawn Class Weights the map's own re-rolls (Alphas); maps only

Only the last row is out of your reach. It belongs to the map.

The settings that matter

These are the fields people hunt for. All of them are in your Mod Data Asset.

What you're looking for Field Where it lives
Spawn alongside vanilla TheNPCSpawnEntriesContainerAdditions Mod Data Asset
Which container SpawnEntriesContainerClassString + Use Exact String each addition
How often your group is picked EntryWeight each spawn entry
Group size the NPCsToSpawn array and NPCsToSpawnPercentageChance each spawn entry
A cap for your creature MaxPercentageOfDesiredNumToAllow AdditionalNPCSpawnLimits
Turn a share of a species into yours GlobalNPCRandomSpawnClassWeights Mod Data Asset
Only during an event ActiveEvent each class weight
Don't catch child classes bExactMatch each class weight
Replace a creature or container everywhere Remap_NPC, Remap_NPCSpawnEntries Mod Data Asset (avoid)

Load order and other mods

The additions and class weights are arrays, and arrays from every mod are appended together. So your additions stack with everyone else's, whatever order the server lists the mods in. That's the main reason I use them.

Remaps are different. Only one mod can replace a class, and modders report some remaps only work from the first mod in load order. A remapped container also drops every other mod's additions to the old one.

Class weights on the same species roll one after another. If the map or another mod turns a Rex into something first, your roll never happens. Modders describe it that way; I haven't measured the order.

Server owners can add spawns too, with ConfigAddNPCSpawnEntriesContainer in Game.ini. Those don't show up in the game data arrays your code can read.

Common mistakes

My variant spawns on Scorched Earth but never on The Island

Modders report this for Rex, Raptor, Carno and Mosasaurus variants, while other species work. They suspected nested containers. The files point somewhere else. The Island's World Settings re-roll those species into their Alphas with Exact Match off. Scorched Earth only does that for the Deathworm.

With Exact Match off, a child of the Rex probably counts as a Rex and gets re-rolled into a vanilla Rex or an Alpha. That fits every report, but I haven't confirmed it in game or found a tested fix.

Note

The Island re-rolls Rex, Raptor, Carno, Mosasaurus, Tusoteuthis, Leedsichthys and Megalodon this way. Aberration does it for three of its own creatures. Extinction, Genesis, Genesis Part 2 and Lost Colony set Exact Match on. If your variant is a child of one of these species, test on that map before you publish.

It never spawns anywhere

Check the cache first, then the container name: no _C, exact string on, no typo. Then check your first member's chance isn't 0 and the weight isn't tiny. Raise the weight in a test build to prove the route works.

It spawns on The Island but hardly at all on Ragnarok or The Center

Those maps fill many zones from _Generic copies of the containers, and your addition only reaches the original. Add the same entries a second time, pointed at the _Generic name (step 1). Valguero and Astraeos use copies too.

It spawns everywhere

Your entry weight is large next to the container's total, or there's no limit. Compare with the vanilla weights in the database and add a MaxPercentageOfDesiredNumToAllow.

My spawns vanished when another mod was added

The other mod remaps the container or the species you build on. Test with each mod alone, then both, in both orders. If you use remaps yourself, move to additions.

Every Stego became my Stego

The class weight's To Classes doesn't list the vanilla Stego with its own weight. Add it back (step 5).

Only the biome near me has creatures after a wipe

That's the test map's creature cap, not your spawns. Test on a real map on a dedicated server.

Check it worked

  1. On a local dedicated server, your creature appears on each target map. It shows up in the biomes you chose, in the group sizes you set.
  2. Vanilla creatures still spawn there in roughly their usual mix.
  3. Over a few wipes, it never passes your limit in one area.
  4. With another spawn mod loaded, both mods' creatures still appear.
  5. Your test-build weight is back to the real value before you upload.
  6. If something is missing, read the server log for your class name before changing fields. See Reading ARK's logs.

Watch

Go deeper

Sources

  • DevKit files, read offline on 2026-11-05: The structs NPCSpawnEntry, NPCSpawnLimit, NPCSpawnEntriesContainerAdditions and ClassRemappingWeight, and the fields of UModDataAsset, UPrimalGameData, UNPCSpawnEntriesContainer and APrimalWorldSettings, from the game module's reflection data. /Game/PrimalEarth/CoreBlueprints/Spawners/DinoSpawnEntriesBeach, DinoSpawnEntriesGrassland and DinoSpawnEntriesMountain (the example values). PrimalGameDataARKNX_BP's CoreNPCSpawnEntriesContainerAdditions (the Carcharodontosaurus by class string) and CoreGlobalNPCRandomSpawnClassWeights (the Birthday Dodo). The World Settings of The Island, Scorched Earth, Aberration, Extinction, Genesis, Genesis Part 2 and Lost Colony (the Alpha re-rolls and their Exact Match flags). The DevKit's cheat manager for DestroyWildDinos.
  • The database (Spawn entry containers (DevKit extraction)): container weights and shares, and which zones on each map use each container. The zone links come from my survey of the cooked server maps (October 2026), not from the DevKit, and include the _Generic copies.
  • tutorials §7, lessons §3, and FailedWaterDinoSpawns.log from real server logs.
  • The ARK Wiki: Spawn entries and Server configuration (limits count per container region; the ini spawn keys).
  • What modders report, from the ARK Modding Community Discord:
    • the three Mod Data Asset routes, and Extra Resources for admin-only creatures (September 2024, October 2025);
    • referencing containers by class string, as the Carcharodontosaurus does (January 2026);
    • Ragnarok and The Center switching to _Generic spawn containers, and mods adding a second set of additions for them (July 2025);
    • Rex, Raptor, Carno and Mosasaurus variants not spawning on The Island (April 2024, January 2026), and the nested-container theory; my World Settings reading is my own;
    • class weights rolling one after another, and the map's Alpha weights clashing with dino mods (August 2024, May 2026);
    • low creature caps on test maps after a wipe (2025);
    • some remaps only working from the first mod in load order (2024).
  • Videos listed under Watch: creators' tutorials, not checked against the kit.
  • Community knowledge from the ARK Modding Community Discord (discussions from April 2024 to May 2026, mainly #asa-general and #asa-blueprints), found with Overseer. Threads that helped (they open for server members): every spawn source a mod can use (September 2024), spawning in the wild versus admin-only (October 2025), a Rex variant not spawning on The Island (January 2026), containers by class string (January 2026), the generic spawners on Ragnarok and The Center (July 2025).
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 spawn containers and game data, the community Discord and creators' videos (see Sources)

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 creatures

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

Browse all creatures

Esc

↑ ↓ move↵ openCtrl ↵ new tab