Start here
7 min readASA DevKit as of November 2026 (UE 5.8.1); ASE where noted
This is my guide to making mods for ARK: Survival Ascended with the ARK DevKit, Studio Wildcard's free Unreal Engine editor on the Epic Games launcher. New to modding? Start with the learning path below. Something broken? Go to Stuck?.
Start with these
- The core method Start from a vanilla asset, make a child, compare.
- Your first mod, start to CurseForge One small change, tested and published.
- How ARK finds your content Why things "don't show up in game", and the fix.
- Symptom index Look up what you're seeing and jump to the fix.
- Reading ARK's logs Where the real error is written down.
- What each asset offers The reference: settings, events and examples.
- Coming from ASE What changed, and moving an old mod across.
What do you want to make?
Pick the closest thing. Each card opens its how-to page.
If yours isn't written yet, the core method still works. Find a vanilla asset that already does what you want, make a child of it (not a copy), and compare.
Items and gear
- A custom item or resource Resources, tools and consumables, start to finish.
- A consumable Food or a potion: what happens when it's used.
- An engram, and why it isn't appearing Level, points, prerequisites and the checklist.
- A weapon and its ammo Guns, bows, melee, and ammo swapping.
- Armor and equipment Slots, armor values, insulation and the worn mesh.
- A cosmetic or skin The official way, from Wildcard's own samples.
Structures
- How to make a custom structure Mesh, placement, snapping, health and decay.
- A crafting station With its own recipes.
- A storage or inventory structure The storage box variant is on the same page.
- A powered or Tek structure Wireless power, fuel, and Tek power.
- A multi-use menu The radial menu on a structure, creature or item.
Creatures
- How to make a custom creature A variant of a vanilla creature: stats and colors. It also gives the overview for a creature from scratch.
- A creature from scratch Your own mesh, skeleton, animation Blueprint and AI, step by step.
- A saddle One that fits your creature, and a platform saddle.
- Taming Foods, affinity, knockout and torpor.
- Breeding Eggs or live birth, gestation, mutations.
- Creature behavior and AI Who it fights, ranges, new attacks, targeting.
- New creatures in the spawns Without replacing a map's tables.
World and loot
- Loot crates and supply drops Your own crate, or your items in vanilla drops.
- A map, or a sublevel mod From the sample island, or added to an existing map.
- Terrain and spawn zones On a custom map: foliage, water, zone managers.
Logic and systems
- A buff or status effect Timed effects, stat changes, and logic on a character.
- A change to vanilla content Without replacing it.
- A singleton Logic that runs for the whole server.
- Server settings Options server owners can change in the ini files.
- Saved data Data that survives a restart.
- UI A HUD element, a menu, a structure's own screen.
Your own assets
- Meshes and animations Blender, import, collision, retargeting.
- Materials, textures and dye regions Vanilla parent materials and color regions.
- Sounds and effects Sound cues, attenuation, Niagara, and who hears what.
Looking up a vanilla class name or value? The database has every creature, item and engram the DevKit ships: /ark/browse/creatures, /ark/browse/items.
Your first mod: the learning path
If this is your first mod, go through these in order. You don't need to know Unreal: every term is explained the first time a page uses it. Every step has its own page. If you'd rather watch first, my beginner guide video walks through the whole path: How to Make an ARK ASA Mod (Complete Beginner Guide). It's on my channel, Hypernatrema Mods, and runs 47 minutes.
- What modding ARK means: what a mod can change, and how mods reach every platform.
- Installing and launching the DevKit: the download, the first launch, and keeping it fast.
- Finding your way around the editor: the Content Browser, the Details panel, and saving.
- Unreal words you'll meet: Blueprint, class, child, class default object, data asset, component, cook, PIE and more.
- The core method: start from a vanilla asset, make a child, compare. Your first mod uses it on a Wooden Club.
- Your first mod, start to CurseForge: the Create Mod wizard, a first item, testing and uploading.
- How ARK finds your content: PrimalGameData and the Mod Data Asset. Read it before anything in part 2. It fixes "it doesn't show up in game". When you need a field it doesn't cover, every Mod Data Asset field lists them all and says how each stacks with other mods.
- Testing your mod: PIE, then a local dedicated server.
- Publishing and updating: CurseForge, updates, and living with ARK and DevKit updates.
Then pick something from the list above.
Understand it: for when it works and you want to know why
These go deeper than the how-to pages. Read them once your first mods work.
- Inheritance and default objects What a child really gets from its parent, and why old things keep old values.
- Sparse class data Why a Set node says CLASS GLOBAL, and how to change a setting for one creature.
- Load order and name collisions What the first mod wins, what the last mod wins, and which names must be unique.
- Performance on busy servers What your mod costs next to forty others, and how to keep it cheap.
- Every Mod Data Asset field All 65, and how each stacks with other mods.
Stuck? Start here
The DevKit rarely shows a clear error. The answer is almost always in a log, and these pages show you where.
- Symptom index Look up what you're seeing and jump to the fix.
- Reading ARK's logs Something doesn't work and you don't know why.
- Reading a crash report The editor, the game or a server crashed.
- When a cook or upload fails The cook or upload failed, or "succeeded" and the mod is broken.
- Works in PIE, not on a server It works in the editor, but not on a server or for other players.
- How ARK finds your content It doesn't show up in game at all.
Before you ask for help
The community Discord is generous with help. People answer faster when your question already has what they'd ask for. Bring these.
1. The right log
| Problem | File |
|---|---|
| Editor or PIE | <DevKit>\Projects\ShooterGame\Saved\Logs\ShooterGame.log is the current session. Older ones are ShooterGame-backup-<date>.log. |
| Editor crash | the newest <date>.crashstack in that same folder, and the ShooterGame.log copy inside the newest <DevKit>\Projects\ShooterGame\Saved\Crashes\UECC-… folder |
| Local cook | <DevKit>\Engine\Programs\AutomationTool\Saved\Cook-<date>_Worker<N>.txt |
| CurseForge cook | Cook-<date>.txt from the build log zip CurseForge gives you |
| Dedicated server | <Server>\ShooterGame\Saved\Logs\ShooterGame.log, plus the .crashstack if it crashed |
| Game client crash | the .crashstack in <Game>\ShooterGame\Saved\Logs\. Start the game with -log if you need a full log. |
Don't paste the whole file into a chat. Find the first error that names one of your own files. Post that line with about twenty lines above it, and attach the full log as a text file if someone asks.
2. Redact it first
Logs carry more than you'd think.
- A server log prints its whole command line. That includes the admin password and the Sentry and CurseForge keys, in plain text. Replace them before posting.
- Logs also hold your PC's name, your Windows user name and IP addresses. Swap those for placeholders like
<PC>and<user>. - Don't post your mod's secrets either. A webhook URL or key in a Blueprint is public the moment you upload. More in lessons §5.
3. What to say
- What you're making, in one sentence, and the class you started from.
- Your DevKit version, shown top right of the editor window.
- Where it fails: PIE (which net mode), single player, your own dedicated server, or a hosted one.
- What you expected, and what happened instead.
- The log lines from step 1, and a screenshot of the Blueprint graph if it's logic.
- What you've already tried.
Search first, too. Most questions have been answered before, and the Discord's archive is searchable through Overseer.
Credits
Every page says which DevKit version it was checked against. Where a fact comes only from what modders report, the page says so in plain words.
This guide stands on other people's work:
- The ARK Modding Community Discord, where most of what modders know about the ASA DevKit was worked out in public. Overseer makes that archive searchable and kindly allowed guides like this one to draw on it. Discord knowledge here is paraphrased, credited by month in each page's Sources, and checked in the DevKit where I could.
- Wildcard Workshop, ZenRowe's official series for the ASE ModKit (#1: Getting Started). It's from 2018, and the basics it teaches still hold: replication, config options, class default objects and SaveGame.
- Studio Wildcard's DevKit documentation and Jeremy Stieglitz's GameFramework and Custom Cosmetics overview.
- The tutorial creators whose videos the guide links with timestamps: SlayerXtreme, Quellcrest, Mist3r Trixt3r, WM Plays, ButtMan, Temptress Lagoon and Exilog.
- ark.wiki.gg for reference (CC BY-NC-SA 4.0).
- The server-log redaction advice comes from my own server logs (checked November 2026).
Community knowledge from the ARK Modding Community Discord (discussions from November 2023 to October 2026), 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
my own logs and the community Discord (see Credits below)
Look something up in creatures
1,551 rows, each with its own page. Search by name or any detail, or start from a category.
By variant
Look something up in items
3,192 rows, each with its own page. Search by name or any detail, or start from a category.