squad-proto/docs/21-damage.md

21 — Урон: стихии, статусы, реакции, триггеры

Продолжение 20-gdd.md. Здесь вся боевая арифметика.

Главное ограничение, из которого всё следует: в игре нет ручных действий (спек 5). Игрок водит диск и строит отряд; ни одна механика ниже не вводит кнопку. Стихии накладываются оружием, реакции срабатывают сами, эффекты висят на снаряжении. Мастерство — это ЧТО ты взял вниз и КУДА повёл отряд, а не как быстро ты нажимаешь.

1. Семь стихий

Код	Имя	Что делает	Против кого
KIN	Кинетика	оглушение, отбрасывание	универсально, режется бронёй
INC	Жар	горение, распространение при смерти	мягкие, скопления
CRY	Холод	замедление, заморозка	быстрые, рывковые
TOX	Кислота	снятие брони, урон от макс. HP	бронированные, жирные
ARC	Дуга	цепь по целям, наводка	толпы, слабые
RAD	Радиация	взрыв при смерти, заражение	стаи, respawn-твари
VOID	Пустота	срезание сопротивлений, притяжение	всё, что защищено

Стихии вводятся по актам (20-gdd.md §3), а не разом: игрок должен успеть понять каждую, прежде чем получит следующую.

1.1. Статусы

Каждая стихия кладёт стаки статуса. Стак живёт dur, сгорает по одному.

Статус	Стаки	Эффект за стак	Потолок
Горение (INC)	5	6% урона удара в секунду, 4 с	при смерти поджигает в радиусе 1.5
Оледенение (CRY)	10	−4% скорости, 3 с	10 стаков → Заморозка 1.4 с, +50% получаемого KIN
Разъедание (TOX)	8	−4% брони, 5 с	+0.8% макс. HP цели в секунду
Разряд (ARC)	4	+5% получаемого крита, 3 с	4 стака → цепь на 2 цели по 40%
Заражение (RAD)	6	+3% получаемого урона, 6 с	при смерти взрыв 60% макс. HP, R=2.2
Схлопывание (VOID)	3	−8% всех сопротивлений, 4 с	3 стака → притяжение к центру

Числа подобраны под один принцип: один стак не значит ничего, полный набор меняет бой. Это заставляет выбирать цель и держать её, а не поливать всех.

2. Формула урона

Одна формула на всё — и на пулю, и на клинок, и на тик горения.

                  ┌ базовый урон источника
dmg_raw   = W · (1 + Σ add) · Π mult
dmg_elem  = dmg_raw · share(e)                для каждой стихии e удара
mitig(e)  = 1 − clamp(R(e) + R_aff − PEN(e), −0.60, +0.85)
dmg_final = Σ_e dmg_elem · mitig(e) · crit · vuln

Символ	Что	Диапазон
W	урон оружия (каталог sim/weapon_defs.h)	8 → 900 по глубине
Σ add	аддитивные проценты (аффиксы «+X% урона»)	0 → 4.5
Π mult	множители (специализации, реакции, метки)	1.0 → 3.0
share(e)	доля стихии в уроне, Σ = 1	конверсия аффиксами
R(e)	сопротивление вида (каталог)	−0.5 → 0.9
PEN(e)	пробитие сборки	0 → 0.75
crit	1.0 или critMult	1.5 → 4.0
vuln	уязвимости от статусов	1.0 → 2.2

Почему сопротивление режется до −0.60, а не глубже. Отрицательное сопротивление — это уязвимость, и она обязана быть ощутимой, но не абсурдной: при −2.0 одна верная стихия обесценивала бы всю остальную сборку.

Почему потолок +0.85, а не 1.0. Иммунитета нет ни у кого. Тварь, которую физически нельзя ранить, — это не сложность, а тупик: игрок без нужной стихии просто не может играть.

2.1. Броня — отдельно от сопротивлений

Броня режет только KIN и работает долей с жёстким потолком ARMOR_CAP = 0.72 (уже в коде). TOX снимает броню стаками — это единственный способ пробить тяжёлую цель без пробития в сборке.

2.2. Крит

critChance = clamp(0.05 + Σ aff, 0, 0.75)
critMult   = 1.5 + Σ aff                      (без потолка)

Шанс с потолком, множитель без — потому что «всегда крит» убивает разброс результата, а «очень больно раз в четыре удара» его сохраняет.

3. Реакции

Две РАЗНЫЕ стихии на одной цели в пределах 3 секунд дают реакцию. Реакция срабатывает сама и снимает оба статуса.

Реакция	Пара	Эффект
Растрескивание	INC + CRY	всплеск 250% APow в точке, +80% к следующему KIN
Возгорание	INC + TOX	облако R=3.0, 180% APow в секунду, 3 с
Сверхпроводник	ARC + CRY	−30% всех сопротивлений цели и соседей, 6 с
Электролиз	ARC + TOX	все DoT на цели ×3 на 3 с
Распад	RAD + INC	зона R=2.5 на 8 с, 60% APow в секунду, кладёт RAD
Пепел	RAD + CRY	цель не воскресает и не респавнится
Резонанс	VOID + любая	реакция повторяется вторым срабатыванием на 60%
Схлоп	VOID + ARC	притяжение всех в R=4 к цели, оглушение 1 с
Осколки	KIN + CRY	замороженная цель при смерти бьёт осколками, 120% APow
Прорыв	KIN + TOX	−40% брони цели на 5 с, игнорируя потолок

3.1. Сила реакции не зависит от оружия

APow(d) = 4 + 0.12·d                    (d — глубина этажа)
reaction = k · APow(d) · (1 + reactionBonus)

Это ключевое решение. Реакция считается от глубины, а не от урона оружия — иначе на сотом этаже реакции стали бы округлением, и вся система стихий превратилась бы в украшение. Так же поступает Genshin с Elemental Mastery, и по той же причине.

Следствие: реакции — это канал «знания» из закона масштаба (20-gdd.md §2). Они растут сами по глубине, но только у того, кто умеет их запускать.

3.2. Внутренний откат

У каждой пары свой ICD: 1.2 с на цель. Без него цепь ARC по десяти тварям взорвала бы этаж одним нажатием, которого к тому же нет.

4. Триггеры: on-hit, on-kill, on-death

Журнал боевых событий уже существует — sim/events.h, кольцевой буфер, по которому сейчас работают эффекты и свет. Триггеры вешаются на него, а не рядом: второй канал событий разошёлся бы с первым в первый же месяц.

Триггер	Когда	Пример эффекта
on_attack	начало выстрела/замаха	«каждый 5-й выстрел бесплатный»
on_hit	попадание	«10% наложить CRY»
on_crit	критическое попадание	«крит снимает 1 стак перезарядки»
on_kill	цель умерла от тебя	«+8% скорости на 3 с, стак до 5»
on_death	ЦЕЛЬ умерла (любая)	«труп взрывается RAD»
on_hurt	по тебе попали	«20%: наложить INC атакующему»
on_down	твой оперативник пал	«отряд получает +25% урона на 10 с»
on_floor	вход на этаж	«+1 бинт, если сумка не полна»
on_extract	эвакуация	«+15% материалов»

4.1. Против взрыва комбинаций

Три ограничителя, все обязательные:

1. ICD у каждого эффекта. Минимум 0.5 с, у мощных — до 8 с.
2. Бюджет строки. Предмет несёт суммарный бюджет B(ilvl) = 40 + 3·ilvl; каждый аффикс стоит по тиру (22-loot.md §3). Шесть сильнейших аффиксов не влезают в один предмет никогда.
3. Запрет рекурсии. Эффект, сработавший от триггера, не может запустить тот же триггер: on_kill → взрыв → смерть → on_kill обрывается на первом шаге.

Без третьего пункта одна цепь ARC на скоплении из сорока тварей вешает игру — и это не гипотеза, а то, как ломаются все игры с триггерами.

5. Твари: сопротивления и роли

Сопротивление — свойство ВИДА, из каталога проекта. Роль читается по профилю сопротивлений, и это единственная подсказка, которую игра даёт напрямую.

Вид	Акт	KIN	INC	CRY	TOX	ARC	RAD	Роль
Бредущий	I	.0	−.2	.0	.0	.0	.3	мясо
Бегун	I	.0	.0	−.4	.0	.2	.0	давление
Плевок	II	.1	.0	.0	.5	−.3	.2	дистанция
Хват	III	.3	−.3	.1	.0	.0	.0	контроль
Громила	III	.5	.2	.3	−.4	.0	.1	танк
Рой	IV	−.2	−.5	.0	.0	−.4	.4	толпа
Скорлупа	IV	.7	.3	.4	−.5	.3	.2	стена
Плакальщик	V	.2	.0	.0	.2	.2	−.6	воскрешает
Пустотник	VI	.3	.3	.3	.3	.3	.3	требует VOID

Читается так: против Скорлупы бесполезно всё, кроме TOX; Плакальщика надо жечь радиацией, иначе он поднимет остальных; Пустотник равномерно защищён, и его берут только срезанием сопротивлений.

Ни у одного вида нет множителя HP от глубины. Глубже выходят ДРУГИЕ виды — правило из 16-descent.md, и оно не отменяется до Бездны (23-endgame.md §2, где отменяется осознанно и с объяснением).

6. Коридор TTK

Чтобы бой не превращался ни в тир, ни в губку, время убийства держится в коридоре — это проверяемое обещание, а не пожелание.

Цель	TTK одним оперативником, с верной стихией	с неверной
мясо своей полосы	0.6–1.2 с	2–4 с
давление	1.0–2.0 с	4–8 с
танк	4–7 с	15–40 с
элита (мутант)	8–15 с	не убивается до отката ресурсов

Разрыв «верная/неверная» — от ×3 до ×6. Меньше — стихии перестают значить, больше — игра требует энциклопедии перед каждым спуском.

Проверяется инструментом --tool ttk <глубина>: он печатает таблицу «вид × сборка → секунды» и валится с кодом 1, если хоть одна пара вышла из коридора.

6.1. Что из этого уже в коде

Веха M21 положила арифметику, но не статусы: горение, оледенение и реакции — следующая веха, они живут ПОВЕРХ этого файла, а не внутри него.

Что	Где
стихии, сопротивления, формула	src/sim/element.h
профиль вида	EnemyDef::resist, src/sim/target.cpp
состав удара оружия	FirearmDef::elem, BladeDef::elem
единственная точка урона	ResolveDamage в bullet.cpp и в клинке
проверка	squad_proto --tool ttk

Стихии есть только у НАХОДИМОГО оружия. Карабин, пистолет и сабля — чистая кинетика, потому что на них меряется приёмка, и её числа обязаны остаться теми же.

Как коридор чуть не измерили неправильно

Первая версия --tool ttk считала разброс по времени убийства и показывала уверенные 2.8x на каждой твари. Выглядело как готовая система — а на самом деле это была разница МОЩНОСТИ стволов: магнум лучше пистолета против всех, и стихии тут ни при чём.

С вынесенной за скобки мощностью оружия правда оказалась другой: 1.04–1.36x, то есть состав удара не значил почти ничего. Механика была декоративной ровно в том же смысле, в каком когда-то был вес.

Чтобы разброс появился, у каждой твари должны быть И уязвимость, И сопротивление среди тех стихий, которые вообще носит оружие. Одной уязвимости мало: если ни один ствол не бьёт тем, что тварь держит, минимум остаётся единицей.

ENEMY         rifle   pistol  shotgun      smg   magnum      bow      ELEM
SHAMBLER        7.5     10.1      8.3      7.2      3.9      6.0     1.90x
SPITTER         4.4      5.9      6.1      2.3      2.2      7.0     2.61x
BRUTE          46.5     62.4     44.2     18.0     14.4     12.1     3.06x

Читается так: дробовик жжёт бредущих, дуга бьёт плевков, лук разъедает громилу, а карабин против громилы бесполезен — сорок шесть секунд.

Коридор пока 1.8–8.0, а не заявленные 3–6: чтобы дотянуть до тройки, нужны почти чистые стихийные сборки, а они приходят с аффиксами (22-loot.md). Занижать цель в документе нельзя, поэтому в инструменте стоит достижимое, а в таблице выше — целевое.

6.2. Статусы и реакции в коде (M22)

Что	Где
правила статусов, потолки, реакции, числа	src/sim/status.h
наложение и запуск реакции	src/sim/reactions.cpp
тик горения и сгорание стаков	UpdateStatuses, зовётся из UpdateTargets
проверка	squad_proto --tool reactions

Реализованы четыре реакции из десяти: SHATTER, IGNITE, SUPERCOND, DECAY. Остальные ждут систем, которых пока нет (крит, воскрешение, притяжение), и дописывать их «пока не работает» значило бы завести шесть мёртвых веток.

Два отступления от документа, оба сознательные:

• кислота и дуга увеличивают получаемый урон, а не снимают броню и не вешают метку крита: у тварей в этой игре брони как числа нет, а крита нет вовсе. Эффект тот же, лишней сущности не заводится;
• SUPERCOND кладёт стаки пустоты вместо отдельного «среза сопротивлений»: пустота в этой игре и означает «защита не работает», и второе имя для того же было бы просто вторым именем.

Горение считается от МАКСИМАЛЬНОГО здоровья цели, а не от урона удара. Иначе на громиле оно не значит ничего, а мелочь дожигает само.

Три ограничителя проверяются, а не подразумеваются

REACTION         TARGET  NEIGHBOUR   STACKS
SHATTER            13.0        0.0        0
IGNITE              9.4        4.7        0
SUPERCOND           3.1        0.0        0
DECAY               6.2        3.1        0

откат: вторая пара внутри 1.2 c нанесла 0.0
рекурсия: урон от реакции наложил стаков 0
сила реакции: D1 4.1, D50 10.0, D100 16.0

Столбец STACKS — сколько стихий осталось после реакции. Ноль обязателен: не погасив пару, следующий удар сложил бы её снова, и реакция стала бы постоянным фоном вместо события.

Шаг симуляции после вехи — 2.9 мкс при бюджете кадра 16666: статусы на шестидесяти четырёх целях ничего не стоят.

7. Свет как ресурс

Хоррор-часть, которая сейчас не сделана: фонарь даёт множитель обзора и не садится. Должен садиться.

заряд(t) = заряд₀ − drain·t,   drain = 1/сек
радиус = base · (0.35 + 0.65 · заряд/заряд₀)

Батареи — расходник (вес 0.3), заменяются автоматически при разряде, как бинты. Кончились — отряд идёт в темноте: обзор 35%, твари замечают первыми.

Это второй после патронов ресурс, который гонит наверх, и он же — причина, по которой ветвь Разведки в дереве узлов не «приятная», а обязательная.