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
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→ nativePrimalStructureItemContainerA crafting station StorageBox_AnvilBench(the Smithy)StructureItemContainerBaseBP→PrimalStructureItemContainerA plain placeable with no inventory StructureBaseBPnative PrimalStructureOpen 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.
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 isPrimalItemStructureGeneric→PrimalItemConsumableGeneric→PrimalItem_Base→ nativePrimalItem, withMyItemTypeset toStructure. - 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.
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 BluePrintEntryyour item Engram RequiredCharacterLevel,RequiredEngramPoints1 or more; a level of 0 sorts to the bottom of the list Item StructureToBuildyour structure Item DescriptiveNameBase,ItemIconJIT,BaseItemWeight,BaseCraftingResourceRequirementsname, icon, weight, recipe Structure ConsumesPrimalItemyour item Structure DescriptiveNamethe 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
ConsumesPrimalItemnames the item.ConsumesPrimalItemlives 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.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
MyStaticMeshpoints 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
AllowStructureColorSetshas six entries, one per paint region. The material needs a colorization setup for paint to show.
- In the components list, select My Static Mesh (StructureMesh) and set your mesh on it. The structure's
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 PlacementEncroachmentBoxExtent10 × 17.5 × 10 half-size of the box that must be free of other things PlacementEncroachmentCheckOffsetZ 55 where that box sits relative to the structure PlacementTraceScale30 × 45 × 20 size of the trace that finds the ground PlacementYawOffsetIncrement90 rotation step when the player rotates the preview bPlacementChooseRotation,bTakeGroundNormal,bForceSnappedStructureToGround,bAdjustPlacementIfCollideon free rotation, tilt to the ground, drop snapped pieces to the ground, nudge out of collisions bRequiresSnapping,PlacementCollisionAdjustmentBuffer,MaxSnapLocRangeandSnappingRotationOffsetare 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
DebugStructuresin 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).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:
SnapPointDescriptionPointLocOffsetDirection Tag list FROM Box 0, 0, 0 bAttachFromPointonSnapTags.SnapFromStructureTagsToInclude=StorageBox_SmallTO Left 0, −130, 0 bAttachToPointonSnapTags.SnapToStructureTagsToInclude=StorageBox_SmallEach entry also has
PointRotOffset,ToPointSnapTypeFlags,SnapPointMatchGroupand per-class include/exclude lists. The structure itself carriesStructureTag(StorageBox_Small) andStructureSnapTypeFlags(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 ownStructureTagand 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 newerStructureTagsarray.
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 Health500 (the Smithy: 1500) 100 if no Blueprint sets it (the C++ default) DecayDestructionPeriodMultiplier4 times the base period, 345,600 s (4 days), which the server's settings scale again StructureSettingsClassStructureSettings_BrokenByStonewhich damage types can hurt it, as multipliers DamageTypeAdjustersdino melee × 4 per-structure extra multipliers bCanBeRepaired,bUsesHealthon The tiers (thatch, wood, stone, metal, Tek) are covered in lessons §8. If your structure runs setup logic, run it from
BPPostLoadedFromSaveGameas well as on placement. Otherwise it's lost after a restart.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_SmallPrimalInventoryBP_AnvilBenchMaxInventoryItems(slots)15 75 Crafting off bAllDefaultInventoryIsEngrams,bForceInventoryBlueprints,bUseCraftQueue,bAllowRemoteCraftingonRecipes none the items in DefaultInventoryItemsFor a station, each item it crafts points back with
CraftingRequiresInventoryComponent= your inventory class. It also goes in your inventory'sDefaultInventoryItems, withbAllDefaultInventoryIsEngramson. 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
ForceAllowCraftingForInventoryComponentsandImpersonateon the inventory component (tutorials §8).- Build your child from the bare base,
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.
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
- 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.
DebugStructuresshows the placement box hugging your mesh.- It snaps where you expect, rotates in the steps you set, and doesn't snap where it shouldn't.
- It takes damage from what it should. It can be repaired, picked up (if allowed) and demolished.
- The inventory has the right slot count. A station lists its recipes and crafts them.
- 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.
- If anything fails silently, read the editor's Output Log for your structure's name before changing anything. See Reading ARK's logs.
Watch
- ASA Modding | Let's Create Our First Mod | Episode 2 (SlayerXtreme). 7:49 the engram. 10:17 the item. 14:18 the inventory. 20:12 the structure Blueprint. 24:26 registering. 26:44 testing. The video copies the vanilla assets; I'd make children.
- Modding in ASA Let's make a simple mod (Mist3r Trixt3r). 12:01 health and inventory size. 14:39 the crafting recipe.
- UPDATE: How to make your own CRAFTING STATION | Episode 12 (SlayerXtreme). 5:45 engram and item. 16:05 what the inventory crafts. 28:02 a custom static mesh. 33:41 assembling it. 38:42 destruction physics.
- Ark Survival Ascended - Dev Kit - Structure Modding (Quellcrest). 0:22 starting from the Smithy. 2:26 the Mod Data Asset cache in PIE. 6:12 swapping the inventory. 11:25 placement collision for a bigger mesh. 16:35 slot count.
- YOU can MAKE your own structure STATIC MESH | Episode 20 (SlayerXtreme). Four minutes on building a mesh from what's already in the kit.
- HOW TO adjust STRUCTURE & DINO damage RESISTANCE | Episode 23 (SlayerXtreme). 0:36 the structure settings class. 4:08 testing it.
- ARK:SA Modding — Ultimate Multi-Use Guide (my video). 8:41 a child of a vanilla structure with its own radial menu.
Go deeper
- How ARK finds your content: the Mod Data Asset and its cache.
- Works in PIE, not on a server.
- When a cook or upload fails: meshes or materials outside your mod folder show up there.
- Modding lessons §8, Structures and What the video tutorials teach §8.
- The database: structures, items, engrams.
- How to make a crafting station, which also covers a storage box, and How to make a powered or Tek structure.
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/StructureItemContainerBaseBPandStructureBaseBP;/Game/PrimalEarth/CoreBlueprints/Items/Structures/Misc/PrimalItemStructure_StorageBox_Smalland its parents;/Game/PrimalEarth/CoreBlueprints/Engrams/EngramEntry_StorageBox_Small;/Game/PrimalEarth/CoreBlueprints/Inventories/PrimalInventoryBP_StorageBox_SmallandPrimalInventoryBP_AnvilBench; the native constructor defaults ofAPrimalStructureand its sparse class data (for the sparse fields, and the defaults of 100 health and a 4-day decay period).DebugStructuresis 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);ForceAllowCraftingForInventoryComponentsandImpersonate(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
NoCollisionpreset (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.
Look something up in items
3,192 rows, each with its own page. Search by name or any detail, or start from a category.
By category
Look something up in engrams
947 rows, each with its own page. Search by name or any detail, or start from a category.