Modding guide

Engrams (PrimalEngramEntry)

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

An engram is the unlock for an item. It's a tiny data-only Blueprint: a level, a point cost, the engrams you need first, and a pointer to one item. Players meet it as a tile in the engram screen. You meet it every time you add something craftable.

  • Native class: PrimalEngramEntry, straight from UObject
  • Start from: the native class itself. Vanilla engrams have no shared Blueprint base.
  • Registered in: your Mod Data Asset's Additional Engram Blueprint Classes
  • Guides: How to make an engram, How ARK finds your content

What you can do with it

  • Unlock an item at a level for a point cost. That's the whole job, and three settings do it. See How to make an engram.
  • Make it craftable in the player's inventory, or only at a station. One switch on the engram, one list on the item. See How to make a custom item.
  • Gate it behind other engrams. A prerequisite list draws the lines in the engram tree.
  • Give it away for free. Auto-unlocked engrams cost nothing and appear at their level, the way skins do.
  • Tag it as Tek, a DLC or a map. That decides its section and who may learn it.
  • Change a vanilla engram's level or cost. Do it without replacing the asset; see Changing vanilla content.

The settings that matter

The class has 12 settings you can edit, and this page covers every one. Display names are what the Details panel shows. Defaults come from the vanilla engrams, because no Blueprint base sits between them and the C++ class.

The unlock

Setting What it does Vanilla default
Blue Print Entry The item this engram teaches. For a structure, point at its item. None
Required Character Level The player level needed to learn it. None. Starter tools use 2.
Required Engram Points What it costs to learn. None. Starter tools cost 3.
Give Blueprint To Player Inventory Puts the recipe in the player's own inventory, so it crafts there. Station items turn it off. Probably on
Engram Requirement Sets The engrams a player must learn first. Empty
Extra Engram Description Extra text on the engram tile. Multi-line. Empty

Required Character Level and Required Engram Points have no readable C++ value. Set both every time. A level of 0 sorts your engram to the bottom of the list.

Give Blueprint To Player Inventory has no readable default either. 529 vanilla engrams set it, and every one sets it off, so it most likely starts on. The editor's tooltip adds a second use: with Auto Unlock Engram, it hands over cosmetics that take no inventory space.

How it's unlocked

Setting What it does Vanilla default
Can Be Manually Unlocked Players can learn it by spending points. Skins turn it off. Probably on
Auto Unlock Engram Learns itself for free at its level. Used for skins and cosmetics. Probably off
Force Is Tek Engram Puts it in the Tek section. Off

These defaults are guesses from how vanilla changes them. 277 vanilla engrams turn manual unlock off and one turns it on. 212 turn auto-unlock on and one turns it off. The usual set for a free cosmetic is manual off, auto on, 0 points.

Grouping and DLC

Setting What it does Vanilla default
Engram Group Which content pack it belongs to, such as a DLC or map. None
Engram Category A rough type, such as saddles or structures. None
Requires DLC A DLC class the player must own to learn it. None

Most vanilla engrams leave all three empty. Those are the base game's. Your own engrams can leave them empty too.

The values vanilla uses

Engram Group, as set on vanilla engrams, by count:

Value Engrams
ARK_BOBSTALLTALES 122
ARK_SCORCHEDEARTH 54
ARK_TEK 50
ARK_ABERRATION 43
ARK_LOSTCOLONY 37
ARK_TIDESOFFORTUNE 27
ARK_EXTINCTION 22
ARK_GENESIS 18
ARK_GEN2 14
ARK_ASTRAEOSORBOBSTALLTALES 13
ARK_DRAGONTOPIA 11
ARK_ASTRAEOS, ARK_TOFORASTRAEOS 3 each
ARK_ASASEASONPASS1 2
ARK_TOFORBOBSTALLTALES 1

Engram Category, set on 101 vanilla engrams: SADDLES 36, STRUCTURES 31, WEAPONS 16, CLOTHING 10, MODSPECIFIC 7, TOOLS 1.

Requires DLC, set on 58: classes under /Game/Packs/DLC/, such as TidesOfFortune, Astraeos_OR_BTT, Dragontopia, Astraeos_OR_ToF, Astraeos and BTT_OR_ToF.

Levels and points across vanilla

I read all 960 vanilla engram Blueprints. 287 cost 0 points; those are mostly skins and auto-unlocks. The most common level is 1, then 54 and 50. Point costs cluster at 6, 24, 15, 18 and 10.

Some vanilla level and point pairs
Engram Level Points Prerequisites
Stone Hatchet 2 3 none
Campfire 2 3 none
Spear 2 3 none
Storage Box 4 6 none
Pike 25 10 Spear
Fireplace 28 15 Campfire and Stone Wall
Simple Pistol 34 15 Flare Gun
Fabricated Pistol 55 18 Simple Pistol
Rex Saddle 74 40 none
Compound Bow 79 40 Bow and Fabricator
Tek Bunker 80 60 none; manual unlock on, auto off
Tek Canteen 101 6 Water Jar and Fabricator

Prerequisites

Engram Requirement Sets is a list of sets. Each set holds a list of engrams. Every vanilla engram with prerequisites uses exactly one set. 72 of them put two or three engrams in it, like the Fireplace above.

The player needs every engram in that set. The list-of-sets shape suggests extra sets are alternatives. No vanilla engram uses a second set, so I haven't confirmed that.

Show me how
  1. Click + on Engram Requirement Sets. That adds one set.
  2. Open the set and click + on its Engram Entries. Pick the engram class, for example EngramEntry_Spear.
  3. Add more entries to the same set if the player needs several.

Point at engram classes, not item classes. The struct is FEngramEntries, with one field, EngramEntries.

Events you can override

None. The class declares no Blueprint events or functions of its own, so there's nothing to hook. An engram is pure data. Logic around learning lives on other classes, outside this page.

Functions you'll call

None on the engram itself. You read its settings from the class defaults like any data Blueprint.

Vanilla examples worth studying

Engram Why look at it
Stone Hatchet The minimum: item, level, points.
Storage Box A structure engram. It points at the structure's item.
Campfire A very early structure.
Pike One prerequisite, and inventory crafting off for a Smithy item.
Fabricated Pistol A later weapon behind the Simple Pistol.
Rex Saddle A saddle: high level, station-only.
Fireplace Two prerequisites in one set.
Tek Bunker The only vanilla engram that turns manual unlock on explicitly.
Grass Ghillie Boots A free skin: auto-unlock, 0 points.

Common mistakes

My engram doesn't show up at all

It isn't in your Mod Data Asset's Additional Engram Blueprint Classes, or PIE is using the cached copy. Work through the checklist in How to make an engram.

It sits at the bottom of the list

Its level is 0. Set Required Character Level to 1 or more.

I can learn it but can't craft it anywhere

Give Blueprint To Player Inventory is off and the item names no station, or the reverse. Check both sides: the engram here, and the item's Crafting Requires Inventory Component (Items).

My prerequisite line goes to the wrong engram

You added an item class to Engram Requirement Sets. It takes engram classes.

Everything else

All 13 settings

Every reflected setting on PrimalEngramEntry, including one the editor doesn't show. Data only.

Setting Code name Type Category Flags
Required Character Level RequiredCharacterLevel int32 PrimalEngramEntry EditAnywhere
Required Engram Points RequiredEngramPoints int32 PrimalEngramEntry EditAnywhere
Give Blueprint To Player Inventory bGiveBlueprintToPlayerInventory bool PrimalEngramEntry EditAnywhere
Can Be Manually Unlocked bCanBeManuallyUnlocked bool PrimalEngramEntry EditAnywhere
Force Is Tek Engram bForceIsTekEngram bool PrimalEngramEntry EditDefaultsOnly
Auto Unlock Engram AutoUnlockEngram bool PrimalEngramEntry EditAnywhere
Blue Print Entry BluePrintEntry TSubclassOf<UPrimalItem> PrimalEngramEntry EditAnywhere
Extra Engram Description ExtraEngramDescription FString PrimalEngramEntry EditAnywhere
Engram Requirement Sets EngramRequirementSets TArray<FEngramEntries> PrimalEngramEntry EditAnywhere
My Engram Index MyEngramIndex int32 Transient, C++ only
Engram Group EngramGroup TEnumAsByte<EEngramGroup> PrimalEngramEntry EditAnywhere
Requires DLC RequiresDLC TSubclassOf<UDLC> PrimalEngramEntry EditAnywhere
Engram Category EngramCategory TEnumAsByte<EEngramCategory> PrimalEngramEntry EditAnywhere

Struct FEngramEntries (one set in Engram Requirement Sets): EngramEntries, TArray<TSubclassOf<UPrimalEngramEntry>>, EditAnywhere.

All functions

PrimalEngramEntry declares no Blueprint-visible functions or events. It inherits one function from UObject.

Sources

  • DevKit files, read offline on 2026-11-05: The class's settings, types and flags come from the DevKit's game code. Values come from the class defaults of all 960 official engram Blueprints, including /Game/PrimalEarth/CoreBlueprints/Engrams/EngramEntry_StoneHatchet, EngramEntry_StorageBox_Small, EngramEntry_Campfire, EngramEntry_Spear, EngramEntry_Pike, EngramEntry_Pistol, EngramEntry_MachinedPistol, EngramEntry_Saddle_Rex, EngramEntry_Fireplace, EngramEntry_CompoundBow; /Game/Genesis2/CoreBlueprints/Engrams/EngramEntry_TekCanteen; /Game/LostColony/CoreBlueprints/Engrams/EngramEntry_LostColony_TekBunker; /Game/ASA/CoreBlueprints/Engrams/EngramEntry_Ragnarok_Skin_GrassGhillie_Boots.
  • The defaults marked "on" or "off" with no C++ value are inferred from which way vanilla Blueprints change them.
  • The editor's tooltips on four of the settings, paraphrased.
  • The level-0 sorting and the cached Mod Data Asset come from the how-to pages, which give their own sources.
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 game code and official content (see Sources)

Esc

↑ ↓ move↵ openCtrl ↵ new tab