🔫 Weapon
Weapons are entities with firing, reloading and aiming functionalities.
They are fully customizable, all pieces of the weapon can be changed with immense possibility of creation.
💂Authority
This class can only be spawned on 🟦 Server.
👪Inheritance
tip
Please take a look at our Default's Weapon package with all built-in Weapons already properly configured and ready to use: https://github.com/nanos-world/nanos-world-weapons.
This Package is already included in the base game, you just need to Package.RequirePackage("nanos-world-weapons") and use it!
🎒 Examples
Server/Index.lua
-- Spawning a Weapon with an AK47 model
local new_weapon = Weapon(
Vector(-900, 185, 215),
Rotator(0, 0, 0),
"nanos-world::SK_AK47"
)
-- Configures Weapon Base Settings
new_weapon:SetAmmoSettings(30, 1000)
new_weapon:SetDamage(30)
new_weapon:SetSpread(30)
new_weapon:SetRecoil(0.25)
new_weapon:SetBulletSettings(1, 20000, 20000, Color(100, 58, 0))
new_weapon:SetCadence(0.1)
new_weapon:SetWallbangSettings(50, 0.75)
-- Configures how the Character Grabs and Aims the Weapon
new_weapon:SetHandlingMode(HandlingMode.DoubleHandedWeapon)
new_weapon:SetSightTransform(Vector(0, 0, -1), Rotator(-1.5, 0, 0))
new_weapon:SetLeftHandTransform(Vector(22, 0, 9), Rotator(0, 60, 90))
new_weapon:SetRightHandOffset(Vector(-10, 0, 0))
-- Configures Weapon Particles
new_weapon:SetParticlesBulletTrail("nanos-world::P_Bullet_Trail")
new_weapon:SetParticlesBarrel("nanos-world::P_Weapon_BarrelSmoke")
new_weapon:SetParticlesShells("nanos-world::P_Weapon_Shells_762x39")
-- Configures Weapon Sounds
new_weapon:SetSoundDry("nanos-world::A_Rifle_Dry")
new_weapon:SetSoundLoad("nanos-world::A_Rifle_Load")
new_weapon:SetSoundUnload("nanos-world::A_Rifle_Unload")
new_weapon:SetSoundZooming("nanos-world::A_AimZoom")
new_weapon:SetSoundAim("nanos-world::A_Rattle")
new_weapon:SetSoundFire("nanos-world::A_AK47_Shot")
-- Configures Weapon Animations
new_weapon:SetAnimationFire("nanos-world::A_AK47_Fire")
new_weapon:SetAnimationCharacterFire("nanos-world::AM_Mannequin_Sight_Fire")
new_weapon:SetAnimationReload("nanos-world::AM_Mannequin_Reload_Rifle")
-- Configures the Mesh to drop when reloading
new_weapon:SetMagazineMesh("nanos-world::SM_AK47_Mag_Empty")
-- Configures the Crosshair Material
new_weapon:SetCrosshairMaterial("nanos-world::MI_Crosshair_Regular")
Using our Default Weapons Package https://github.com/nanos-world/nanos-world-weapons to spawn an AK47:
Server/Index.lua
-- Includes the nanos world Default Weapons Package in your Package
-- (you don't need to download it, just include it!)
Package.RequirePackage("nanos-world-weapons")
-- Spawning the AK47
local my_ak47 = NanosWorldWeapons.AK47(Vector(1035, 154, 300), Rotator())
-- Giving the Weapon to a Character
my_character:PickUp(my_ak47)
More related examples:
Prop Shootergetting-started/tutorials-and-examples/prop-shooterWeapon Scopegetting-started/tutorials-and-examples/weapon-scopeWeapon Flashlightgetting-started/tutorials-and-examples/weapon-flashlight🏗️ Constructor
local my_weapon = Weapon(location?, rotation?, asset?, collision_type?, gravity_enabled?)
| Type | Name | Default | Description |
|---|---|---|---|
| Vector | location | Vector(0, 0, 0) | |
| Rotator | rotation | Rotator(0, 0, 0) | |
| SkeletalMesh Reference | asset | | |
| CollisionType | collision_type | CollisionType.Normal | |
| boolean | gravity_enabled | true |
🦠 Functions
Inherited Actor Functions
Base Actorscripting-reference/classes/base-classes/actor
| Returns | Name | Description | |
|---|---|---|---|
 | AddImpulse | Applies a force in world world to this Actor | |
| | AttachTo | Attaches this Actor to any other Actor, optionally at a specific bone | |
| | Destroy | Destroys this Actor | |
| | Detach | Detaches this Actor from AttachedTo Actor | |
| | SetCollision | Sets this Actor's collision type | |
| | SetForce | Adds a permanent force to this Actor, set to Vector(0, 0, 0) to cancel | |
| | SetGravityEnabled | Sets whether gravity is enabled on this Actor | |
 | SetVisibility | Sets whether the actor is visible or not | |
 | SetHighlightEnabled | Sets whether the highlight is enabled on this Actor, and which highlight index to use | |
| | SetOutlineEnabled | Sets whether the outline is enabled on this Actor, and which outline index to use | |
| | SetLifeSpan | Sets the time (in seconds) before this Actor is destroyed. After this time has passed, the actor will be automatically destroyed. | |
| | SetLocation | Sets this Actor's location in the game world | |
| | SetRotation | Sets this Actor's rotation in the game world | |
| | SetRelativeLocation | Sets this Actor's relative location in local space (only if this actor is attached) | |
| | SetRelativeRotation | Sets this Actor's relative rotation in local space (only if this actor is attached) | |
| | SetScale | Sets this Actor's scale | |
 | SetNetworkAuthority | Sets the Player to have network authority over this Actor | |
| | SetValue | Sets a value in this Actor | |
| | TranslateTo | Smoothly moves this actor to a location over a certain time | |
| | RotateTo | Smoothly rotates this actor to an angle over a certain time | |
| | boolean | IsBeingDestroyed | Returns true if this Actor is being destroyed |
| | boolean | IsVisible | Returns true if this Actor is visible |
| | boolean | IsGravityEnabled | Returns true if gravity is enabled on this Actor |
| | boolean | IsInWater | Returns true if this Actor is in water |
| | boolean | IsNetworkDistributed | Returns true if this Actor is currently network distributed |
| | boolean | IsValid | Returns true if this Actor is valid (i.e. wasn't destroyed and points to a valid Actor) |
| | table of Base Actor | GetAttachedEntities | Gets all Actors attached to this Actor |
| | Base Actor or nil | GetAttachedTo | Gets the Actor this Actor is attached to |
| | table | GetBounds | Gets this Actor's bounds |
| | CollisionType | GetCollision | Gets this Actor's collision type |
| | number | GetID | Gets the universal network ID of this Actor (same on both client and server) |
| | Vector | GetLocation | Gets this Actor's location in the game world |
| | Rotator | GetRotation | Gets this Actor's angle in the game world |
| | Vector | GetForce | Gets this Actor's force (set by SetForce()) |
| | boolean | HasNetworkAuthority | Returns true if the local Player is currently the Network Authority of this Actor |
| | boolean | HasAuthority | Gets if this Actor was spawned by the client side |
| | Vector | GetScale | Gets this Actor's scale |
| | string | GetType | Gets the type of this Actor |
| | any | GetValue | Gets a value stored on this Actor at the given key. Please refer to Entity Values for more information |
| | Vector | GetVelocity | Gets this Actor's current velocity |
| | AddActorTag | Adds an Unreal Actor Tag to this Actor | |
| | RemoveActorTag | Removes an Unreal Actor Tag from this Actor | |
| | table of string | GetActorTags | Gets all Unreal Actor Tags on this Actor |
| | function | Subscribe | Subscribes to an Event |
| | Unsubscribe | Unsubscribes all callbacks from this Event in this Actor within this Package, or only the callback passed |
Inherited Paintable Functions
Base Paintablescripting-reference/classes/base-classes/paintable
| Returns | Name | Description | |
|---|---|---|---|
| | SetMaterial | Sets the material at the specified index of this Actor | |
| | SetMaterialFromCanvas | Sets the material at the specified index of this Actor to a Canvas object | |
| | SetMaterialFromSceneCapture | Sets the material at the specified index of this Actor to a SceneCapture object | |
| | SetMaterialFromWebUI | Sets the material at the specified index of this Actor to a WebUI object | |
| | ResetMaterial | Resets the material from the specified index to the original one | |
| | SetMaterialColorParameter | Sets a Color parameter in this Actor's material | |
| | SetMaterialScalarParameter | Sets a Scalar parameter in this Actor's material | |
| | SetMaterialTextureParameter | Sets a texture parameter in this Actor's material to an image on disk | |
| | SetMaterialVectorParameter | Sets a Vector parameter in this Actor's material | |
| | SetPhysicalMaterial | Overrides this Actor's Physical Material with a new one |
Inherited Pickable Functions
Base Pickablescripting-reference/classes/base-classes/pickable
| Returns | Name | Description | |
|---|---|---|---|
| | AddSkeletalMeshAttached | Attaches a Skeletal Mesh as master pose to this entity | |
| | AddStaticMeshAttached | Attaches a Static Mesh to this entity | |
| | PullUse | Pulls the usage of this Pickable (will start firing if this is a weapon) | |
| | ReleaseUse | Releases the usage of this Pickable (will stop firing if this is a weapon) | |
| | RemoveSkeletalMeshAttached | Removes, if it exists, a SkeletalMesh from this Pickable given its custom ID | |
| | RemoveStaticMeshAttached | Removes, if it exists, a StaticMesh from this Pickable given its custom ID | |
| | SetAttachmentSettings | Sets the Attachment Settings for this Pickable (how it attaches to the Character when Picking up) | |
| | SetCrosshairMaterial | Sets the crosshair material for this Pickable | |
| | SetPickable | Sets if this Pickable can be picked up from ground by the player | |
| | SkeletalMesh Reference | GetAssetName | Gets the name of the asset this Pickable uses |
| | Character or nil | GetHandler | Gets the Character, if it exists, that's holding this Pickable |
| Returns | Name | Description | |
|---|---|---|---|
| | Reload | Forces this Weapon to reload | |
| | SetAmmoBag | Sets this Weapon's Ammo in the Bag | |
| | SetAmmoClip | Sets this Weapon's Ammo in the Clip | |
| | SetAmmoSettings | Aux for setting and configuring ammo | |
| | SetAnimationFire | Animation played by the Weapon when Firing | |
| | SetAnimationCharacterFire | Animation played by the Character when Firing | |
| | SetAutoReload | If the Character will reload automatically when ammo empties | |
| | SetBulletColor | Set the Bullet Color | |
| | SetAutoReload | Sets if the Weapon auto reloads when ammo empties | |
| | SetBulletSettings | Aux for setting and configuring the Bullet | |
| | SetCadence | Speed of shots | |
| | SetClipCapacity | Capacity of the Weapon's clip | |
| | SetDamage | Set the Base Weapon's Damage | |
| | SetHandlingMode | Sets how the Character grabs this Weapon | |
| | SetLeftHandTransform | Left Hand Offset | |
| | SetMagazineMesh | Set the mesh used when the Character reloads the weapon | |
| | SetParticlesBulletTrail | Particle of the Bullet flying | |
| | SetParticlesBarrel | Particle of the Fire Blast in the muzzle | |
| | SetParticlesShells | Particle of the empty bullet flying from the weapon when shooting | |
| | SetRightHandOffset | Set the offset of Right Hand | |
| | SetSightFOVMultiplier | The FOV multiplier when ADS | |
| | SetSightTransform | Offset applied to align player's head to weapon's sight and rotation applied on the weapon when ADS | |
| | SetSoundDry | Sound when weapon has not bullet and try to shoot | |
| | SetSoundLoad | Sound when Loading a magazine | |
| | SetSoundUnload | Sound when Unloading a magazine | |
| | SetSoundZooming | Sound when Zooming | |
| | SetSoundFire | Sound when Shooting | |
| | SetSoundAim | Sound when Aiming | |
| | SetSoundFireLastBullets | Sound when firing with only having X remaining bullets in the magazine | |
| | SetSpread | Base Weapon's Spread | |
| | SetRecoil | Base Weapon's Recoil | |
| | SetUsageSettings | Sets if the Weapon can hold to keep firing and if it needs to release to fire | |
| | SetWallbangSettings | Sets how the bullet will pass through walls | |
| | number | GetAmmoBag | Gets this Weapon's Ammo Bag |
| | number | GetAmmoClip | Gets this Weapon's Ammo Clip |
| | number | GetAmmoToReload | |
| | HandlingMode | GetHandlingMode | |
| | string | GetAnimationCharacterFire | |
| | string | GetAnimationFire | |
| | string | GetMagazineMesh | |
| | string | GetParticlesBulletTrail | |
| | string | GetParticlesShells | |
| | string | GetSoundDry | |
| | string | GetSoundLoad | |
| | string | GetSoundUnload | |
| | string | GetSoundZooming | |
| | string | GetSoundAim | |
| | string | GetSoundFire | |
| | boolean | GetCanHoldUse | |
| | boolean | GetHoldReleaseUse | |
| | number | GetBulletCount | |
| | Color | GetBulletColor | |
| | number | GetCadence | |
| | number | GetClipCapacity | |
| | number | GetDamage | |
| | Vector | GetRightHandOffset | |
| | Vector | GetLeftHandLocation | |
| | Rotator | GetLeftHandRotation | |
| | Vector | GetSightLocation | |
| | Rotator | GetSightRotation | |
| | number | GetSightFOVMultiplier | |
| | number | GetSpread | |
| | number | GetRecoil |
Reload
Forces this Weapon to reload (only if being handled by a Character)
my_weapon:Reload()
SetAmmoBag
Sets this Weapon's Ammo in the Bag
my_weapon:SetAmmoBag(new_ammo)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | new_ammo |
SetAmmoClip
Sets this Weapon's Ammo in the Clip
my_weapon:SetAmmoClip(new_ammo)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | new_ammo |
SetAmmoSettings
Aux for setting and configuring ammo
my_weapon:SetAmmoSettings(ammo_clip, ammo_bag, ammo_to_reload?, clip_capacity?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | ammo_clip | ||
| number | ammo_bag | ||
| number | ammo_to_reload? | ammo_clip | |
| number | clip_capacity? | ammo_clip |
SetAnimationFire
Animation played by the Weapon when Firing
my_weapon:SetAnimationFire(animation_asset_path, play_rate?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Animation Reference | animation_asset_path | ||
| number | play_rate? | 1 |
SetAnimationCharacterFire
Animation played by the Character when Firing
my_weapon:SetAnimationCharacterFire(animation_path, play_rate?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Animation Reference | animation_path | ||
| number | play_rate? | 1 |
SetAutoReload
If the Character will reload automatically when ammo empties. Default is true
my_weapon:SetAutoReload(auto_reload)
| Type | Parameter | Default | Description |
|---|---|---|---|
| boolean | auto_reload |
SetBulletColor
Set the Bullet Color
Only has effect if using Bullet Trail particle P_Bullet_Trail or if you particle has the Color parameter
my_weapon:SetBulletColor(color)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Color | color |
SetAutoReload
Sets if the Weapon auto reloads when ammo empties
my_weapon:SetAutoReload(auto_reload)
| Type | Parameter | Default | Description |
|---|---|---|---|
| boolean | auto_reload |
SetBulletSettings
Aux for setting and configuring the Bullet
my_weapon:SetBulletSettings(bullet_count, bullet_max_distance, bullet_velocity, bullet_color)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | bullet_count | 1 for common weapons > 1 for shotguns | |
| number | bullet_max_distance | ||
| number | bullet_velocity | Visuals only | |
| Color | bullet_color |
SetCadence
Speed of shots
my_weapon:SetCadence(cadence)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | cadence | 1 shot at each cadence second |
SetClipCapacity
Capacity of the Weapon's clip
my_weapon:SetClipCapacity(clip)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | clip |
SetDamage
Base Weapon's Damage
This will be multiplied by multiplier factors when hitting specific bones
my_weapon:SetDamage(damage)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | damage |
SetHandlingMode
Sets how the Character grabs this Weapon
my_weapon:SetHandlingMode(mode)
| Type | Parameter | Default | Description |
|---|---|---|---|
| HandlingMode | mode |
SetLeftHandTransform
Left Hand Offset
my_weapon:SetLeftHandTransform(location, rotation)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Vector | location | ||
| Rotator | rotation |
SetMagazineMesh
Set the mesh used when the Character reloads the weapon.
Will drop this Mesh as an animation effect.
my_weapon:SetMagazineMesh(static_mesh_asset_path, magazine_mesh_hide_bone?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| StaticMesh Reference | static_mesh_asset_path | ||
| string | magazine_mesh_hide_bone? | b_gun_mag | Weapon bone to hide when reloading it |
SetParticlesBulletTrail
Particle of the Bullet flying
my_weapon:SetParticlesBulletTrail(particle_asset_path)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Particle Reference | particle_asset_path |
SetParticlesBarrel
Particle of the Fire Blast in the muzzle
my_weapon:SetParticlesBarrel(particle_asset_path)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Particle Reference | particle_asset_path |
SetParticlesShells
Particle of the empty bullet flying from the weapon when shooting
my_weapon:SetParticlesShells(particle_asset_path)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Particle Reference | particle_asset_path |
SetRightHandOffset
Set the Offset of Right Hand. To position relative to the camera.
my_weapon:SetRightHandOffset(offset)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Vector | offset |
SetSightFOVMultiplier
The FOV multiplier when ADS
my_weapon:SetSightFOVMultiplier(multiplier)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | multiplier |
SetSightTransform
Offset applied to align player's head to weapon's sight and rotation applied on the weapon when ADS
my_weapon:SetSightTransform(location, rotation)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Vector | location | ||
| Rotator | rotation |
SetSoundDry
Sound when weapon has not bullet and try to shoot
my_weapon:SetSoundDry(sound_asset_path, volume?, pitch?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Sound Reference | sound_asset_path | ||
| number | volume? | 1 | |
| number | pitch? | 1 |
SetSoundLoad
Sound when Loading a magazine
my_weapon:SetSoundLoad(sound_asset_path, volume?, pitch?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Sound Reference | sound_asset_path | ||
| number | volume? | 1 | |
| number | pitch? | 1 |
SetSoundUnload
Sound when Unloading a magazine
my_weapon:SetSoundUnload(sound_asset_path, volume?, pitch?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Sound Reference | sound_asset_path | ||
| number | volume? | 1 | |
| number | pitch? | 1 |
SetSoundZooming
Sound when Zooming
my_weapon:SetSoundZooming(sound_asset_path, volume?, pitch?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Sound Reference | sound_asset_path | ||
| number | volume? | 1 | |
| number | pitch? | 1 |
SetSoundFire
Sound when Shooting
my_weapon:SetSoundFire(sound_asset_path, volume?, pitch?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Sound Reference | sound_asset_path | ||
| number | volume? | 1 | |
| number | pitch? | 1 |
SetSoundAim
Sound when Aiming
my_weapon:SetSoundAim(sound_asset_path, volume?, pitch?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Sound Reference | sound_asset_path | ||
| number | volume? | 1 | |
| number | pitch? | 1 |
SetSoundFireLastBullets
Sound when firing with only having X remaining bullets in the magazine, useful for last shot 'ping' or sound when low on bullets
my_weapon:SetSoundFireLastBullets(sound_asset_path, remaining_bullets_count?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Sound Reference | sound_asset_path | ||
| number | remaining_bullets_count? | 1 | The amount of remaining bullet to start playing this sound |
SetSpread
Base Weapon's Spread
my_weapon:SetSpread(spread)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | spread | the higher the less precision - recommended value: 20 |
SetRecoil
Base Weapon's Recoil
my_weapon:SetRecoil(recoil)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | recoil | 0 means no Recoil, default is 1 |
SetUsageSettings
Sets if the Weapon can hold to keep firing and if it needs to release to fire
my_weapon:SetUsageSettings(can_hold_use, hold_release_use)
| Type | Parameter | Default | Description |
|---|---|---|---|
| boolean | can_hold_use | ||
| boolean | hold_release_use |
SetWallbangSettings
Sets how the bullet will pass through walls
my_weapon:SetWallbangSettings(max_distance, damage_multiplier)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | max_distance | Max distance to pass through another wall | |
| number | damage_multiplier | Damage given if wallbangged |
GetAmmoBag
Gets this Weapon's Ammo Bag
Returns number ()
local ret = my_weapon:GetAmmoBag()
GetAmmoClip
Gets this Weapon's Ammo Clip
Returns number ()
local ret = my_weapon:GetAmmoClip()
GetAmmoToReload
Returns number ()
local ret = my_weapon:GetAmmoToReload()
GetHandlingMode
Returns HandlingMode ()
local ret = my_weapon:GetHandlingMode()
GetAnimationCharacterFire
Returns string ()
local ret = my_weapon:GetAnimationCharacterFire()
GetAnimationFire
Returns string ()
local ret = my_weapon:GetAnimationFire()
GetMagazineMesh
Returns string ()
local ret = my_weapon:GetMagazineMesh()
GetParticlesBulletTrail
Returns string ()
local ret = my_weapon:GetParticlesBulletTrail()
GetParticlesShells
Returns string ()
local ret = my_weapon:GetParticlesShells()
GetSoundDry
Returns string ()
local ret = my_weapon:GetSoundDry()
GetSoundLoad
Returns string ()
local ret = my_weapon:GetSoundLoad()
GetSoundUnload
Returns string ()
local ret = my_weapon:GetSoundUnload()
GetSoundZooming
Returns string ()
local ret = my_weapon:GetSoundZooming()
GetSoundAim
Returns string ()
local ret = my_weapon:GetSoundAim()
GetSoundFire
Returns string ()
local ret = my_weapon:GetSoundFire()
GetCanHoldUse
Returns boolean ()
local ret = my_weapon:GetCanHoldUse()
GetHoldReleaseUse
Returns boolean ()
local ret = my_weapon:GetHoldReleaseUse()
GetBulletCount
Returns number ()
local ret = my_weapon:GetBulletCount()
GetBulletColor
Returns Color ()
local ret = my_weapon:GetBulletColor()
GetCadence
Returns number ()
local ret = my_weapon:GetCadence()
GetClipCapacity
Returns number ()
local ret = my_weapon:GetClipCapacity()
GetDamage
Returns number ()
local ret = my_weapon:GetDamage()
GetRightHandOffset
Returns Vector ()
local ret = my_weapon:GetRightHandOffset()
GetLeftHandLocation
Returns Vector ()
local ret = my_weapon:GetLeftHandLocation()
GetLeftHandRotation
Returns Rotator ()
local ret = my_weapon:GetLeftHandRotation()
GetSightLocation
Returns Vector ()
local ret = my_weapon:GetSightLocation()
GetSightRotation
Returns Rotator ()
local ret = my_weapon:GetSightRotation()
GetSightFOVMultiplier
Returns number ()
local ret = my_weapon:GetSightFOVMultiplier()
GetSpread
Returns number ()
local ret = my_weapon:GetSpread()
GetRecoil
Returns number ()
local ret = my_weapon:GetRecoil()
🚀 Events
Inherited Actor Events
Base Actorscripting-reference/classes/base-classes/actor
| Name | Description | |
|---|---|---|
| | Destroy | Triggered when an Actor is destroyed |
| | Spawn | Triggered when an Actor is spawned/created |
| | ValueChange | Triggered when an Actor has a value changed with :SetValue() |
Inherited Pickable Events
Base Pickablescripting-reference/classes/base-classes/pickable
| Name | Description | |
|---|---|---|
| | Drop | When a Character drops this Pickable |
| | Hit | When this Pickable hits something |
| | Interact | Triggered when a Character interacts with this Pickable (i.e. tries to pick it up) |
| | PickUp | Triggered When a Character picks this up |
| | PullUse | Triggered when a Character presses the use button for this Pickable (i.e. clicks left mouse button with this equipped) |
| | ReleaseUse | Triggered when a Character releases the use button for this Pickable (i.e. releases left mouse button with this equipped) |
| Name | Description | |
|---|---|---|
| | Fire | Triggered when Weapon fires (this will be triggered for each shot) |
| | Reload | When a Weapon is reloaded, optionally by a Character |
| | AmmoClipChanged | When the Ammo Clip is changed, by reloading or manually setting through scripting |
| | AmmoBagChanged | When the Ammo Bag is changed, by reloading or manually setting through scripting |
Fire
Triggered when Weapon fires (this will be triggered for each shot)
Weapon.Subscribe("Fire", function(self, shooter)
end)
| Type | Argument | Description |
|---|---|---|
| Weapon | self | |
| Character | shooter |
Reload
When a Weapon is reloaded, optionally by a Character
Weapon.Subscribe("Reload", function(self, character, ammo_to_reload)
end)
| Type | Argument | Description |
|---|---|---|
| Weapon | self | |
| Character | character | |
| number | ammo_to_reload |
AmmoClipChanged
When the Ammo Clip is changed, by reloading or manually setting through scripting
Weapon.Subscribe("AmmoClipChanged", function(self, old_ammo_clip, new_ammo_clip)
end)
| Type | Argument | Description |
|---|---|---|
| Weapon | self | |
| number | old_ammo_clip | |
| number | new_ammo_clip |
AmmoBagChanged
When the Ammo Bag is changed, by reloading or manually setting through scripting
Weapon.Subscribe("AmmoBagChanged", function(self, old_ammo_clip, new_ammo_clip)
end)
| Type | Argument | Description |
|---|---|---|
| Weapon | self | |
| number | old_ammo_clip | |
| number | new_ammo_clip |