Гайд по скриптингу в DayZ

[_MayHem_]

Немного структурированные знания по скриптингу в Dayz
 

Введение

Моддинг и скриптинг в DayZ Standalone — это процессы создания и изменения игрового контента с помощью внешних модификаций и программных скриптов. Моддинг позволяет добавить новые возможности, изменить баланс или добавить уникальный контент, а скриптинг — это инструмент расширения функционала игры за счёт написания кода на языке Enfusion Script.

Существует несколько основных типов модов:

• Балансные моды — корректируют игровые параметры, например, урон оружия, здоровье персонажей или частоту появления ресурсов.
• Контентные моды — добавляют новые предметы, сущности, анимации или даже целые игровые механики, как кастомные рецепты крафта или уникальные задания.
• Серверные моды — расширяют возможности управления сервером, добавляют админ-команды, систему логирования или настройки экономики.

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

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

Структура модов и файлов

Стандартная структура мода для DayZ Standalone построена так, чтобы обеспечить удобство разработки, сборки и подключения модификаций как на клиентской, так и на серверной стороне. Рассмотрим подробно основные папки и ключевые файлы.

Основные папки мода

• addons — содержит скомпилированные PBO-файлы, которые игра загружает как готовые модули. Это конечный формат мода для запуска.
• scripts — исходный код скриптов на Enfusion Script, включая логику игрового поведения, классы, функции и т.д.
• config — файлы конфигурации, такие как config.cpp, определяющие параметры сущностей, предметов, настройки мода.
• meta — метаданные, в том числе системные файлы, описывающие зависимости и структуру мода.

Ключевые файлы конфигурации

• config.cpp — основной конфигурационный файл, содержащий описание классов, наследования, определение настроек объектов и скриптов.
• types.xml — определяет параметры лута и спавна предметов в мире игры: частоту появления, количество, зоны генерации.
• events.xml — задаёт группы событий со списком предметов, которые могут появляться при наступлении определённых условий.
   

  Процесс сборки и подключение мода

  Для упаковки мода создаётся PBO-файл — специальный архив, который содержит все важные файлы и папки. PBO формат используется движком DayZ для быстрого и упорядоченного доступа к ресурсам. Для создания PBO применяются инструменты:

• Addon Builder — официальный инструмент из Arma Tools для упаковки папки с модом в PBO.
• Community Tools — сторонние программы, например, PBO Manager, которые позволяют упаковывать и распаковывать PBO.

• После сборки мод помещается на сервер и/или клиент, подключается в конфигурационных файлах сервера (например, serverDZ.cfg) через параметр mods=. При запуске игры или сервера мод автоматически загружается и используется.

  Пример простой структуры модификации

  Please Log in or Register to see this: Code

  Основы Enfusion Script

  Enfusion Script — это специализированный скриптовый язык, разработанный компанией Bohemia Interactive для управления игровой логикой в DayZ Standalone. Он основан на синтаксисе, похожем на C++ и SQF, но адаптирован под особенности движка Enfusion, обеспечивая мощный и гибкий инструмент для моддинга.
  
   

  Переменные и типы данных

  В Enfusion Script поддерживаются основные типы данных:

• int — целочисленные значения
• float — числа с плавающей точкой
• bool — логические значения (true/false)
• string — текстовые строки
• ref — ссылки на объекты и классы

• В примере класс CustomPlayer наследует базовые свойства и методы PlayerBase, переопределяя метод OnPlayerHit с вызовом родительской реализации через super.

  Особенности языка Enfusion Script

• Строгая типизация — ошибки типов легко обнаруживаются на этапе компиляции.
• Поддержка событий и хуков для реакций на игровые действия.
• Интеграция с движком игры через специальные API для работы с объектами, игроками и окружением.
• Поддержка декларативных конфигураций файлов, таких как config.cpp, в тесной связке со скриптами.

• Знание этих основ критично для успешной работы с моддингом в DayZ, поскольку понимание структуры и возможностей Enfusion Script позволяет создавать не только простые корректировки, но и сложные игровые механики, интегрируя собственный код с базовой логикой игры.

  Объявление переменной происходит с явным указанием типа:

  Please Log in or Register to see this: Code

  Функции и методы

  Функции объявляются с использованием ключевого слова void или возвращаемого типа, если функция возвращает значение. Параметры передаются в круглых скобках:

  Please Log in or Register to see this: Code

  Наследование классов

  Enfusion Script поддерживает объектно-ориентированное программирование с наследованием. Для создания нового класса от существующего используется оператор ::

  Please Log in or Register to see this: Code

  Работа с сущностями

  В DayZ ключевыми игровыми сущностями являются PlayerBase, ItemBase и AnimalBase. Эти базовые классы представляют игрока, предметы и животных соответственно. Создание и модификация сущностей позволяет добавлять новые игровые механики, расширять взаимодействия и изменять поведение объектов в мире.

  Основные классы сущностей

• PlayerBase — отвечает за логику и состояния персонажа: здоровье, инвентарь, движения, взаимодействия.
• ItemBase — базовый класс для всех предметов в игре, включая оружие, снаряжение, расходники.
• AnimalBase — класс, управляющий поведением дикой природы, включая передвижения, агрессивность и реакции.

• Создание кастомной сущности

  Для создания собственной сущности используется наследование из одного из базовых классов. Например, создадим новый предмет с дополнительной логикой:

  Please Log in or Register to see this: Code

  Здесь CustomItem наследуется от ItemBase, добавляет конструктор и переопределяет метод OnUse(), чтобы выполнить дополнительный код при использовании предмета.

  Модификация поведения сущностей

  Расширение классов позволяет изменять логику без переписывания всего кода. Например, для игрока можно добавить дополнительную реакцию на получение урона:

  Please Log in or Register to see this: Code

  Особенности работы с сущностями

• Все кастомные классы необходимо прописывать в config.cpp для правильной регистрации игры.

• Взаимодействие с миром и лутом

  В DayZ спавн объектов и лута в игровом мире регулируется с помощью файлов types.xml и events.xml. Эти конфигурации определяют, какие предметы и с какой частотой появляются, а также в каких зонах и в каких условиях. Такой подход позволяет гибко настраивать генерацию ресурсов, настроить уникальные локации и события, влияющие на игровой процесс.

• Наследование позволяет переопределять методы, расширяя базовый функционал, сохраняя при этом совместимость.
• Используйте вызов super для вызова методов родительского класса, чтобы не потерять основную логику
   

  Файл types.xml

  В types.xml задаётся базовый список объектов для спавна — оружие, еда, медикаменты, бытовые предметы и многое другое. Каждая запись описывается с помощью параметров:

• name — идентификатор предмета;
• nominal — желаемое количество предметов на карте;
• lifetime — время существования объекта в секунду;
• restock — через сколько секунд после спавна объект может появиться вновь;
• min и quantmin — минимальное количество предметов и минимальный стэк;
• max и quantmax — максимальное количество и стек.

• Пример записи в types.xml для нового предмета:

  Please Log in or Register to see this: Code

  Файл events.xml

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

  Пример события, создающего набор лута:

  Please Log in or Register to see this: Code

  Создание спавна через скрипты

  Кроме XML-конфигов, в DayZ можно создавать и управлять спавном объектов программно через Enfusion Script. Для этого используются методы создания объектов в мире, например:

  Please Log in or Register to see this: Code

  Данный код создаёт экземпляр объекта CustomBandage в указанной позиции без прикрепления к персонажу.

  Особенности событийного спавна

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

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

•  

Обработка событий и хуки

В DayZ Standalone жизненный цикл объектов охватывает три ключевых этапа: создание, обновление и уничтожение. Во время создания объект инициализируется с базовыми параметрами, на стадии обновления происходит обработка логики поведения, а при уничтожении — освобождение ресурсов и возможное выполнение завершающих действий.

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

События игрока

• Рождение (OnPlayerSpawn) — инициализация состояния персонажа после входа в игру.
• Смерть (OnPlayerDeath) — момент обработки смерти для сохранения состояния или запуска дополнительных эффектов.
• Действия (например, OnItemUse, OnHit) — реакции на использование предметов, получение урона и другие игровые взаимодействия.

Action-система

Action-система отвечает за выполнение и обработку пользовательских действий (например, взятие предмета, открытие двери). Добавление нового действия требует создания класса-наследника ActionBase, определяющего логику, условия запуска и анимации.

Пример простого добавления действия:

Please Log in or Register to see this: Code

Пример подписки на событие и обработка

Возьмём пример подписки на событие смерти игрока через хук:

Please Log in or Register to see this: Code

Здесь EEKilled — виртуальный метод, вызываемый в момент смерти. Использование ключевого слова override позволяет модифицировать поведение без уничтожения базовой логики, а вызов super.EEKilled(killer) гарантирует сохранение стандартной обработки.

Благодаря хукам и системе событий в DayZ моддеры получают мощный инструмент для гибкого расширения и глубокой кастомизации игрового поведения.

Пользовательские предметы и крафт

Создание собственного предмета в DayZ требует последовательного подхода, включающего создание моделей, конфигурацию и добавление логики и рецептов крафта. Рассмотрим основные шаги.

1. Создание модели и текстур

Первый этап — подготовка 3D-модели предмета в стороннем редакторе (например, Blender или 3ds Max) и экспорт в формат, поддерживаемый движком (обычно .p3d). Также необходимы текстуры в форматах .paa или .tga, которые создаются на основе исходных изображений.

2. Описание предмета в config.cpp

В конфигурационном файле описывается класс предмета с указанием модели, информации для инвентаря и параметров взаимодействия. Пример:

Please Log in or Register to see this: Code

3. Добавление рецепта крафта в config.cpp и скрипты

Чтобы игрок мог создавать новый предмет, следует описать рецепт крафта. Для этого в cfgRecipes (кастомном или существующем) задаются необходимые компоненты и количество.

Please Log in or Register to see this: Code

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

4. Добавление анимаций и взаимодействий

Анимации для новых предметов задаются в cfgMoves и связаны с Action-системой. Для кастомных взаимодействий обычно создают новые классы действий (ActionBase). Например, можно добавить уникальное использование ножа для добычи ресурсов или нанесения урона.

Итоговый пример использования в скрипте

Please Log in or Register to see this: Code

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

Работа с инвентарём и характеристиками

В DayZ Standalone управление инвентарём и характеристиками игрока осуществляется через сочетание скриптов и конфигурационных файлов. Моддеры могут изменять параметры здоровья, голода, жажды, а также добавлять, удалять или передавать предметы между персонажами и объектами.

Изменение характеристик игрока

Для изменения параметров состояния персонажа (здоровья, голода, жажды и др.) используются методы класса PlayerBase. Например, чтобы изменить здоровье игрока, доступен метод SetHealth, а для работы с голодом и жаждой — свойства, связанные с компонентом StaminaHandler или Stats.

Please Log in or Register to see this: Code

Работа с инвентарём: добавление и удаление предметов

Взаимодействие с инвентарём реализуется через классы EntityAI и Inventory. Для выдачи предмета игроку используется метод GiveItem или создание объекта с последующим добавлением в инвентарь.

Please Log in or Register to see this: Code

Please Log in or Register to see this: Code

Передача предметов между игроками

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

Please Log in or Register to see this: Code

Типичные задачи и решения

• Выдача стартового набора: при спавне игрока.
• Автоматическое лечение: изменение показателей здоровья через скрипты при использовании аптечек.
• Удаление нелегальных предметов: проверка инвентаря и удаление через цикл.

Пользовательский интерфейс и HUD

В DayZ Standalone пользовательский интерфейс (UI) создаётся с помощью встроенного UI API, позволяющего создавать окна, кнопки, текстовые поля и другие элементы для взаимодействия с игроком. Основу UI составляет система виджетов, которые можно размещать на экране и управлять ими через скрипты на Enfusion Script.

Структура UI и взаимодействие со скриптом

UI элементы создаются в виде классов, наследующих Widget или WidgetScript. Основная сцена HUD реализована в виде специального виджета, который отвечает за отображение информации поверх игрового мира. Для взаимодействия с игровым кодом UI использует события и методы на скриптовой стороне.

Пример создания простого HUD

Ниже пример создания простого HUD, выводящего здоровье игрока в левом верхнем углу экрана:

Please Log in or Register to see this: Code

В данном примере создаётся класс CustomHUD, который инициализирует виджет из layout-файла и обновляет текст с текущим значением здоровья игрока каждое игровое обновление.

Советы по отладке и оформлению UI

• Используйте встроенный Workspace Debugger для просмотра иерархий виджетов и свойств;
• Разделяйте логику и оформление: храните лейауты в .layout файлах, а логику — в скриптах;
• Минимизируйте количество обновлений: обновляйте UI только при изменении данных, чтобы снизить нагрузку;
• Проверяйте Null-ссылки: всегда убеждайтесь, что виджеты корректно инициализированы перед использованием;
• Используйте стили и шаблоны: для единообразия интерфейса и удобства поддержки кода.

Серверная логика и администрирование

В DayZ Standalone скрипты могут исполняться как на стороне клиента, так и на сервере. Разделение ролей важно для оптимизации и безопасности. Клиент отвечает за отображение, управление пользовательским интерфейсом и локальную логику, тогда как сервер обрабатывает важные игровые процессы, валидацию действий, управление состояниями и синхронизацию между игроками.

Основные различия между серверным и клиентским кодом:

• Сервер: контролирует игровые правила, спавн объектов, обработку событий и действия игроков; все критичные вычисления выполняются здесь.
• Клиент: отвечает за визуализацию, анимации, интерфейс и локальный отклик на действия игрока.

Админ-команды и их обработка

Администрация сервера может использовать кастомные команды для управления игровым процессом, выдачи предметов или выполнения других операций. Для добавления админ-команды в Enfusion Script необходимо:

• Создать класс команды, реализующий интерфейс ChatCommandHandler или аналогичный.
• Зарегистрировать команду в системе через специальный менеджер команд.
• Обработать ввод и выполнить соответствующие действия.

Пример простой админ-команды для выдачи предмета:

Please Log in or Register to see this: Code

Работа с логами сервера

Логирование – важный инструмент для мониторинга работы сервера, отладки и аудита админских действий. В DayZ можно писать собственные сообщения в лог с помощью функции Print или специализированных методов сервера.

• Print("Сообщение") — выводит строку в общий лог сервера и консоль.
• Для разделения логов рекомендуется добавлять теги или префиксы, например: Print("[MyMod] Действие выполнено").
• Для более сложной логики можно реализовать запись в отдельные файлы через API сервера или внешние плагины.

Рекомендации по эффективному управлению сервером и модами

• Всегда разграничивайте серверный и клиентский код, минимизируя выполнение тяжелых операций на клиенте.
• Используйте проверки прав администратора перед выполнением команд, чтобы избежать злоупотреблений.
• Логируйте важные действия админов и критичные события для последующего анализа.
• Тестируйте моды в условиях, максимально приближенных к боевым, чтобы выявлять возможные ошибки и утечки производительности.
• Регулярно обновляйте и чистите логи, чтобы сервер не тормозил из-за больших файлов.

Оптимизация и best practices

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

Рекомендации по стилю и структуре кода

• Чёткая организация файлов: разделяйте логику по папкам и классам, используйте понятные имена для файлов и классов, чтобы упростить навигацию и поддержку.
• Комментирование: сопровождайте сложный или нестандартный код комментариями, чтобы облегчить понимание и последующую доработку.
• Избегайте дублирования кода: выносите часто повторяющиеся операции в функции или базовые классы, что улучшает читаемость и снижает вероятность ошибок.

Типовые ошибки и их предотвращение

• Null-ссылки: всегда проверяйте объекты на >null< перед использованием, особенно при работе с инвентарём и сущностями.
• Неправильное наследование: при переопределении методов не забывайте вызывать super для сохранения базовой логики.
• Чрезмерная частота вызовов: минимизируйте вычисления в методах Update или на каждую итерацию, используйте события и таймеры.

Совместимость и тестирование

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

Советы по производительности

• Оптимизируйте циклы и алгоритмы — избегайте вложенных вызовов без необходимости.
• Используйте локальные переменные, где это возможно, для снижения нагрузки на память и уменьшения доступа к объектам.
• Минимизируйте количество создаваемых объектов и спавн объектов строго при необходимости.
• Профилируйте скрипты и анализируйте точки узкого места с помощью встроенных средств и логов.

Примеры реализации

В этом разделе представлены три законченных примера кода с подробным объяснением их работы и инструкциями по интеграции в игру DayZ Standalone 1.24+.

1. Кастомный игровой ивент с уникальным поведением

Этот пример демонстрирует создание кастомного игрового ивента, который при активации спавнит группу врагов в радиусе от игрока. Ивент можно вызывать по триггеру или вручную из скрипта.

Please Log in or Register to see this: Code

Интеграция: вызовите метод TriggerEvent, например, по выполнению определённого условия в игровом событии или через консоль. Ивент автоматически создаст врагов рядом с игроком и заставит их атаковать игрока.

2. Админ-команда для управления игроками на сервере

Пример реализации простой админ-команды /kick, которая позволяет администратору выгнать игрока с сервера по имени.

Please Log in or Register to see this: Code

Использование: зарегистрируйте этот класс в системе команд серверного скрипта. Админы смогут вызвать команду в чате /kick JohnDoe, где JohnDoe — ник игрока.

3. Простой мод для изменения поведения животных

Модификация, которая изменяет поведение стандартных животных, делая их более агрессивными и быстрее реагирующими на игрока.

Please Log in or Register to see this: Code

Интеграция: данный мод необходимо добавить в скрипты, перекрыв базовый класс AnimalBase. После этого все животные будут обладать улучшенными параметрами агрессивности и быстрее реагировать на подход игроков.


 

КОМУ ПОМОГЛА ДАННАЯ СТАТЬЯ СТАВЬТЕ РЕКЦИИ😄

[Saba]

thanks bro

[akudinov28]

Привет. Статья очень хорошая. У меня есть немалый опыт разработки в других сферах, но в dayz только начинаю разбираться. Буду предельно благодарен, если подскажешь вот что: где можно найти API движка? Ну то есть где найти описание базовых классов (player, item, vehicle и т.д.), их свойств и методов, эвентов и так далее?

[_MayHem_]

14 часов назад, akudinov28 сказал:

Привет. Статья очень хорошая. У меня есть немалый опыт разработки в других сферах, но в dayz только начинаю разбираться. Буду предельно благодарен, если подскажешь вот что: где можно найти API движка? Ну то есть где найти описание базовых классов (player, item, vehicle и т.д.), их свойств и методов, эвентов и так далее?

Как таковой документации нет. Есть просто код без описания
https://dayz-scripts.yadz.app/index.html