Weapons

HELIX has a flexible weapon system that supports firearms, melee weapons, and projectile-based tools. You can configure damage, fire rate, recoil, spread, and hit detection to build anything from a realistic shooter to a cartoon paint gun.

Spawning & Equipping

Create a weapon and attach it to a character to get started.

Blueprint

// Spawn a weapon using a Blueprint asset
AWeapon* Rifle = Weapon::Spawn(
    FVector(0, 0, 0),
    FRotator(0, 0, 0),
    "/ShooterCore/Weapons/Rifle/BP_WeaponActor_Rifle.BP_WeaponActor_Rifle_C",
    CollisionType::Normal,
    true
);

Lua

-- Spawn a weapon using a Blueprint asset
local rifle = Weapon(
    Vector(-900, 185, 215),
    Rotator(0, 0, 0),
    "/ShooterCore/Weapons/Rifle/BP_WeaponActor_Rifle.BP_WeaponActor_Rifle_C",
    CollisionType.Normal,
    true
)

JavaScript

// Spawn a weapon using a Blueprint asset
const rifle = new Weapon(
    new Vector(-900, 185, 215),
    new Rotator(0, 0, 0),
    "/ShooterCore/Weapons/Rifle/BP_WeaponActor_Rifle.BP_WeaponActor_Rifle_C",
    CollisionType.Normal,
    true
);

Configuring Weapons

Weapon behavior -- damage, ammo, fire rate, spread, and recoil -- is configured through the weapon's Blueprint asset in HELIX Studio. The Weapon class inherits from Actor, so you have access to all standard Actor functions for positioning, visibility, and lifecycle management.

note

The Weapon API provides constructor-level configuration and inherits Actor functions. Weapon-specific gameplay properties (damage, fire rate, spread, recoil) are typically set inside the weapon's Blueprint rather than through scripting API calls. See the full API reference for the latest available functions.

Hit Detection & Damage

Weapons handle hit detection and firing internally. Since Weapon inherits from Actor, you can use the event system to subscribe to relevant gameplay events and implement custom damage logic in your scripts or Blueprints.

Projectile Weapons

For weapons that fire visible projectiles (rockets, grenades, arrows), you can configure projectile speed, gravity, and explosion radius instead of using hitscan detection.

tip

Melee weapons work with the same Weapon class -- set the fire rate to your swing speed and use a short-range trace instead of projectiles. Check out the Vault for ready-made weapon packs.