How to make a weapon and its ammo
14 min readASA DevKit as of November 2026 (UE 5.8.1); ASE where noted
You'll build a weapon with its own damage and fire rate, its own ammo, and an engram that teaches it. It wears down and can be repaired like a vanilla one. The first one takes me an afternoon, mostly on the ammo links. The next takes under an hour.
- You'll make: a gun, bow, melee or thrown weapon with its own stats, its own ammo and an engram
- Time: an afternoon the first time; under an hour after that
- Level: beginner to intermediate (you've made an item)
- You'll need: a mod set up and registered, and the vanilla weapon closest to yours
Before you start:
- Have your mod open on its test map, with your PrimalGameData and Mod Data Asset linked. Your first mod covers that.
- Read How to make a custom item first. A weapon is an item with an extra Blueprint.
- Find the vanilla weapon that already behaves like yours in the database: /ark/browse/items.
If you only want the steps, read the numbered list and skip the rest.
How a weapon is built
Every weapon is two Blueprints. The item lives in your inventory: name, icon, weight, recipe and durability. The weapon actor is what you hold: mesh, animations, sounds, damage and fire rate. The item points at the weapon actor, and the game spawns that actor when you equip the item.
Ammo is a third Blueprint, an ordinary item. A projectile weapon adds a fourth, the projectile. Damage itself is described by a damage type, a small class that says what kind of hit this is.
The process
Pick the vanilla weapon closest to yours. Its native class decides how it fires, so pick by behavior, not by looks. Everything you don't change, you get for free.
Show me how
The weapon actor's native class is the one that matters. These are the real parents in the current kit:
You want Item to start from Weapon actor Native class of the actor A gun that hits instantly PrimalItem_WeaponGun, the Simple Pistol (database)WeapGunShooterWeapon_InstantA gun that fires a projectile PrimalItem_WeaponCrossbow(database)WeapCrossbowShooterWeapon_ProjectileA bow you draw PrimalItem_WeaponBow(database)WeapBowPrimalWeaponBowA melee weapon PrimalItem_WeaponSword(database)WeapSword→WeapBaseClub→WeapBaseMeleeShooterWeapon_MeleeSomething you throw PrimalItem_WeaponGrenade(database)WeapGrenadePrimalWeaponGrenadeThe item chain for guns is
PrimalItem_WeaponGun→PrimalItemWeaponGenericGun→PrimalItemWeaponGeneric→PrimalItem_Base→ nativePrimalItem. Melee items usePrimalItemWeaponGenericAmmolessinstead. Thrown items usePrimalItemWeaponGenericAmmolessConsumeSelf: the grenade is its own ammo.The Spear is a surprise: it's thrown, and its weapon actor is a
PrimalWeaponBow.Make children of both Blueprints, not copies. A child inherits everything and stores only what you change. A copy drags along every vanilla default and graph, and it stops getting Wildcard's fixes.
Show me how
- Right-click the vanilla item → Create Child Blueprint Class, and save it in your mod folder with your prefix.
- Do the same for the weapon actor (the
Weap…Blueprint). - Modders who copied a vanilla gun to build a fully custom one found the copied defaults fought their own graph. A child of the plainest parent avoids that.
- My beginner guide video builds a weapon item and its engram at 15:58.
Link the item and the weapon actor. The item's Weapon Template names your weapon actor. Without it, equipping gives you the vanilla weapon.
Show me how
Asset Field Set it to Item WeaponTemplateyour weapon actor Item DescriptiveNameBase,ItemDescription,ItemIconJIT,BaseItemWeight,BaseCraftingResourceRequirementsname, text, icon, weight, recipe Item MyItemType,MyEquipmentTypeboth Weapon; inherited, leave themThe Simple Pistol's item weighs 5 and costs 60 metal ingots and 5 wood, among other things.
Set damage. Damage lives on the weapon actor, the projectile or the damage type. It's never on the item.
Show me how
Weapon kind Where the damage number is Vanilla value Instant gun weapon actor → InstantConfig→HitDamage,DamageType,WeaponSpreadWeapGun: 100,DmgType_InstantProjectile weapon weapon actor → ProjectileClass; then the projectile'sWeaponConfig→DirectDamage,DamageTypeProjArrow(stone arrow): 55;ProjArrow_Tranq: 20Melee weapon actor → MeleeDamageAmount,MeleeDamageTypeWeapSword: 90; the base club: 3Every weapon's melee bash weapon actor → MeleeDamageAmount10 on guns and bows These are the raw values in the files. The item's quality roll scales them through the item's weapon-damage stat (
ItemStatInfos[3]).For a projectile weapon, make a child of the vanilla projectile and point your weapon actor's
ProjectileClassat it. For a special effect on hit, make a child damage type. A damage type can give the victim a buff throughBuffToGiveVictimCharacter:DmgType_BolagivesBuff_Bola. See How to make a buff.SlayerXtreme puts a food drain on a tranq arrow's damage type at 14:10.
Set fire rate, clip size and reload. These sit in the weapon actor's Weapon Config. Change only the fields you need.
Show me how
Field in WeaponConfigWhat it does WeapGunWeapBowWeapSwordTimeBetweenShotsseconds between shots or swings 0.475 1.0 0.4 AmmoPerClipshots per reload 6 1 8 NoAnimReloadDuration,bForceReloadDurationreload time when no animation sets it 0.3, on bInfiniteAmmono ammo needed on ItemDurabilityToConsumePerShotdurability lost per shot 0.2 WeaponConfigis neither replicated nor saved. The game rebuilds it from the class defaults on every equip. So a change your graph makes at runtime is gone the next time the player equips the weapon.Bows also have
MinimumInitialSpeed(900),MaximumInitialSpeed(3600) andPullingTimeForMaximumSpeed(1.2 s): how far and fast a drawn arrow flies.Make the ammo item and link it both ways. The weapon names the ammo it fires. The ammo names the weapons it loads into. Both links are needed.
Show me how
- Make a child of
PrimalItemAmmo_Base(stack 100, weight 0.1), or ofPrimalItemAmmo_ArrowBasefor arrows.MyItemTypeisAmmo. - On your weapon actor, set
WeaponAmmoItemTemplateto your ammo item.WeapGunusesPrimalItemAmmo_SimpleBullet(database). - On a thrown weapon, the ammo is the item itself.
WeapGrenade'sWeaponAmmoItemTemplateis the grenade item, withbConsumeAmmoOnUseAmmoon. - A projectile you can pick back up names its ammo too:
ProjArrow'sPickupItemClassis the stone arrow.
For one weapon with one ammo, that's all. For more than one ammo, see the next step.
- Make a child of
Add more ammo types, if your weapon swaps ammo. Each ammo type gets its own weapon actor, and the ammo item decides which one you hold. That's how bows work: a tranq arrow turns the bow into a tranq bow.
Show me how
The stone arrow (
PrimalItemAmmo_ArrowStone, database) shows the pattern:Field on the ammo item Stone arrow's value What it means bSupportDragOntoOtherItemon it can be dragged onto a weapon SupportDragOntoItemClassPrimalItem_WeaponBowthe first weapon item it loads into AmmoSupportDragOntoWeaponItemWeaponTemplateWeapBowthe weapon actor that item becomes with this ammo SupportDragOntoItemClassescrossbow, compound bow, fabricated crossbow… more weapon items, as a list AmmoSupportDragOntoWeaponItemWeaponTemplatesWeapCrossbow,WeapCompoundBow_Stone…the weapon actor for each, in the same order bUseOnItemSetIndexAsDestinationItemCustomDataon the weapon item remembers which ammo it holds bPreventDragOntoOtherItemIfSameCustomDataon dropping the same ammo again does nothing bUseOnItemWeaponRemoveClipAmmoon swapping unloads the old ammo The two lists are paired by position. Entry 0 of the item list goes with entry 0 of the weapon list.
The tranq arrow names
WeapBow_Tranqfor the bow. The crossbow's tranq version,WeapCrossbow_Tranq, is a child ofWeapCrossbow. ItsWeaponAmmoItemTemplateis the tranq arrow and itsProjectileClassisProjArrow_Tranq_Bolt. The Longneck does the same with darts andWeapOneShotRifleTranq.So for your own weapon with two ammo types:
- Weapon actor A:
WeaponAmmoItemTemplate= ammo A. Weapon actor B, a child of A: ammo B and its projectile. - Ammo A and ammo B: your weapon item in the item list, and A or B in the same slot of the weapon list.
- Your weapon item's
ItemClassToUseAsInitialCustomData= ammo A. That's the ammo it starts with; the Bow uses the stone arrow.
The two list fields are in the ammo's sparse class data: values ASA keeps once per class, in a separate block. Find them in Class Defaults, and treat them as fixed for the whole class at runtime.
- Weapon actor A:
Decide what to do about vanilla ammo. Vanilla ammo doesn't know your weapon exists. Its lists name only vanilla weapons, so it won't load into yours.
Show me how
You have three choices:
- Ship your own ammo. It's the cleanest: nothing vanilla changes.
- Edit the vanilla ammo's class defaults at runtime. A singleton adds your item and weapon actor to the vanilla ammo's two lists at server start, on the server and the clients. Modders favor this small edit. It's covered in Changing vanilla content without replacing it.
- Make your weapon item a child of the vanilla one. The vanilla ammo then accepts it, but it equips the vanilla weapon actor with vanilla stats. It's rarely what you want.
Weapons where vanilla never offered a swap, like the sniper rifle, are harder. Modders report that adding a new ammo there means vanilla bullets can't be loaded back without extra runtime edits, or replacement ammo.
Give it your mesh, animations and sounds. Swap assets on the inherited components and fields. Don't delete components.
Show me how
- The weapon actor has two meshes: Mesh1P (WeaponMesh1P), seen in first person, and Mesh3P (WeaponMesh3P), seen by everyone else.
- Animations are montages with a 1P and a 3P entry:
EquipAnim,FireAnim,ReloadAnim,MeleeAnim,UnequipAnim.OverridePawnTPVAnimBlueprintchanges how the character holds it;OverrideAttachPointis the hand socket (PistolWeaponAttach,BowWeaponAttach,MeleeWeaponAttach). - Sounds:
FireSound(instant guns),FireProjectileSound(bows and projectile guns),EquipSound,OutOfAmmoSound. The item has its ownEquipSoundandItemBrokenSoundin its sparse data. - The easy route for a new look: keep the vanilla skeletal meshes and attach a static mesh to the weapon's socket on both Mesh1P and Mesh3P, then hide the vanilla mesh. A sword or axe has one pivot, so this works well.
- Since the UE 5.5 DevKit, modders report you can't change the parent socket of an inherited mesh component. Attach your mesh as a new child component of it instead.
- A full skeletal weapon needs rigging to the vanilla weapon skeleton in Blender, and its own Mesh1P animation class.
Your own meshes, materials and sounds must live in your mod folder. Referencing vanilla ones is fine.
Add attachments, if it takes them. A scope or silencer works exactly like ammo. The attachment item swaps your weapon for a scoped or silenced weapon actor.
Show me how
The Scope Attachment (
PrimalItemWeaponAttachment_Scope, item typeWeaponAttachment) lists the Simple Pistol, Longneck, Fabricated Pistol and others inSupportDragOntoItemClasses. ItsAmmoSupportDragOntoWeaponItemWeaponTemplateslistsWeapGun_Scoped,WeapOneShotRifleScopedand so on, in the same order.So a scoped version of your gun is another weapon actor, a child of yours. The vanilla scope won't know about it, for the same reason as vanilla ammo. Modders note the values go on the attachment item, not on the weapon.
Set durability and repair. Durability is an item stat; wear per use is on the weapon actor.
Show me how
What Field Vanilla values Uses durability at all item bUseItemDurabilityon; off for grenades and spears Base durability item ItemStatInfos[2]→InitialValueConstantpistol 60, sword 70, bow 50, crossbow 100 Wear per shot weapon WeaponConfig→ItemDurabilityToConsumePerShotpistol 0.2 Wear per melee hit weapon ItemDurabilityToConsumePerMeleeHitsword 0.3, base club 0.4 Can be repaired item bAllowRepairon (C++ default) Repair cost a share of the recipe, or the item's own OverrideRepairingRequirementsthe Tek Sword lists its own XP for repairing item BaseRepairingXPpistol 25.25 ItemStatInfos[2]is the max-durability slot of the item stat table.OverrideRepairingRequirementsis sparse class data.Make and register the engram. A new engram entry teaches the weapon. The ammo usually gets its own. How to make an engram has the fields; How ARK finds your content has the cache trap.
Show me how
- Make a new
PrimalEngramEntrychild for the weapon. SetBluePrintEntryto your weapon item. - Do the same for the ammo, if players craft it.
- Add both to the Mod Data Asset's Additional Engram Blueprint Classes. Then reset the cache.
- Recipes that need a station: the Simple Pistol's item sets
CraftingRequiresInventoryComponentto the Smithy's inventory.
- Make a new
Test it. PIE first, then a local dedicated server with a second player.
Show me how
Give yourself the weapon and ammo: right-click each item in the content browser → Give, or use
GiveItemwith the item's path. Then equip, fire, reload, swap ammo, and hit a creature. Watch durability drop, let it break, repair it.Open the inventory with your fists out, not the weapon. Opening it while holding a weapon is a known PIE crash.
The full list is in Check it worked.
How the pieces connect
| This asset | Field | Points at |
|---|---|---|
| Mod Data Asset | Additional Engram Blueprint Classes | your weapon and ammo engrams |
| Engram | BluePrintEntry |
your weapon item (or ammo item) |
| Weapon item | WeaponTemplate |
your weapon actor |
| Weapon item | ItemClassToUseAsInitialCustomData |
the ammo it starts with, when it swaps ammo |
| Weapon actor | WeaponAmmoItemTemplate |
the ammo item it fires |
| Weapon actor | ProjectileClass |
the projectile, for projectile weapons |
| Weapon actor / projectile | DamageType, MeleeDamageType |
the damage type |
| Ammo item | SupportDragOntoItemClass(es) |
the weapon items it loads into |
| Ammo item | AmmoSupportDragOntoWeaponItemWeaponTemplate(s) |
the weapon actor for each, in the same order |
| Projectile | PickupItemClass |
the ammo you get back |
| Attachment item | the same two drag-onto lists | the weapon items, and their scoped or silenced actors |
| Damage type | BuffToGiveVictimCharacter (optional) |
a buff on whoever it hits |
The settings that matter
| What you're looking for | Field | Where it lives |
|---|---|---|
| Which weapon actor the item spawns | WeaponTemplate |
item |
| Damage of an instant gun | InstantConfig.HitDamage |
weapon actor |
| Damage of a projectile | WeaponConfig.DirectDamage |
projectile |
| Melee damage | MeleeDamageAmount, MeleeDamageType |
weapon actor |
| Fire rate | WeaponConfig.TimeBetweenShots |
weapon actor |
| Clip size | WeaponConfig.AmmoPerClip |
weapon actor |
| No ammo needed | WeaponConfig.bInfiniteAmmo |
weapon actor |
| Ammo it fires | WeaponAmmoItemTemplate |
weapon actor |
| Which weapons ammo loads into | SupportDragOntoItemClasses + AmmoSupportDragOntoWeaponItemWeaponTemplates |
ammo item, sparse data |
| Durability | ItemStatInfos[2], bUseItemDurability |
item |
| Wear per use | ItemDurabilityToConsumePerShot, ItemDurabilityToConsumePerMeleeHit |
weapon actor |
| Meshes | Mesh1P, Mesh3P | weapon actor, components |
| Hand socket | OverrideAttachPoint |
weapon actor |
Common mistakes
Equipping my weapon gives me the vanilla one
The item's WeaponTemplate still points at the vanilla actor. On a bow or crossbow, check the loaded ammo too: the
ammo picks the weapon actor. Your item and your actor must be in the ammo's two lists (step 7).
My ammo highlights when I drag it, but it won't load
A link is missing on one side. Check that the ammo lists your item and your weapon actor at the same position.
Then check that weapon actor's WeaponAmmoItemTemplate names this ammo.
After firing the special ammo, the weapon won't switch back
The first ammo is missing its own entry for your weapon. Every ammo type needs both list entries, the normal one included.
Vanilla arrows or bullets won't go into my weapon
Vanilla ammo only lists vanilla weapons. Ship your own ammo, or add your weapon to the vanilla ammo's lists at runtime (step 8).
My changes to fire rate or clip size vanish
You changed WeaponConfig at runtime. It's rebuilt from the defaults on every equip and never saved. Change the class
defaults, or reapply your change each time the weapon is equipped.
My pickaxe suddenly has a 20-round clip
A Make WeaponData node with only one pin wired resets every other field to the C++ defaults. Use Set Members in Struct on a copy of the current value instead (lessons §2).
My weapon is stuck in a T-pose in first person
Mesh1P has no animation class set, or your skeletal mesh isn't rigged to the vanilla weapon skeleton. Modders found the Mesh1P anim class doesn't show as changed when you compare Blueprints, so set it by hand. The static mesh route in step 9 avoids this.
I can't move my mesh to another socket
Since the UE 5.5 DevKit, the parent socket of an inherited mesh component is locked. Add your mesh as a new component attached to that one, at the socket you want (step 9).
The editor crashes when I open the inventory in PIE
It's a long-standing PIE crash: opening the inventory while holding any weapon but fists. It doesn't hit every setup, but put the weapon away first (lessons §3).
Check it worked
- In PIE, the engram is in the list at the level you set. The weapon and ammo craft where they should.
- Equipping shows your mesh in first and third person, with the right animations and sounds.
- It fires at the rate you set, reloads, and runs out of ammo. Melee swings hit where the blade is.
- Damage on a creature matches what you expect. Any victim buff from your damage type shows up.
- Every ammo type loads, swaps and swaps back. Arrows you can recover drop the right item.
- Durability drops with use, the weapon breaks, and it can be repaired.
- Repeat on a local dedicated server with a separate client, and watch the other player's view. PIE runs server and client in one process, so it hides replication mistakes. See Works in PIE, not on a server.
- If something fails silently, read the Output Log for your weapon's name first. See Reading ARK's logs.
Watch
- Creating that FOOD DRAINING TRANQ we all love | Episode 6 (SlayerXtreme). 1:20 the engram. 3:58 item and weapon. 6:52 the arrow's look. 10:42 projectile and damage. 14:10 food drain on the damage type. 19:28 the forgotten Mod Data Asset entry.
- HOW TO make your OWN Tranq Sniper | Episode 23 (SlayerXtreme). 2:03 ammo and damage on the weapon. 3:50 going further.
- Creating your OWN custom HARVESTING TOOL | Episode 10 (SlayerXtreme). 1:36 copying and linking. 3:57 tool properties. 7:30 durability. 9:32 weapon template and harvest rates. 12:33 testing.
- Ark Survival Ascended - Dev Kit - Custom Item Data (Quellcrest). 12:28 a damage type's adjust-damage hook. 28:44 a melee weapon. 33:00 a bow.
- How to Make an ARK ASA Mod (Complete Beginner Guide) (my video). 15:58 an item, its engram and its weapon, linked.
Go deeper
- How to make a custom item and How to make an engram.
- How to make a buff, for effects on whoever your weapon hits.
- Changing vanilla content without replacing it, for letting vanilla ammo into your weapon.
- How ARK finds your content and Works in PIE, not on a server.
- Modding lessons §8, Weapons and damage.
- The database: items, engrams.
Sources
- DevKit files, read offline on 2026-11-05: Every class, field and value on this page comes from these, read with
their sparse class data:
/Game/PrimalEarth/CoreBlueprints/Weapons/PrimalItem_WeaponGun,PrimalItem_WeaponBow,PrimalItem_WeaponCrossbow,PrimalItem_WeaponSword,PrimalItem_WeaponBaseClub,PrimalItem_WeaponGrenade,PrimalItem_WeaponSpear,PrimalItem_WeaponOneShotRifleand their parents;WeapGun,WeapBow,WeapCrossbow,WeapCrossbow_Tranq,WeapOneShotRifle,WeapSword,WeapBaseClub,WeapBaseMelee,WeapGrenade,WeapSpear;PrimalItemAmmo_Base,PrimalItemAmmo_ArrowBase,PrimalItemAmmo_ArrowStone,PrimalItemAmmo_ArrowTranq,PrimalItemAmmo_TranqDart,PrimalItemAmmo_SimpleBullet,PrimalItemAmmo_SimpleRifleBullet;/Game/PrimalEarth/CoreBlueprints/Projectiles/ProjArrowandProjArrow_Tranq;/Game/PrimalEarth/CoreBlueprints/Items/WeaponAttachments/PrimalItemWeaponAttachment_Scope;PrimalItem_WeaponTekSword(repair override);DmgType_Bola.bAllowRepairis from the nativeUPrimalItemconstructor. - Modding lessons in this section: damage never on the item,
WeaponConfignot replicated or saved (lessons §8); the Make WeaponData trap (lessons §2); the inventory-with-weapon PIE crash (lessons §3). - What modders report, from the ARK Modding Community Discord:
- the asset list for a custom gun (August 2025);
- how the item, weapon and ammo references chain for several ammo types, and why vanilla ammo needs a small class default edit (2026; the edit favored over workarounds in June 2026);
- bows and crossbows taking the weapon class from the ammo, and a custom crossbow equipping as vanilla (April 2024);
- sniper-style weapons not taking vanilla ammo back (2026);
- copied vanilla guns fighting a custom graph (2024);
- attachments using the same two lists, set on the attachment item (January 2025, February 2026);
- the locked parent socket since UE 5.5 (June 2025);
- the static mesh swap for melee weapons (August 2025), and children of the sword for melee (December 2024);
- the Mesh1P animation class not showing as changed (November 2023).
- Videos listed under Watch: creators' tutorials, not checked against the kit.
- Community knowledge from the ARK Modding Community Discord (discussions from November 2023 to June 2026, mainly #asa-general, #asa-blueprints, #asa-animation and #asa-devkit-issues), found with Overseer. Threads that helped (they open for server members): assets you need for a custom gun (August 2025), several ammo types on one weapon (May 2026), the drag-swap flag and vanilla ammo (June 2026), attachments set on the attachment item (January 2025), locked sockets since UE 5.5 (June 2025), the static mesh swap for a sword (August 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 items
3,192 rows, each with its own page. Search by name or any detail, or start from a category.
By category
Look something up in engrams
947 rows, each with its own page. Search by name or any detail, or start from a category.