Modding guide

How to make an engram, and why it isn't appearing

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

An engram is what puts your item in the player's engram list, at a level and a cost you choose. Making one takes five minutes. Getting it to show up the first time can take longer, so half of this page is the checklist for that.

  • You'll make: an engram players learn at a level you set, with points, prerequisites and the right crafting place
  • Time: five minutes per engram; the checklist when it doesn't show
  • Level: beginner (you've made your first mod)
  • You'll need: a mod set up and registered, and the item the engram should teach

Before you start:

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

What an engram entry is

An engram entry is a small data-only Blueprint. It holds the level, the point cost and the prerequisites, and it points at one item. The game builds the engram list from two places. The first is the PrimalGameData's own list, with 889 vanilla engrams. The second is every mod's Additional Engram Blueprint Classes.

So an engram needs three things: the right parent, a link to its item, and a place in your Mod Data Asset.

The process

  1. Make a new engram entry with parent PrimalEngramEntry. Don't duplicate or subclass a vanilla engram. Start fresh, so nothing ties yours to Wildcard's.

    Show me how
    • Content browser → right-click → Blueprint Class → All Classes → search PrimalEngramEntry. It's the native C++ class every engram comes from.
    • Name it EngramEntry_<prefix>_<item>, in your mod folder.
    • It opens as a data-only Blueprint: just the defaults, no graph. That's normal.

    Wildcard sometimes makes one engram a child of another; some saddle engrams are. For a mod, modders report that a child of a vanilla engram can end up learned but not craftable, especially once something remaps the parent. My beginner guide video shows the fresh-entry route at 15:58.

  2. Point it at your item. Set Blue Print Entry to the item the engram teaches.

    Show me how
    Your content Blue Print Entry is
    A resource, food, tool or armor piece the item (PrimalItem…)
    A weapon the weapon's item, not the weapon actor
    A structure the structure's item (PrimalItemStructure_…), not the structure itself

    The code name is BluePrintEntry. One engram teaches one item.

  3. Set the level and the point cost. Use a level of 1 or more. A level of 0 sorts the engram to the bottom of the list, with the Tekgrams.

    Show me how

    Required Character Level (RequiredCharacterLevel) and Required Engram Points (RequiredEngramPoints). Some vanilla values to measure yours against:

    Engram Level Points
    Stone Pick 1 0
    Cloth Shirt 3 3
    Storage Box 4 6
    Sparkpowder 6 3
    Mortar and Pestle 6 6
    Stimulant 11 6
    Metal Pick 20 6
    Advanced Bullet 55 8

    Every vanilla engram a player learns normally has level 1 or more. The few left at 0 are Tekgrams and event unlocks that can't be learned by hand. I explain level 0 at 21:12 in my beginner guide video.

  4. Decide where it's crafted. Leave Give Blueprint To Player Inventory on for items crafted in the player's inventory. Turn it off for items only a station makes.

    Show me how

    The code name is bGiveBlueprintToPlayerInventory. Vanilla engrams that don't set it, like the Stone Pick and the Cloth Shirt, craft in the inventory. Station items turn it off: the Stimulant and Sparkpowder for the Mortar and Pestle, the Metal Pick for the Smithy.

    The station side is on the item, in Crafting Requires Inventory Component. Step 9 of How to make a custom item has both halves.

  5. Add prerequisites, if it needs any. Engram Requirement Sets lists the engrams a player must learn first.

    Show me how

    It's an array of sets. Each set has an Engram Entries list. The Advanced Bullet has one set holding the Simple Bullet, so you need the Simple Bullet first. 351 vanilla engrams use one set.

    Two vanilla engrams use two sets. The Water Well's are the Large Storage Box and Cementing Paste. I read separate sets as alternatives, any one of which unlocks it, but I haven't tested that. If you need "all of these", put them in one set.

  6. Leave the other switches alone unless you need them. Each one changes how players unlock the engram or where it shows.

    Show me how
    Panel name (code name) What it does
    Can Be Manually Unlocked (bCanBeManuallyUnlocked) on in practice by default. Off means players can't spend points on it; something else must unlock it, like a boss or a Tekgram.
    Auto Unlock Engram (AutoUnlockEngram) unlocks it for free once the player reaches the level
    Force Is Tek Engram (bForceIsTekEngram) shows it in the Tek section
    Engram Group (EngramGroup) which DLC or map it belongs to. Modders leave it on ARK Prime.
    Engram Category (EngramCategory) a category tag; Mod Specific exists, and some ASA saddles use it
    Extra Engram Description extra text on the engram's tooltip

    The vanilla Grass Ghillie skin engrams combine three of these. They're level 1, 0 points, with Can Be Manually Unlocked off and Auto Unlock on, so everyone simply has them.

    A Tek icon can come from the item too. Modders found the item's own Tek flags put an engram in the Tek section even with Force Is Tek off.

  7. Register it in the Mod Data Asset. Add the engram to Additional Engram Blueprint Classes. Don't touch the engram list in your PrimalGameData.

    Show me how

    Open the Mod Data Asset, search the Details panel for "engram", click + on Additional Engram Blueprint Classes and pick your engram. Save. My beginner guide video does it at 20:24.

    • The engram entry goes here, not the item and not the structure.
    • Additional Structure Engrams, despite its name, takes items: it adds them to a vanilla station's recipe list. You don't need it for a normal engram.
    • The PrimalGameData's inherited Engram Blueprint Classes is the master list. Modders report that editing it breaks the whole engram screen.

    The full table of fields is in How ARK finds your content.

  8. Reset the cache, then test. The DevKit keeps a copy of your Mod Data Asset from the first time it loaded. A new engram won't show until you reset it.

    Show me how

    Clear the test map's World Settings Primal Game Data Override, press Play once, stop, and put your PrimalGameData back. Restarting the DevKit works too. The cache trap has the details.

    You only need this after Mod Data Asset edits. Changing an engram's level later shows up on the next Play.

  9. Unlock it to test. Open the engram screen and learn it. If you want to skip leveling, use a cheat.

    Show me how
    Command What it does
    cheat giveengrams unlocks every engram for you, yours included
    cheat unlockengram "Blueprint'<your item's path>'" unlocks one engram; it takes the item's path, not the engram's
    cheat giveitem "Blueprint'<path>'" 1 0 1 gives the item as a blueprint you can craft from

    Modders note that giveengrams sometimes needs running twice. Creative mode lets you craft without engrams, so it can't prove your engram works.

It isn't appearing: a checklist

Check these in order. The first two are the cause nine times out of ten.

  1. Did you reset the cache after adding it to the Mod Data Asset? See step 8.
  2. Is the engram entry in Additional Engram Blueprint Classes? Not the item, not the structure, and not Additional Structure Engrams.
  3. Does Blue Print Entry point at your item? For a structure, at the structure's item.
  4. Is the level 1 or more? At 0 it sits at the very bottom, among the Tekgrams.
  5. Can it be learned? Can Be Manually Unlocked should be on, unless another route unlocks it.
  6. Is the parent PrimalEngramEntry? A child or copy of a vanilla engram is the usual cause of "learned but not craftable".
  7. Is the engram filtered? An engram search filter can show it in the wrong section. Clear the search box.
  8. Is it learned but not in the crafting list? Check Give Blueprint To Player Inventory and the item's Crafting Requires Inventory Component (step 4).
  9. Does cheat giveitem work? Then the item is fine and the problem is the engram or its registration.
  10. Does your test map name your PrimalGameData, and does it point at your Mod Data Asset? The checklist in How ARK finds your content covers both.
  11. On a server: does the log show your mod loading? See Reading ARK's logs.

Changing a vanilla engram instead

You don't need a new engram to change a vanilla one's level or cost. The Mod Data Asset can remove vanilla engrams (Remove Engram Blueprint Classes) or swap one for yours everywhere (Remap Engrams). Remaps clash when two mods remap the same engram.

To change one at runtime, modders report that editing the engram's class defaults isn't enough. The PrimalGameData also holds a live copy of each engram, made at load. Change both, on the server and on every client. See Changing vanilla content without replacing it.

How the pieces connect

This asset Field Points at
Test map's World Settings Primal Game Data Override your PrimalGameData
Your PrimalGameData Additional Mod Data Asset your Mod Data Asset
Mod Data Asset Additional Engram Blueprint Classes your engram
Engram Blue Print Entry your item (for a structure, its item)
Engram Engram Requirement Sets the engrams needed first
Item Crafting Requires Inventory Component the station that crafts it, if any
Mod Data Asset Additional Structure Engrams only to add your item to a vanilla station

The settings that matter

What you're looking for Panel name Code name
The item it teaches Blue Print Entry BluePrintEntry
Level Required Character Level RequiredCharacterLevel
Point cost Required Engram Points RequiredEngramPoints
Craftable in the inventory Give Blueprint To Player Inventory bGiveBlueprintToPlayerInventory
Prerequisites Engram Requirement Sets EngramRequirementSets
Learnable with points Can Be Manually Unlocked bCanBeManuallyUnlocked
Free on reaching the level Auto Unlock Engram AutoUnlockEngram
Tek section Force Is Tek Engram bForceIsTekEngram
DLC or map Engram Group EngramGroup
Registration Additional Engram Blueprint Classes AdditionalEngramBlueprintClasses

Common mistakes

My engram doesn't appear, but cheat giveitem works

The engram isn't in Additional Engram Blueprint Classes, or the Mod Data Asset cache is stale. Add it, reset the cache (step 8) and test again.

The engram screen broke after I added my engram

You added it to the PrimalGameData's master Engram Blueprint Classes list. Undo that edit, and register the engram in the Mod Data Asset instead. How ARK finds your content explains the two lists.

It's learned, but the item never shows in the crafting list

Check the parent first: it should be PrimalEngramEntry, not a vanilla engram. Then check Give Blueprint To Player Inventory, and whether the item needs a station.

My engram sits at the bottom of the list, or in the Tek section

The level is 0, or Force Is Tek Engram is on. Set the level to 1 or more. If it's still in the Tek section, check the item's Tek flags, and clear any engram search filter.

I put my structure in Additional Engram Blueprint Classes and nothing happened

That array takes engram entries only. Make an engram whose Blue Print Entry is the structure's item, and register that. The structure goes in Additional Structures To Place.

Check it worked

  1. After a cache reset, your engram is in the list at the level you set, with your item's icon and name.
  2. Learning it costs the points you set, and only once its prerequisites are learned.
  3. The item crafts where it should: your inventory, or the station.
  4. Repeat on a local dedicated server with a separate client. Then restart the server and check the engram is still learned. PIE can't prove this. See Works in PIE, not on a server.

Watch

Go deeper

Sources

  • DevKit files, read offline on 2026-11-05: The engram fields and values on this page come from every engram entry in the official content (950), merged with their sparse class data. Examples: /Game/PrimalEarth/CoreBlueprints/Engrams/EngramEntry_StonePick, EngramEntry_ClothShirt, EngramEntry_StorageBox_Small, EngramEntry_Sparkpowder, EngramEntry_MortarAndPestle, EngramEntry_Stimulant, EngramEntry_MetalPick, EngramEntry_AdvancedBullet and EngramEntry_WaterWell; /Game/ASA/CoreBlueprints/Engrams/EngramEntry_Ragnarok_Skin_GrassGhillie_*; /Game/Genesis/CoreBlueprints/Engrams/EngramEntry_HoverSkiff. The counts (166 engrams that are children of other engrams, 351 with one requirement set, two with two, none learnable by hand at level 0) are from the same read. The PrimalGameData's 889-engram list is from PrimalGameDataARKNX_BP.
  • How ARK finds your content for the Mod Data Asset fields and the cache.
  • What modders report, from the ARK Modding Community Discord:
    • which array takes engram entries and which takes items (November 2023, October 2024);
    • editing the master engram list breaking the engram screen (2023 to 2024);
    • learned but not craftable, from a child of a vanilla engram (June 2024);
    • changing a vanilla engram at runtime needs the class defaults and the PrimalGameData's copy (November 2024);
    • leaving Engram Group on ARK Prime, and the item's Tek flags and search filter showing a Tek icon (December 2024, December 2025);
    • giveengrams needing a second run, and creative mode not giving real engrams (May 2026).
  • The ARK Wiki, console commands: GiveEngrams and UnlockEngram, whose examples use item paths.
  • Videos listed under Watch: creators' tutorials, not checked against the kit.
  • Community knowledge from the ARK Modding Community Discord (discussions from November 2023 to May 2026, mainly #asa-general, #asa-blueprints and #asa-graphs), found with Overseer. Threads that helped (they open for server members): engram entry vs structure, which array (November 2023), Additional Structure Engrams takes items (October 2024), learned but not craftable (June 2024), changing an existing engram at runtime (November 2024), an engram stuck in the Tek section (December 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 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