properties which define the vast majority of gun attributes and may change accross instances

constancts which define gun attributes and should not be changed in an instance of the gun

offsets. runtime storage of offsets generated by recoil sway wag or any other element.

string the name of the gun. Set to __template for guns which have no instances.

ItemStack itemstack held by the player

ObjRef the gun entity

string the itemstring of the gun- i.e. "guns4d_pack_1:m4". Set to "" for __template guns.

list of registered guns, DO NOT MODIFY I really need a metatable for this class...

bool is the bolt charged

table list of particle spawner handles (generated by firing)

int the active index of the firemode from lvl1_fields.properties.firemodes

float walking time used to generate the figure 8 for wag

float

float

float time left for the chamber to cycle (for firerates)

int number of rounds left that need to be fired after a burst fire

function

vector containing the offset from animations, this will be generated if {@consts.ANIMATIONS_OFFSET_AIM}=true

total offsets of the gun in the same format as a an offset

table hipfire properties

table aiming ("aiming down sights") properties

table list of firemodes

table list of corresponding images for firemodes

table defines the guns recoil

table defines the guns idle sway

table defines the movement of the gun while walking

table defines how rounds are chambered into the gun

defines what ammo the gun uses

defines visual attributes of the gun

float=.5 max angular deviation (vertical) from breathing

vector the offset from the center of the muzzle flash. Used by fire()

int=600 The number of rounds (cartidges) this gun can throw per minute. Used by update(), fire() and default controls

the item entity's attributes. This will later include held item definition...

int=3 how many rounds in burst using when firemode is at "burst"

string overlay on the item to use when infinite ammo is on

table containing a list of actions for PC users passed to Control_handler

table containing a list of actions for touch screen users passed to Control_handler

and ordered list of reloading states used by default_controls.

the default reload states for a magazine operated weapon, copied from the m4.

Example

{action="charge", time=.5, anim="charge", sounds={sound="ar_charge", delay = .2}},
{action="unload_mag", time=.25, anim="unload", sounds = {sound="ar_mag_unload"}},
{action="store", time=.5, anim="store", sounds = {sound="ar_mag_store"}},
{action="load", time=.5, anim="load", sounds = {sound="ar_mag_load", delay = .25}},
{action="charge", time=.5, anim="charge", sounds={sound="ar_charge", delay = .2}}

a table of soundspecs to be referenced by other functions

vector the offset of the gun (relative to the right arm's default position) at hip.

the ratio that the look rotation is expressed through player_axial (rotated around the viewport) rotation as opposed to gun_axial (rotating the entity).

sway speed multiplier while at hip

sway angle multiplier while at hip+

vector the offset of the gun relative to the eye's position at hip.

float the horizontal offset of the eye when aiming

the time it takes to go into full aim

"inventory_overlay_single.png"

"inventory_overlay_auto.png"

"inventory_overlay_burst.png"

"inventory_overlay_safe.png" (unimplemented firemode)

float TL:DR higher decreases recoil at expense of smoothness. 1/value is the deviation of a normalized bell curve, where x is the time since firing. this means that increasing it decreases the time it takes for the angular velocity to fully "decay".

float Correction of recoil offset per second is calculated as such: target_correction_factor[axis]*time_since_fire*recoil[axis]

float The maximum rate per second of recoil offset as determined with gun.properties.recoil.target_correction_factor

float caps the recoil velocity that can stack up from shots.

vector {x=float, y=float}, defines the initial angular velocity produced by firing the gun

vector {x=float, y=float}, ranges -1 to 1. Defines the probability of the recoil being positive or negative for any given axis.

float angular velocity multiplier when firing from the hip

float maximum angle of the sway

float angular velocity the sway

float maximum angle multiplier while the gun is at the hip

float velocity multiplier while the gun is at the hip

float=1.6 the cycle speed multiplier

float=1 decay factor when walking has stopped and offset remains.

table containing angular deviation while walking in the same format as an offset vector. Acts as a multiplier on the figure-8 generated while walking.

bool defines wether the draw animation is played on swap (when loaded). Used in the instance construction method

string "none" bolt will never need to be charged after reload, "catch" when fired to empty bolt will not need to be charged after reload, "no_catch" bolt will always need to be charged after reload.

float the time it takes to swap to the gun

string name of the animation to play from visuals.animations

string name of the sound to play from sounds

table a list of accepted bullet itemstrings

table a list of accepted magazine itemstrings

string the mag the gun starts with. Set to "empty" for no mag, otherwise it defaults to accepted_magazines[1] (if present)

toggles backface culling

a table of animations in the format {x=int, y=float}. Indexes define the name of the animation to be refrenced by other functions of the gun.

frequency of keyframe samples for animation offsets and

default max hear distance when not specified

fps=60 animation fps i.e. during firing when no length is specified

bool

bool

bool

bool

bool wether the gun rotates on it's own axis instead of the player's view (i.e. ironsight misalignments)

wether animations create an offset

whether the idle animation changes or not

general gain multiplier for third persons when hearing sounds

the root bone of the gun (for animation offsets)

string="magazine",the bone of the magazine in the gun (for dropping mags)

string="right_aimpoint", the bone which the right arm aims at to

string="left_aimpoint", the bone which the left arm aims at to