Dngcher: Новая страница: «== Система взрывов == '''Система взрывов''' это стандартная механика, отвечающая за расчёт урона, разрушение плиток, физические эффекты (броски объектов), воспламенение, звук и визуализацию взрывов. Всё управляется через '''прототипы взрывов''' (`ExplosionPrototyp...»`


2026-10-05T14:22:07Z
Новая страница: «== Система взрывов ==  '''Система взрывов''' это стандартная механика, отвечающая за расчёт урона, разрушение плиток, физические эффекты (броски объектов), воспламенение, звук и визуализацию взрывов. Всё управляется через '''прототипы взрывов''' (<code>ExplosionPrototyp...»
Новая страница
== Система взрывов ==



'''Система взрывов''' это стандартная механика, отвечающая за расчёт урона, разрушение плиток, физические эффекты (броски объектов), воспламенение, звук и визуализацию взрывов. Всё управляется через '''прототипы взрывов''' (<code>ExplosionPrototype</code>), '''компоненты-триггеры''' (<code>ExplosiveComponent</code>, <code>ScatteringGrenadeComponent</code>, <code>ProjectileGrenadeComponent</code>) и '''системы''' (<code>ExplosionSystem</code>).



== Прототип взрыва (<code>ExplosionPrototype</code>) ==



Это YAML-описание типа взрыва. Все поля определяют, как взрыв наносит урон, разрушает плитки, выглядит и звучит.



{| class="wikitable"

! Поле !! Тип !! Описание

|-

| <code>damagePerIntensity</code> || <code>DamageSpecifier</code> || '''Базовый урон''' за единицу интенсивности. На каждом тайле итоговый урон это <code>damagePerIntensity * интенсивность_на_плитке</code>. Виды урона: <code>Heat</code>, <code>Blunt</code>, <code>Piercing</code>, <code>Structural</code>, <code>Cold</code> и другие.

|-

| <code>fireStacks</code> || <code>float?</code> || Количество <code>Stacks</code> огня, добавляемых загоревшимся сущностям (если есть <code>FlammableComponent</code>).

|-

| <code>temperature</code> || <code>float?</code> || Температура, до которой нагревается атмосфера в затронутых тайлах.

|-

| <code>tileBreakChance</code> и <code>tileBreakIntensity</code> || <code>float[]</code> || Два массива одинаковой длины, задающие '''функцию зависимости шанса разрушения плитки''' от интенсивности. Шанс интерполируется линейно между точками (<code>intensity -> chance</code>).

|-

| <code>tileBreakRerollReduction</code> || <code>float</code> || После успешного разрушения плитки интенсивность '''уменьшается''' на это значение, и делается повторная попытка разрушить следующий слой (например, чтобы пробить покрытие). Это позволяет сильным взрывам создавать разгерметизации.

|-

| <code>lightColor</code> || <code>Color</code> || Цвет точечного света в эпицентре взрыва.

|-

| <code>fireColor</code> || <code>Color?</code> || Цвет, которым модулируется текстура огня на плитках. Если не задан то, используется стандартный.

|-

| <code>texturePath</code> || <code>ResPath</code> || Путь к RSI-файлу с текстурами огня.

|-

| <code>fireStates</code> || <code>int</code> || Количество состояний (градаций) текстуры огня.

|-

| <code>intensityPerState</code> || <code>float</code> || Порог интенсивности для перехода к следующему состоянию огня.

|-

| <code>smallSoundIterationThreshold</code> || <code>int</code> || Если количество итераций (колец) взрыва меньше этого числа то, взрыв считается маленьким и проигрывается тихий звук.

|-

| <code>sound</code>, <code>smallSound</code>, <code>soundFar</code>, <code>smallSoundFar</code> || <code>SoundSpecifier</code> || Звуки для обычного и маленького взрыва (ближний и дальний).

|-

| <code>maxCombineDistance</code> || <code>float</code> || Если два взрыва одного прототипа происходят в одном тике и эпицентры ближе этого расстояния то, их интенсивность суммируется (они объединяются в один взрыв).

|}



== Интенсивность и её распределение ==



Главное значение это '''интенсивность взрыва'''. Она определяется в момент вызова взрыва (через <code>QueueExplosion</code> или <code>TriggerExplosive</code>).



=== Основные параметры распространения ===



* <code>totalIntensity</code> — суммарная энергия взрыва. Она распределяется по плиткам.

* <code>slope</code> — скорость падения интенсивности с расстоянием (на каждую плитку). Чем больше <code>slope</code>, тем быстрее затухает взрыв.

* <code>maxTileIntensity</code> — максимальная интенсивность, которая может быть на одной плитке. Это ограничивает локальный урон и шанс разрушения.



Радиус взрыва определяется косвенно: общая интенсивность примерно равна объёму конуса взрыва (интенсивность как высота). Чем больше <code>totalIntensity</code>, тем больше площадь.



=== Алгоритм заливки ===



# Начинается с заданных координат эпицентра взрыва (плитка или точка в космосе).

# На каждой итерации добавляет соседние плитки (сначала ортогональные, затем диагональные).

# Интенсивность каждой новой итерации определяется по формуле <code>stepSize = slope / 2</code> (или меньше, если осталось мало интенсивности).

# Процесс продолжается, пока не кончится <code>totalIntensity</code> или не будет достигнут лимит итераций/площади.



Таким образом, плитки на разных расстояниях получают разные значения интенсивности.



== Расчёт урона и сопротивление ==



Урон по сущностям вычисляется для каждой затронутой плитки отдельно.



# Базовый урон это <code>damagePerIntensity * интенсивность_на_плитке</code>.

# Учитываются глобальные модификаторы урона от взрывов (через <code>DamageableSystem</code>).

# Для каждой сущности на плитке вызывается событие <code>GetExplosionResistanceEvent</code> (передаётся ID прототипа). Это позволяет модифицировать коэффициент урона (например, броня, скафандры).

# Если сущность имеет <code>ExplosionResistanceComponent</code>, коэффициент защиты применяется перед нанесением урона.

# После всех модификаций урон наносится через <code>DamageableSystem.TryChangeDamage</code> (игнорируя обычные резисты, т.к. резисты ко взрывам уже учтены).



=== Вложенные контейнеры и экипировка ===



Событие <code>BeforeExplodeEvent</code> позволяет рекурсивно пробрасывать урон на содержимое контейнеров (рюкзаки, карманы). Это позволяет, например, взрывать предметы внутри сумки игрока, если сам игрок получил урон. Коэффициент урона для содержимого также может быть изменён.



== Разрушение плиток ==



Взрыв может разрушать плитки (стены, полы). Этот процесс идёт параллельно с нанесением урона сущностям.



* Шанс разрушения определяется функцией <code>TileBreakChance(intensity)</code> - линейная интерполяция между точками из <code>tileBreakChance</code> и <code>tileBreakIntensity</code>.

* Если плитка разрушена то, она '''меняется на покрытие''' (или на следующий слой из истории плиток, если есть <code>TileHistoryComponent</code>).

* После каждого успешного разрушения интенсивность уменьшается на <code>tileBreakRerollReduction</code>, и шанс пересчитывается для следующего слоя. Это позволяет сильным взрывам пробивать несколько слоёв стен.

* Если новая плитка помечена как <code>MapAtmosphere = true</code>, это означает создание вакуума - но только если взрыву разрешено создавать вакуум (<code>canCreateVacuum</code>).



'''Ограничения:''' <code>maxTileBreak</code> - сколько раз может разрушиться один тайл (обычно бесконечно), <code>tileBreakScale</code> это множитель интенсивности для расчёта разрушения (можно сделать взрыв сильнее по урону, но слабее по пробитию).



== Визуализация и звук ==



Визуал отрисовывается на клиенте через <code>ExplosionOverlay</code>. Сервер создаёт специальную сущность с компонентом <code>ExplosionVisualsComponent</code>, которая передаёт клиенту:



* координаты эпицентра,

* наборы плиток по итерациям,

* список интенсивностей,

* матрицу трансформации для космоса.



Клиент подгружает текстуры из прототипа и рисует их с соответствующим цветом и прозрачностью, в зависимости от текущей интенсивности и прогресса взрыва (номер итерации).



Звук воспроизводится сразу в момент создания взрыва (сервер отправляет звуковые события игрокам в радиусе). Есть два набора звуков — для близкого и дальнего расстояния.



== Компоненты-триггеры взрывов ==



=== <code>ExplosiveComponent</code> ===



Самый простой - содержит ссылку на прототип и параметры:



* <code>ExplosionType</code> - ID прототипа.

* <code>TotalIntensity</code>, <code>IntensitySlope</code>, <code>MaxIntensity</code> - могут переопределять значения по умолчанию.

* <code>TileBreakScale</code>, <code>MaxTileBreak</code>, <code>CanCreateVacuum</code> - управляют разрушением тайлов.

* <code>Repeatable</code> - может ли взрываться несколько раз.

* <code>DeleteAfterExplosion</code> — удалять ли сущность после взрыва.



Система вызывает <code>TriggerExplosive</code>, который ставит взрыв в очередь.



=== <code>ScatteringGrenadeComponent</code> ===



Используется для гранат, которые разлетаются на множество мелких взрывающихся объектов. При срабатывании (триггер по ключу) содержимое контейнера (и неразмноженные экземпляры) разбрасываются в стороны с заданной скоростью и случайными углами. Затем у каждого выброшенного объекта может быть активирован таймер (Trigger) через заданные задержки.



Параметры:



* <code>FillPrototype</code> - прототип для заполнения, если контейнер пуст.

* <code>Capacity</code> - максимальное количество вылетающих entity (можно добавить любую entity, которая будет вылетать при активации этой гранаты).

* <code>Velocity</code>, <code>Distance</code>, <code>RandomAngle</code>, <code>RandomDistance</code> - параметры разлёта.

* <code>DelayBeforeTriggerContents</code>, <code>IntervalBetweenTriggers</code> — задержки активации.



=== <code>ProjectileGrenadeComponent</code> ===



Похож на <code>ScatteringGrenade</code>, но выбрасывает не взрывающиеся объекты, а снаряды (<code>projectiles</code>), которые летят с заданной скоростью и наносят урон при попадании (через систему стрельбы).



== Сопротивление взрывам (<code>ExplosionResistanceComponent</code>) ==



Этот компонент можно добавить предмету (например, сумке) или на саму сущность. Он уменьшает или увеличивает получаемый урон от взрывов в зависимости от коэффициента.



* <code>DamageCoefficient</code> - множитель (2 - урон в два раза больше, 1 - нет защиты, 0 - полная неуязвимость).

* <code>Modifiers</code> - словарь, где ключ - ID прототипа взрыва, значение - дополнительный множитель именно для этого типа. Это позволяет иметь разную защиту от разных взрывов.

* <code>Worn</code> - если <code>true</code>, то действует только когда предмет надет (через <code>InventoryRelayedEvent</code>).

* <code>Examine</code> - строка локализации для отображения в осмотре.



== Пример из <code>explosion.yml</code> ==



 - type: explosion

   id: Default

   damagePerIntensity:

     types:

       Heat: 5

       Blunt: 5

       Piercing: 5

   tileBreakChance: [0, 0.5, 1]

   tileBreakIntensity: [0, 10, 30]

   tileBreakRerollReduction: 20

   lightColor: Orange

   texturePath: /Textures/Effects/fire.rsi

   fireStates: 3

   temperature: 800



* <code>Default</code> - ID прототипа.

* <code>damagePerIntensity</code> - количество урона за одну единицу интенсивности на всём тайле.

* <code>tileBreakChance</code> и <code>tileBreakIntensity</code> - шанс разрушения плитки: при интенсивности 0 -> 0%, при 10 -> 50%, при 30 -> 100%.

* <code>tileBreakRerollReduction</code> - после разрушения интенсивность уменьшается на 20, и проверяется следующий слой.

* <code>lightColor</code> - цвет вспышки в эпицентре взрыва.

* <code>texturePath</code> - путь к текстуре взрыва.

* <code>fireStates</code> - то, какой <code>State</code> (написанный в <code>meta.json</code>) используется при взрыве

* <code>temperature</code> - температура атмосферы после взрыва



== Очередь и объединение взрывов ==



Взрывы ставятся в очередь (<code>_explosionQueue</code>) и обрабатываются понемногу за тик, чтобы не нагружать сервер. Если два взрыва одного прототипа происходят в одном тике и их эпицентры ближе <code>maxCombineDistance</code>, их интенсивности суммируются. Это позволяет, например, детонировать одновременно несколько бомб, создавая один мощный взрыв вместо нескольких маленьких.
Участник:Dngcher/Песочница - История изменений
