Hydra / Гидра (набор утилит и скриптового языка Papyrus)

Патч для загрузки Form Editor ID при запуске игры.

Идентификаторы редактора (Editor ID) обычно доступны только внутри Creation Kit.
Благодаря этому патчу их теперь можно использовать непосредственно в игре: через скриптовые команды, в консоли управления, а также в модах, требующих этой функции (например, Base Object Swapper и Spell Perk Item Distributor).

Патч для предварительной загрузки и связывания скриптов Papyrus.

Некоторые скрипты могут оставаться незагруженными или несвязанными на момент, когда игра завершает первичную загрузку.
Обычно это не вызывает сбоев, поскольку скрипты подгружаются при первом обращении к ним. Однако такой подход может создавать микрофризы и задержки, особенно при обращении к крупным и сложным скриптам.
Этот патч предпринимает попытку заранее загрузить и связать все скрипты Papyrus ещё на этапе старта, полностью устраняя подобные просадки и задержки во время игры.

Ускорение нативных функций (экспериментально; по умолчанию отключен)

Патч для ускорения большинства нативных функций Papyrus.

При вызове потоконебезопасных нативных функций Papyrus, таких как ObjectReference.GetBaseObject, игровой движок помещает этот вызов в очередь до следующего игрового кадра, чтобы выполнить его последовательно в одном потоке.
Для понимания масштаба: при 60 FPS один кадр занимает около 16 мс. Это означает, что вызов десятков подобных функций суммарно задерживает выполнение скрипта на несколько секунд.

Как работает решение:
• Патч переносит все подобные вызовы функций в тасклеты скриптов (script tasklets), защищённые мьютексом.
• Это позволяет выполнять вызовы незамедлительно.
• Функции вроде ObjectReference.GetBaseObject теперь выполняются примерно за 0.01 мс вместо ~16 мс (приблизительно в 1 600 раз быстрее).

Ограничения и совместимость:
• Скрытые функции, такие как ObjectReference.AddItem, продолжают работать как в оригинальной игре: родительский стек ожидает полного завершения работы вызванной функции.
• Внимание: Патч может изменить поведение отдельных скриптов, если их логика ранее затачивалась под обязательную задержку в один кадр.
• Для предотвращения конфликтов список задействованных функций можно гибко настраивать через шаблоны (pattern matching) в конфигурационном файле.

В: Почему это не просто обновление для Papyrus Common Library?

О: Я решил вынести проект как отдельный, поскольку Hydra, хоть и похожа в некоторых аспектах, имеет множество фундаментальных различий в работе с Papyrus. Из-за этого она не была бы совместима с существующими модами, использующими Papyrus Common Library.

В: Можно ли использовать Hydra вместе с Papyrus Common Library?

О: Да.

В: Заменяет ли Hydra мод Papyrus Common Library?

О: В некотором смысле Hydra задумывалась как его замена, однако модам, у которых Papyrus Common Library указан в качестве обязательного требования, по-прежнему необходима его установка.

В: У меня появляется всплывающее сообщение об ошибке Hydra.dll «Plugin/PapyrusManager.cpp» (152): Не удалось загрузить скрипт типа «Hydra:Forms:Actvator».

О: При установке F4SE обязательно проверьте, чтобы была скопирована вся папка Data из архива F4SE со всем содержимым.