Modding guide

How to make a custom structure

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

An item in your inventory places your own structure, with your mesh on it, sensible health and decay, and an engram that teaches it. Snap points and a storage or crafting inventory come along if you want them. The first one takes me about an afternoon, mostly on placement and snapping. After that, the next takes under an hour.

  • You'll make: a structure players learn, craft and place, with your mesh, snap points and an inventory if it needs one
  • Time: an afternoon the first time; under an hour after that
  • Level: beginner (you've made your first mod)
  • You'll need: a mod set up and registered, a vanilla structure to start from, and optionally a mesh

Before you start:

  • Have your mod project open on its test map, with your PrimalGameData and Mod Data Asset linked. Your first mod covers that.
  • Read How ARK finds your content too. It's the reason most new structures "don't show up".
  • Pick a vanilla structure that already behaves like yours: a box, a station, a wall. The database lists them all with health, snap points and inventory: /ark/browse/structures.
  • A mesh is optional. Use your own from Blender, or put vanilla meshes together as components.

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

The process

  1. Pick the vanilla structure closest to yours. Start from a storage box for anything that holds items, a crafting station for anything that crafts, and a wall or foundation for building pieces. Everything you don't change, you get for free.

    Show me how

    Some good starting points, with their real parents in the current kit:

    You want Start from Its parent chain
    A box or container StorageBox_Small (database) StructureItemContainerBaseBP → native PrimalStructureItemContainer
    A crafting station StorageBox_AnvilBench (the Smithy) StructureItemContainerBaseBP → PrimalStructureItemContainer
    A plain placeable with no inventory StructureBaseBP native PrimalStructure

    Open the vanilla structure and its item side by side with the database page. The fields named on this page are the ones to compare. "Native" means the C++ class at the root: you can't edit it, only inherit from it.

  2. Make children, not copies: one for the structure, one for its item, and a new engram. A child Blueprint inherits everything from its parent and stores only what you change. It keeps working when Wildcard updates the parent. A copy freezes the old values and old graphs in your mod.

    Show me how
    • Right-click the vanilla structure Blueprint → Create Child Blueprint Class, save it in your mod folder, and give it your mod's short prefix.
    • Do the same for its item. The small storage box's item is PrimalItemStructure_StorageBox_Small. Its chain is PrimalItemStructureGeneric → PrimalItemConsumableGeneric → PrimalItem_Base → native PrimalItem, with MyItemType set to Structure.
    • Make a new engram: a Blueprint with parent PrimalEngramEntry. Don't duplicate or subclass the vanilla engram (EngramEntry_StorageBox_Small). My beginner guide video shows why at 15:58.

    The one place a child can hurt: some vanilla structures add their inventory component in a way the child can't edit. Step 8 covers that.

  3. Link the three together. The engram teaches the item, the item places the structure, and the structure knows which item it used up.

    Show me how
    Asset Field Set it to
    Engram BluePrintEntry your item
    Engram RequiredCharacterLevel, RequiredEngramPoints 1 or more; a level of 0 sorts to the bottom of the list
    Item StructureToBuild your structure
    Item DescriptiveNameBase, ItemIconJIT, BaseItemWeight, BaseCraftingResourceRequirements name, icon, weight, recipe
    Structure ConsumesPrimalItem your item
    Structure DescriptiveName the name players see when they look at it

    These are the exact fields the vanilla small storage box uses: engram level 4 and 6 points, item weight 4, and the structure's ConsumesPrimalItem names the item. ConsumesPrimalItem lives in the structure's sparse class data, the class-wide values ASA keeps in a separate block. So look for it in Class Defaults, not in the Event Graph's variables.

  4. Give it your mesh and materials. The structure's look is one static mesh component. Replace the mesh on it; don't delete the component.

    Show me how
    • In the components list, select My Static Mesh (StructureMesh) and set your mesh on it. The structure's MyStaticMesh points at that component. Modders report that deleting it and adding your own mesh component breaks the structure.
    • Your own meshes, materials and textures must live in your mod's folder. Referencing vanilla ones is fine. To kit-bash, add vanilla meshes as extra components. You only need a copy of a vanilla mesh if you edit the mesh itself.
    • Collision: open your mesh and use Collision → Auto Convex Collision. For shapes players walk into, set Collision Complexity to "Use Complex Collision As Simple" instead. Then check the component's collision preset isn't NoCollision.
    • Dyeing: the structure's AllowStructureColorSets has six entries, one per paint region. The material needs a colorization setup for paint to show.
  5. Set up placement. Placement is a set of boxes and traces the game checks before the preview turns green. Start from the parent's values and only change what your mesh's size forces you to.

    Show me how

    The fields, with the small storage box's values (units are centimeters):

    Field Box value What it does
    PlacementEncroachmentBoxExtent 10 × 17.5 × 10 half-size of the box that must be free of other things
    PlacementEncroachmentCheckOffset Z 55 where that box sits relative to the structure
    PlacementTraceScale 30 × 45 × 20 size of the trace that finds the ground
    PlacementYawOffsetIncrement 90 rotation step when the player rotates the preview
    bPlacementChooseRotation, bTakeGroundNormal, bForceSnappedStructureToGround, bAdjustPlacementIfCollide on free rotation, tilt to the ground, drop snapped pieces to the ground, nudge out of collisions

    bRequiresSnapping, PlacementCollisionAdjustmentBuffer, MaxSnapLocRange and SnappingRotationOffset are sparse class data in ASA. Set them in Class Defaults, and treat them as fixed for the whole class at runtime.

    To see the boxes, type DebugStructures in the PIE console. It's a player-controller command in the kit. If the preview is green but won't place, modders find the encroachment box is usually too tall for the mesh.

    Your own "can't place here" text goes in the structure's Prevent Build Structure Reason String Override list. If you override BPIsAllowedToBuild, pass the incoming reason through. Returning "allowed" switches off every vanilla placement rule (lessons §8).

  6. Add or adjust snap points. A snap point is a spot where your structure attaches to another one (FROM), or where others attach to it (TO). Your child inherits the parent's whole list.

    Show me how

    The small storage box has 6 snap points. Here are two:

    SnapPointDescription PointLocOffset Direction Tag list
    FROM Box 0, 0, 0 bAttachFromPoint on SnapTags.SnapFromStructureTagsToInclude = StorageBox_Small
    TO Left 0, −130, 0 bAttachToPoint on SnapTags.SnapToStructureTagsToInclude = StorageBox_Small

    Each entry also has PointRotOffset, ToPointSnapTypeFlags, SnapPointMatchGroup and per-class include/exclude lists. The structure itself carries StructureTag (StorageBox_Small) and StructureSnapTypeFlags (8192), and your child inherits both. That's why a child of the box snaps to vanilla boxes. If it shouldn't, give it its own StructureTag and update the tag lists.

    • Overriding one snap point means owning the whole list (lessons §8).
    • Stop and restart PIE after every snap edit. Snapping misbehaves until you do.
    • On structures with alternate pieces (rails, sloped walls, triangle roofs), the FROM points on the alternates have to line up with the main piece's. Modders report that inserting a point at the start of an alternate's list breaks it.
    • Snap rotation by tag reads the single StructureTag, not the newer StructureTags array.
  7. Set health, decay and resistances. Start from the parent's numbers and change what your structure needs. Tiers like thatch, wood and stone are damage tables, not health numbers.

    Show me how
    Field Small storage box Notes
    Health 500 (the Smithy: 1500) 100 if no Blueprint sets it (the C++ default)
    DecayDestructionPeriodMultiplier 4 times the base period, 345,600 s (4 days), which the server's settings scale again
    StructureSettingsClass StructureSettings_BrokenByStone which damage types can hurt it, as multipliers
    DamageTypeAdjusters dino melee × 4 per-structure extra multipliers
    bCanBeRepaired, bUsesHealth on

    The tiers (thatch, wood, stone, metal, Tek) are covered in lessons §8. If your structure runs setup logic, run it from BPPostLoadedFromSaveGame as well as on placement. Otherwise it's lost after a restart.

  8. Give it an inventory, if it stores or crafts. The inventory is a separate component class. The structure only points at it.

    Show me how

    The vanilla values:

    Storage box Smithy
    Inventory class PrimalInventoryBP_StorageBox_Small PrimalInventoryBP_AnvilBench
    MaxInventoryItems (slots) 15 75
    Crafting off bAllDefaultInventoryIsEngrams, bForceInventoryBlueprints, bUseCraftQueue, bAllowRemoteCrafting on
    Recipes none the items in DefaultInventoryItems

    For a station, each item it crafts points back with CraftingRequiresInventoryComponent = your inventory class. It also goes in your inventory's DefaultInventoryItems, with bAllDefaultInventoryIsEngrams on. Never tick an item's own "Is Engram" flag.

    The locked inventory: On some children the inherited inventory component shows as editable only in the parent. Modders report two ways out:

    • Build your child from the bare base, StructureItemContainerBaseBP, which has no inventory component of its own. Then add your own inventory component.
    • Or remove the inherited one in the construction script and add your own.

    Make your inventory class a child of the vanilla one, so it keeps the settings you didn't touch. After changing the inventory setup, pick the structure up and place it again.

    To let your station craft a vanilla station's recipes, or show other mods' additions to it, look at ForceAllowCraftingForInventoryComponents and Impersonate on the inventory component (tutorials §8).

  9. Register the engram. Add your engram to the Mod Data Asset; that's what puts it in players' engram lists. How ARK finds your content has the field and the cache trap.

    Show me how
    • Add the engram class to the Mod Data Asset's Additional Engram Blueprint Classes (my beginner guide video, 20:24).
    • Additional Structure Engrams is a different thing: it adds an item to a vanilla station's recipe list. You don't need it for a new structure.
    • Modders also report checking Additional Structures to Place when a structure won't equip.
    • The editor keeps a cached copy of the Mod Data Asset. After editing it, clear the World Settings "Primal Game Data Override", run PIE once, then put it back. Restarting the DevKit works too.
  10. Test it. PIE first, then a local dedicated server.

    Show me how

    In PIE: learn the engram (or right-click the item in the content browser → Give), place it on the ground and on a foundation, rotate it, snap a second one, open its inventory, damage it, pick it up, demolish it. Then the same on a local dedicated server, and once more after restarting the server so it loads from the save. The full list is in Check it worked.

How the pieces connect

This asset Field Points at
Your PrimalGameData its Mod Data Asset field your Mod Data Asset
Test map's World Settings Primal Game Data Override your PrimalGameData
Mod Data Asset Additional Engram Blueprint Classes your engram
Engram (PrimalEngramEntry child) BluePrintEntry your item
Item (PrimalItemStructure… child) StructureToBuild your structure
Structure ConsumesPrimalItem your item (the one placing uses up)
Structure PickupGivesItem (optional) the item picking it up returns, when that should differ
Structure its inventory component your PrimalInventoryBP… class
Items crafted in it CraftingRequiresInventoryComponent your inventory class
Mod Data Asset Additional Structure Engrams only to add your item to a vanilla station

The settings that matter

What you're looking for Field Where it lives
The mesh My Static Mesh (StructureMesh) structure, components
Max health Health structure, Class Defaults
How fast it decays DecayDestructionPeriodMultiplier structure
What can damage it StructureSettingsClass, DamageTypeAdjusters structure
Why the green preview won't place PlacementEncroachmentBoxExtent, PlacementEncroachmentCheckOffset structure
Snap points SnapPoints structure
What it snaps with StructureTag, StructureSnapTypeFlags, each point's SnapTags structure (the tag is sparse data)
Must snap / can't stand alone bRequiresSnapping structure, sparse data
Slots MaxInventoryItems the inventory component's class
Recipes DefaultInventoryItems + bAllDefaultInventoryIsEngrams the inventory component's class
Name, weight, recipe DescriptiveNameBase, BaseItemWeight, BaseCraftingResourceRequirements item
Engram level and cost RequiredCharacterLevel, RequiredEngramPoints engram

Common mistakes

The item does nothing when I use it, or the preview won't place

Check the links first. The item's StructureToBuild must name your structure, and the structure's ConsumesPrimalItem must name your item. Then check the Mod Data Asset cache (step 9). If the preview is green but clicking does nothing, shrink the encroachment box (step 5).

It's not in my engram list

The engram isn't in Additional Engram Blueprint Classes, or PIE is still using the cached Mod Data Asset. Also check the engram's level isn't 0. More in How ARK finds your content.

Snapping acts strangely after I changed snap points

Stop PIE and start it again. Snap changes don't apply to a running session.

My structure snaps to vanilla pieces, or vanilla pieces snap to mine

Your child inherited the parent's StructureTag and snap flags. Give it its own tag and edit the tag lists. Or set StructureSnapTypeFlags so it only matches your own pieces.

I can't edit the inventory on my child structure

The parent added it in a way children can't edit. Use one of the two workarounds in step 8.

The station places a little off from where the preview snapped

Modders have reported this more than once, and nobody has fully explained it. They suspected logic in BPPlacedStructure moving the visuals, and moving that setup to Begin Play helped one of them. If you hit it, check what your graph does on placement first.

All the placement rules stopped working

An override of BPIsAllowedToBuild returns "allowed" instead of passing the incoming reason through. Pass it through (step 5).

My mesh is there but players walk through it

The mesh has no simple collision, or the component's collision preset is NoCollision. Step 4 has the fix.

Check it worked

  1. In PIE on your test map, the engram is in the list at the level you set. The item crafts, and the preview turns green on flat ground and red where it should.
  2. DebugStructures shows the placement box hugging your mesh.
  3. It snaps where you expect, rotates in the steps you set, and doesn't snap where it shouldn't.
  4. It takes damage from what it should. It can be repaired, picked up (if allowed) and demolished.
  5. The inventory has the right slot count. A station lists its recipes and crafts them.
  6. Repeat 1 to 5 on a local dedicated server with a separate client. Then restart the server and check the placed structure still has its health, items and any state your graph sets up. PIE runs the server and client in one process, so it can't prove this. See Works in PIE, not on a server.
  7. If anything fails silently, read the editor's Output Log for your structure's name before changing anything. See Reading ARK's logs.

Watch

Go deeper

Sources

  • DevKit files, read offline on 2026-11-05: Every class, field and value on this page comes from these: /Game/PrimalEarth/Structures/StorageBox_Small, StorageBox_AnvilBench, BuildingBases/StructureItemContainerBaseBP and StructureBaseBP; /Game/PrimalEarth/CoreBlueprints/Items/Structures/Misc/PrimalItemStructure_StorageBox_Small and its parents; /Game/PrimalEarth/CoreBlueprints/Engrams/EngramEntry_StorageBox_Small; /Game/PrimalEarth/CoreBlueprints/Inventories/PrimalInventoryBP_StorageBox_Small and PrimalInventoryBP_AnvilBench; the native constructor defaults of APrimalStructure and its sparse class data (for the sparse fields, and the defaults of 100 health and a 4-day decay period). DebugStructures is a player-controller command in the kit.
  • Modding lessons and What the video tutorials teach in this section: overriding snap points, BPIsAllowedToBuild, damage tiers (lessons §8); ForceAllowCraftingForInventoryComponents and Impersonate (tutorials §8, from creators' tutorials, not checked in the kit).
  • What modders report, from the ARK Modding Community Discord:
    • deleting the mesh component breaks the structure (March 2024);
    • kit-bashing with vanilla meshes, and when you need a copy (October 2024);
    • collision setup and the NoCollision preset (2024);
    • a green preview that won't place, from a too-tall encroachment box (April 2024);
    • the reason string override (2024);
    • restarting PIE after snap edits (2023–2024), and FROM points on alternate pieces;
    • snap rotation reading StructureTag (August 2024);
    • never ticking an item's "Is Engram" flag;
    • the two locked-inventory workarounds (September 2025);
    • checking Additional Structures to Place (tips thread, April 2024);
    • stations placing off from the preview (2024, unexplained). The "item does nothing" checklist under Common mistakes comes from the "Structure Won't Place/Equip" tips thread (April 2024) and matches the fields in the kit.
  • Videos listed under Watch: creators' tutorials, not checked against the kit.
  • Community knowledge from the ARK Modding Community Discord (discussions from November 2023 to October 2025, mainly #asa-tips-and-snippets, #asa-blueprints and #asa-general), found with Overseer. Threads that helped (they open for server members): Structure Won't Place/Equip (April 2024), how the snap-rotation options work (August 2024), the locked inventory on a child structure (September 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 Blueprints, the community Discord and creators' videos (see Sources)

Look something up in structures

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

Browse all structures

Look something up in items

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

Browse all items

Look something up in engrams

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

Browse all engrams

Esc

↑ ↓ move↵ openCtrl ↵ new tab