Modding guide

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:

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

The process

  1. 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 → native PrimalItem
    A crafted resource Sparkpowder (database) PrimalItemResource_Craftable → PrimalItemResourceGeneric → PrimalItem_Base
    Food, a drug or a potion Stimulant (database) or Raw Meat (database) PrimalItemConsumableEatable → PrimalItemConsumableGeneric → PrimalItem_Base
    Food that gives a buff Fria Curry (database) PrimalItemConsumableEatable_BuffingSoup → PrimalItemConsumableEatable → …
    A harvesting tool Stone Pick (database) PrimalItem_WeaponBasePick → PrimalItemWeaponGenericAmmoless → PrimalItemWeaponGeneric → PrimalItem_Base
    An 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, BaseBoots and 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.

  2. 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.

  3. 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.

  4. 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 is WeapStonePick. 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.

  5. 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.

  6. 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), seconds 600 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.

  7. 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 bUsed and 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 by RepairResourceRequirementMultiplier.

    Quality rolls scale these numbers through the other fields in each stat entry. Leave those as the parent has them.

  8. 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.

  9. 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 with PrimalInventoryBP_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.

  10. 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 gives Buff_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
    bConsumeItemOnUse on 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, bPreventDinoAutoConsume stop 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.

  11. 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 giveitem path (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 0 finds the item by name.
  12. 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.
  13. 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

  1. In PIE, give yourself the item. The name, icon, description, weight and stack size are right.
  2. Use it, if it's usable. The stats move the way you set, and the buff icon appears.
  3. Leave one in your inventory past its spoil time. It turns into what you set, or disappears.
  4. Learn the engram and craft it where it should craft: your inventory, or the station.
  5. Equip a tool or armor piece. It shows, wears down with use, and repairs.
  6. 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.
  7. If anything fails silently, read the Output Log for your item'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, merged with their sparse class data: /Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_Wood, PrimalItemResource_Sparkpowder and PrimalItemResource_Stone; /Game/PrimalEarth/CoreBlueprints/Items/Consumables/PrimalItemConsumable_RawMeat, _CookedMeat, _Stimulant, _Narcotic, _Soup_FriaCurry and _HealSoup; /Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItem_WeaponStonePick and PrimalItem_WeaponMetalPick; /Game/PrimalEarth/CoreBlueprints/Items/Armor/Cloth/PrimalItemArmor_ClothShirt; their parents up to PrimalItem_Base; the engrams EngramEntry_Stimulant, EngramEntry_MetalPick and EngramEntry_StonePick; the native UPrimalItem constructor 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 _C suffix 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: AddMaxItemQuantityOverride explains 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 _C suffix 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.

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