How to make a custom item or resource
13 min readASA DevKit as of November 2026 (UE 5.8.1); ASE where noted
An item needs a name, an icon, a stack size and a weight. It can spoil, wear out, be crafted from a recipe at a station you choose, and do something when it's used. The first one takes me about an hour. After that, a simple resource or food item takes ten minutes.
- You'll make: a resource, food, tool or armor piece that players craft, carry and use
- Time: about an hour the first time; ten minutes after that
- Level: beginner (you've made your first mod)
- You'll need: a mod set up and registered, a vanilla item to start from, and an icon texture
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.
- Find a vanilla item that already behaves like yours. The database lists every one with its stack, weight, spoil time and recipe: /ark/browse/items.
- An engram is what lets players learn the recipe. It has its own page: How to make an engram.
- Weapons that shoot, and their ammo, are on How to make a weapon. Placeable items are on How to make a custom structure.
If you only want the steps, read the numbered list and skip the rest.
The process
Pick the vanilla item closest to yours. Start from a resource for anything that only goes into recipes. Pick a food or drug for anything players eat or use. Start from a tool or an armor piece for things they equip.
Show me how
Good starting points, with their real parents in the current kit:
You want Start from Its parent chain A gathered resource Wood (database) PrimalItemResourceGeneric→PrimalItem_Base→ nativePrimalItemA crafted resource Sparkpowder (database) PrimalItemResource_Craftable→PrimalItemResourceGeneric→PrimalItem_BaseFood, a drug or a potion Stimulant (database) or Raw Meat (database) PrimalItemConsumableEatable→PrimalItemConsumableGeneric→PrimalItem_BaseFood that gives a buff Fria Curry (database) PrimalItemConsumableEatable_BuffingSoup→PrimalItemConsumableEatable→ …A harvesting tool Stone Pick (database) PrimalItem_WeaponBasePick→PrimalItemWeaponGenericAmmoless→PrimalItemWeaponGeneric→PrimalItem_BaseAn armor piece Cloth Shirt (database) PrimalItemArmor_BaseShirt→PrimalItemArmorGeneric→PrimalItem_Base"Native" means the C++ class at the root. You can't edit it, only inherit from it. The kit has a base for each armor slot too:
PrimalItemArmor_BaseHelmet,BaseGloves,BaseBootsand so on.The item's kind is its My Item Type (
MyItemType): Resource, Equipment, Weapon, MiscConsumable and others. Your child inherits it, which is one more reason to start from the right parent.Make a child Blueprint, not a copy. A child inherits everything from its parent and stores only what you change. It keeps working when Wildcard updates the parent.
Show me how
Right-click the vanilla item in the content browser → Create Child Blueprint Class. Save it in your mod's folder with your mod's short prefix, for example
PrimalItemConsumable_MM_Tonic.Open it and click Class Defaults. Every field on this page is there. Use the Details panel's search box to find them.
Give it a name, a description and an icon. These are what players see in their inventory.
Show me how
Field (code name) What it does Descriptive Name Base ( DescriptiveNameBase)the item's name Item Description ( ItemDescription)the tooltip text Item Icon JIT ( ItemIconJIT)the icon: a soft reference to a texture, plus an expiry time Item Icon Material Parent ( ItemIconMaterialParent)optional; a material that colors the icon to match dyes The old Item Icon field is deprecated in ASA, and the cook warns about it. Use Item Icon JIT. If a graph of yours reads an item's icon, call the Get Item Icon JIT function rather than reading the field.
Import a square texture into your mod folder for the icon. Mist3r Trixt3r makes one inside the DevKit (4:00). Look at a vanilla icon's texture settings and match them.
Give it a look, if it has one. Resources and food have no model of their own. Tools and armor do, and each keeps it in a different place.
Show me how
- A tool or weapon: the mesh lives on the weapon actor that Weapon Template (
WeaponTemplate) points at. The Stone Pick's isWeapStonePick. Make a child of that too, and set your mesh on it. The weapon page covers the rest. - Armor: the item carries a skeletal mesh component for each body. Actor Class Attachment Infos
(
ActorClassAttachmentInfos) attaches them: the Cloth Shirt has one entry for the male player pawn and one for the female. Swap the mesh on both components. - To recolor armor without a new mesh, see tutorials §8. It needs Item Icon Material Parent set.
Meshes, materials and textures you make must live in your mod's folder. Referencing vanilla ones is fine.
- A tool or weapon: the mesh lives on the weapon actor that Weapon Template (
Set the stack size and weight. Stack size is how many fit in one slot. Weight is per item.
Show me how
Field C++ default Wood Raw Meat Stimulant Stone Pick Max Item Quantity ( MaxItemQuantity)1 100 40 100 1 Base Item Weight ( BaseItemWeight)0.5 0.5 0.1 0.1 2 The C++ default is what you get when no Blueprint in the chain sets the field. Servers scale stack sizes with their own stack multiplier, so players may see bigger stacks than you set.
Set the spoil time and what it spoils into, if it spoils. Leave the time at 0 for items that never spoil.
Show me how
Field Raw Meat Cooked Meat Fria Curry Spoiling Time ( SpoilingTime), seconds600 1,200 18,000 Spoiling Item ( SpoilingItem)Spoiled Meat Spoiled Meat none: it just disappears Spoiling Item Quantity ( SpoilingItemQuantity)1 (the default) 1 Spoiling Item is sparse class data in ASA: the class-wide values ASA keeps in a separate block. Look for it in Class Defaults, under the item's sparse data section.
Fridges and preservation bins don't change the item. Their inventory has Item Spoiling Time Multipliers, one multiplier per item class.
Turn on durability, if it wears out. Tools and armor lose durability as they're used. Resources and food don't use it.
Show me how
- Tick Use Item Durability (
bUseItemDurability). - Set the durability in Item Stat Infos, entry 2, which is MaxDurability. Tick its
bUsedand set Initial Value Constant. The Stone Pick has 40 and the Cloth Shirt 25. - Entry 1 is Armor (the Cloth Shirt's is 10). Entries 5 and 7 are hypothermal and hyperthermal insulation.
- Repairing is on by default (
bAllowRepair). By default a repair costs half the recipe, set byRepairResourceRequirementMultiplier.
Quality rolls scale these numbers through the other fields in each stat entry. Leave those as the parent has them.
- Tick Use Item Durability (
Write its recipe and crafting time. The recipe is a list of resources and amounts. The crafting time is in seconds.
Show me how
Base Crafting Resource Requirements (
BaseCraftingResourceRequirements) holds one entry per ingredient:Entry field Stimulant's first entry What it does Resource Item Type Stimberry the ingredient's item class Base Resource Requirement 5 how many Crafting Require Exact Resource Type off on = only this exact class; off = children count too The Stimulant's second entry is 2 Sparkpowder. Cooked Meat turns exact type on for its Raw Meat. That's how a recipe takes one kind of meat and not every child of it.
Blueprint Time To Craft (
BlueprintTimeToCraft) is the crafting time: 5 seconds by default, 1 for the Stimulant and 60 for Fria Curry.Your own resource works as an ingredient with no extra registration. To put it into a vanilla item's recipe, see Common mistakes.
Choose where it's crafted. Either in the player's own inventory, or at a station. The item names the station; the engram decides whether the player's inventory can craft it.
Show me how
Crafted in On the item On its engram The player's inventory leave Crafting Requires Inventory Component empty leave Give Blueprint To Player Inventory on A station Crafting Requires Inventory Component = the station's inventory class turn Give Blueprint To Player Inventory off The vanilla Stimulant points at
PrimalInventoryBP_MortarAndPestle, and its engram turns the inventory switch off. The Metal Pick does the same withPrimalInventoryBP_AnvilBench, the Smithy.Stations like the Smithy also list their recipes in their inventory's Default Inventory Items. To add your item to a vanilla station without copying the station, use the Mod Data Asset's Additional Structure Engrams: the station as For Class, your item in Class Additions. How ARK finds your content has the table.
For your own station, see step 8 of How to make a custom structure.
Set what happens when it's used, for food and drugs. A consumable can change stats directly, give a buff, or both.
Show me how
Stat changes: Use Item Add Character Status Values (
UseItemAddCharacterStatusValues) holds one entry per stat. Raw Meat has two:Entry field Raw Meat, entry 1 Raw Meat, entry 2 Status Value Type Food Health Base Amount To Add 10 −5 Add Over Time / Add Over Time Speed on / 5 on / 4 Use Item Quality on on The Stimulant uses the same field to take away 40 Torpidity and 15 Water.
A buff: set Buff To Give Owner Character (
BuffToGiveOwnerCharacter). Fria Curry givesBuff_FriaCurry. It's sparse class data in ASA. Armor uses Buff To Give Owner When Equipped instead. To make the buff itself, see How to make a buff.Other switches:
Field What it does bConsumeItemOnUseon for food: one is used up each time. Off gives a reusable item. MinimumUseInterval(sparse)the cooldown between uses, in seconds; Raw Meat's is 0.2 bPreventUseByDinos,bPreventDinoAutoConsumestop tames eating it; Fria Curry sets both GiveItemWhenUsed(sparse)an item handed back after use Anything more needs a graph. Modders often give the item a buff and put the logic in the buff.
Get it into the game. Players learn it from an engram, find it in loot, or both. For testing, give it to yourself directly.
Show me how
- An engram: make one that points at your item. How to make an engram covers it.
- Loot: add it to a crate's item sets. See How to make loot crates.
- Testing in PIE: right-click the item in the content browser → Give. The Output Log then prints the
full
cheat giveitempath (Mist3r Trixt3r, 2:52). - Typed by hand:
cheat giveitem "Blueprint'/MyMod/Items/PrimalItemConsumable_MM_Tonic.PrimalItemConsumable_MM_Tonic'" 1 0 0. The numbers are quantity, quality and "as blueprint". Right-click the asset → Copy Reference gets the path. - The short form:
cheat gfi <part of the class name> 1 0 0finds the item by name.
Register what needs registering. The item itself isn't registered anywhere. Its engram is.
Show me how
- Add the engram to the Mod Data Asset's Additional Engram Blueprint Classes, then reset the cache. How ARK finds your content has both.
- A resource used only as an ingredient needs nothing in the Mod Data Asset. Modders use custom resources that way without trouble.
- An item nothing references, one you only spawn by path from code, needs Extra Resources. Otherwise the cook leaves it out.
Test it. PIE first, then a local dedicated server. The list is in Check it worked.
How the pieces connect
| This asset | Field | Points at |
|---|---|---|
| Mod Data Asset | Additional Engram Blueprint Classes | your engram |
Engram (PrimalEngramEntry child) |
Blue Print Entry | your item |
| Engram | Give Blueprint To Player Inventory | on = craftable in the player's inventory |
| Item | Crafting Requires Inventory Component | the station's inventory class |
| Item | Base Crafting Resource Requirements | each ingredient's item class |
| Item | Spoiling Item | the item it turns into |
| Item (consumable) | Buff To Give Owner Character | a buff class |
| Item (tool) | Weapon Template | the weapon actor, which holds the mesh |
| Item (armor) | Actor Class Attachment Infos | its mesh components, per player pawn |
| Mod Data Asset | Additional Structure Engrams | only to add your item to a vanilla station |
| Mod Data Asset | Extra Resources | items reached only by path from code |
The settings that matter
| What you're looking for | Field | Notes |
|---|---|---|
| Name, tooltip | DescriptiveNameBase, ItemDescription |
|
| Icon | ItemIconJIT |
not the deprecated ItemIcon |
| Stack size | MaxItemQuantity |
default 1 |
| Weight | BaseItemWeight |
default 0.5 |
| Spoiling | SpoilingTime, SpoilingItem, SpoilingItemQuantity |
Spoiling Item is sparse data |
| Durability | bUseItemDurability + Item Stat Infos entry 2 |
|
| Armor value | Item Stat Infos entry 1 | |
| Recipe | BaseCraftingResourceRequirements |
one entry per ingredient |
| Crafting time | BlueprintTimeToCraft |
default 5 s |
| Crafting station | CraftingRequiresInventoryComponent |
the station's inventory class |
| Stat changes on use | UseItemAddCharacterStatusValues |
|
| Buff on use | BuffToGiveOwnerCharacter |
sparse data |
| Used up on use | bConsumeItemOnUse |
|
| Use cooldown | MinimumUseInterval |
sparse data |
Common mistakes
cheat giveitem works, but it's not in my engram list
The item is fine; the engram isn't registered, or PIE is still using the cached Mod Data Asset. Work through How to make an engram.
I learned it, but I can't craft it in my inventory
The engram has Give Blueprint To Player Inventory off, or the item names a station in Crafting Requires Inventory Component. Turn the first on and empty the second if it should craft anywhere (step 9).
The icon is a gray arrow, a blank square or missing
Set the icon in Item Icon JIT, not the old Item Icon field. Any graph that reads icons should call Get Item Icon JIT. Modders also hit a gray-arrow bug in early 2025 that a game update fixed, so update your DevKit first.
My resource is ignored in a vanilla recipe override
Server recipe overrides in the ini need the _C suffix on every class name, vanilla or modded:
PrimalItemResource_Wood_C. Modders have also heard that the override only applies to items with an engram. That's
unconfirmed, but check it if the suffix doesn't fix it.
Stacks are bigger than I set
The server's stack size multiplier scales every item's Max Item Quantity. Test on a server with default settings.
My healing item also drains food
Modders report that adding health this way costs food. Start from the Medical Brew (PrimalItemConsumable_HealSoup,
database) instead, or add a food entry that balances it.
My tool equips but does nothing
The item's Weapon Template still points at the parent's weapon, or at nothing. Harvesting and damage live on the weapon actor. See How to make a weapon.
My armor shows on one body type only
Actor Class Attachment Infos has an entry per player pawn. Set your mesh on both components, male and female.
Check it worked
- In PIE, give yourself the item. The name, icon, description, weight and stack size are right.
- Use it, if it's usable. The stats move the way you set, and the buff icon appears.
- Leave one in your inventory past its spoil time. It turns into what you set, or disappears.
- Learn the engram and craft it where it should craft: your inventory, or the station.
- Equip a tool or armor piece. It shows, wears down with use, and repairs.
- Repeat on a local dedicated server with a separate client. PIE runs the server and the client in one process, so it can't prove the client sees the same thing. See Works in PIE, not on a server.
- If anything fails silently, read the Output Log for your item's name before changing anything. See Reading ARK's logs.
Watch
- How to Make an ARK ASA Mod (Complete Beginner Guide) (my video). 15:58 making the item and a new engram, and linking them. 20:24 registering the engram.
- Creating your OWN custom HARVESTING TOOL | Episode 10 (SlayerXtreme). 1:36 making and linking the assets. 3:57 tool properties. 5:51 the icon. 7:30 durability. 9:32 the weapon template and harvest rates. 12:33 testing.
- How to CREATE your own GLOVES with ease! | Episode 11 (SlayerXtreme). 1:36 the engram. 4:06 armor stats. 7:24 the mesh. 12:07 testing.
- Creating that FOOD DRAINING TRANQ we all love | Episode 6 (SlayerXtreme). 14:10 draining food through the damage type. 19:28 the fix when the item is missing: the Mod Data Asset entry.
- Modding: Publishing a mod (Mist3r Trixt3r). 4:00 making and assigning a custom item icon.
- Modding: Spawn Commands (Mist3r Trixt3r). 2:52 getting your item's blueprint path for
giveitem. - Ark Survival Ascended - Dev Kit - Custom Item Data (Quellcrest). 5:00 per-item data, the only per-item state that replicates. 8:05 changing an item's name at runtime.
Go deeper
- How to make an engram, and How ARK finds your content.
- How to make a buff for consumable effects, and How to make a weapon for tools that harvest.
- Modding lessons §8, Items: item IDs, durability as a fraction, custom data names to avoid.
- What the video tutorials teach §5 (custom item data) and §8 (giving items in PIE, recoloring armor).
- The database: items and engrams.
- Changing vanilla content without replacing it, for a vanilla item's recipe.
Sources
- DevKit files, read offline on 2026-11-05: Every class, field and value on this page comes from these, merged
with their sparse class data:
/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_Wood,PrimalItemResource_SparkpowderandPrimalItemResource_Stone;/Game/PrimalEarth/CoreBlueprints/Items/Consumables/PrimalItemConsumable_RawMeat,_CookedMeat,_Stimulant,_Narcotic,_Soup_FriaCurryand_HealSoup;/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItem_WeaponStonePickandPrimalItem_WeaponMetalPick;/Game/PrimalEarth/CoreBlueprints/Items/Armor/Cloth/PrimalItemArmor_ClothShirt; their parents up toPrimalItem_Base; the engramsEngramEntry_Stimulant,EngramEntry_MetalPickandEngramEntry_StonePick; the nativeUPrimalItemconstructor defaults (stack 1, weight 0.5, craft time 5 s, spoiling item quantity 1, repair on, repair cost multiplier 0.5). - Modding lessons and What the video tutorials teach in this section: item rules (lessons §8); custom item data, giving items in PIE and armor recolors (tutorials §5 and §8, from creators' tutorials).
- What modders report, from the ARK Modding Community Discord:
- a consumable is a child of the generic consumable with Buff To Give Owner Character set (July 2025);
- the buff field is in the item's sparse data (November 2025);
- testing a buff through a child of a vanilla food (April 2026);
- Item Icon deprecated in favor of Item Icon JIT and the Get Item Icon JIT function (December 2024, January 2025);
- the gray-arrow icon bug, fixed by a game update (January 2025);
- spoil multipliers on inventories (January 2025, February 2026);
- a resource needs no Mod Data Asset entry to be an ingredient (September 2026);
- the
_Csuffix in recipe overrides, and the unconfirmed "needs an engram" claim (November 2024); - exact-type requirements (2024);
- health added on use costing food, and starting from the Medical Brew (December 2024).
- The ARK Wiki, console commands:
AddMaxItemQuantityOverrideexplains how the server's stack multiplier applies. - Videos listed under Watch: creators' tutorials, not checked against the kit.
- Community knowledge from the ARK Modding Community Discord (discussions from November 2024 to September 2026,
mainly #asa-general, #asa-blueprints and #asa-graphs), found with Overseer.
Threads that helped (they open for server members):
making a consumable that gives a buff (July 2025),
Item Icon JIT (December 2024),
a custom resource in a vanilla recipe (September 2026),
the
_Csuffix in recipe overrides (November 2024), a healing item draining food (December 2024).
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 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.