ammo

This datum is the base for absolutely every ammo type in the game.

Vars
accuracy	This is added to the bullet's base accuracy
accuracy_var_low	How much the accuracy varies when fired
accurate_range	For most guns, this is where the bullet dramatically looses accuracy. Not for snipers though
accurate_range_min	Snipers use this to simulate poor accuracy at close ranges
airburst_multiplier	how much damage airbursts do to mobs around the target, multiplier of the bullet's damage
ammo_behavior_flags	What kind of behavior the ammo has
armor_type	Does this have an override for the armor type the ammo should test? Bullet by default
barricade_clear_distance	How far the bullet can travel before incurring a chance of hitting barricades; normally 1.
bonus_projectiles_amount	How many extra projectiles it shoots out. Works kind of like firing on burst, but all of the projectiles travel together
bonus_projectiles_scatter	Degrees scattered per two projectiles, each in a different direction.
bonus_projectiles_type	Type path of the extra projectiles
bullet_color	Determines what color our bullet will be when it flies
damage	This is the base damage of the bullet as it is fired
damage_falloff	How much damage the bullet loses per turf traveled
damage_type	BRUTE, BURN, TOX, OXY, CLONE are the only things that should be in here
deflagrate_multiplier	Multiplier for deflagrate chance
fire_burst_damage	Flat damage caused if fire_burst is triggered by deflagrate
handful_amount	how much of this ammo you can carry in a handful
handful_greyscale_colors	greyscale color for the bullet items associated with the ammo
handful_greyscale_config	greyscale config for the bullet items associated with the ammo
handful_icon_state	used in icons/obj/items/ammo for use in generating handful sprites
hitscan_effect_icon	If this ammo is hitscan, the icon of beam coming out from the gun
hud_state	Bullet type on the Ammo HUD
incendiary_strength	Base fire stacks added on hit if the projectile has AMMO_INCENDIARY
max_range	This will de-increment a counter on the bullet
on_pierce_multiplier	A multiplier applied to piercing projectile, that reduces its damage/penetration/sundering on hit
penetration	How much armor it ignores before calculations take place
ping	The icon that is displayed when the bullet bounces off something.
point_blank_range	Weapons will get a large accuracy buff at this short range
projectile_greyscale_colors	greyscale color for the projectile associated with the ammo
projectile_greyscale_config	greyscale config for the projectile associated with the ammo
scatter	How much the ammo scatters when burst fired, added to gun scatter, along with other mods
shell_speed	How fast the projectile moves
shrapnel_chance	The % chance it will imbed in a human
sound_armor	When it's blocked by human armor.
sound_bounce	When it bounces off something.
sound_hit	When it deals damage.
sound_miss	When it misses someone.
sundering	How many stacks of sundering to apply to a mob on hit
Procs
ammo_process	called on projectile process() when AMMO_SPECIAL_PROCESS flag is active
deflagrate	handles the probability of a projectile hit to trigger fire_burst, based off actual damage done
fire_bonus_projectiles	Fires additional projectiles, generally considered to still be originating from a gun Such a buckshot origin_override used to have the new projectile(s) originate from a different source than the main projectile
fire_burst	the actual fireblast triggered by deflagrate
fire_directionalburst	A variant of Fire_bonus_projectiles without fixed scatter and no link between gun and bonus_projectile accuracy
on_hit_mob	Special effects when hitting mobs.
on_hit_obj	Special effects when hitting objects.
on_hit_turf	Special effects when hitting dense turfs.
on_leave_turf	Special effects for leaving a turf. Only called if the projectile has AMMO_LEAVE_TURF enabled
on_shield_block	Does it do something special when shield blocked? Ie. a flare or grenade that still blows up.
reflect	bounces the projectile by creating a new projectile and calculating an angle of reflection
staggerstun	Handles CC application on the victim

Var Details

var
accuracy
–

This is added to the bullet's base accuracy

var
accuracy_var_low
–

How much the accuracy varies when fired

var
accurate_range
–

For most guns, this is where the bullet dramatically looses accuracy. Not for snipers though

var
accurate_range_min
–

Snipers use this to simulate poor accuracy at close ranges

var
airburst_multiplier
–

how much damage airbursts do to mobs around the target, multiplier of the bullet's damage

var
ammo_behavior_flags
–

What kind of behavior the ammo has

var
armor_type
–

Does this have an override for the armor type the ammo should test? Bullet by default

var
barricade_clear_distance
–

How far the bullet can travel before incurring a chance of hitting barricades; normally 1.

var
bonus_projectiles_amount
–

How many extra projectiles it shoots out. Works kind of like firing on burst, but all of the projectiles travel together

var
bonus_projectiles_scatter
–

Degrees scattered per two projectiles, each in a different direction.

var
bonus_projectiles_type
–

Type path of the extra projectiles

var
bullet_color
–

Determines what color our bullet will be when it flies

var
damage
–

This is the base damage of the bullet as it is fired

var
damage_falloff
–

How much damage the bullet loses per turf traveled

var
damage_type
–

BRUTE, BURN, TOX, OXY, CLONE are the only things that should be in here

var
deflagrate_multiplier
–

Multiplier for deflagrate chance

var
fire_burst_damage
–

Flat damage caused if fire_burst is triggered by deflagrate

var
handful_amount
–

how much of this ammo you can carry in a handful

var
handful_greyscale_colors
–

greyscale color for the bullet items associated with the ammo

var
handful_greyscale_config
–

greyscale config for the bullet items associated with the ammo

var
handful_icon_state
–

used in icons/obj/items/ammo for use in generating handful sprites

var
hitscan_effect_icon
–

If this ammo is hitscan, the icon of beam coming out from the gun

var
hud_state
–

Bullet type on the Ammo HUD

var
incendiary_strength
–

Base fire stacks added on hit if the projectile has AMMO_INCENDIARY

var
max_range
–

This will de-increment a counter on the bullet

var
on_pierce_multiplier
–

A multiplier applied to piercing projectile, that reduces its damage/penetration/sundering on hit

var
penetration
–

How much armor it ignores before calculations take place

var
ping
–

The icon that is displayed when the bullet bounces off something.

var
point_blank_range
–

Weapons will get a large accuracy buff at this short range

var
projectile_greyscale_colors
–

greyscale color for the projectile associated with the ammo

var
projectile_greyscale_config
–

greyscale config for the projectile associated with the ammo

var
scatter
–

How much the ammo scatters when burst fired, added to gun scatter, along with other mods

var
shell_speed
–

How fast the projectile moves

var
shrapnel_chance
–

The % chance it will imbed in a human

var
sound_armor
–

When it's blocked by human armor.

var
sound_bounce
–

When it bounces off something.

var
sound_hit
–

When it deals damage.

var
sound_miss
–

When it misses someone.

var
sundering
–

How many stacks of sundering to apply to a mob on hit

Proc Details

proc
ammo_process
(/obj/projectile/proj, damage)

called on projectile process() when AMMO_SPECIAL_PROCESS flag is active

proc
deflagrate
(/atom/target, /obj/projectile/proj)

handles the probability of a projectile hit to trigger fire_burst, based off actual damage done

proc
fire_bonus_projectiles
(/obj/projectile/main_proj, /mob/living/shooter, /atom/source, range, speed, angle, target, origin_override)

Fires additional projectiles, generally considered to still be originating from a gun Such a buckshot origin_override used to have the new projectile(s) originate from a different source than the main projectile

proc
fire_burst
(/atom/target, /obj/projectile/proj)

the actual fireblast triggered by deflagrate

proc
fire_directionalburst
(/obj/projectile/main_proj, /mob/living/shooter, /atom/source, projectile_amount, angle, target, loc_override)

A variant of Fire_bonus_projectiles without fixed scatter and no link between gun and bonus_projectile accuracy

proc
on_hit_mob
(/mob/target_mob, /obj/projectile/proj)

Special effects when hitting mobs.

proc
on_hit_obj
(/obj/target_obj, /obj/projectile/proj)

Special effects when hitting objects.

proc
on_hit_turf
(/turf/target_turf, /obj/projectile/proj)

Special effects when hitting dense turfs.

proc
on_leave_turf
(/turf/target_turf, /obj/projectile/proj)

Special effects for leaving a turf. Only called if the projectile has AMMO_LEAVE_TURF enabled

proc
on_shield_block
(/mob/target_mob, /obj/projectile/proj)

Does it do something special when shield blocked? Ie. a flare or grenade that still blows up.

proc
reflect
(/turf/T, /obj/projectile/proj, scatter_variance)

bounces the projectile by creating a new projectile and calculating an angle of reflection

proc
staggerstun
(/mob/victim, /obj/projectile/proj, max_range, stun, paralyze, stagger, slowdown, knockback, soft_size_threshold, hard_size_threshold)

Handles CC application on the victim

The base ammo datum /datum/ammo

Vars

Procs

Var Details

var accuracy –

var accuracy_var_low –

var accurate_range –

var accurate_range_min –

var airburst_multiplier –

var ammo_behavior_flags –

var armor_type –

var barricade_clear_distance –

var bonus_projectiles_amount –

var bonus_projectiles_scatter –

var bonus_projectiles_type –

var bullet_color –

var damage –

var damage_falloff –

var damage_type –

var deflagrate_multiplier –

var fire_burst_damage –

var handful_amount –

var handful_greyscale_colors –

var handful_greyscale_config –

var handful_icon_state –

var hitscan_effect_icon –

var hud_state –

var incendiary_strength –

var max_range –

var on_pierce_multiplier –

var penetration –

var ping –

var point_blank_range –

var projectile_greyscale_colors –

var projectile_greyscale_config –

var scatter –

var shell_speed –

var shrapnel_chance –

var sound_armor –

var sound_bounce –

var sound_hit –

var sound_miss –

var sundering –