Rosetta

Rosetta - это клиентская библиотека для Minecraft, которая берёт на себя всю возню с обучением игрока в модах. Читаешь описание? Скорее всего, ты наткнулся на неё случайно - потому что какой-нибудь build-better или drop-highlighter тянет её как зависимость. Пугаться не надо, сама по себе она ничего в игре не меняет.

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

Что делает Rosetta

Когда установлен любой мод, использующий Rosetta, ты получаешь единую систему онбординга. Одноразовые попапы, подсказки, алерты и новости - всё в одном оформлении, с общей логикой и очередью показа. Для авторов модов главный плюс в том, что карточки не наступают друг на друга: если бы каждый мод лепил своё окно, они бы рендерились одновременно и превращали первый запуск в кашу. Rosetta выстраивает очередь, ведёт учёт версий и запоминает, что игрок уже видел.

Вот что она умеет:

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

Как это меняет игру

Тут всё про комфорт, а не про новый контент. Туториалы не лезут в бой: Rosetta сама глушит карточки, когда ты получаешь урон, спишь, летишь, мёртв или в режиме наблюдателя. Никаких "добро пожаловать в мод!" посреди схватки с рейдом.

Единый интерфейс для всех модов - это на самом деле куда важнее, чем кажется. Не надо привыкать к разным клавишам и разным способам закрытия окон. Всё выглядит и ведёт себя одинаково. И да, закрытые карточки остаются закрытыми между сессиями: состояние живёт локально в твоей установке Minecraft. Никаких облаков, никакого трекинга по серверам.

Категории тоже продуманы. Туториалы, подсказки, предупреждения, новости и титры помечены отдельно, поэтому в экране воспроизведения они группируются адекватно, а не в одну свалку.

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

Важно понимать границы. Rosetta не добавляет никакого игрового контента: ни блоков, ни предметов, ни мобов, ни измерений, ни рецептов.

Она только клиентская. Серверам её ставить не нужно, и серверы не могут проталкивать через неё сообщения игрокам.

И ещё: если поставить Rosetta саму по себе, ты не увидишь вообще ничего. Для работы ей нужен мод, который её использует.

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

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

Технические детали и совместимость

• Загрузчики: Fabric, NeoForge
• Версии Minecraft: 1.21.1 - 26.1.2
• Java: 21 (для 1.21.x) / 25 (для 26.x)

Если ставишь сборку модов на Fabric или НеоForge и видишь в зависимостях Rosetta - знай, это не баг, а норма. Скачать Rosetta стоит тем, кто хочет, чтобы обучение в модах проходило гладко, без спама одинаковых окон при каждом запуске. Совместима с популярными оптимизациями вроде Sodium, не конфликтует с шейдерами через Iris, не мешает работе модов на производительность - грубо говоря, сидит тихо и делает свою работу.