Modonomicon

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

Вдохновением для Modonomicon послужила легендарная книга из Thaumcraft - Таумономикон, а также более современный Patchouli. Разработчик взял лучшее из обоих подходов и добавил свои фишки.

Что умеет Modonomicon

По факту, Modonomicon заточен под авторов модов и сборщиков модпаков. Вы создаете датапак, в котором описываете книгу, её главы и страницы. Всё это подгружается в игру, и игрок может листать документацию прямо в интерфейсе. Основные плюшки:

• Полностью через датапаки - не нужно писать код на Java. Любой модпак или отдельный мод может добавить свою книгу простым датапаком. Гидра или любой другой загрузчик датапаков подойдёт.

• Мультиблоки как в Patchouli - можно показать построение многоблочных структур, но теперь они тоже управляются датапаками. Удобно для технических модов.

• Расширяемость - если ваш мод вводит уникальные крафты (например, магическую алхимию), можно добавить свой тип страницы с рецептами. Modonomicon спроектирован так, чтобы модули могли дописывать новые фичи.

• Двумерная карта контента - знаете, как в Thaumonomicon? Есть дерево открытий: читайте содержимое, открывайте новые главы, двигайтесь по карте достижений. В Modonomicon это реализовано через систему категорий и прогрессии.

• Гибкая система условий - книги могут быть "закрыты" до тех пор, пока игрок не выполнит определённое действие: скрафтит предмет, достигнет уровня, найдет локацию. Это даёт много пространства для квестов и гайдов.

• Markdown-разметка - для оформления текста используется расширенный Маркдаун. Картинки, списки, ссылки, таблицы - всё как в вебе, только в Minecraft.

• Типы страниц - текст, рецепты, изображения, предметы, даже шейпы крафта. Всё рендерится прямо в книге.

Зачем это вообще нужно?

Если коротко - Modonomicon делает гайды и документацию частью игры. Вам не надо открывать браузер, смотреть видео на YouTube или читать PDF. Книга уже внутри Майнкрафта, в красивой обёртке. Для мододелов это must-have: игрок заходит на сервер, открывает книгу и сразу понимает, что к чему.

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

Технические моменты

Скачать Modonomicon можно для Minecraft под Fabric или Forge (и NeoForge, и Quilt тоже поддерживаются). На момент написания актуальные версии - 1.19-1.21. Мод весит около 200-300 КБ, на производительность не влияет. Внутренние ссылки: если у вас в сборке есть ссылка на документацию Modonomicon, она останется рабочей.

Повторюсь: это не гайд по игре, а средство для создания гайдов. Как русская локализация - если авторы сборки написали книгу на русском, Modonomicon её покажет. Если нет - увы.

Лицензия и использование

Код Modonomicon распространяется под MIT-лицензией, ассеты - под CC BY 4.0. Использовать в сборках можно свободно, достаточно указать ссылку на страницу мода. На CurseForge ссылка проставляется автоматически, так что можно вообще не париться.