MT Machine-translated from Japanese (game and mod terms use the official translations). Term sources ↓

Home › Researched mods

Vanilla Weapons Expanded - Non-Lethal

Weapons

Layer 1 At a glance

What the mod is, how to use it, video

Vanilla Weapons Expanded - Non-Lethal
Vanilla Weapons Expanded - Non-Lethal — Oskar Potocki (Vanilla Expanded Team)

6-Weapon Set for "Capturing Without Killing"

560.5KSubs
★4.8Workshop rating
16features
13mod images
Taser gun(テーザーガン)テーザーの「条件付きスタン」Dart gun(ダートガン/麻酔銃)Tear gas launcher(催涙ガスランチャー)
Basics
Type
(Weapon Addition) + a bit of C#
Game versions
1.5 / 1.6 / 1.7 (in loadFolders.xml, 1.7 also reads the 1.6 folder)
Dependencies
Harmony (brrainz.harmony), Vanilla Expanded Framework
Author
Oskar Potocki (Vanilla Expanded team)
License
Not stated (no LICENSE file)
Workshop
2454918354 ・ 560,520 Subs ・ ★★★★★
Repository
Vanilla-Expanded/VanillaWeaponsExpanded-NonLethal

▼ Deeper from here

Layer 2 What is inside

Main features, category cards, tier list

All 6 weapons: stats and crafting

Read from the mod's Defs by machine. Bars compare with the closest vanilla weapons machine-computed

Taser gun

Damage / shot
1 VWE_ConditionalStun
Range
6.9
Per burst
1
Mass
1.2 kg
Cost
Steel 45・Component 2

Non-lethal pistol

Damage / shot
6 Blunt
Range
25.9
Per burst
6
Mass
1.2 kg
Cost
Steel 30・Component 1

Dart gun

Damage / shot
3 VWE_AnestheticDart
Range
36.9
Per burst
3
Mass
2.6 kg
Cost
Steel 60・Component 5・Neutroamine 20

Tear gas launcher

Damage / shot
—
Range
19.9
Per burst
—
Mass
3 kg
Cost
Steel 65・Component 3・Neutroamine 50

miss radius 2.9

Tear gas grenades

Damage / shot
—
Range
15.9
Per burst
—
Mass
1 kg
Cost
Neutroamine 40・Steel 10

miss radius 1.9

Stun baton

Attacks
handle 4・head 8
Mass
0.85 kg
Cost
Steel 40・Component 1
Damage per burst
Recurve bow vanilla14
Inferno cannon vanilla10
Non-lethal pistol6
Dart gun3
Taser gun1
Damage per second (calc)
Non-lethal pistol4.6
Recurve bow vanilla4.5
Inferno cannon vanilla1
Dart gun0.4
Taser gun0.1
Range (cells)
Dart gun36.9
Inferno cannon vanilla26.9
Non-lethal pistol25.9
Recurve bow vanilla25.9
Tear gas launcher19.9
Tear gas grenades15.9
Taser gun6.9

Full stats

WeaponDmgTypeAPBlast rBurstBurst gap (s)Min rangeRange
Taser gun1VWE_ConditionalStun45%— 1——6.9
Non-lethal pistol6Blunt9%†— 1——25.9
Dart gun3VWE_AnestheticDart5%†— 1——36.9
Tear gas launcher—VWENL_TearGas—3.9 1——19.9
Tear gas grenades—VWENL_TearGas—3.9 1——15.9
WeaponAcc touchShortMediumLongWarmup (s)Cooldown (s)Per burstPer second (calc)Closest vanilla
Taser gun100%89%78%60% 1.26.610.1Inferno cannon ×0.12
Non-lethal pistol80%70%40%30% 0.3164.6Recurve bow ×1.02
Dart gun55%74%82%80% 3.54.330.4Inferno cannon ×0.37
Tear gas launcher———— 3.54.5———
Tear gas grenades———— 2.85.66———
WeaponMass (kg)Move speedHPDeterioration
Taser gun1.2—1002
Non-lethal pistol1.2—1002
Dart gun2.6—1002
Tear gas launcher3—1002
Tear gas grenades1—1002
WeaponAttacks (power, cooldown s, type)Mass (kg)HPDeteriorationCost
Stun batonhandle 4 / 1.5s blunt/poke
head 8 / 1.5s blunt
0.851002Steel 40・Component 1

Values are read from the mod's Defs by machine, with ParentName inheritance resolved (normal quality, default mod settings)。
† not set: the game's rule, damage × 1.5%。
"Per second" = per-burst damage ÷ (warmup + burst time + cooldown); ignores accuracy, armor, shooter skill, and extra targets hit by blasts or flames (one target)。
"Closest vanilla" = the vanilla gun nearest in range and per-second damage; × = per-second ratio

Crafting (research, bench, ingredients, skill)

WeaponResearchWorkbenchIngredientsSkillWork
Taser gunVWE_NonLethalMachining tableSteel 45・Component 2Crafting 104,600
Non-lethal pistolVWE_NonLethalMachining tableSteel 30・Component 1Crafting 44,400
Dart gunVWE_NonLethalMachining tableSteel 60・Component 5・Neutroamine 20Crafting 636,000
Tear gas launcherVWE_NonLethalMachining table・Machining tableSteel 65・Component 3・Neutroamine 50Crafting 410,000
Tear gas grenadesVWE_NonLethalMachining tableNeutroamine 40・Steel 10Crafting 64,600
Stun batonVWE_NonLethalMachining tableSteel 40・Component 1Crafting 36,600

Features with pictures (7)

Equipment Weapon Ranged Taser GunProjectile Shot Taser Gun Taser Gun A

1Taser gun

A short-range pistol with a range of 6.9.

Equipment Weapon Melee Stun Baton

2 Taser's "Conditional Stun"

The actual damage is only 1.

Equipment Weapon Ranged Dart GunProjectile Dart Small

3 Dart gun (dart gun / tranquilizer gun)

Long-range tranquilizer gun with a range of 36.9.

Equipment Weapon Ranged Dart GunProjectile Dart Small

4Dart wound

A small puncture wound.

Equipment Weapon Ranged Tear Gas GrenadesEquipment Weapon Ranged Tear Gas LauncherProjectile Tear Gas Thrown

5Tear gas launcher

Range 19.9, can also target the ground.

Equipment Weapon Ranged Tear Gas GrenadesEquipment Weapon Ranged Tear Gas LauncherProjectile Tear Gas Thrown

6Tear gas grenades

A tool for throwing.

Equipment Weapon Melee Stun Baton

7Stun baton

Melee weapon.

Show the other 9 features
8Research on 'non-lethal weapons'
Prerequisite: Gunsmithing. Research cost: 1400. Era: Industrial. Displayed in the "Vanilla Expanded" research tab.
9Non-lethal pistol
Rubber bullet (Blunt, 6 damage). Range 25.9, relatively fast rate of fire. As the description states, it can cause death by contusion.
10Anesthetic (status abnormality)
A dart hit gives "anesthetic". At severity 0.98 or more it is "sedative kicking in"; at 0.6–0.98 it is "sedated", with consciousness 0.01 = unconscious; at 0.3–0.6 it is "woozy" (vomiting, wandering in confusion, forgetting memory thoughts); below that it is "wearing off". It drops by 1.5 per day, so from severity 1 it reaches 0 and wears off in about 0.67 days (about 40,000 ticks), before the 45000–120000 tick time limit.
11tear gas cloud
20-30 seconds remaining. Every 2 seconds, apply "tear gas" to the pawn breathing in the clouds. The higher the poison resistance, the less effective it is.
12Tear gas Status Effect
「blinded (blindness)」: Vision -100%, Operation & Movement -60%, Pain x2. 「teary (tearful)」: Vision -80%. 「wearing off (fading)」: Vision -30%. Decreases by 30 per day (recovers within a few hours).
13Enemy NPCs also equip
Weapon tag "NonLethal". Tazers and launchers have spawn rates set (Speculation: Used by factions with corresponding equipment tags)
14 Weapon classification of Ideology
Only when Ideology is present, assign the classification of RangedHeavy/RangedLight/ShortShots/LongShots/Melee (related to the doctrine's 'preferred weapons' and 'disliked weapons').
15Mod Settings (Switching to Ineffective Opponents)
Refer to the configuration table below.
16For other mod authors: UnaffectedByNonLethalDef
Creatures whose defNames are listed in XML become immune to stun, anesthetic and tear gas only when the setting "affect specific creatures" (ON by default = it works) is turned OFF. The default list covers the Behemoth, Gallatross, Summit Crab and Fungal Husk from Alpha Animals, plus the Archotech Centipede.

In-game photos

Dart gun
Dart gun
Taser gun
Taser gun
Tear gas launcher
Tear gas launcher
Stun baton
Stun baton
Tear gas grenades
Tear gas grenades

▼ Deeper from here

Layer 3 Numbers and caveats

Full stat tables, gaps to vanilla, husbandry, compatibility and caveats

Features not described in the introduction / Hard to understand

Open
  • Darts do not hit unconscious targets: When the sedation level exceeds 0.6 (= during sedation), dart damage becomes 0. This prevents killing them by over-firing.
  • Anesthetic, stun and tear gas do not work on mechanoids: the effects of anesthetic, stun and tear gas are not applied to mechanical targets. But the taser's 1 damage, the stun baton's blow, and rubber bullet damage still land (DamageWorker_ConditionalStun.cs only blocks the added stun).
  • Gas masks can protect against tear gas: Wearing a vanilla gas mask completely protects against gas clouds and rupture damage. It does not work on pawns who cannot breathe. Although there are voices on Steam saying "it cannot be protected by a gas mask," it can be protected in the source.
  • Effect reduced by Poison Resistance: The effectiveness of tear gas is (1 − Poison Resistance) times.
  • Tasers are weak against armor: If 1 damage is blocked by armor, it will not stun (pierce 0.45).
  • In the "woozy" state of anesthesia, one vomits, becomes confused and wanders, and forgets thoughts and memories. This persists for a while even after being caught.
  • It also works on bosses in VFE Insectoids 2 (such as Queen, Empress, Titantick, etc.) and entities in Anomaly. It can be disabled in the settings.
  • Stambaton has a relicChance=1 (it can be a candidate for an Ideology relic).

Compatibility with other mods

Details
  • Use the Vanilla Expanded Framework's LaserGun/LaserBeamDef (taser beam) and ThingDefExtension (used in conjunction with shields).
  • It directly specifies creatures by defName, such as those in VFE Insectoids 2 and Alpha Animals (it is not a problem if those mods are not installed).
  • Apply the weapon classification patch only when Ideology is present.
  • It is said to be compatible with Combat Extended (according to a website introduction. Since this repository does not have a patch for CE, it is presumed that CE side supports it, speculation).

Notes and known limitations

  • When "Insect Boss" or "Specific Creatures" are set to OFF in the settings, if Dart or Tear Gas hits something other than Pawns (such as walls), it may cause an error by reading pawn.def as null (likely due to insufficient null checks in DamageWorker_AddInjury_NoMechs and DamageWorker_TearGas). This does not occur with the default ON settings.
  • The tear gas explosion has a process that directly reduces HP, with a damage amount of 0 but a "Kill" branch. There are reports on Steam of players dying from tear gas (the cause cannot be identified solely from the source).
  • Weapon, status effect, and gas mods. It is fine to install them midway. If you uninstall them, the corresponding weapons or gases will disappear from the save (estimated).

Mod settings items

The category name for the settings screen is "VWE - Non-lethal". 3 options (table in layer 4).

Settings table ↓

Key operations, buttons, menus

Open (Key operation, button, menu)

There are no new buttons or keys. Only the standard attack command for weapons. Launchers and grenades can be aimed at the ground.

▼ Deeper from here

Layer 4 For the deep divers: how it works in the source

Mechanisms read from source, raw Defs values, formulas, open questions

From here on: site-only detail (not covered in the video)

Mod settings items

Open the table (3 rows)

The category name for the settings screen is "VWE - Non-lethal".

Setting (as shown)DefaultEffect
Allow stun and paralysis damage to affect entitiesONWhen turned off, it does not affect entities in the Anomaly DLC.
Allow stun and paralysis damage to affect insectoid bossesONWhen turned off, it does not work on bosses such as VFE Insectoids 2 (creatures from another mod, SW_Emperorisopod, are also affected).
Allow stun and paralyze damage to affect specific creaturesONWhen turned off, it does not affect creatures listed in UnaffectedByNonLethalDef.

Features and evidence (files, classes)

Open the table with evidence (16 rows)
#FeatureIn-game appearance / controlsEvidence (file/class)
1Research on "non-lethal weapons"Prerequisite: Gunsmithing. Research cost: 1400. Era: Industrial. Displayed in the "Vanilla Expanded" research tab.Defs/ResearchProjectDefs/ResearchProjects.xml、ResearchTabs.xml
2Taser gunShort-range pistol with a range of 6.9. Electric beam (VEF's LaserGun). Requires Steel 45, 2 parts, and a crafting skill of 10. Can be used in conjunction with a shield.VWE_Weapons_Ranged_NonLethal.xml VWE_Gun_Taser
3Taser's "Conditional Stun"Actual damage is only 1. If it hits and deals 1 or more damage, it additionally applies Stun for 45. If blocked by armor, it does not stun.DamageWorker_ConditionalStun、DamageDef VWE_ConditionalStun
4Non-lethal pistolRubber bullet (Blunt, 6 damage). Range 25.9, relatively fast rate of fire. As the description states, it can cause death by contusion.VWE_Gun_RubberBulletPistol、VWE_Bullet_RubberPistol
5Dart gun (sedative gun)A long-range tranquilizer gun with a range of 36.9. Aiming time is 3.5 seconds. Requires 20 Netroamine to craft. The work amount is 36000, making it quite heavy.VWE_Gun_DartGun
6Anesthetic (Anesthesia) status abnormalityA dart hit gives "anesthetic". At severity 0.98 or more it is "sedative kicking in"; at 0.6–0.98 it is "sedated", with consciousness 0.01 = unconscious; at 0.3–0.6 it is "woozy" (vomiting, wandering in confusion, forgetting memory thoughts); below that it is "wearing off". It drops by 1.5 per day, so from severity 1 it reaches 0 and wears off in about 0.67 days (about 40,000 ticks), before the 45000–120000 tick time limit.Hediffs_Global_NonLethal.xml VWE_Anesthetic
7Dart woundA small puncture wound. 15% infection rate, may remain as a scar.VWE_Dart
8Tear gas launcherRange 19.9, can also target the ground. The deviation range of impact is 2.9. Crafted at the Machining Table. Requires 50 Neutroamina.VWE_Gun_TearGasLauncher
9Tear gas grenadesA throwable tool. Range 15.9. Explodes with a radius of 3.9 after 100 ticks from impact, leaving a yellow gas cloud. Explodes when burned by fire.NonLethalGrenade.xml
10Tear gas cloud20-30 seconds remaining. Every 2 seconds, apply "tear gas" to the pawn breathing in the cloud. Higher ToxicResistance makes it less effective.Gas_TearGas、Gas_Various.xml
11Status effect of Tear gas「blinded (blindness)」: Vision -100%, Operation & Movement -60%, Pain x2. 「teary (tearful)」: Vision -80%. 「wearing off (fading)」: Vision -30%. Decreases by 30 per day (recovers within a few hours).VWE_TearGas
12Stun batonMelee weapon. The head attack has a conditional stun effect. Crafted at a machining station. Can be used in conjunction with a shield.VWE_MeleeWeapon_StunBaton
13Enemy NPCs also equip itWeapon tag "NonLethal". Tazers and launchers have a generateCommonality setting (speculation: used by factions with the corresponding equipment tag)weaponTags of each ThingDef
14Weapon classification of IdeologyOnly when Ideology is present, assign the classification of RangedHeavy/RangedLight/ShortShots/LongShots/Melee (related to the doctrine's 'preferred weapons' and 'disliked weapons').Patches/Ideology.xml
15Mod Settings (Switching for Ineffective Targets)Refer to the configuration table below.VanillaWeaponsExpandedNonLethal_Settings
16For other Mod creators: UnaffectedByNonLethalDefCreatures whose defNames are listed in XML become immune to stun, anesthetic and tear gas only when the setting "affect specific creatures" (ON by default = it works) is turned OFF (!anestheticAffectsXMLDefined && in DamageWorker_AddInjury_NoMechs.cs). The default list covers the Behemoth, Gallatross, Summit Crab and Fungal Husk from Alpha Animals, plus the Archotech Centipede.Defs/UnaffectedByNonLethalDef.cs、StaticCollections、UnaffectedByNonLethalDefs.xml

Unverified or inferred statements

Open 4
  • 13 — Enemy NPCs also equip ...
  • It is said to be compatible with Combat Extended (according to a website introduction. Since this repository does not have a patch for CE, it is presumed that CE side supports it, speculation).
  • When "Insect Boss" or "Specific Creatures" are set to OFF in the settings, if Dart or Tear Gas hits something other than Pawns (such as walls), it may cause an error by reading pawn.def as null (likely due to insufficient null checks in DamageWorker_AddInjury_NoMechs and DamageWorker_TearGas). This does not occur with the default ON settings.
  • Weapon, status effect, and gas mods. It is fine to install them midway. If you uninstall them, the corresponding weapons or gases will disappear from the save (estimated).

Commit read

https://github.com/Vanilla-Expanded/VanillaWeaponsExpanded-NonLethal
9d17199bb4d8ac1aba13bff9f2b39dc7cd16db5a

Credit

Vanilla Weapons Expanded - Non-Lethal — Oskar Potocki (Vanilla Expanded Team) ・ Steam Workshop ・ GitHub

Image and license notes (from the report)
  • License: Not specified. Treat as the author's copyrighted work.

Reference: https://catalogue.smods.ru/archives/76365, https://steamcommunity.com/sharedfiles/filedetails/comments/2454918354