Rosetta

Rosetta

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

Если ты читаешь это и удивляешься, откуда он у тебя взялся, — скорее всего, какой-то другой мод (build-better, drop-highlighter и т. п.) зависит от него ради функций обучения.

Что Rosetta делает для тебя

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

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

Как это меняет твой опыт

• Туториалы никогда не прерывают бой. Rosetta автоматически подавляет карточки, пока ты получаешь урон, спишь, планируешь, мёртв или в режиме наблюдателя. Ты не получишь экран «добро пожаловать в этот мод!» посреди драки.
• Один интерфейс для всех модов. Вместо того чтобы каждый мод изобретал свой приветственный экран с разными клавишами, вёрсткой и поведением при закрытии, моды на Rosetta используют одинаковый вид и ощущение, и им не приходится бороться за отрисовку поверх других.
• Твои закрытия сохраняются. Карточки, которые ты подтвердил, остаются подтверждёнными между игровыми сессиями. Состояние хранится в твоей установке Minecraft. Никакого облака, никакого отслеживания по серверам.
• Карточки разделены по категориям для фильтрации. Туториалы, подсказки, предупреждения, заметки о новом и титры помечаются соответствующим образом, так что экран повтора группирует их разумно.

Чего Rosetta НЕ делает

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

Для авторов модов

Rosetta предоставляет формат регистрации карточек на основе JSON5 для типичных случаев (rosetta-onboard.json5 в ресурсах твоего мода) плюс Java API-билдер для сложных случаев (кастомные триггеры, указатели в мире, туториалы из нескольких слайдов, кастомные виджеты). Если ты изменил карточку, ты можешь показать её заново, изменив номер версии карточки, чтобы она появилась снова после изменений контента, или зарегистрировать новый ID для каждого крупного релиза для заметок о новом. Категории (tutorial, tip, warning, news, credits) определяют группировку в интерфейсе повтора.

Заявление об ИИ

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

Поддерживаемые загрузчики: Fabric, NeoForge Поддерживаемые версии Minecraft: с 1.21.1 по 26.1.2 Уровень Java: 21 (1.21.x) / 25 (26.x) Документация: https://github.com/Malteas-Games/malt-mods/tree/main/docs/rosetta