Lua-фреймворк для Project Zomboid Build 42, позволяющий создавать и управлять темами главного меню с поддержкой аудио, изображений и видео. Сам по себе не изменяет меню.

[B42] Menu Theme Framework v13.11.2026 · ModsFire, 10.5 МБ · 8 скачиваний
Содержание

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.

Скриншоты 4

В коллекцию Пожаловаться