Modding guide

How to make armor and equipment

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

Your armor piece goes in its slot, shows on both body types, protects, keeps you warm or cool, and can give a set bonus. With a vanilla mesh it takes me under an hour. A new mesh adds the Blender work, and that's most of the time.

  • You'll make: a helmet, chestpiece, gloves, leggings, boots or shield, with its look, stats and an optional set bonus
  • Time: under an hour with a vanilla mesh; a day or more with your own
  • Level: beginner for stats; intermediate once you bring your own mesh
  • You'll need: a mod set up and registered, and the vanilla piece closest to yours

Before you start:

How an armor piece works

An armor piece is an ordinary item with three extra jobs.

  1. It fills a slot. Its equipment type says which one.
  2. It shows on the body. It attaches meshes to the wearer, with a separate entry per body type.
  3. It changes the wearer. Armor, durability and insulation come from its stats. Anything else comes from a buff.

The process

  1. Make a child of the vanilla piece closest to yours. Pick the same slot. Never copy one.

    Show me how

    Every vanilla piece sits on a per-slot base, which sits on PrimalItemArmorGeneric:

    Slot Base class A good vanilla parent
    Head PrimalItemArmor_BaseHelmet Flak Helmet (database), Riot Helmet (database)
    Chest PrimalItemArmor_BaseShirt Flak Chestpiece (database), Ghillie Chestpiece (database)
    Hands PrimalItemArmor_BaseGloves Flak Gauntlets (database)
    Legs PrimalItemArmor_BasePants any leggings
    Feet PrimalItemArmor_BaseBoots Flak Boots (database)
    Off hand PrimalItemArmor_Shield Wooden Shield (database), Metal Shield (database), Riot Shield (database)
    • Flak is "Metal" in the code: PrimalItemArmor_MetalShirt and so on.
    • Right-click the parent → Create Child Blueprint Class, and save it in your mod folder with your prefix.
    • A child keeps the parent's meshes, which is handy while you test the stats.
  2. Check its slot. The base already sets My Equipment Type. Leave it unless you're moving the piece.

    Show me how
    Equipment type Slot
    Hat head; the C++ default, so the helmet base stores nothing
    Shirt, Pants, Gloves, Boots chest, legs, hands, feet
    Shield off hand
    Accessory0 the accessory slots, on PrimalItemArmor_BaseAccessory

    The helmet base also sets Equip Requires Explicit Owner Tags to HatRack and Player. Keep both, or players can't wear it.

  3. Set its armor, durability and insulation. These are entries in Item Stat Infos. Change only Initial Value Constant; quality scales the rest.

    Show me how
    Entry Stat Generic base Flak Chestpiece Riot Chestpiece Fur Chestpiece Ghillie Chestpiece
    1 Armor 1 100 115 40 32
    2 Max durability 50 120 120 120 45
    5 Hypothermal insulation (cold) 10 15 15 65 8
    7 Hyperthermal insulation (heat) −2 −7 −10 −30 30
    • Each entry needs Used ticked. Shields turn armor and insulation off.
    • The Fur Chestpiece ticks Prevent If Submerged on its cold insulation, so fur stops working in water.
    • Every field of an entry: Item stats.
    • Torpor protection is Damage Torpidity Armor Rating and Indirect Torpidity Armor Rating: Riot 0.25 and 0.077, Flak 0.12 and 0.04. Durability Decrease Multiplier slows wear; the Hazard Suit uses 0.75.
    • Those three live in the sparse class data, the class-wide block in Class Defaults.
  4. Give it a mesh for each body. Each body type gets its own entry in Actor Class Attachment Infos, with its own mesh. Miss one and the piece is invisible on that body.

    Show me how

    The Flak Chestpiece has two entries:

    Entry Owner Actor Class Parent Component To Attach Mesh
    0 PlayerPawnTest_Male a Skeletal Mesh Component With Soft Ref HM_Metal_Shirt
    1 PlayerPawnTest_Female another one HF_Metal_Shirt
    • Gloves need four meshes: male and female, each in third and first person.
    • Use the With Soft Ref components. They load the mesh only while someone wears it.
    • Each entry's Player Mesh Texture Mask hides the skin underneath. Flak uses the BodyMask_Shirt parameter with its own mask texture.
    • Equipment Hat Hide Item Head Hair and Facial Hair hide hair. The Flak Helmet hides facial hair.
  5. Make the mesh follow the body. Vanilla does it two ways. The simple one is Use Parent Anims: the mesh copies the body's pose bone by bone.

    The body sliders are a separate job. In ASA, the character creator's sliders (body composition, muscle, the torso, arm and leg shapes) don't move bones and aren't morph targets. The player's material pushes the vertices instead, reading a second UV layout and a delta map texture. Vanilla armor carries the same data, so it changes shape with the body. A mesh made from scratch doesn't: it stays the default shape whatever the sliders say, and the body pokes through on a heavier or more muscular survivor. Modders add that data with a community Blender toolkit shared in the Discord's #open-source channel.

    Show me how
    Piece How it moves Setting
    Ghillie Chestpiece, Flak Gloves and Boots copies the body's pose Use Parent Anims on
    Flak Chestpiece its own animation Blueprint copies the pose with Copy Pose From Mesh, then a Rigid Body node swings the plates Use Parent Anims off; anim class HM_Metal_Shirt_PPAnimBP

    For your own mesh:

    • Export the player mesh to Blender, model on top of it, and weight-paint to its bones. Check the weights by hand: automatic weights often leave a shirt floating.
    • Export as FBX with "add leaf bones" off.
    • Import with Skeleton set to the player's skeleton, and don't import a new one.
    • Make a female version too. Modders report the two rigs share bones, but the shapes differ.
    • For the body sliders, copy the player mesh's extra UV layout onto your mesh and use a material set up like vanilla armor's (see the note above). The community Blender toolkit does the transfer.
  6. Give it effects with a buff. Set Buff To Give Owner When Equipped. The buff lives while the piece is worn.

    Show me how
    • Make the buff with How to make a buff, with a duration of 0.
    • Tick Use Instigator Item on the buff. Modders found it then goes away with its item.
    • Fill the drop-down buff field, not the Blueprint Path one.
    • Some effects are plain fields. The Ghillie pieces lower creatures' targeting range with Add Dino Targeting Range: −0.15 on the chest and legs.
    • For your own logic, turn on Use Blueprint Equipped Notifications and use Blueprint Equipped and Blueprint Unequipped. Equipped has an "is from save game" input: it fires again when the game loads.
    • These events are for equipment slots. Weapons use their own.
  7. Add a set bonus, if you want one. Give every piece the same buff, and let the buff check what's worn.

    Show me how

    The Arctic Scout set does exactly this (Arctic Scout Chestpiece, its buff):

    Where Setting Value
    All five pieces Buff To Give Owner When Equipped Buff_ArcticArmor
    Buff Active Prevents Buff Classes itself, so only one copy runs
    Buff Use Instigator Item on
    Buff Use Buff Tick Server on, about once a second
    Buff Item Classes (its own variable) the five piece classes

    On each tick, it calls Get Equipped Item Of Class for every class in the list. It keeps the answer in a replicated "wearing full set" variable. While that's true, it halves stamina use through BP Adjust Status Value Modification.

    The Hazard Suit is another example modders point to.

  8. Make it a shield, if it's a shield. A shield blocks damage with its durability instead of adding armor.

    Show me how
    Setting Wooden Shield Metal Shield Riot Shield
    Item Stat Infos entry 2, durability 350 1,250 2,300
    Shield Block Damage Percentage (sparse) 1.0 1.0 1.0
    Shield Damage To Durability Ratio (sparse) 1.0 1.0 1.0
    Prevent Armor Durabilty Consumption on on on
    • The mesh is a static mesh on the hand socket: ShieldAttach, or MetalShieldAttach for metal.
    • Attachment Require Weapon Support Shield is on, so it only shows with a weapon that allows a shield.
    • Blocking Shield FPV Translation and Rotation place it in first person while blocking.
  9. Set its recipe and engram, and register it. These work as for any item.

    Show me how
  10. Test it on both bodies. Equip it on a male and a female survivor, in first and third person.

    Show me how
    • Give it to yourself with GiveItem. Modders test the other body by respawning as it. The full list: Check it worked.

How the pieces connect

This asset Field Points at
Armor item Actor Class Attachment Infos one mesh entry per body
Armor item Buff To Give Owner When Equipped your buff
Engram entry Blue Print Entry the armor item
Mod Data Asset engram fields the engram entry

The settings that matter

What you're looking for Field
Slot My Equipment Type
Armor, durability, cold, heat Item Stat Infos entries 1, 2, 5, 7
Torpor protection Damage and Indirect Torpidity Armor Rating (sparse)
Mesh per body, skin masks Actor Class Attachment Infos
Effects while worn Buff To Give Owner When Equipped

The full list is in the item reference.

Common mistakes

My armor is invisible when I wear it

No attachment entry matches this body, or its component has no Mesh Ref. Check the male and female entries (step 4).

It shows on male characters but not female, or looks wrong on them

The female entry points at the parent's mesh, or at nothing. Give it a female mesh, and test as a female survivor.

The body pokes through the armor

The entry's texture mask doesn't hide that area. Copy the vanilla mask, or paint your own.

My armor ignores the body sliders

It keeps the default shape on every survivor, and the body pokes through on bigger ones. The mesh is missing the body-shape data the material reads: the extra UV layout and a material set up like vanilla armor's (step 5). Weight painting can't fix this.

The armor floats or doesn't bend with the body

The mesh isn't weighted to the player's bones, or nothing copies the body's pose. Fix the weights, then turn on Use Parent Anims (step 5).

My gloves vanish in first person

The first-person meshes are missing. Gloves need four: male and female, third and first person.

The stats don't apply

Tick Used on the entry and change Initial Value Constant. Old pieces keep their rolled values, so craft a new one. Modders report stats are stored on a 0 to 65,535 scale. Huge values overflow, so use a buff for extreme toughness.

My buff stays after I take the armor off

It was added by hand and never removed. Use Buff To Give Owner When Equipped with Use Instigator Item (step 6).

My shield doesn't show

The weapon in your hand doesn't allow a shield. That's Attachment Require Weapon Support Shield doing its job.

It worked locally, but the CurseForge build is broken

A modder's pieces arrived with 0 durability after the cloud cook. Read the cook log: When a cook or upload fails.

Check it worked

  1. In PIE, the piece goes in its slot and moves with the body as you walk, run and crouch.
  2. It looks right on a female body too, with no skin poking through.
  3. Gloves show in first person; a helmet hides the hair you meant.
  4. The tooltip shows your armor, durability and insulation.
  5. The buff appears on equip and goes on unequip. A set bonus needs the full set.
  6. Repeat on a local dedicated server with a separate client, and relog once. See Testing your mod and Works in PIE, not on a server.

Watch

Go deeper

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 own armor, shields and buffs, 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 buffs and status effects

1,606 rows, each with its own page. Search by name or any detail, or start from a category.

Browse all buffs and status effects

Esc

↑ ↓ move↵ openCtrl ↵ new tab