Знакомство с модом Vocation: озвученные сообщения и интерактивные сценарии в Minecraft
Модификации в Minecraft давно перестали быть просто набором новых блоков или инструментов. Сегодня моды позволяют создавать целые сюжетные линии, управлять игровым процессом через триггеры и даже добавлять озвучку. Именно таким инструментом является Vocation — небольшой, но гибкий мод, созданный специально для разработчиков модпаков и авторов кастомных карт. С его помощью можно выводить на экран текстовые сообщения с именем рассказчика, проигрывать звуковые файлы и запускать цепочки событий в ответ на действия игрока.
Vocation не добавляет готовых квестов или диалогов — он предоставляет каркас, который вы наполняете собственным контентом через JSON-файлы. Это делает мод идеальным решением для тех, кто хочет оживить свою сборку, не углубляясь в программирование на Java. Достаточно разобраться в структуре конфигурации, и вы сможете создать всё: от простого приветствия при первом входе на сервер до сложной системы поэтапного обучения с наградами.
Как работает Vocation
Принцип работы мода прост: на клиенте и сервере должны находиться одинаковые JSON-файлы с описанием сообщений. Когда игрок выполняет определённое условие (триггер), на экране появляется текстовое поле с заданным сообщением, именем рассказчика и, при желании, проигрывается звуковая дорожка. Каждое сообщение имеет уникальный идентификатор, что позволяет отслеживать, видел ли его игрок, и выстраивать цепочки зависимостей — одно сообщение может требовать, чтобы перед ним были просмотрены другие.
Сообщения не обязаны содержать текст: можно оставить поле message пустым, и тогда событие сработает «тихо», но всё равно отметится как увиденное и выполнит назначенные действия. Это удобно для создания скрытых проверок или промежуточных этапов, которые не должны отвлекать игрока.
Установка и начало работы
Для работы Vocation необходимо установить мод и на сервер, и на клиент. После первого запуска игры в корневой директории появится папка vocation_data, расположенная рядом с папками mods и config. Внутри неё вы создаёте собственную папку с любым именем — это будет ваше рабочее пространство. Если планируется использовать озвучку, внутри этой папки нужно создать подпапку audio и поместить туда файлы в формате .ogg.
Кстати, если вы пользуетесь лаунчером foxygame.net, установка Vocation становится ещё проще: этот гибкий и современный лаунчер позволяет загружать моды прямо из своего меню, избавляя от ручного копирования файлов. После этого останется лишь дождаться генерации папки vocation_data и приступить к написанию сценариев.
Все сообщения описываются в JSON-файлах с расширением .json, которые размещаются непосредственно в созданной вами папке (не в audio). Количество файлов не ограничено — вы можете разбивать сообщения по категориям для удобства. Важно, чтобы содержимое JSON-файлов на сервере и клиенте полностью совпадало; аудиофайлы могут отсутствовать на сервере, но JSON должны быть идентичны.
Формат сообщения: анатомия JSON
Корнем каждого файла является массив, внутри которого перечислены объекты сообщений. Вот ключевые поля, которые можно использовать:
- id — уникальный строковый идентификатор сообщения. Используется в триггерах, требованиях и командах.
- message — текст, отображаемый на экране. Может быть пустым, если нужно выполнить действия без вывода.
- narrator — имя рассказчика, которое появляется над сообщением. Помогает обозначить источник информации.
- time — длительность показа в тиках (20 тиков = 1 секунда).
- voiceover — необязательное поле с именем .ogg файла из папки audio, который проиграется при появлении сообщения.
- requirements — массив идентификаторов сообщений, которые игрок должен был увидеть хотя бы раз, чтобы это сообщение могло сработать.
- triggers — массив условий, при выполнении любого из которых (логическое «ИЛИ») сообщение будет показано. Если триггеры не указаны, сообщение можно вызвать только командой.
- actions — массив действий, выполняемых при появлении сообщения (выдача предметов, выполнение команд).
Гибкость структуры позволяет комбинировать эти поля в любых сочетаниях, создавая многослойные взаимодействия.
Триггеры: как «поймать» момент
Триггеры определяют, на какое событие в игре отреагирует сообщение. Мод поддерживает несколько типов триггеров, каждый со своими параметрами:
- message_seen — срабатывает, когда игрок увидел другое сообщение Vocation. Параметр key содержит ID целевого сообщения. Полезно для построения диалоговых цепочек.
- stat_above — проверяет, превышает ли значение игровой статистики (например, количество прыжков или смертей) заданный порог. Параметры: key (имя статистики) и value (минимальное значение).
- item_pickup — реагирует на поднятие предмета. Требует описания стека предметов в поле stack.
- item_craft — срабатывает при создании предмета в верстаке или инвентаре. Также использует stack.
- mob_kill — фиксирует убийство моба. Параметр key — имя моба (например, minecraft:zombie).
Если в массиве triggers указано несколько условий, достаточно выполнения любого из них. Это позволяет, например, показать подсказку и при подборе определённого ресурса, и при убийстве моба, который его дропает.
Действия: награды и команды
Когда сообщение появляется на экране, оно может выполнить одно или несколько действий. На данный момент доступны два типа:
- give_item — выдаёт игроку предмет. Описывается через объект stack, включающий ID предмета, метаданные (опционально), размер стака и NBT-теги.
- run_command — выполняет консольную команду с уровнем привилегий командного блока от имени игрока. Параметр param содержит команду, включая слеш. Это открывает безграничные возможности: от телепортации до изменения игровых правил.
Формат стека предметов максимально приближен к тому, что используется в команде /give. Можно указать id (например, minecraft:diamond), metadata (для шерсти или дерева), stackSize и nbt — JSON-объект с тегами. В триггерах метаданные и NBT можно опустить, тогда проверка будет менее строгой.
Команды мода: управление из консоли
Vocation добавляет несколько полезных команд, которые расширяют контроль над сообщениями:
- /vocation-review — доступна любому игроку. Повторно показывает последнее увиденное сообщение, но не выполняет действия повторно.
- /vocation-reload — команда для администраторов. Перезагружает все JSON-файлы из папки vocation_data без перезапуска сервера.
- /vocation-clear <player> — очищает все данные Vocation указанного игрока (какие сообщения были увидены). Требует прав командного блока.
- /vocation-set-seen <player> <id> <true/false> — принудительно помечает сообщение как увиденное или нет. Позволяет сбрасывать прогресс, чтобы триггеры сработали снова.
- /vocation-show <player> <id> [do-actions] — немедленно показывает указанное сообщение игроку. Если добавлен параметр do-actions, выполняются и действия, а сообщение помечается как увиденное. Без него сообщение не запоминается, что удобно для тестирования.
- /vocation-check <player> <id> — работает аналогично /testfor: выдаёт сигнал компаратора, если игрок видел сообщение. Полезна для создания редстоун-схем, реагирующих на прогресс.
Для кого этот мод
Vocation ориентирован прежде всего на создателей модпаков и авторов приключенческих карт. Он не пытается быть готовым квестовым движком, а даёт низкоуровневый, но интуитивно понятный инструмент для сценаристов. Благодаря поддержке озвучки и гибкой системе триггеров можно реализовать обучение новичков, сюжетные вставки, систему достижений с наградами или даже динамические подсказки, реагирующие на стиль игры.
Поскольку мод был написан всего за несколько часов на стриме, он не претендует на идеальную оптимизацию или обширный функционал, но своей задачи — выводить сообщения и запускать действия — он выполняет отлично. А простота формата JSON делает порог входа минимальным: достаточно базового понимания структуры данных, чтобы начать писать собственные сценарии.
Если вы давно хотели добавить в свою сборку «живые» диалоги или озвученные подсказки, Vocation станет отличным выбором. А в связке с другими модами, управляющими рецептами или генерацией мира, можно создать по-настоящему уникальный игровой опыт, который удивит даже бывалых игроков.