Editing Weapons

<!--Top Nav Box-->
{| align=center
| {{Gear_Nav}}
|}
----
<!-- End of Nav -->
{{TOCright}}

{{for|ways for both countering and using each kind of weapon|Weapon Guide}}

'''Weapons''' are used by [[colonists]] and [[raiders]] alike to fight each other (and sometimes to put down enraged [[animals]]). Weapons have several characteristics that make them useful in different combat situations. They currently do not consume any ammunition, but instead take time to aim and additional cooldown time for subsequent shots.

If left exposed with no roof, a weapon on the ground will [[Deterioration|deteriorate]] until it disintegrates without a trace. Weapons stored in a [[shelf]] will not deteriorate, even if left outside.

Weapons of quality Excellent or higher have an engraving that can be read by clicking the Art tab from the inspect pane.

==Ranged weapons==
Range weapons consist mostly of firearms, as well as other non-gunpowder weapons like [[Neolithic Weapons|bows and throwing spears]], and also the advanced charge rifle and incendiary launcher. A ranged weapon's accuracy and damage are also affected by its [[quality]] level.

The ranges are measured in tiles and correspond to:
* Touch = 3
* Short = 12
* Medium = 25
* Long = 40.

Between those ranges, accuracy stats are interpolated. A weapon will never fire past its range stat, even if it has an accuracy value listed for longer ranges. For example, a pump shotgun, with a maximum range 15.9 and acc. stats 80-87-77-64, will never fire out at a range of 25 tiles, yet the medium range accuracy stat does still bear relevance to its accuracy at 13-15 cells; you can think of its accuracy stats as 80-87-(77)-(n/a) instead.

DPS (Optimal) refers to the theoretical DPS if every single shot were to hit the target. DPS for the various ranges takes into account the weapon's accuracy at the start of the defined range.

Some ranged weapons fire in bursts with each shot having individual hit chances. Cooldown starts once all shots in a burst are fired.

Ranged weapons also can't fire in melee range unless the target is downed or not immediately hostile to the player's faction.

Stats listed in the table below are for weapons that are of normal quality; better/worse quality will raise/lower the % to hit as appropriate.
{| {{STDT|sortable c_06 text-center}}
! colspan='2'|Name !! Damage !! AP !! Stopping Power !! Warm-Up<br/>(ticks){{ref label|Time|A}} !! Cooldown<br/>(ticks){{ref label|Time|A}} !! Range<br/>(tiles) !! Burst Count !! Burst (ticks){{ref label|Time|A}} !! Bullet Speed !! Accuracy<br/>(Touch) !! Accuracy<br/>(Short) !! Accuracy<br/>(Medium) !! Accuracy<br/>(Long) !! Miss Radius !! Blast Radius !! DPS<br/>(Optimal){{ref label|DPS Targets|B}} !! data-sort-type="number"|DPS<br/>(Touch){{ref label|DPS Targets|B}} !! data-sort-type="number"|DPS<br/>(Short){{ref label|DPS Targets|B}} !! data-sort-type="number"|DPS<br/>(Medium){{ref label|DPS Targets|B}} !! data-sort-type="number"|DPS<br/>(Long){{ref label|DPS Targets|B}} !! Value {{icon|silver|}}
|-
{{#ask:[[Concept:Ranged Weapons]] [[Class::!Mechanoid Weapons]] [[Name::!Uranium slug cannon]] [[Name::!Autocannon]] [[Name::!Mini-turret gun]]
 | named args=yes
 | ?Name=?Name
 | format=template
 | template=Weapon/Row/Ranged}}
|}
:{{note|Time|A}} At normal game speed, there are 60 ticks to one real world second. See: [[Time]].
:{{note|DPS Targets|B}} This DPS assumes a single target - weapons with a blast radius may have higher effective DPS by virtue of hitting multiple targets.

=== Quality modifiers ===

{| {{STDT|sortable c_06 text-center}}
! Quality !! Accuracy Modifier !! Base Damage Modifier !! Armor Penetration Modifier
|-
!Awful
|0.80
|0.90
|0.90
|-
!Poor
|0.90
|1.00
|1.00
|-
!Normal
|1.00
|1.00
|1.00
|-
!Good
|1.10
|1.00
|1.00
|-
!Excellent
|1.20
|1.00
|1.00
|-
!Masterwork
|1.35
|1.25
|1.25
|-
!Legendary
|1.50
|1.50
|1.50
|-
|}

=== Accuracy ===
{{Stub|section=1|reason=Needs to be double checked and what happens at ranges beyond 40 tiles for weapon accuracy?, Smoke effect needs to be added to this page and [[Smoke]], and darkness combat precept effect needs info}}
Ranged weapon accuracy follows the following equation:
{| class="wikitable"
|-
| Accuracy = [[Shooting Accuracy]]^Range * Weapon Accuracy * [[Weather]] * [[Smoke]] * [[Cover]]
|}
Where:
* [[Shooting Accuracy]]: Is the stat of the shooting pawn
* Range: Is the distance in tiles between the shooter and the target
* Weapon Accuracy: Is the weapon accuracy of the weapon at that range, if it is not one of the listed values at 3, 12, 25, or 40 tiles, it is linearly interpolated between the two points on either side.
* [[Weather]]: Is the accuracy modifier for a given weather ranging from 50% for Fog, to 100% on a clear day.
* [[Smoke]]: If smoke occupies any tile directly between the shooter and target, it reduces the accuracy by ?? (see smoke for details over whether offset or multiplier)
* [[Cover]]: ??  
* Darkness Combat Prefered Precept{{IdeologyIcon}}: Up to +25%/-20 ranged accuracy & +10%/-10% melee accuracy in darkness/brightly lit environments, respectively.{{Check Tag|In what OoO?|Where is that in the order of operations?}}

Related to accuracy, there are also friendly fire mechanics that prevent misses from hitting nearby allies within a certain radius. See [[friendly fire]] for details.

== Unobtainable weapons ==
These weapons are equipped by either mechanoids or by turrets and cannot be obtained independent from their regular users without the use of [[dev mode]].
They include: the [[autocannon]], the [[heavy_charge_blaster|heavy charge blaster]], the [[inferno_cannon|inferno cannon]], the [[Inferno_cannon_(Turret)|turret form of the inferno cannon]], the [[light_charge_blaster|light charge blaster]], the [[mini-slugger]], the [[mini-turret_gun|mini-turret gun]], the [[needle_gun|needle gun]], and the [[uranium_slug_cannon|uranium slug cannon]]. When a normal pawn equips a debug-spawned weapon and then drops it, the weapon will disappear.

== Melee weapons ==
{{Rewrite|reason=Cleanup, automated tables needed, inclusion of implant weapons and bionics for comparison in table}}
{{Recode|reason=Cleanup, automated tables needed, inclusion of implant weapons and bionics for comparison in table}}
These are touch-range weapons. Besides dedicated melee weapons, all ranged weapons can also be used as makeshift melee weapons.

The exact damage of a melee weapon is based on its [[quality]] level, with a low quality weapon dealing less damage and a high quality weapon dealing more.

Note that melee accuracy is determined by a [[colonist]]'s [[Skills#Melee|melee skill]] and further modified by health stats of manipulation and sight, as well as the opponent's dodge chance.

Weapons of quality Excellent or higher have an engraving that can be read by clicking the Art tab from the inspect pane.

===Base melee stats===
The following stats are for weapons that are of normal quality and made out of [[steel]] (the baseline material).  Other materials may do more or less average damage per second (DPS), as will better/worse [[quality|qualities]].

{| {{STDT|sortable c_06 text-center}}
! colspan='2'|Name !! Average cooldown !! data-sort-type="number"| Weakest attack damage !! data-sort-type="number"| Strongest attack damage !! data-sort-type="number"| Average DPS !! Damage type {{ref label|Blunt|A|A}} !! Average AP !! data-sort-type="number"| Value {{icon|silver|}}
|-
! style='text-align: left !important;'|
! style='text-align: left !important;'| Unarmed human
| 2 s || 5 || 8.2 || 2.29 || Blunt || - || -
|-
! style='text-align: left !important;'| {{Icon Small|Axe|}}
! style='text-align: left !important;'| [[Axe]] {{ref label|Royalty|E|E}}
| 2 s || 9 || 15 || 6.71 || Sharp || 20% || -
|-
! style='text-align: left !important;'| {{Icon Small|Breach axe|}}
! style='text-align: left !important;'| [[Breach axe]]
| 1.67s || 7.5 || 9 || 6.22 || Sharp || 12.33% || -
|-
! style='text-align: left !important;'| {{Icon Small|Beer|}}
! style='text-align: left !important;'| [[Beer]] {{ref label|Material|B|B}}
| 2 s || 9 || 9 || 4.50 || Blunt || 13% || -
|-
! style='text-align: left !important;'| {{Icon Small|Bionic arm|}}
! style='text-align: left !important;'| [[Bionic arm]] {{ref label|Material|B|B}}
| 2 s || 12 || 12 || 6.00 || Blunt || 18% || 1500
|-
! style='text-align: left !important;'| {{Icon Small|club|}}
! style='text-align: left !important;'| [[Club]]
| 2 s || 9 || 14 || 6.27 || Blunt || 19% || -
|-
! style='text-align: left !important;'| {{Icon Small|Elephant tusk|}}
! style='text-align: left !important;'| [[Elephant tusk]] {{ref label|Material|B|B}}
| 2.48 s || 9 || 18.2 || 6.89 || Sharp || 27% || 80
|-
! style='text-align: left !important;'| {{Icon Small|Gladius|}}
! style='text-align: left !important;'| [[Gladius]]
| 2 s || 9 || 15 || 7.52 || Sharp || 23% || -
|-
! style='text-align: left !important;'| {{Icon Small|Ikwa|}}
! style='text-align: left !important;'| [[Ikwa]]
| 1.91 s || 9 || 15 || 6.71 || | Sharp || 20% || -
|-
! style='text-align: left !important;'| {{Icon Small|Jade knife|}}
! style='text-align: left !important;'| [[Jade knife]] {{ref label|Jade|C|C}}
| 2.76 s || 12 || 13.5 || 5.35 || Sharp || 20% || 159
|-
! style='text-align: left !important;'| {{Icon Small|Knife|}}
! style='text-align: left !important;'| [[Knife]]
| 1.82 s || 9 || 13 || 4.50 || Sharp || 18% || -
|-
! style='text-align: left !important;'| {{Icon Small|Longsword|}}
! style='text-align: left !important;'| [[Longsword]]
| 2.5 s || 9 || 23 || 8.60 || Sharp || 33% || -
|-
! style='text-align: left !important;'| {{Icon Small|Mace|}}
! style='text-align: left !important;'| [[Mace]]
| 2 s || 9 || 15.7 || 7.02 || Blunt || 21% || -
|-
! style='text-align: left !important;'| {{Icon Small|Monosword|}}
! style='text-align: left !important;'| [[Monosword]]{{ref label|Material|D|D}} {{ref label|Royalty|E|E}}
| 2 s || 12 || 28 || 13.33 || Sharp || 84% || 2000
|-
! style='text-align: left !important;'| {{Icon Small|Monosword|}}
! style='text-align: left !important;'| [[Persona_monosword|Persona Monosword]] {{ref label|Material|D|D}} {{ref label|Royalty|E|E}}
| 1 s || 12 || 32 || 30.69 || Sharp || 85% || 1300-2900
|-
! style='text-align: left !important;'| {{Icon Small|Plasmasword|}}
! style='text-align: left !important;'| [[Plasmasword]]{{ref label|Material|D|D}}{{ref label|Royalty|E|E}}{{ref label|Plasma|F|F}}
| 2.6 s || 12 || 21 || 7.85 || Sharp + Burn || 28% || 2000
|-
! style='text-align: left !important;'| {{Icon Small|Plasmasword|}}
! style='text-align: left !important;'| [[Persona_plasmasword|Persona Plasmasword]] {{ref label|Material|D|D}}{{ref label|Royalty|E|E}}{{ref label|Plasma|F|F}}
| 1.3 s || 12 || 23 || 11.11 || Sharp + Burn || 33% || 1500-2100
|-
! style='text-align: left !important;'| {{Icon Small|Eltex staff|}}
! style='text-align: left !important;'| [[Eltex staff]] {{ref label|Material|D|D}}{{ref label|Royalty|E|E}}
| 2.6 s || 12 || 12 || 4.62 || Blunt || ?% || 1000
|-
! style='text-align: left !important;'| {{Icon Small|Spear|}}
! style='text-align: left !important;'| [[Spear]]
| 2.5 s || 13 || 23 || 7.35 || Sharp || 38% || 
|-
! style='text-align: left !important;'| {{Icon Small|Thrumbo horn|}}
! style='text-align: left !important;'| [[Thrumbo horn]] {{ref label|Material|B|B}}
| 1.85 s || 15 || 15 || 8.11 || Sharp || 41% || 800
|-
! style='text-align: left !important;'| {{Icon Small|Warhammer|}}
! style='text-align: left !important;'| [[Warhammer]] {{ref label|Royalty|E|E}}
| 2.6 s || 11 || 20|| 6.89 || Blunt || 27% || 
|-
! style='text-align: left !important;'| {{Icon Small|Zeushammer|}}
! style='text-align: left !important;'| [[Zeushammer]] {{ref label|Material|D|D}}{{ref label|Royalty|E|E}}
| 2.75 s || 15 || 31 + 9 EMP Damage|| 9.95 || Blunt + EMP || 42%  || 2000
|-
! style='text-align: left !important;'| {{Icon Small|Zeushammer|}}
! style='text-align: left !important;'| [[Persona_zeushammer|Persona Zeushammer]]{{ref label|Material|D|D}}{{ref label|Royalty|E|E}}
| 2.05 s || 15 || 31 + 12 EMP Damage|| 13.40 || Blunt + EMP || 42% || 2600-4200
|-
|}

:{{note label|Blunt|A|A}} All sharp melee weapons come also with (weak) blunt attacks.
:{{note label|Material|B|B}} Material cannot be changed for these. They also do not come in varying quality levels. The average DPS is always the final value and no formulas are needed for them.
:{{note label|Jade|C|C}} A jade knife can only be obtained via the Lost tribe scenario; they cannot be crafted nor purchased.
:{{note label|Monoswords|D|D}} These weapons cannot be created by the player, they are able to be obtained through quests and purchasing them from Merchants. Both of these are also able to come in "persona" variants that cannot be wielded by anyone other than the bonded pawn unless it has the "[[Persona weapon#Freewielder|freewielder]]" trait, so make sure you choose a good and unlikely to die pawn to use them.
:{{note label|Royalty|E|E}} These weapons were added by [[Royalty (DLC)]]
:{{note label|Plasma|F|F}} These weapons also have a 75% chance to set a pawn on fire. This damage is included in the DPS.

=== Material / Quality modifiers ===
{| {{STDT|sortable c_06 text-center}}
! Material !! Cooldown speed factor !! Damage factor (Blunt) !! DPS factor (Blunt) !! Damage factor (Sharp) !! DPS factor (Sharp) !! Max HP factor
|-
![[Sandstone Blocks|Sandstone]]
|1.30|| | 1.00 || 0.77 || | 0.50 || 0.38 || 1.4
|-
![[Granite Blocks|Granite]]
|1.30|| | 1.00 || 0.77 || | 0.65 || 0.50 || 1.7
|-
![[Limestone Blocks|Limestone]]
|1.30|| | 1.00 || 0.77 || | 0.60 || 0.46 || 1.55
|-
![[Slate Blocks|Slate]]
|1.30|| | 1.00 || 0.77 || | 0.60 || 0.46 || 1.3
|-
![[Marble Blocks|Marble]]
|1.30|| | 1.00 || 0.77 || | 0.60 || 0.46 || 1.2
|-
![[Silver]]
|1.00 || | 1.00 || 1.00 || | 0.85 || 0.85 || 0.7
|-
![[Gold]]
|1.00|| | 1.00 || 1.00 || | 0.75 || 0.75 || 0.6
|-
![[Steel]]
|1.00 || | 1.00 || 1.00 || | 1.00 || 1.00 || 1.0
|-
![[Plasteel]]
|0.80|| | 0.90 || 1.13 || | 1.10 || 1.38 || 2.8
|-
![[Wood]]
|1.00|| | 0.90 || 0.90 || | 0.45 || 0.45 || 0.65
|-
![[Uranium]]
|1.10|| | 1.50 || 1.36 || | 1.10 || 1.00 || 2.5
|-
![[Jade]]
|1.30|| | 1.50 || 1.15 || | 1.00 || 0.77 || 0.5
|-
|}

{| {{STDT|sortable c_06 text-center}}
! Quality !! Base Damage Modifier
|-
!Awful
|0.80
|-
!Poor
|0.90
|-
!Normal
|1.00
|-
!Good
|1.10
|-
!Excellent
|1.20
|-
!Masterwork
|1.45
|-
!Legendary
|1.65
|-
|}

Do note that stone blocks can only be used with clubs.

=== Melee formulas ===
==== General formulas ====
'''Damage''' for any melee weapon is '''Base Damage x Material Modifier x Quality Modifier'''

'''Cooldown''' is calculated as '''Weapon melee cooldown / Material melee cooldown'''

'''DPS''' (damage per second) is calculated as '''Damage / Cooldown'''. Note that you must use Cooldown (seconds) to get DPS, otherwise if you use Cooldown (Ticks) you'll calculate DPT (Damage Per Tick) which you probably don't want.

'''AP''' (armor piercing) defaults to 0.015 x '''Damage''' if no value is specified

'''Chance Factor''' defaults to 1 if no value is specified

==== Listed DPS on weapons ====
The DPS listed on the info tab for weapons is deceiving as it is no longer used when a pawn equips the item (see below). Regardless this is how it is computed based on the melee attack options the weapon has:
# For each attack option compute the '''Selection Weight''' = '''Damage''' x '''Damage'''
# For each attack option compute the '''Selection Chance''' = '''Selection Weight''' / SumOfAll('''Selection Weights''')
# Compute the '''Average Damage''' = SumOfAll('''Damage''' x '''Selection Chance''')
# Compute the '''Average Cooldown''' = SumOfAll('''Cooldown''' x '''Selection Chance''')
# Compute the '''Average DPS''' = '''Average Damage''' / '''Average Cooldown'''

Note that this is mathematically incorrect (see below for more details). Below is an example with a Normal Persona Zeus Hammer:

{| class="wikitable"
|-
! Attack !! Damage !! Cooldown !! Selection Weight !! Selection Chance
|-
| head || 31 || 2.2 || 961 || 81%
|-
| handle || 15 || 1.6 || 225 || 19%
|}

'''Average Damage''' = 31 x 81% + 15 x 19% = 27.965

'''Average Cooldown''' = 2.2 x 81% + 1.6 x 19% = 2.086

'''Average DPS''' = 27.965 / 2.086 = 13.40

You can find more of these values in Dev mode >> Logging Menu >> Tools. There are also values listed for pawns and these are computed the same as above except that in step 1 you also multiply by 0.3 and the '''Chance Factor''' if one is specified. Note that just like the item values these are not actually used in the game anymore (see below).

==== Listed DPS on pawns ====
This is a system used since version [[Version/1.1.2610|1.1.2610]] and it is based on a category system. It is based on the attack options available however now we take both the options from the weapon as well as the options from the pawn (eg. fists) into account:

# For each attack option compute the '''Initial Selection Weight''' = '''Damage''' x (1 + '''AP''') x '''Chance Factor''' / '''Cooldown'''
# For each attack option determine the '''Category''' based on the highest weight value we just computed:
#* ''Best'' if '''Initial Selection Weight''' >= 0.95 x MAX('''Initial Selection Weight''')
#* ''Worst'' if '''Initial Selection Weight''' < 0.25 x MAX('''Initial Selection Weight''')
#* ''Mid'' Otherwise
# For each attack option compute the '''Final Selection Weight''' based on the categories:
#* 0.75 / NumberOfOptionsIn(''Best'') if the option is in the ''Best'' category
#* 0.25 / NumberOfOptionsIn(''Mid'') if the option is in the ''Mid'' category
#* 0.0 if the option is in the ''Worst'' category
# For each attack option compute the '''Selection Chance''' = '''Final Selection Weight''' / SumOfAll('''Final Selection Weights''')
# Compute the '''Average Damage''' = SumOfAll('''Damage''' x '''Selection Chance''')
# Compute the '''Average Cooldown''' = SumOfAll('''Cooldown''' x '''Selection Chance''')
# Compute the '''Average DPS''' = '''Average Damage''' / '''Average Cooldown'''

Below is an example with a pawn carrying a Normal Persona Zeus Hammer (note that AP is not specified and therefore is defined as '''Damage''' x 0.015):

{| class="wikitable"
|-
! Attack !! Damage !! Cooldown !! Armor Piercing !! Chance Factor !! Initial Selection Weight !! Category !! Final Selection Weight !! Selection Chance
|-
| head || 31 || 2.2 ||  ||  || 20.64 || Best || 0.75 || 75.0%
|-
| handle || 15 || 1.6 ||  ||  || 11.48 || Mid || 0.125 || 12.5%
|-
| left fist (archotech arm) || 14 || 2 ||  ||  || 8.47 || Mid || 0.125 || 12.5%
|-
| right fist || 8.2 || 2 ||  ||  || 4.60 || Worst || 0.00 || 0.0%
|-
| teeth || 8.2 || 2 ||  || 0.07 || 0.32 || Worst || 0.00 || 0.0%
|-
| head || 5 || 2 ||  || 0.2 || 0.54 || Worst || 0.00 || 0.0%
|}

'''Average Damage''' = 31 x 75% + 15 x 12.5% + 14 x 12.5% = 26.875

'''Average Cooldown''' = 2.2 x 75% + 1.6 x 12.5% + 2 x 12.5% = 2.100

'''Average DPS''' = 26.875 / 2.100 = 12.80

Note that in this case upgrading the left arm actually decreased the average DPS (from 13.17 to 12.80) by moving an inferior attack option from ''Worst'' to ''Mid''.

There is a peculiarity in the description above as it seems that the AccuracyTouch properties of ranged weapons is not used. This may be a bug as it seems intended that it should have been used.

==Stopping power==
{{stub|section=1|reason=Lacking detail. How does stagger proc, what are its exact effects and durations, etc}}
Stopping power is the ability of ranged weapons to cause stagger when hitting a target, slowing them down for a short<sup>How short?</sup> period. The size of the number relates directly to the body size of the pawn that can be staggered by the weapon - thus, to stagger [[human]]s a stopping power of {{Q|Human|Body Size}} or higher is required while to stagger an [[elephant]] a stopping power of {{Q|Elephant|Body Size}} would be needed.

Most weapons have stopping power of 0.5, insufficient to stagger a human pawn, however the following weapons have higher stopping powers: {{#ask: [[Stopping Power::>0.500001]]}}

== Biocoding ==
Weapons can be biocoded. These weapons are found on raiders, guests and other pawns and are only usable by the specific pawn that the weapon is biocoded to. They can be [[Electric smelter|smelted]] and have a specific option in the bill menu to allow their sorting.

== Version history ==
* [[Version/0.0.245|0.0.245]] - Shooting accuracy split into into misses due to equipment and misses due to skill.
* [[Version/0.0.250|0.0.250]] - Melee attacks incap more than guns and explosives. '''N.b. That this change may or may not be represented in the current version. It was only added in this previous version.'''
* [[Version/0.8.657|0.8.657]] - Melee weapons have a [[quality]]. Can now craft any kind of melee weapon from appropriate materials.
* [[Version/0.9.722|0.9.722]] - High-quality weapons have art engraved into them. All weapons now have quality levels, including guns and bows. Quality affects accuracy.
* [[Version/1.1.0|1.1.0]] - Biocoding added

{{nav|weapon|wide}}
[[Category:Weapons| ]]
[[Category:Equipment]]