Dynamic Bloodpool Framework / Фреймворк динамических луж крови

Dynamic Bloodpool Framework — это система, разработанная для создания анимированных луж крови плавным, стабильным и полностью настраиваемым способом, без использования Папирус-скриптов или стандартных декалей.

В отличие от традиционных решений, которые полагаются на наложение статических декалей друг на друга или работу постоянных скриптов, данный фреймворк использует динамическую 3D-модель (mesh), которая в реальном времени адаптируется к поверхности ландшафта и рельефа. Лужа крови естественным образом огибает окружение и непрерывно развивается, избегая мерцания текстур (Z-fighting) и нестабильного поведения.

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

Система полностью управляется данными через JSON-файлы, предоставляя полный контроль над внешним видом и поведением луж крови. Это позволяет создавать неограниченное количество вариаций без необходимости использовать плагины (ESP/ESM) или сталкиваться с техническими ограничениями.



◈ Ограничения традиционных декалей
В оригинальной игре отсутствует система анимированных луж крови. Мододелам приходилось полагаться на импровизированные решения с использованием статических декалей. Самая популярная система — *Enhanced Blood Textures (EBT)* — работает путем наложения нескольких текстур друг на друга в одной и той же точке с помощью постоянно работающего скрипта.

Основные ограничения такого подхода:
* Ограниченная плавность анимации.
* Отсутствие реального изменения размера со временем.
* Движок вынужден обрабатывать десятки текстур для одной-единственной лужи крови, что существенно влияет на производительность.
* Скрипт Папируса (Papyrus) остается активным в фоновом режиме на протяжении всего времени существования эффекта, что может вызывать задержки, нестабильность и падение кадров в определенных локациях.
Коротко говоря: этот метод неэффективен, ненадежен и ограничен визуально.

◈ Первый подход: Анимированные декали
Первоначальная идея заключалась в прямой манипуляции декалями для их анимации. После разработки нескольких алгоритмов для сглаживания и синхронизации обновления текстур выяснилось следующее:
* Визуальный результат был приемлемым в отдельный момент времени, но...
* Декали всё равно мерцали между обновлениями,
* А производительность существенно снижалась со временем.
Вывод был очевиден: движок игры попросту не предназначен для эффективной обработки анимированных декалей в реальном времени.

◈ Новый подход: Система динамических 3D-моделей
Чтобы преодолеть эти ограничения, *Dynamic Bloodpool Framework* был переработан с использованием кардинально иного подхода:
* Единая плоская 3D-сетка (mesh), состоящая из множества узлов, заменяет традиционные декали.
* Каждый узел динамически адаптируется к поверхности ландшафта в реальном времени, позволяя луже крови точно повторять геометрию окружения.
* Анимация больше не достигается наложением текстур или работой скриптов. Вместо этого 3D-сетка развивается за счет манипуляции её геометрией и параметрами шейдеров.
* Поведение и внешний вид полностью управляются через JSON-файлы, включая размер, скорость роста, текстуры, цвет, непрозрачность, оттенок, свойства свечения и многое другое.

Преимущества:
* Максимальная плавность и визуальная стабильность.
* Минимальное влияние на производительность.
* Полная гибкость настройки через файлы данных.
* Никаких фоновых скриптов, задержек скриптового движка и мерцания текстур.

Единственное известное ограничение связано с точностью коллизии поверхностей. Если поверхность имеет некорректные данные коллизии, могут возникать незначительные проваливания текстуры. Однако в подавляющем большинстве случаев 3D-сетка идеально огибает окружение.

Часто задаваемые вопросы (FAQ):
಄ Может ли мод вызывать просадки производительности?
Это крайне маловероятно, так как все операции обрабатываются движком игры в реальном времени наиболее оптимизированным образом. Кроме того, загрузка ресурсов происходит асинхронно при запуске игры, что предотвращает появление лагов. Если вы заметили временное проседание частоты кадров во время анимации луж крови, просто уменьшите значение `iTargetFramerate` в файле `DynamicBloodpoolFramework.ini`.

಄ Работает ли мод со всеми версиями игры?
Да, мод без проблем работает на любой версии игры, включая VR.

಄ Совместим ли мод с графическими модами?
Да, мод полностью совместим со всеми графическими и визуальными модами.

಄ Совместим ли мод с [XYZ]?
Да, Dynamic Bloodpool Framework совместим абсолютно со всеми другими модами без исключения.

಄ Лужи крови не появляются, хотя установлен Sanguine Symphony:
Убедитесь, что версия Sanguine Symphony — 1.2.0 или выше.
Если вы также используете Core Impact Framework (CIF), убедитесь, что он обновлен до версии 1.2.6 или выше.

಄ У меня происходит вылет (crash) или возникает конкретная ошибка:
В этом случае, пожалуйста, обратитесь к инструкциям, приведенным в закрепленном комментарии в разделе комментариев (Comments) на Нексусе.

಄ Могу ли я настроить мод под себя, и нужно ли это делать?
Все переменные уже были тщательно отрегулированы для достижения наилучшего визуального результата. Если вы все же хотите изменить некоторые параметры, вы можете сделать это, отредактировав файл `SKSE\Plugins\DynamicBloodpoolFramework.ini`. Как и во всех моих модах, этот файл снабжен подробными комментариями к каждой настройке. Впрочем, вам вряд ли потребуется что-либо в нем менять.

Требования:
Skyrim Special Edition / Anniversary Edition / Skyrim VR
Address Library for SKSE Plugins
SKSE64 SE
SKSE64 AE
* Хотя сам фреймворк полностью автономен, ему всё равно необходимы файлы инструкций (`.json`) для определения его поведения. Эти файлы, вместе с соответствующими ресурсами (ассетами), могут поставляться любым модом, в который добавлена поддержка *Dynamic Bloodpool Framework*. Со своей стороны я планирую использовать эту систему как минимум в двух своих модах:
᯽ Sanguine Symphony (версия 1.2.0+)
Это новое обновление (которое должно быть доступно к моменту, когда вы это читаете) в полной мере использует возможности *Dynamic Bloodpool Framework*, создавая лужу крови ровно в том месте, куда пришелся удар по NPC в момент его смерти. Целый раздел в меню MCM мода *Sanguine Symphony* посвящен тонкой настройке множества параметров, связанных с лужами крови.
᯽ Dismembering Framework (версия 2.0.0) [В разработке / W.I.P.]
В настоящее время версия 2.0.0 находится в разработке. Первая итерация *Dynamic Bloodpool Framework* была представлена еще в альфа-версии 2 мода *Dismembering Framework v2*. Его официальная полноценная интеграция состоится с релизом второй версии на Nexus Mods. Точных сроков выхода (ETA) пока нет, так как план разработки все еще весьма обширный.

Установка:
⚠️ Примечание: сам по себе фреймворк не добавляет никаких луж крови! Перед установкой фреймворка убедитесь, что вы установили хотя бы один мод, использующий его возможности, например Sanguine Symphony.
* Вы можете безопасно устанавливать, обновлять и удалять мод во время прохождения игры.
Установить архив через менеджеры модлов или вручную. Активация не требуется.
Можете свободно изменять настройки в файле `DynamicBloodpoolFramework.ini` по пути SKSE/Plugins/DynamicBloodpoolFramework.ini (все пояснения переведены на русский в самом файле).