Modding guide

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

  1. 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) WeapGun ShooterWeapon_Instant
    A gun that fires a projectile PrimalItem_WeaponCrossbow (database) WeapCrossbow ShooterWeapon_Projectile
    A bow you draw PrimalItem_WeaponBow (database) WeapBow PrimalWeaponBow
    A melee weapon PrimalItem_WeaponSword (database) WeapSword → WeapBaseClub → WeapBaseMelee ShooterWeapon_Melee
    Something you throw PrimalItem_WeaponGrenade (database) WeapGrenade PrimalWeaponGrenade

    The item chain for guns is PrimalItem_WeaponGun → PrimalItemWeaponGenericGun → PrimalItemWeaponGeneric → PrimalItem_Base → native PrimalItem. Melee items use PrimalItemWeaponGenericAmmoless instead. Thrown items use PrimalItemWeaponGenericAmmolessConsumeSelf: the grenade is its own ammo.

    The Spear is a surprise: it's thrown, and its weapon actor is a PrimalWeaponBow.

  2. 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.
  3. 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 WeaponTemplate your weapon actor
    Item DescriptiveNameBase, ItemDescription, ItemIconJIT, BaseItemWeight, BaseCraftingResourceRequirements name, text, icon, weight, recipe
    Item MyItemType, MyEquipmentType both Weapon; inherited, leave them

    The Simple Pistol's item weighs 5 and costs 60 metal ingots and 5 wood, among other things.

  4. 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, WeaponSpread WeapGun: 100, DmgType_Instant
    Projectile weapon weapon actor → ProjectileClass; then the projectile's WeaponConfig → DirectDamage, DamageType ProjArrow (stone arrow): 55; ProjArrow_Tranq: 20
    Melee weapon actor → MeleeDamageAmount, MeleeDamageType WeapSword: 90; the base club: 3
    Every weapon's melee bash weapon actor → MeleeDamageAmount 10 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 ProjectileClass at it. For a special effect on hit, make a child damage type. A damage type can give the victim a buff through BuffToGiveVictimCharacter: DmgType_Bola gives Buff_Bola. See How to make a buff.

    SlayerXtreme puts a food drain on a tranq arrow's damage type at 14:10.

  5. 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 WeaponConfig What it does WeapGun WeapBow WeapSword
    TimeBetweenShots seconds between shots or swings 0.475 1.0 0.4
    AmmoPerClip shots per reload 6 1 8
    NoAnimReloadDuration, bForceReloadDuration reload time when no animation sets it 0.3, on
    bInfiniteAmmo no ammo needed on
    ItemDurabilityToConsumePerShot durability lost per shot 0.2

    WeaponConfig is 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) and PullingTimeForMaximumSpeed (1.2 s): how far and fast a drawn arrow flies.

  6. 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 of PrimalItemAmmo_ArrowBase for arrows. MyItemType is Ammo.
    • On your weapon actor, set WeaponAmmoItemTemplate to your ammo item. WeapGun uses PrimalItemAmmo_SimpleBullet (database).
    • On a thrown weapon, the ammo is the item itself. WeapGrenade's WeaponAmmoItemTemplate is the grenade item, with bConsumeAmmoOnUseAmmo on.
    • A projectile you can pick back up names its ammo too: ProjArrow's PickupItemClass is the stone arrow.

    For one weapon with one ammo, that's all. For more than one ammo, see the next step.

  7. 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
    bSupportDragOntoOtherItem on it can be dragged onto a weapon
    SupportDragOntoItemClass PrimalItem_WeaponBow the first weapon item it loads into
    AmmoSupportDragOntoWeaponItemWeaponTemplate WeapBow the weapon actor that item becomes with this ammo
    SupportDragOntoItemClasses crossbow, compound bow, fabricated crossbow… more weapon items, as a list
    AmmoSupportDragOntoWeaponItemWeaponTemplates WeapCrossbow, WeapCompoundBow_Stone… the weapon actor for each, in the same order
    bUseOnItemSetIndexAsDestinationItemCustomData on the weapon item remembers which ammo it holds
    bPreventDragOntoOtherItemIfSameCustomData on dropping the same ammo again does nothing
    bUseOnItemWeaponRemoveClipAmmo on 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_Tranq for the bow. The crossbow's tranq version, WeapCrossbow_Tranq, is a child of WeapCrossbow. Its WeaponAmmoItemTemplate is the tranq arrow and its ProjectileClass is ProjArrow_Tranq_Bolt. The Longneck does the same with darts and WeapOneShotRifleTranq.

    So for your own weapon with two ammo types:

    1. Weapon actor A: WeaponAmmoItemTemplate = ammo A. Weapon actor B, a child of A: ammo B and its projectile.
    2. Ammo A and ammo B: your weapon item in the item list, and A or B in the same slot of the weapon list.
    3. 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.

  8. 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.

  9. 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. OverridePawnTPVAnimBlueprint changes how the character holds it; OverrideAttachPoint is the hand socket (PistolWeaponAttach, BowWeaponAttach, MeleeWeaponAttach).
    • Sounds: FireSound (instant guns), FireProjectileSound (bows and projectile guns), EquipSound, OutOfAmmoSound. The item has its own EquipSound and ItemBrokenSound in 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.

  10. 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 type WeaponAttachment) lists the Simple Pistol, Longneck, Fabricated Pistol and others in SupportDragOntoItemClasses. Its AmmoSupportDragOntoWeaponItemWeaponTemplates lists WeapGun_Scoped, WeapOneShotRifleScoped and 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.

  11. 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 bUseItemDurability on; off for grenades and spears
    Base durability item ItemStatInfos[2] → InitialValueConstant pistol 60, sword 70, bow 50, crossbow 100
    Wear per shot weapon WeaponConfig → ItemDurabilityToConsumePerShot pistol 0.2
    Wear per melee hit weapon ItemDurabilityToConsumePerMeleeHit sword 0.3, base club 0.4
    Can be repaired item bAllowRepair on (C++ default)
    Repair cost a share of the recipe, or the item's own OverrideRepairingRequirements the Tek Sword lists its own
    XP for repairing item BaseRepairingXP pistol 25.25

    ItemStatInfos[2] is the max-durability slot of the item stat table. OverrideRepairingRequirements is sparse class data.

  12. 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 PrimalEngramEntry child for the weapon. Set BluePrintEntry to 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 CraftingRequiresInventoryComponent to the Smithy's inventory.
  13. 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 GiveItem with 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

  1. In PIE, the engram is in the list at the level you set. The weapon and ammo craft where they should.
  2. Equipping shows your mesh in first and third person, with the right animations and sounds.
  3. It fires at the rate you set, reloads, and runs out of ammo. Melee swings hit where the blade is.
  4. Damage on a creature matches what you expect. Any victim buff from your damage type shows up.
  5. Every ammo type loads, swaps and swaps back. Arrows you can recover drop the right item.
  6. Durability drops with use, the weapon breaks, and it can be repaired.
  7. 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.
  8. If something fails silently, read the Output Log for your weapon's name first. See Reading ARK's logs.

Watch

Go deeper

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_WeaponOneShotRifle and 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/ProjArrow and ProjArrow_Tranq; /Game/PrimalEarth/CoreBlueprints/Items/WeaponAttachments/PrimalItemWeaponAttachment_Scope; PrimalItem_WeaponTekSword (repair override); DmgType_Bola. bAllowRepair is from the native UPrimalItem constructor.
  • Modding lessons in this section: damage never on the item, WeaponConfig not 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.

Browse all items

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