Lua-фреймворк для Project Zomboid Build 42, позволяющий создавать и управлять темами главного меню с поддержкой аудио, изображений и видео. Сам по себе не изменяет меню.
Содержание
Menu Theme Framework (MTF) - это фреймворк на Lua для Project Zomboid Build 42, предназначенный для создания и управления пользовательскими темами главного меню. Самостоятельно мод не вносит изменений в меню; он предоставляет инструменты, необходимые для модов-тем, чтобы заменить внешний вид и звук титульного меню. Без установленной темы визуальных или звуковых изменений не происходит.
Основные возможности
- Перехват главного меню: Темы могут рисовать собственные фоны и оверлеи до и после стандартных кнопок меню.
- Фоны из изображений и видео: Поддерживается смена изображений с анимацией слайд-шоу (горизонтальный или вертикальный сдвиг, затемнение), собственные фоны и воспроизведение видеороликов с синхронизированным звуком. Можно объединять несколько клипов с плавными переходами.
- Макеты кнопок: Темы могут использовать стандартный список, нижнюю полосу, карусель либо горизонтальные или вертикальные карточки. Фреймворк управляет размерами, прокруткой, наведением, фокусом и кликами. Игроки выбирают макет в окне настроек темы меню.
- Поддержка мыши и геймпада: Все макеты поддерживают как мышь, так и контроллер. D-Pad перемещает фокус по кнопкам, а X/Square открывает окно настроек.
- Стилизация тем: Элементы - карточки, полосы, стрелки, логотип, затемнение меню - настраиваются через таблицы стилей; тема может заменить любой элемент своим рисунком.
- Воспроизведение аудио: Темы могут настраивать плавное появление звука, случайный порядок и выбор треков. Видео можно сопровождать отдельным аудиофайлом (в Project Zomboid звук в .bik-видео не воспроизводится).
- Замена логотипа: Стандартный логотип скрывается, чтобы тема могла отобразить свой по имени файла. Если не задан, используется логотип в стиле оригинала.
- Окно настроек: В левом нижнем углу титульного меню появляется кнопка настроек темы с вкладками: отображение, интерфейс (отдельные кнопки), аудио и кредиты. Все параметры сохраняются между сессиями.
- Шаблон темы: В комплекте есть документированный шаблон темы, демонстрирующий регистрацию, работу с видео, изображениями, музыкой, карточками и настройками. Моддеры могут скопировать и доработать его для создания своих тем.
Технические детали
- Фреймворк активируется только после регистрации темы. Если установлено несколько тем, используется первая зарегистрированная; остальные отображаются как игнорируемые в окне настроек.
- Темы работают с титульным меню до загрузки игры. Фреймворк оборачивает функцию отрисовки меню, чтобы тема могла рисовать до и после стандартных кнопок.
Аудио
- Музыка темы, звук видео и звуки интерфейса воспроизводятся через общий UI-эмиттер с отдельными уровнями громкости.
- Пока активна тема, фреймворк на каждом кадре отключает громкость музыки и звуковых эффектов игры, возвращая их перед загрузкой мира. Настройки игрока не изменяются.
Изображения
- Фоновые изображения масштабируются и центрируются под любое разрешение и соотношение сторон. Слайд-шоу по умолчанию сменяет изображения каждые 15 секунд. Карточки с изображениями появляются после загрузки текстур с плавным затемнением.
- Эффекты вроде размытия или цветокоррекции должны быть заранее применены к изображениям, так как Lua в Build 42 не поддерживает работу с шейдерами или цветом.
Видео
- С версии Build 42.22 поддерживается загрузка пользовательских Bink (.bik) видео, но звук в них не воспроизводится. Отдельный аудиофайл запускается синхронно с видео. Фреймворк поддерживает синхронизацию видео и звука, а также последовательное или случайное воспроизведение клипов с плавными переходами.
- Пока активна тема, фреймворк отключает стандартное видео меню, возвращая настройку игрока перед определёнными экранами и загрузкой мира. Если "Видеоеффекты" выключены, тема отображает статичное изображение вместо видео.
Совместимость и требования
- Требуется Project Zomboid Build 42.19 или новее (для тем с видео - Build 42.22+).
- Не использует Java-код, не требует ручной установки или замены файлов.
- Включает переводы на все поддерживаемые языки Project Zomboid.
- Совместим со всеми соотношениями сторон, разрешениями и размерами шрифтов.
- Поддержка геймпада.
- Только клиентская часть; серверный код отсутствует.
- Не изменяет файлы оригинальной игры. Настройки тем сохраняются локально в папке Zomboid/Lua/MenuThemeFramework.
- Совместим с модами, добавляющими кнопки в главное меню.
- Не совместим с модами, которые заменяют фон, логотип, музыку или видео главного меню, а также радикально изменяют стиль или расположение кнопок.
Создание тем
- В комплекте есть шаблон Menu Theme Template - рабочий мод-тема, который можно включить отдельно для демонстрации возможностей. Для создания своей темы скопируйте и переименуйте шаблон, следуя комментариям внутри.
- Полная документация для авторов тем (аудио, графика, видео, макеты кнопок, стилизация, настройки и справочник) предоставляется отдельно.
Примечание: Этот фреймворк необходим для работы модов-тем, таких как GTA Menu Theme или RDR Menu Theme.




Комментарии 0
Пока нет комментариев — будьте первым.
Войдите или зарегистрируйтесь, чтобы оставить комментарий.