护甲等级系统ArmorLevelSystem

Armor Level System

Adds an "armor level" to gear, giving Barotrauma a Tarkov-style damage resolution. [hr][/hr]

Before you start

This mod ships with no armor data of its own — subscribing to it alone changes nothing. So how do you actually get the effect?

• Use it alongside a gear mod that has registered armor with this system.
• Or fill in the Armor value table in the mod settings using [code]identifier:level[/code]. This works for any gear — vanilla body armor, diving suits, or clothing from other mods.

[hr][/hr]

How it works

1. Penetration check

Armor value = level / 10; penetration = the projectile's penetration (0 ~ 1). The difference d = armor value − penetration directly determines the chance to penetrate and the damage dealt after penetrating.

2. Layered armor and penetration decay

Resolution order: OuterClothes (diving suit slot) → InnerClothes (clothing slot). After the outer layer is pierced, the projectile's penetration is reduced, and the remaining penetration is then checked against the inner layer.

3. Blunt damage

When a layer is not pierced, the gap between penetration and armor still causes a small amount of blunt damage. This can be turned off in the settings — with it off, a failed penetration deals no damage at all. [hr][/hr]

How to use

Mod settings

• Master switch — turning it off disables the whole system and falls back to the vanilla damage calculation
• Blunt damage — on = a failed penetration still deals a small amount of damage; off = a failed penetration deals no damage
• Armor value table — [code]id:level[/code] or [code]id:level:penetrationDecay[/code], separate multiple items with commas. Example: [code]captainsuniform:4,my_divingsuit:6:0.5[/code]

Console commands

[table noborder=1] [tr][td]armorlevel[/td][td]show current state and all entries[/td][/tr] [tr][td]armorlevel add <id> <level> [decay][/td][td]add or override an entry[/td][/tr] [tr][td]armorlevel del <id>[/td][td]remove an entry[/td][/tr] [tr][td]armorlevel clear[/td][td]clear all settings entries[/td][/tr] [tr][td]armorlevel export[/td][td]output the current settings (easy to share)[/td][/tr] [tr][td]armorlevel reload[/td][td]re-read settings[/td][/tr] [tr][td]armorlevel on | off[/td][td]master switch[/td][/tr] [tr][td]armorlevel blunt on | off[/td][td]blunt damage toggle[/td][/tr] [tr][td]armorlevel test <pen> <level|id>[/td][td]calculate a result offline[/td][/tr] [/table]

For mod authors

ArmorLevelSystem.Register("my_divingsuit", 5) -- level 5 armor
ArmorLevelSystem.Register("my_vest", 4, 0.03) -- optional custom penetration decay

Only applies to items in the OuterClothes / InnerClothes slots and to damage-type afflictions. [hr][/hr]

Included: debuff blacklist

Also included is a "debuff blacklist" — write the afflictions you don't want into the list and the player team becomes immune to them. The default list contains some debuffs from TSM. Feel free to add, remove, or disable them entirely.

Console commands

[table noborder=1] [tr][td]dmgbl[/td][td]show the list[/td][/tr] [tr][td]dmgbl add a,b,c[/td][td]add entries[/td][/tr] [tr][td]dmgbl remove a,b[/td][td]remove entries[/td][/tr] [tr][td]dmgbl set a,b,c[/td][td]replace the list[/td][/tr] [tr][td]dmgbl reload[/td][td]reload[/td][/tr] [tr][td]dmgbl on / off[/td][td]master switch[/td][/tr] [/table] Note: the ids in the list must match the affliction ids used by vanilla and by other mods, and the defaults may not match what you want — please adjust them to suit your needs. [hr][/hr] All features of this mod require LuaCsForBarotrauma.