How to make loot crates and change supply drops
12 min readASA DevKit as of November 2026 (UE 5.8.1); ASE where noted
Loot is two jobs. The first is your own loot crate, with its own item sets, weights, quantities and quality. The second is getting your mod's items into vanilla supply drops and cave crates without replacing what's already in them. A crate takes me about an hour the first time; adding to vanilla drops takes about the same.
- You'll make: a custom crate with its own loot, and your items rolling in vanilla drops next to the vanilla loot
- Time: about an hour for each part the first time
- Level: intermediate (you've made an item and a singleton)
- You'll need: a registered mod, the items you want to hand out, and a singleton for the vanilla part
Before you start:
- Have your items working with
cheat giveitem. How to make a custom item covers that. - For the vanilla part, read Changing vanilla content without replacing it. It explains the class default object edit this page uses, and what it costs.
- Keep the database open: /ark/browse/loot lists every vanilla crate and loot set, with every entry, weight, quantity and quality.
If you only want the steps, read the numbered lists and skip the rest.
How loot is built
Loot is four layers deep. Learn these names once and every crate reads the same way.
- Crate: A structure with an inventory. It rolls a number of item sets. The white supply drop is
SupplyCrate_Level03. - Item set: One roll of the crate, picked by its set weight. The white drop has four, weighted 1, 0.1, 0.025 and 0.0025.
- Loot item set asset: A small reusable asset that holds one set's contents. The white drop's main one is
LootItemSet_SupplyDrop_Level03_ASA. - Entry: A group of items inside a set, picked by its entry weight. "Resources" and "Saddles with Quality" are two of them.
A set on the crate usually holds no items itself. Its Item Set Override points at a loot item set asset, and that asset's contents are used. The crate's own set weight still decides how often it's picked. That indirection is what makes "add to vanilla drops" possible: many crates share one asset.
How a crate rolls, number by number, is on Crates and loot.
Part 1: your own crate
Make a loot item set asset for your loot. It's a data-only Blueprint whose parent is Primal Supply Crate Item Set. Keeping the loot in its own asset lets other mods and your own code find it.
Show me how
- Content browser → Blueprint Class → search "PrimalSupplyCrateItemSet" → name it
LootItemSet_<YourMod>_…. - Open it and expand Item Set (
ItemSet, structSupplyCrateItemSet). Its fields:
Field Code name Vanilla white drop Set Name SetNameLootset level 03Item Entries ItemEntries8 entries (step 2) Min Num Items / Max Num Items MinNumItems,MaxNumItems1 to 2 picks from the entries Num Items Power NumItemsPower0.4 (below 1 leans towards the max) Items Random Without Replacement bItemsRandomWithoutReplacementoff; on means no entry repeats Vanilla's ASA sets are children of
LootItemSet_SupplyDrop_ASA_Base, which supplies 2 items at power 0.4. A child that leaves a field alone takes its parent's value, not the struct default.- Content browser → Blueprint Class → search "PrimalSupplyCrateItemSet" → name it
Fill the entries: what drops, how many, how good. Each entry is a group of items. It has one weight, one quantity range and one quality range.
Show me how
The fields of one entry (struct
SupplyCrateItemEntry), with the white drop's "Resources" entry as the example:Field Code name "Resources" What it does Item Entry Name ItemEntryNameResourcesa label Entry Weight EntryWeight1 how often this entry is picked in its set Items Items8 resource classes the item classes; soft references since the 2026 cooker change Item Class Strings ItemClassStringsempty the same by class name, for items you can't reference Items Weights ItemsWeightsempty = all equal one weight per item, same order Min / Max Quantity MinQuantity,MaxQuantity10 to 100 how many Quantity Power QuantityPower0.6 below 1 leans towards the max Apply Quantity To Single Item bApplyQuantityToSingleItemon one stack of one item; off re-picks the item for each unit Min / Max Quality MinQuality,MaxQuality0 to 1 quality before the crate's multiplier Chance To Be Blueprint Override ChanceToBeBlueprintOverride0 0 to 1 Chance To Actually Give Item ChanceToActuallyGiveItem1 below 1, a picked entry can give nothing For gear with quality, copy a vanilla gear entry: "Armor, Tools, and Weapons with Quality" uses quality 1.8 to 3.84,
MinRandomQuality1.8,RequiresMinQuality1.2 and a 0.1 blueprint chance. LeaveItemsWeightsempty or give it exactly one value per item.Make the crate: a child of the vanilla supply crate base. It's a structure with an inventory. It inherits the drop-in, the decay timer and the "Loot it!" inventory.
Show me how
- Right-click
/Game/PrimalEarth/Structures/BuildingBases/SupplyCrateBaseBP→ Create Child Blueprint Class. Its native class isPrimalStructureItemContainer_SupplyCrate, a child of the structure container. - Or start from the vanilla crate closest to yours, such as SupplyCrate_Level03, and change what you need.
- Set Item Sets (
ItemSets): add one set, Set Weight 1, Item Set Override = your loot item set. Add more sets for rarer extras, as the white drop does. - Set Min Item Sets / Max Item Sets (
MinItemSets,MaxItemSets). The white drop rolls 2 to 3. - Min / Max Quality Multiplier scale every entry's quality. Required Level To Access locks it by player level.
- Descriptive Name is what players see. The base says "Supply Crate".
- Additional Item Sets (
AdditionalItemSets) are rolled on top of the normal sets, every time.
- Right-click
Decide how the crate reaches the world. A crate does nothing until something spawns it. Pick the route that matches your mod.
Show me how
Route How Notes Your own map supply crate spawning volumes on the map for map makers Your own logic spawn the crate on the server from a singleton, an item or a structure the usual route for a gameplay mod No crate at all GenerateCustomCrateItemson a player's inventory componentrolls crate loot straight into an inventory Replace a vanilla crate Remap Supply Crates in the Mod Data Asset not recommended; see Common mistakes GenerateCustomCrateItemstakes the same set fields as a crate: custom item sets, min and max sets, power, quality multipliers and passes. Its source class can be anything. Genesis rewards use it.Keep the crate inside your mod folder and it gets cooked, even if your code only loads it by path (registration).
Test it with
summon. Summon a fresh crate after every change; a crate rolls once and never re-rolls.Show me how
- In PIE:
cheat summon <YourCrate>_C. The vanilla white drop ischeat summon SupplyCrate_Level03_C. - For the test, raise your set's weight or set
MinItemSetshigh so you see your entries quickly. Put them back before you upload. - Rolled crate contents are never saved, so inspect them in the inventory screen, not in a save.
- In PIE:
Part 2: your items in vanilla drops
The safest default is to add an entry to the vanilla loot set's class default object, from a singleton. The class default object (CDO) is the copy of a class that every new instance is built from. Crates read their loot from the loot set's CDO, so one edit reaches every crate that uses that set.
Find the loot item sets you want to add to. Open a vanilla crate in the database and note its sets' overrides.
Show me how
SupplyCrate_Level03 uses LootItemSet_SupplyDrop_Level03_ASA at weight 1, a thatch structures set at 0.1, and two "quality only" sets at 0.025 and 0.0025. Scorched Earth has its own
_SEsets, and other maps have theirs. Edit each set your item belongs in.The crate's own Item Sets array isn't readable from Blueprint. The loot set assets are, which is another reason to edit them.
Make a singleton that runs once when the server starts. It's a
SaveGameActorchild registered in Server Extra World Singleton Actor Classes.Show me how
How ARK finds your content has the field. My singleton video shows the setup at 1:46. Run the loot edit behind Switch Has Authority; crates roll on the server, so the edit only has to happen there.
Other mods may edit the same sets at the same moment. One modder found a short timer before the edit helped.
Add your entry to each set's CDO. Add, never replace. Replacing the array wipes other mods' additions and server owners' ini overrides.
Show me how
- Get Class Default Object (
UVictoryCore) with your loot set class, such asLootItemSet_SupplyDrop_Level03_ASA. - Cast To PrimalSupplyCrateItemSet, then get Item Set (
ItemSet). - Build your
SupplyCrateItemEntry(step 2 of Part 1) and Add it to a copy ofItemEntries. - Write it back with Set Members in SupplyCrateItemSet, then set Item Set on the CDO. A Break node gives you a copy, so changing the copy alone does nothing.
- Before adding, check your item isn't already in the entries, so a second run doesn't double it.
For a crate that uses a set list (
ItemSetsOverride), the asset is aPrimalSupplyCrateItemSetswith anItemSetsarray. Add a whole set there the same way.Keep your entry's weight modest. Vanilla entry weights in the white drop run from 0.2 to 1.
- Get Class Default Object (
Rewire with soft references if your graph predates the 2026 change. The entry's Items array became soft class references. Old graphs show a pin type error on compile.
Show me how
The error reads like "Array of Primal Item Class References is not compatible with Array of Primal Item Soft Class References". Replace the array you build with an array of Primal Item soft class references and reconnect. The type in the kit today is
TArray<TSoftClassPtr<UPrimalItem>>.Modders saw it first after a cooker update, before the matching kit update. If the cook and your kit disagree, update the kit and recompile.
Test with a freshly summoned vanilla crate. Summon a few white drops and look for your entry.
The other routes, and why I don't use them
- Remap the crate or loot set. Remap Supply Crates swaps a vanilla crate for your child. It breaks server owners' loot ini for that crate and other mods' CDO edits. Modders also report it doesn't change drops.
- Replace the entries. A CDO edit that sets the array instead of adding to it. It wipes other mods' additions and the server's ini overrides.
- Ask server owners.
ConfigOverrideSupplyCrateItemsin Game.ini, withbAppendItemSetson, adds sets to a crate. It works and stacks, but every server has to do it by hand.
Creature drops
A creature's death loot is an inventory component with the same item set fields. The creature lists it in Death
Inventory Templates (DeathInventoryTemplates), with Death Inventory Chance To Use. Make your own component
class pointing at your own loot item set. How to make a custom creature covers the creature side;
SlayerXtreme's Episode 24 walks through it.
How the pieces connect
| This asset | Field | Points at |
|---|---|---|
Your crate (SupplyCrateBaseBP child) |
Item Sets → Item Set Override | your loot item set |
| Your crate | Item Sets Override (optional) | a PrimalSupplyCrateItemSets list |
Your loot item set (PrimalSupplyCrateItemSet child) |
Item Set → Item Entries → Items | your items (soft references) |
| A vanilla crate | Item Sets → Item Set Override | a vanilla loot item set: the asset you add to |
| Your singleton | its server-start graph | the vanilla loot set CDOs |
| Your Mod Data Asset | Server Extra World Singleton Actor Classes | your singleton |
| A creature | Death Inventory Templates | a death inventory component with item sets |
The settings that matter
These are the fields people hunt for, from crate to item.
| What you're looking for | Field | Where it lives |
|---|---|---|
| How many sets a crate rolls | MinItemSets, MaxItemSets, NumItemSetsPower |
crate |
| Which loot a set uses | ItemSetOverride |
each set on the crate |
| How often a set is picked | SetWeight |
each set on the crate |
| Better quality across the crate | MinQualityMultiplier, MaxQualityMultiplier |
crate |
| Player level lock | RequiredLevelToAccess |
crate |
| How many items a set gives | MinNumItems, MaxNumItems, NumItemsPower |
loot item set |
| How often an entry is picked | EntryWeight |
each entry |
| Which item in an entry | Items + ItemsWeights |
each entry |
| Stack size of the roll | MinQuantity, MaxQuantity, bApplyQuantityToSingleItem |
each entry |
| Item quality | MinQuality, MaxQuality, QualityPower |
each entry |
| Blueprint instead of item | ChanceToBeBlueprintOverride, bForceBlueprint |
each entry |
Common mistakes
My item never shows up in the vanilla crate
Summon a new crate; old ones keep their first roll. Then check the edit ran on the server, and that you added to the right map's set. Raise your entry's weight in a test build to rule out bad luck.
A crate gives five different items when I set a quantity of 5
bApplyQuantityToSingleItem is off, so the quantity is a number of picks. Turn it on to get one stack of one item.
The graph broke after a cooker or kit update
The entry's Items array is soft class references now. Rewire as in Part 2, step 4.
Generate Custom Crate Items gives nothing
The min and max item sets you passed are 0. That happens when they come from an empty struct. Set them explicitly.
Remap Supply Crates did nothing
Modders have reported that since early on: vanilla drops kept spawning. One found the route that worked was changing the crate's loot reference instead. Use the CDO edit above.
Server owners say their loot config stopped working
Your mod replaces the entries or remaps the crate. Server ini overrides look crates up by class name, and a set overwrites them. Switch to adding entries.
My creature's death loot doesn't work in PIE
SlayerXtreme hit this with a new death inventory. The creature dropped nothing until they restarted the DevKit. Restart before you rebuild anything.
Check it worked
cheat summonyour crate. It lands, opens at the right level and holds the number of sets you set.- Over ten summons, rare sets turn up about as often as their weights say.
- Quantities and quality look right, and blueprint chances behave.
- Your items appear in freshly summoned vanilla drops, next to the normal loot.
- With a server-owner ini override on the same crate, both their loot and yours still appear.
- On a local dedicated server with a separate client, all of the above still holds.
Watch
- HOW TO ADD drops to your own CUSTOM DINOS | Episode 24 (SlayerXtreme). 2:10 the loot item set. 3:28 its entries. 5:58 linking it to the creature. 7:06 the DevKit restart.
- Wildcard Workshop #12: Class Default Objects (ZenRowe, ASE). 1:45 what a CDO is. 2:36 why editing a vanilla CDO on a client is risky. 4:43 the rule: change CDOs on the server only.
- Ark Survival Ascended - Dev Kit - Replication (Quellcrest). 26:37 reading an item's CDO.
- Ark Ascended Devkit: The Ultimate CCA (Singleton) Tutorial (my video). 1:46 making and registering the singleton.
Go deeper
- Changing vanilla content without replacing it: CDO edits, default buffs and remaps compared.
- Crates and loot: how a crate rolls, and how quality becomes an item's rating.
- How ARK finds your content: singletons and Extra Resources.
- The database: loot, items.
- The wiki's server configuration for the ini route.
Sources
- DevKit files, read offline on 2026-11-05: The structs
SupplyCrateItemEntry(withItemsasTArray<TSoftClassPtr<UPrimalItem>>),SupplyCrateItemSetandConfigSupplyCrateItemsOverride; the classesAPrimalStructureItemContainer_SupplyCrate,UPrimalSupplyCrateItemSet,UPrimalSupplyCrateItemSets,UPrimalInventoryComponent(GenerateCustomCrateItems) andAPrimalDinoCharacter(death inventory fields), with their Blueprint visibility flags;UVictoryCore::GetClassDefaultObject; all from the game module's reflection data./Game/PrimalEarth/Structures/SupplyCrate_Level03andBuildingBases/SupplyCrateBaseBP;/Game/PrimalEarth/CoreBlueprints/ItemLootSets/LootItemSet_SupplyDrop_Level03_ASAandLootItemSet_SupplyDrop_ASA_Base;PrimalInventoryBP_SupplyCrate. - The database (Loot: supply crates, containers and item sets (DevKit extraction)) and Crates and loot: parent inheritance in loot sets, quantity as picks, and crate rolls never being saved.
- The ARK Wiki: Server configuration
(
ConfigOverrideSupplyCrateItems,bAppendItemSets) and Beacon IDs (summoning crates). - What modders report, from the ARK Modding Community Discord:
- editing the loot set with a CDO edit as the most compatible way to add loot (March 2024, October 2026);
- add or remove rather than set, so ini overrides survive (March 2024);
- a public open-source mod that adds loot this way, and a timer before the edit (January and May 2026);
- the soft-reference change to loot entries after a cooker update, and the compile error (January 2026);
- Remap Supply Crates not changing drops, and the crate's loot reference as the route that worked (January 2024);
- remaps breaking server loot ini and other mods' CDO edits (January and May 2026);
GenerateCustomCrateItemsreturning nothing with min and max sets at 0 (2024–2026).
- Videos listed under Watch: creators' tutorials, not checked against the kit. ZenRowe's is ASE-era.
- Community knowledge from the ARK Modding Community Discord (discussions from January 2024 to October 2026, mainly #asa-general, #asa-blueprints and #asa-graphs), found with Overseer. Threads that helped (they open for server members): add loot without replacing it (October 2026), remap versus a CDO add (March 2024), a singleton loot example (May 2026), loot entries as soft references (January 2026), Remap Supply Drops not working (January 2024), Generate Custom Crate Items (November 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 crates and loot sets, the community Discord and creators' videos (see Sources)
Look something up in loot crates and item sets
872 rows, each with its own page. Search by name or any detail, or start from a category.
By kind
Look something up in items
3,192 rows, each with its own page. Search by name or any detail, or start from a category.