Условия использования

Играя в Project Zomboid (PZ), вы соглашаетесь с: Условия использования (ENG)

В плане моддинга PZ вы так же согласны с: Политика моддинга (ENG)

Ключевые ограничения

Indie Stone оставляет за собой право реализовывать любые функции в игре, независимо от того, существуют ли моды, которые выполняют ту же цель.
Моддеры PZ несут единоличную ответственность за свой мод, включая (но не ограничиваясь) соответствие любым хостинговым платформам (таким как Steam Workshop). Они также несут ответственность за получение согласия третьих лиц на любые сторонние материалы в моде. Юридически мы просим моддеров «заявлять и гарантировать» (т.е. обещать на законных основаниях), что их мод является их собственной оригинальной работой, а любое стороннее содержимое полностью и должным образом лицензировано моддером.
Создание модов регулируется нашей Политикой моддинга, которая может время от времени обновляться любыми техническими требованиями относительно того, как должны работать моды PZ.
Моддеры Project Zomboid могут бесплатно получать денежные/подарочные пожертвования от игроков, использующих их релизы и ценящих время и усилия, вложенные в них. Однако создание модов исключительно для тех, кто решил сделать пожертвование (или отдельный «внутримодовый» контент и бонусы), не допускается. Создатели модов не могут продавать модификации Project Zomboid.

Установка и использование модов

Установка модов - Как установить моды на Steam или GoG версию игры

Использование модов - Как включить моды и настроить их

Решение самых частых проблем с модами - Что делать если моды плохо работают или ломают игру

Создание модов

Введение

В моддинге для PZ можно выделить несколько основных направлений:

Изменение скриптов - Скриптами в игре описаны параметры предметов, рецептов и транспорта. Сделать мод, который меняет значения предметов, транспорта, рецепта или добавляет новый предмет, не сложно. Для этого не нужно знаний программирования и из инструментов нужен любой текстовый редактор. Скрипты находятся в .txt файлах и имеют определенную структуру.
Написание Lua кода - Основное направление в моддинге PZ. Большинство модов содержат Lua код. PZ разработан в основном на языках Java и Lua, так что использование Lua кода в модах тесно связано с исследованием исходного кода игры. При создании более сложных модов вам придется погрузится в декомпилированный Java код игры. Мы расскажем основы языка Lua, но вы должны быть знакомы с основами программирования. Также желательно общее представление о синтаксисе языка Java, т.к. вам в один момент вам придется лезть в код игры чтобы разобраться как работает та или иная функция.
Создание 3D моделей - В данный момент с помощью модов в игру можно добавить новые модели транспорта, оружия, обычных предметов и одежды. Игра использует 2 формата моделей - .X и .FBX. Нам для создания модов с моделями будет достаточно .FBX формата.
Создание карты - Создание локаций, зданий и общего окружения для игры
Создание анимаций - Создание анимаций для персонажа. Включает в себя создания файла анимации и интеграции ее в игру.
Создание текстур, картинок и иконок - Это направление дополняет остальные. Для моделей понадобятся текстуры, для предметов - текстуры и иконки, для интерфейса - те или иные изображения, для карты - текстуры для новых тайлов (новые объекты для размещения на карте).

Инструменты для работы

Текстовые редакторы - Используются для изменения скриптов и написания кода. Предпочтительно использовать редакторы с подсветкой синтаксиса Lua - например Notepad++ или VS Code
Программы для 3D моделирования - Используются для работы над 3D моделями. Например: Blender
Редакторы изображений - Используется для создание иконок, текстур для предметов и тайлов. Например: GIMP, Photoshop

Начинающий уровень

Структура мода - Как устроен мод и как создать заготовку для мода

Структура папки PZ и папки Zomboid - Описание файлов и папок, что пригодятся при разработке модов

Запуск игры в Debug режиме - Как запустить игру в режиме разработчика и использовать его

Синтаксис скриптов - Руководство об устройстве скриптов (файлы .txt) для предметов, рецептов и переводов

Введение в Lua - Руководство по языку Lua

Логирование и обработка ошибок - Как использовать логи для получения информации об игре/моде и обрабатывать ошибки

Создание 3D модели для предмета - Создаем модель с текстурой для предмета

События - События PZ и подключение к ним

Работа со звуками и музыкой - Добавление и проигрывание аудио файлов

Работа с таблицами спавна - Изменение таблиц спавна предметов

Загрузка мода в мастерскую Steam - Как оформить и загрузить мод в мастерскую Steam

ModData - Работа с данными мода и их хранением

Создание первого мода - Руководство по созданию мода "Молот Тора"

Создание заготовки для мода
Добавление новых предметов в игру
Добавление новых рецептов
Добавление предметов в таблицы спавна предметов
Подключение к событиям (Lua)
Добавление звуков
Добавление переводов на другие языки

Продвинутый уровень

Тайлы - Руководство по тайлам

Транспорт - Руководство по транспорту

Анимации - Руководство по анимации

TimedActions - Руководство о действиях по времени

Пользовательский интерфейс - Руководство по пользовательскому интерфейсу

Профессии, перки и навыки - Руководство по профессиям, перкам и навыкам

Мультиплеер - Руководство по настройке мода для работы в мультиплеере

Создание мода на огнестрельное оружие и броню - Руководство по созданию мода "Экипировка второй мировой войны"

Создание оружия ближнего и дальнего боя
Создание одежды и брони
Добавление и настройка предметов

Создание мода добавляющего новый транспорт - Руководство по созданию мода "Спортивный автомобиль"

Создание модели и текстур
Добавление и настройка транспорта

Создание мода добавляющего новую карту - Руководство по созданию мода "Дом у озера"

Создание заготовки для карты
Создание новых тайлов
Создание зданий
Добавление карты и тайлов в игру

Создание мода, добавляющего новые анимации - Руководство по созданию мода "Макарена"

Создание анимации
Добавление анимации в игру

Создание мода, расширяющего функционал - Руководство по созданию мода "Дубликаты ключей"

Создание действий по времени (TimedActions)
Работа с пользовательским интерфейсом
Добавление профессии, перка и навыка

Создание мода с клиент-серверной архитектурой - Руководство по созданию мода "Банкоматы"

Работа с клиент-серверными командами
Работа с глобальной ModData

Полезные статьи и ссылки

Как стоит делать и как делать не стоит - Хорошие и плохие практики при создании модов

Файлы - Руководство по работе с файлами

Загрузка модов в игре - Порядок загрузки модов и порядок загрузки файлов мода

Получение доступа к публичным переменным объектов Java - Как получить и использовать переменные объектов Java

Декомпилирование кода игры - Как изучать исходный Java код игры