Modding guide

How to make a map or a sublevel mod

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

The goal is a World Partition map that loads on a dedicated server, with terrain, harvestable foliage, water, wild creatures, supply drops, spawn points and a working sky. The first one takes a few evenings, and much of that is waiting on the editor and the cook.

  • You'll make: a custom map from Wildcard's sample island, or a level your mod loads into an existing map
  • Time: a few evenings for a small map; cooks take hours
  • Level: intermediate (you've made and published a mod)
  • You'll need: an empty mod, a CurseForge project, and plenty of RAM

Before you start:

  • Read How ARK finds your content. A map tests through the same Primal Game Data Override field, with the same cache trap.
  • Creators recommend 64 GB of RAM. The kit runs big maps at a few frames per second.
  • The database's map pages, such as The Island, show each official map's settings.

The two routes

Route What you get How it ships
A full map your own world, picked by name when a server starts a map mod, with an Entry Map Name
A level loaded into a map your actors placed into The Island or another map a regular mod with a loader actor

ASE had map extensions; ASA doesn't. The substitute is a level your mod loads at runtime, covered in Adding to an existing map.

For a full map, start from DuplicateSampleIsland. It's Wildcard's script, and it copies a small, complete World Partition island into your mod. Most videos start from an Empty Open World level and copy actors by hand instead. Their notes on water, spawns and the landscape still help.

The process

  1. Make an empty mod, then run DuplicateSampleIsland. The script copies the sample map into your mod under the name you give it.

    Show me how
    • Create the mod with UGC → Create Mod → Blank, then close the editor.
    • Run <DevKit>\ModTools\Scripts\DuplicateSampleIsland.bat. It asks for your mod's folder and a level name, such as MyMap_WP. That name is what servers will type.
    • It runs a World Partition builder on /Game/Maps/SampleIsland/SampleIslandWP. Leave its log window open until it finishes.
    • Don't move or rename the level later; modders report World Partition data breaking when they do.
    • Delete the wizard's spare test level so it doesn't cook into your map.
  2. Learn what the sample gives you. It's a small island with every system already wired up.

    Show me how
    Part Actors in the sample
    Terrain a Landscape with 16 streaming proxies, two runtime virtual texture volumes
    Foliage 16 Instanced Foliage Actors: trees, bushes, rocks, metal, crystal
    Water BP_IslandWaterPlane, four Physics Volumes with Water Volume ticked, an underwater post process volume
    Sky UDS_Island, UDS_Island_Weather, DayCycleManager, sky light, height fog, wind
    Wild spawns 16 land and 16 water zone managers, each with two volumes
    Players 40 Player Starts in eight regions
    Data layers five, including Landscape and Persistent

    See the layers in Window → World Partition → Data Layers Outliner. Load the whole map before you edit across it.

  3. Set the World Settings ARK needs. Open Window → World Settings. The fields are listed in The settings that matter.

    Show me how
    • Primal Game Data Override: your mod's PrimalGameData, while you test, so PIE loads your content. The sample and the official map mods leave it empty.
    • Map Friendly Name: the name in the server list.
    • Min/Max Kill X and Y, Kill Z: the sample's edges are ±48,000, about 480 m each way. Widen them before you grow the landscape.
    • Override Player Spawn Regions: the spawn screen's names. Each Player Start's Spawn Point Region indexes this list from 0.
    • Editor Enable NPC Spawners on, Editor Do Force Disable NPC Spawners off.
    • Latitude/Longitude Origin and Scale for your map's size, and Current Minimap Data once you have one.
  4. Shape the terrain. Sculpt the sample's landscape, or import a heightmap. Keep the ARK landscape material.

    Show me how
    • The sample's landscape uses MI_ASA_IslandLandscape with Nanite on, and the Island's paint layers.
    • For an import, creators copy the Island's landscape material and virtual-texture assets into the mod. They set the material's map size value to the landscape width in centimeters, then Build Grass Maps Only. tutorials §9 has the values.
    • Paint the data layers too. High wetness makes the whole map look wet.
    • Set the landscape's collision preset to GroundTerrain.
  5. Paint foliage with ARK's foliage types. A foliage type's Attached Component Class is the harvest component that makes it give resources.

    Show me how
    • In Foliage mode, add the official foliage types, the assets named …_settings.

    • Reference vanilla types directly. Copy one into your mod only to change it, and use Copy, never Move. Moving a vanilla asset breaks the kit until you verify its files.

      Setting Example
      Attached Component Class WoodHarvestComponent, StoneHarvestComponent, MetalHarvestComponent_Rich
      Replicate This Component on, for anything harvestable
      Is Falling Tree on for trees, with Destroyed Mesh Actor Class TreeFalling_Blueprint
      Destroyed Mesh what a bush or rock leaves behind
    • For a different yield, make a child of the harvest component and change Max Harvest Health. Rich metal has 1,700; normal metal has 620.

  6. Add water. The ocean is a water plane plus physics volumes. Lakes come from the ASA water tool.

    Show me how
    • Ocean: keep BP_IslandWaterPlane and stretch its physics volumes over your sea. A Physics Volume only swims when Water Volume is ticked.
    • Lakes: BP_WaterTool_ASA, then bake water components. Creators report the water-plane mesh must be copied into the mod to render in game.
    • Water creatures that can't place are listed in the server's FailedWaterDinoSpawns.log.
  7. Set up spawn zones. A zone manager points at a spawn container and links two volumes. The zone volume counts creatures; the smaller spawn volume is where they appear.

    Show me how
    • Place NPCZoneManagerBlueprint_Land (or _Water), an NPCZoneVolume and an NPCZoneSpawnVolume. Make the zone volume larger in every direction, and let the spawn volume pass through the ground.
    • On the manager, fill Linked Zone Volumes, Linked Zone Spawn Volume Entries (weight 1) and NPC Spawn Entries Container Object.
    • The sample's land managers use DinoSpawnEntriesJungle, Min Desired Number Of NPC 23, multiplier 1.85. Its water managers use Inland Water (12) and Ocean (9).
    • Land managers tick Never Spawn In Water; water managers tick Only Spawn In Water. Default Zone Spawn Volume Floor Tags is Landscape.
    • Keep spawn actors in an always-loaded data layer. The sample uses Persistent.
    • Your own creatures need your own container: How to add creatures to spawns.

    [!NOTE] On the sample, 12 of the 16 water managers, the Ocean ones, have an empty zone volume slot. I haven't tested whether they spawn as shipped. Link a zone volume to each before you rely on ocean spawns.

  8. Add biomes, supply drops and caves. Each is a volume. Copy one from an official map and change its fields.

    Show me how
    • Biomes: a Biome Zone Volume sets the zone name, temperature, wind, a buff and music. The sample has none.
    • Supply drops: a Supply Crate Spawning Volume. Linked Supply Crate Entries lists crate classes with weights; Linked Spawn Point Entries lists the points where crates land.
    • Scorched Earth's drops use Max Num Crates 1 and Min Crate Distance From Structure 8,000. Its caves use cave crates. Your own crates: How to make loot crates.
    • Caves: a post process, structure prevention and audio volume each, plus a physics volume under water.
  9. Keep the sky together. The UDS pair and the Day Cycle Manager work as a set. Don't add other lights.

    Show me how
    • UDS_Island and UDS_Island_Weather drive light and weather. The DayCycleManager is still required.
    • Modders delete stray Directional Light and Sky Light actors when they add UDS.
    • The sample turns on Force No Precomputed Lighting, so you never build lighting.
    • Day length is in World Settings: Day Cycle Speed Scale, Day Time Speed Scale, Night Time Speed Scale.
    • Sky, weather and post process actors must not be Spatially Loaded.
  10. Test in PIE, then on a local dedicated server. PIE proves the map works. The server proves it cooks and loads by name.

    Show me how
  11. Set the Entry Map Name, then upload. In UGC Settings, pick your mod and type the level's file name.

    Show me how
    • Entry Map Name (map mods only) is your map's main level. Single player opens it, and a server opens it when started with -MapModID=<your mod ID> and no map name on the command line (a map name there wins). Don't add _WP unless the file has it.
    • The same panel has Disable Singleplayer.
    • Clear the Primal Game Data Override before you upload; see Other mods stop working on my map.
    • The level must sit inside your mod's folder, or it doesn't upload.
    • Publishing and updating your mod covers the rest.

Adding to an existing map

There's no extension system, so a mod adds to a map by loading a level of its own at runtime.

  1. Build your additions in a new level. Only your custom assets need to be in your mod folder.
  2. Load it from a singleton with Load Level Instance (by Object Reference) or (by Name). How to run global logic shows the singleton.
  3. Load it on the server and on every client, including late joiners. A loaded level isn't replicated by itself.
  4. Upload it as a normal mod, with no Entry Map Name.

Positions differ per map, so plan a level or offset per map. A landscape in your level fights the map's runtime virtual texture, so meshes and foliage work better than terrain.

Keep the map fast

These are Epic's general habits for any Unreal level, from their optimization talks. I haven't measured them on an ARK map, and ARK's own scalability settings may already handle some.

  • Lights cost the most, so turn off Cast Shadows where a light doesn't need them, keep Attenuation Radius small, and give every light a Max Draw Distance. Past four overlapping stationary lights, one falls back to fully dynamic shadows. Niagara lights (embers, sparks) shouldn't cast shadows. The Light Complexity view mode shows overlap.
  • Give meshes that never move Static mobility. One Epic demo lost 20% of its frame to a building made of movable meshes.
  • Draw distance: Set Max Draw Distance on small props, or use a Cull Distance Volume, which maps object size to cull distance. Its effect only shows in game view (press G). Zero means "always drawn".
  • Draw calls are components times materials. Hundreds of copies of one prop belong in foliage or an Instanced Static Mesh component: one draw call per material. Merge Actors (Tools menu) bakes a cluster into one mesh.
  • Foliage: density scaling on low settings removes the visuals but keeps the collision. Masked leaves cost more in overdraw than in polygons.
  • Occlusion works per object, so big occluders (cliffs, walls) hide what's behind them and a field of small things doesn't. Block long sight lines in your layout.
  • Detail Mode on a component or light drops small props and fill lights on low settings.
  • Collision on clutter: Meshes get physics by default. Set NoCollision on leaves, pebbles and props nobody touches. In Epic's 5.8 profiling talk, one game spent 10.5 s of its load creating physics for clutter.
  • Keep each instanced mesh component's copies in one area. A component whose copies spread across the map gets huge bounds and costlier shadows.
  • If a mesh can be Nanite, make it Nanite.
  • Keep the landscape material light, because it covers most of the screen and every instruction counts many times.

How the pieces connect

This asset Field Points at
Your map's World Settings Primal Game Data Override your PrimalGameData, for testing
UGC Settings Entry Map Name your level's file name
A zone manager Container Object; Linked Zone (Spawn) Volumes a spawn container; its two volumes
A foliage type Attached Component Class a harvest component
A supply crate volume Linked Supply Crate Entries; Linked Spawn Point Entries crate classes; points on the map
A Player Start Spawn Point Region an index into Override Player Spawn Regions
Your singleton Load Level Instance your added level

The settings that matter

What you're looking for Setting Where
Name in the server list Map Friendly Name World Settings
Map edges Min/Max Kill X and Y, Kill Z World Settings
Spawn screen regions Override Player Spawn Regions World Settings
Creatures in PIE Editor Enable NPC Spawners World Settings
Alphas and variants NPC Random Spawn Class Weights World Settings
Which DLC engrams work here Valid Engram Groups Bit Mask World Settings
Banned structures Prevent Structure Classes World Settings
Station recipes on this map Inventory Component Appends World Settings
Starting items per map Additional Default Map Item Sets your Mod Data Asset
Which level loads (single player, and servers started with -MapModID) Entry Map Name UGC Settings

Valid Engram Groups Bit Mask filters engrams by their Engram Group. Scorched Earth and Ragnarok use 6; Valguero uses 46. I haven't decoded the bits, so copy the value from the official map closest to yours. The full list is in World settings and the game mode.

Common mistakes

The map is black, or stuck in daylight

The UDS pair or the Day Cycle Manager is missing, or an extra light fights them. Copy all three back from the sample and delete other lights (step 9).

No dinos spawn

Check World Settings first: Editor Enable NPC Spawners on, Force Disable off. Then check each manager links both volumes and a container, and the spawn volume clips into the ground. Modders also replace fields left at -1 (step 7).

Players fall through the world

Modders set the landscape collision to GroundTerrain and turn off Is Spatially Loaded on every landscape proxy. If players die at one line, check the kill bounds.

The landscape shows The Island's texture in the distance

Your landscape reads another map's virtual texture. Modders found the landscape virtual textures must live in your map's folder. Check where your duplicate's volumes point.

Resources harvest in PIE but not after the cook

Turn on Replicate This Component on the foliage type, and check its Attached Component Class.

The cook takes forever

Cooks run from 30 minutes to about 12 hours, and maps sit at the long end. A cloud cook stuck for a day has usually hung, so re-upload. Shrink textures and read When a cook or upload fails.

The map is too big for consoles

CurseForge rejects a cross-platform cook over 5 GB, because of the consoles' limit. PC-only uploads have a 15 GB limit for the source and cooked files. Some modders have reported a higher limit, but go by CurseForge's published number. Copied 16k landscape textures alone can pass 2.5 GB, so lower their resolution first.

My map isn't in the server list, or shows as UNKNOWN

The Entry Map Name doesn't match the level's file name. Remove any _WP the file doesn't have, and set Map Friendly Name.

Other mods stop working on my map

Your map names its own PrimalGameData in the override. Modders report this cuts out other mods, and official maps leave it empty. Put creatures and items in a companion mod instead.

HLOD building crashes or never ends

Modders start the build, stop it after a few minutes, then build the HLOD actors from the Outliner in batches. Merged HLODs have crashed the kit.

Check it worked

  1. The server starts on your map by name, and the server list shows your friendly name.
  2. You can spawn in every region.
  3. Land and water creatures return after cheat DestroyWildDinos.
  4. Trees fall, rocks break, and each gives the right resource.
  5. A supply crate lands within a few minutes.
  6. Night comes, weather changes, and the edges kill where you expect.
  7. Another mod loaded alongside still works.

Watch

Go deeper

Sources

  • Unreal Fest 2026 talks (UE 5.8, the kit's version; auto captions): clutter collision, instance bounds, Nanite and the landscape material (Profiling with Pirates, 2026-07-14).
  • General Unreal videos (not ARK-specific, not checked in the kit): lights and shadows (Epic, manual, 2022); overlapping lights and mobility (auto, 2025); draw distance and cull volumes (Epic, manual, 2020); foliage, occlusion and merging (Epic, manual, 2019); draw calls and instancing (auto, 2025).
  • Official pages, read 2026-11-08: Wildcard's DevKit changelog (-MapModID and the entry map) and CurseForge's uploading a new mod via ARK's DevKit (the 5 GB cross-platform and 15 GB limits).
  • DevKit files, read offline on 2026-11-06: DuplicateSampleIsland.bat; SampleIslandWP's World Settings and its 269 external actors; the foliage types Kapok_04_settings and SM_MetalRock_01_Settings; Scorched Earth's supply crate volumes; Ragnarok's and Valguero's World Settings; the reflected fields of ANPCZoneManager, ANPCZoneVolume, ASupplyCrateSpawningVolume, ABiomeZoneVolume, APrimalWorldSettings, FWorldDefaultItemSet.
  • The database (Maps (DevKit extraction)) for kill bounds, data layers and engram masks; tutorials §9 for the creators' landscape and water notes.
  • What modders report, from the ARK Modding Community Discord: no map extensions, and runtime-loaded levels that don't replicate (2024 to 2025); a map's own PrimalGameData breaking other mods (March 2025); Entry Map Name and _WP (2024, July 2025); spawn zone fixes (2024, July 2026); the Day Cycle Manager (2023, October 2025); falling through the landscape (2024); virtual textures and console size (2023, September 2026); hung cooks (January 2024); HLOD builds (June 2025); harvestable foliage (May and July 2026).
  • Videos under Watch are creators' tutorials, not checked against the kit.
  • Community knowledge from the ARK Modding Community Discord (discussions from November 2023 to July 2026, mainly #asa-mapping and #asa-general), found with Overseer. Threads that helped (they open for server members): load a level instead (June 2025), a map's own PrimalGameData (March 2025), no dinos on a custom map (December 2024), Entry Map Name (July 2025), falling through (November 2024), harvestable foliage (July 2026).
Where this page's information comes from

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

the DevKit's sample map and official maps, the community Discord and creators' videos (see Sources)

Esc

↑ ↓ move↵ openCtrl ↵ new tab