Rosetta

Rosetta — это клиентская библиотека, предназначенная для доставки обучающих туториалов, советов и списков изменений в унифицированном и отполированном виде.

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

При использовании модов на базе Rosetta игроки получают доступ к следующим элементам:

• Карточки первого запуска: полноэкранные приветственные окна при первом входе в мир после установки мода с объяснением его основных функций.
• Подсказки в HUD: уведомления в ванильном стиле, появляющиеся над панелью быстрого доступа при совершении определенных действий (например, при первом открытии нового интерфейса или поднятии нового типа предмета).
• Многостраничные туториалы: пошаговые инструкции с затемнением фона и выделением конкретных областей интерфейса для глубокого изучения механик.
• Экран повтора: возможность открыть меню Rosetta в любое время, чтобы перечитать пропущенные подсказки, ознакомиться с заметками об изменениях или освежить память о забытых функциях.
• Единая почта уведомлений: если мод пытается обучить игрока в момент высокой нагрузки (бой, полет на крыльях, сон), подсказка ставится в очередь и отображается индикатором на HUD, когда игрок будет готов.

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

• Отсутствие прерываний в бою: Rosetta автоматически скрывает карточки, если персонаж получает урон, спит, скользит, находится в состоянии смерти или в режиме наблюдателя.
• Единый интерфейс: все моды используют одинаковые макеты, клавиши и поведение закрытия окон, исключая визуальные конфликты и наслоения.
• Сохранение прогресса: информация о подтвержденных карточках сохраняется между игровыми сессиями в локальной установке Minecraft.
• Категоризация: туториалы, советы, предупреждения, новости и титры автоматически группируются в меню повтора для удобного поиска.

Для авторов модов Rosetta предлагает гибкие инструменты интеграции:

• Регистрация через JSON5: стандартный формат для простых случаев (файл rosetta-onboard.json5 в ресурсах мода).
• Java Builder API: инструменты для продвинутых сценариев, включая кастомные триггеры, указатели в игровом мире, многостраничные туториалы и собственные виджеты.
• Управление версиями: изменение номера версии карточки позволяет повторно показать её пользователям после обновления контента мода.

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

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