Modding guide

Symptom index

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

Start here when something is wrong and you don't know which page covers it. Find what you see, read the usual cause, then follow the link to the section that fixes it.

The entries are grouped by where the problem shows up. If two pages help, both are linked, the better one first. Each group ends with the pages whose "Common mistakes" hold more.

Before anything else

Three checks find most problems before you open any page below.

  1. Read the log. Search it for your mod's folder name and read the first error. See Reading ARK's logs.
  2. Check registration. Most "it's not there" problems are a missing Mod Data Asset entry or a stale cache. See It doesn't show up in game: a checklist.
  3. Test on a local dedicated server. PIE hides most multiplayer bugs. See Testing your mod.

It doesn't show up in game

  • cheat giveitem works, but my engram isn't in the list. The engram entry isn't in Additional Engram Blueprint Classes, or PIE is using the cached Mod Data Asset. Engram checklist, registration
  • My changes to the Mod Data Asset don't show in PIE. The DevKit reads it once per session and keeps that copy. The cache trap
  • My test map loads none of my content. Its Primal Game Data Override is empty or names the wrong PrimalGameData. Testing your mod
  • The engram screen broke after I added my engram. You edited the inherited master Engram Blueprint Classes list instead of the Mod Data Asset. Registration
  • It's learned, but I can't craft it. Give Blueprint To Player Inventory is off, or the item asks for a station. Engram, item
  • My engram sits at the bottom of the list, or in the Tek section. Its level is 0, or Force Is Tek Engram is on. Engram
  • I registered my structure and nothing happened. Additional Engram Blueprint Classes takes engram entries only; the structure goes in Additional Structures To Place. Engram
  • It doesn't appear in the Cosmetics menu. It has no Mod Custom Cosmetic Entries row, or the Mod Data Asset is cached. Cosmetic
  • My singleton never runs, or isn't in the dropdown. It isn't in the Mod Data Asset, the cache is stale, or its parent is Actor instead of SaveGameActor. Singleton, dropdown
  • The icon is a gray arrow, a blank square or missing. The icon is set in the old Item Icon field instead of Item Icon JIT. Item

More: How ARK finds your content, How to make an engram.

It works in PIE but not on a server

  • It worked in PIE and does nothing on my server. The code runs on the wrong machine, or the cooked game never loaded something. Works in PIE, not on a server
  • Clients don't see a variable change. The variable or actor doesn't replicate, it was set on a client, or the structure is dormant. PIE vs server
  • My effect, sound or animation plays only for me. It was spawned on the server or one client; use a multicast from the server. PIE vs server
  • My Run on Server event never fires. The client doesn't own that actor, so Unreal drops the call. PIE vs server
  • My ini settings come back empty, or the cast to the game mode fails. The ini and the game mode exist only on the server. PIE vs server, singleton
  • My singleton works on the server, but clients never see it. It doesn't replicate or isn't relevant to every client. PIE vs server
  • My CDO edit works for the host, not for clients. Every machine has its own class defaults, and the client never ran the edit. Changing vanilla, PIE vs server
  • It works in the DevKit and is dead in the cooked game. A soft reference never loaded, or an asset reached only by path wasn't cooked. PIE vs server, registration
  • My Print String shows nothing on the server. Print String is stripped from shipping builds; use Print Message in Shipping Build. PIE vs server
  • It works for the first player and not for the next one. Late joiners miss multicasts, and players spawned before your bind never trigger it. PIE vs server
  • My timer stops after nobody has been nearby for a while. Stasis put the actor to sleep. PIE vs server
  • Dinos turn invisible after they come out of stasis. A multicast on a repeating timer breaks their setup on clients. PIE vs server

More: Works in PIE, not on a server, Testing your mod.

The editor or game crashes

  • It crashes on start, or a few seconds after the map appears. Usually the GPU, a driver or an overlay, not your mod. Installing, the GPU
  • Everything I open from my mod crashes the kit. The kit's files or cache are damaged, or an asset is corrupted. Installing, a corrupted asset
  • The crash says EXCEPTION_ACCESS_VIOLATION, or a cast failed. Code used a None or destroyed object. Crash reports
  • It crashes when I compile, save or start PIE with one Blueprint. That Blueprint's graph is damaged. Crash reports
  • It crashes after a long session, saying it ran out of memory. The DevKit's memory creeps up until RAM and page file run out. Crash reports
  • It crashes when I open the inventory in PIE, stop PIE or switch maps. These are known DevKit crashes with simple workarounds. Known PIE crashes, weapon
  • The game or server crashes and every frame says UnknownFunction. Shipping builds have no symbols; reproduce it on a local server. Crash reports

More: the five crash families, Installing the DevKit.

The editor and PIE

  • It's stuck on the splash screen, or frozen. It's usually compiling shaders or loading, not crashed. Installing, busy or crashed?
  • My mod's folder isn't in the Content Browser. Show Plugin Content is off. Editor
  • I edited a vanilla asset and nothing changed in the uploaded mod. Mods only ship their own folder; make a child instead. Your first mod, editor
  • My test server won't start with my unpublished mod. The project ID needs -dev. Testing on a server before you publish
  • A friend can't join my -dev test server. Add them as a project member with Cross Platform Testing ticked. Testing on a server before you publish
  • My local cook keeps getting replaced on the server. The server's CurseForge client re-downloads files that differ. Your first mod
  • My time checks are wrong in PIE. The world clock starts at 200,000,000 seconds, not zero. Testing your mod

More: Finding your way around the editor, Installing the DevKit, Testing your mod.

The log shows an error

  • "Accessed None": A node used an empty object reference; the next line names the Blueprint and node. Reading logs
  • LogBlueprint: Error with a [Compiler] message: A node or pin your Blueprint uses changed or is gone. Reading logs
  • "Failed to load" or "a dependent package was not available": Your asset points at something deleted, moved, in another mod or in DLC. Reading logs
  • "Serial size mismatch" or "stream is most likely corrupted": An asset file is damaged. Reading logs, crash reports
  • PIE closes itself with "Runaway loop detected". A loop or recursion ran too long. Reading logs

More: The lines that matter, the noise every launch prints.

The cook or upload fails

  • The cook ends with an ExitCode that isn't 0. The number only means "read the cook log". Cook failures
  • CurseForge says the cook succeeded, but the mod is broken. CurseForge only rejects a cook when the cooker crashes. Cook failures
  • "Couldn't save package, filename is too long": The full path, cooker prefix included, is over 260 characters. Cook failures
  • The cook is rejected and nothing looks wrong. A folder named Windows, or another reserved name, can break it. Cook failures
  • "Skipping non mounted imported package": Your asset references another mod's content. Cook failures
  • Players without a DLC can't use my mod, or textures are missing live. You referenced DLC or kit-only content. Cook failures
  • Blueprints that compiled last week fail in the cook. An update changed a type, often hard to soft references. Cook failures, loot
  • The upload fails with an "unhandled exception". Modders found the cover image must be exactly square; crop it and try again. Your first mod
  • The upload worked, but the mod isn't on my CurseForge dashboard. The email you typed in the DevKit must be the one you log in to CurseForge with. Your first mod
  • My upload was rejected with no log. Early rejections come without logs; run a local cook to see the errors. Cook failures
  • The upload window is stuck on the cooking tools. Your kit is out of date, on the beta branch, or newer than CurseForge's cooker. Installing, publishing

More: the known killers, Your first mod.

Creatures

  • My variant has the parent's stats. Your status component's priority isn't higher than the inherited one. Creature
  • My creature just stands there, or never walks to its target. A copied creature lost its AI controller, the map has no nav mesh, or Dont Wander is on. Creature AI, creature
  • It never attacks, or the attack does no damage. The attack ranges don't fit the body, or the swing notify, radius or damage type is missing. Creature AI, no damage
  • My tame attacks me or my tribe. A targeting override skips the team check, or a passive tame kept a carnivore's AI. Creature AI, taming
  • It won't eat my food while knocked out. The food isn't in its diet, or its priority is 0. Taming, creature
  • It wakes up too soon, or tranqs don't knock it out. Torpor drains too fast or is blocked. Taming
  • My babies hatch as the vanilla species. Your creature still lays its parent's egg. Breeding
  • They won't mate. A breeding switch is off, or the two are different classes without Additional Mating Classes. Breeding
  • The egg says "too cold" and never hatches. The test map has no temperature. Breeding
  • It doesn't spawn in the wild. It isn't in a spawn field, the container name is wrong, the cache is stale, or the test map's creature cap hides it. Spawns, creature
  • My variant spawns on Scorched Earth but never on The Island. The Island likely re-rolls children of some species into vanilla ones. Spawns
  • Every Stego became my Stego. The class weight no longer lists the vanilla creature. Spawns
  • The saddle won't go in the slot. Its owner tags don't match the creature's Dino Name Tag. Saddle, creature
  • The saddle is invisible, huge or floating. The mesh isn't rigged to this creature's skeleton, or the socket or offset is wrong. Saddle, huge or floating
  • The rider sits inside the creature or floats. The rider socket is missing or misplaced. Saddle

More: creature, creature AI, taming, breeding, saddle, spawns.

Structures

  • The item does nothing, or the preview won't place. The item and structure don't point at each other, the cache is stale, or the encroachment box is too big. Structure, registration
  • Snapping acts strangely after I changed snap points. Snap changes don't reach a running PIE session. Structure
  • My structure snaps to vanilla pieces, or they snap to mine. It inherited the parent's structure tag and snap flags. Structure
  • All the placement rules stopped working. Your placement override returns "allowed" instead of passing the reason through. Structure
  • My mesh is there, but players walk through it. The mesh has no simple collision, or the preset is NoCollision. Structure
  • My recipe doesn't show in my station. The item isn't a recipe in Default Inventory Items, or a placed station still has its old list. Crafting station, old recipes
  • Items won't go into my station or box. A fuel-burning parent only accepts fuels. Crafting station
  • It has the recipes but never crafts. The station isn't on; crafting waits for fuel or power. Crafting station

More: structure, crafting station.

Items and gear

  • My tool equips but does nothing. Its Weapon Template still points at the parent's weapon, or at nothing. Item
  • My resource is ignored in a vanilla recipe override. Server recipe overrides need _C on every class name. Item
  • Equipping my weapon gives me the vanilla one. Weapon Template still points at the vanilla actor, or the loaded ammo picks it. Weapon
  • My ammo won't load, or the weapon won't switch back after special ammo. A link is missing between an ammo and the weapon actor. Weapon, switching back
  • My changes to fire rate or clip size vanish. The weapon's config is rebuilt from the defaults on every equip. Weapon
  • My weapon is stuck in a T-pose in first person. The first-person mesh has no animation class, or isn't rigged to the weapon skeleton. Weapon
  • My armor is invisible, or shows on one body type only. No attachment entry matches that body, or it has no mesh. Armor, one body type
  • The armor floats, or the body pokes through. The mesh isn't weighted to the player's bones, or the texture mask doesn't hide that area. Armor, poking through
  • The armor stats don't apply. Used isn't ticked on the stat, or you're testing an old piece. Armor
  • My buff stays after I take the armor off. It was added by hand and never removed. Armor
  • My cosmetic shows the plain Custom Survivor look. Apply To Classes misses a class. Cosmetic
  • Players can only pick one of my two cosmetics. Two entries on the same class share a Cosmetic ID. Cosmetic
  • My creature costume goes on every creature, or on none. It needs Is Item Skin and a tag or class filter. Cosmetic
  • My weapon skin shows both meshes. The original meshes aren't hidden on equip. Cosmetic
  • My cosmetic works in single player but not on a server. The server owner hasn't allowed it. Cosmetic
  • My item never shows up in the vanilla crate. Old crates keep their first roll, or the edit missed the server or the map's set. Loot
  • A crate gives five different items when I set a quantity of 5. The quantity counts picks unless Apply Quantity To Single Item is on. Loot

More: item, weapon, armor, cosmetic, loot.

Buffs, singletons and vanilla changes

  • My change only applies to new things. Existing things copied the old default when they were made. Inheritance
  • My buff vanishes after a second. The base buff's Deactivate After Time is 1. Buff
  • Static Add Buff returns nothing. You called it on a client; add gameplay buffs on the server. A client-only buff needs its own setup. Buff
  • My event or override never fires. Its bUseBP… switch is off. Buff, creature AI
  • Creatures or players already in the world don't get my setup. Default buffs and spawn binds only catch new arrivals; sweep the existing ones at start. Buff, singleton
  • My change hits every creature of that species. You set a sparse class data value, which the whole class shares. Buff, creature
  • My singleton runs twice. Single player and listen hosts run both branches, and replicated singletons run on clients too. Singleton
  • My buff can't find the singleton at server start. Nothing promises the singleton spawns first. Singleton
  • Old items still show the old value. Only new items copy the class defaults. Changing vanilla
  • Players see my changes in single player after leaving my server. A vanilla CDO edit lingers until they restart the game. Changing vanilla

More: buff, singleton, changing vanilla.

UI and input

  • My widget never shows. You created it on the server, in Try Multi Use, or the entry isn't Client Side Only. UI
  • My UI works in the DevKit but not in the live game. Widget code ran on the server, which PIE lets draw. UI
  • It shows for the host only. Get Player Controller 0, or a client event on an unowned actor, lands on the host. UI
  • Every player sees my HUD, or it opens twice. Each nearby client has a copy of the buff, and Begin Play runs on all of them. UI, buff
  • Input is stuck after I close my menu. You set the input mode or cursor yourself and never restored it. UI
  • The E key stopped working. An input node in a buff consumes the Use key. UI, buff
  • My multi-use entry doesn't show. The switch to use Blueprint entries is off, or the array you return isn't the one you added to. Multi-use
  • Vanilla's multi-use entries disappeared. You skipped the parent call. Multi-use
  • My multi-use entry fires on the client only. Client Side Only is ticked, or Try returned false. Multi-use, Client Do

More: UI, multi-use.

Saving and restarts

  • My variable resets after a restart. SaveGame isn't ticked, a client set it, Begin Play resets it, or the actor isn't saved. Save data, singleton
  • It saves on a server but not in the DevKit. The kit doesn't save unless you add the launch switches and tick Play Persistent Player. Save data, testing
  • My buff is gone after a restart. Buffs don't save by default. Buff, save data
  • My creature lost its buff after a cryopod. Cryopods drop every buff. Save data
  • My saved reference is empty after a restart. References don't survive; save an ID instead. Save data

More: save data.

Updates and other mods

  • My mod broke after an ARK or DevKit update. Overridden events, replaced properties and changed types break quietly. Publishing, after each update

  • The old version still loads after my update. The file isn't approved yet, or the server or game hasn't restarted. Publishing

  • Players say my mod isn't loaded after an update. Their game half-applied the update; a restart or reinstall fixes it. Publishing

  • Placed structures vanished after my update. You renamed, moved or deleted their class. Publishing

  • My mod works alone and breaks with another mod. Both remap or overwrite the same thing. Registration

  • My spawns vanished when another mod was added. The other mod remaps the container or species you build on. Spawns

  • Another mod's multi-use entry replaced mine. You share a use index. Multi-use

  • Server owners say their ini or loot config stopped working. Your mod replaces an array they override, or remaps the class they name. Changing vanilla, loot

  • My ported ASE mod has "Parent: None" Blueprints or errors on old nodes. Missing parents, stale pins and changed types. Coming from ASE

  • My ported ASE mod has odd level caps or missing engrams. Its PrimalGameData still has the ASE parent. Coming from ASE

  • My ported mod tests fine in the kit, but the upload is tiny or the cooked mod crashes. It was copied, not moved, into its plugin. Coming from ASE

  • My mod only works when it's first in the mod list. It remaps a class another mod remaps too, or uses a remap that only works from the first mod. Load order

  • A server owner's ini line hits the wrong item. Two mods share a short class name. Load order

  • Creature colors changed after a mod was added. Mod color IDs follow load order. Load order

More: publishing, load order and other mods, load order and name collisions.

Go deeper

Sources

  • Built from the "Common mistakes" and fix-it sections of the guide pages linked above, as of 2026-11-06. Each page's own Sources list where its facts come from.
Where this page's information comes from

Applies to: ASA DevKit as of November 2026 (UE 5.8.1); ASE where noted

the guide's own pages (see Sources below)

Esc

↑ ↓ move↵ openCtrl ↵ new tab