Guide

Интерактивный игровой мод-справочник с плавным рендерингом интерфейса, поддержкой Markdown и 3D-превью мультиблоков.

от deaddieselБиблиотеки Управление Утилиты

NeoForgeForge

Загрузчики: NeoForgeForge
Скачиваний на Modrinth: 1,2 тыс.
Подписчиков на Modrinth: 8
версии: 24
Обновлён: 19 октября 202619 окт.
Опубликован: в 2026

В избранное Следить за обновлениямиСледить

Коротко о моде

Библиотека — нужна другим модам

Работает на NeoForge и Forge

Для Minecraft 1.20.1, 1.21.1

Нужен и в игре, и на сервере

Последняя версия — 1.7.0 от 19 октября 2026

Лицензия MIT — бесплатно

Где нужен

В игреобязателенНа сервереобязателен

Нужен и в игре, и на сервере

Версии игры1.20.1, 1.21.1

Описание переведено автоматическиПоказать оригинал (EN)

🧱 Отрисовывай сложные мультиблоки. Разбирай Markdown прямо внутри интерфейса.
🎬 Воспроизводи видео, GIF и изображения — на Windows, macOS и Linux через FFmpeg.
🎨 Полностью настраиваемые темы, переопределения для каждой книги, свои цвета и фоны глав, опциональные визуальные эффекты.

📚 Интерактивные книги Компиляция прямо с диска. Мультикнижные пространства имён, без упаковки в JAR. Полный набор команд для просмотра списка и открытия книг. _{боковая панель поиск /guide list /guide open unlock_tag index горячая перезагрузка}	🧱 Проекция мультиблоков Предпросмотр и пошаговая сборка сложных структур. _{слои вращение зум HUD прогресса NBT}	📝 Движок Markdown Полноценный Markdown, отрисовываемый прямо в интерфейсе. _{таблицы ссылки спойлеры предметы мобы звуки отступы поиск полнотекстовый}	🎬 Мультимедиа Воспроизведение видео, GIF и изображений прямо в книге. _{JavaCV FFmpeg GIF WebP URL полный экран приглушение кэш}
📔 Журнал исследователя Личный блокнот, хранящийся в NBT игрока. Заметки, живой предпросмотр Markdown, чек-листы, таблицы и спойлеры. _{заметки редактор предпросмотр чек-листы markdown NBT синхронизация}	🔭 Сканер руководства ПКМ по блоку, мобу, выпавшему предмету или жидкости — и вы сразу переходите к нужной главе. _{блоки мобы предметы жидкости @bind: @bind_tag: экран выбора}	⌨️ Горячие клавиши руководства Настраиваемые горячие клавиши для открытия книги или журнала без захода в инвентарь. _{B N переназначаемые учитывают инвентарь учитывают Curios}	🎨 Темы и фоны Каждый элемент интерфейса настраивается через JSON, включая фоны глав. _{для каждой книги цвета chapterBackground color image URL эффекты замок}
🖼️ Универсальные изображения Поддержка PNG, JPEG, BMP и GIF везде — иконки, фоны, медиа. _{PNG JPEG BMP GIF локальные серверные URL}	🎒 Интеграция с Curios Опционально. Если установлен Curios, книгу и журнал можно носить в слоте пояса, и они отображаются на модели. _{пояс рендер опционально}	🧩 Хуки модов и квестов Привязки JEI, чекбоксы внутри книги, прогресс, синхронизируемый с сервером. _{@bind: @bind_tag: квесты UUID NBT}	🔒 Блокировка книг Скрывайте книги, пока игроку не выдан тег разблокировки любым источником команд. _{unlock_tag KubeJS FTB Quests достижения}

🔒 Разблокировка книг	▸ Теги разблокировки для каждого игрока: Добавьте `unlock_tag` в любой `book.json`, и книга будет скрыта в меню выбора, пока у игрока нет соответствующего тега. Идеально для обучающих книг, руководств для эндгейма или контента, открывающегося по сюжету. ▸ Управление командами: `/guide unlock <tag>` и `/guide lock <tag>` выдают или отзывают теги; обе принимают необязательный аргумент с игроком (уровень OP 2) для админов. `/guide unlocks` показывает ваши активные теги, `/guide unlocks clear` стирает их все разом. ▸ Дружелюбно к сборкам: Подойдёт любая система, умеющая выполнять команды — события KubeJS, награды FTB Quests, достижения или собственные скриптовые паки. Состояние хранится для каждого игрока в серверном NBT и синхронизируется при входе и после каждого изменения.
📔 Дневник исследователя	▸ Личный блокнот: Предмет `guide_diary` открывает приватный список заметок, хранящихся в NBT игрока. Каждая заметка содержит заголовок, текст, время создания / обновления и координаты + измерение, где она была создана. Заметки переживают перезаходы, смену измерений и переустановку клиента; другие игроки их никогда не увидят, даже на сервере. ▸ Редактор и живой предпросмотр: Редактор — это настоящее многострочное текстовое поле с навигацией курсором, поддержкой буфера обмена (Ctrl+A/C/V/X) и тематической прокруткой, которую можно перетаскивать. Предпросмотр отображает заметку так же, как книга — цвета, стили, ссылки, таблицы, разделители, спойлеры и чек-листы — и обновляется с задержкой 200 мс во время набора. ▸ Интерактивные чек-листы: Флажки в стиле Markdown (`- [ ]` / `- [x]`) переключаются левым кликом в предпросмотре. Состояние хранится внутри самой заметки и сохраняется при каждом клике. Выполненные задачи показывают зелёную галочку и зачёркивание; цвет задачи задаётся префиксом с `&`-кодом перед флажком (`&e- [ ]`, `&c- [ ]`). ▸ Поддержка Markdown в дневнике: Цвета `&0`–`&f`, стили `&l`/`&o`/`&n`/`&m`, сброс `&r`, внешние ссылки `[текст](https://…)`, разделители (`---`, `&6---`, `&l&9---`), таблицы с переносом и прокруткой перетаскиванием, спойлеры (`@spoiler:` / `@endspoiler`) и чек-листы. Редактор на лету преобразует `&x` в `§x`, так что авторам никогда не нужно вводить знак параграфа напрямую. ▸ Сетевая синхронизация: Дневник синхронизируют два пакета — пакет синхронизации (сервер → клиент, отправляется при входе) и пакет обновления (клиент → сервер, отправляется при создании / обновлении / удалении). Конфликты разрешаются по принципу «последняя запись побеждает», без подтверждающего обмена.
🔭 Сканер руководства	▸ Поиск в один клик: Предмет `guide_scanner` определяет registry ID блока, моба, выпавшего предмета или жидкости и ищет его в той же карте привязок, что используют JEI и горячая клавиша `G` (`@bind:` / `@bind_tag:`). Единственное совпадение сразу открывает главу; несколько совпадений открывают тематический экран выбора со сворачиваемым деревом — одна книга развёрнута за раз, главы вложены внутрь, значки глав отображаются. ▸ Рейкаст по сущностям: Использует собственный рейкаст с AABB-клипом, поэтому мелкие выпавшие предметы и тонкие хитбоксы определяются корректно — ванильный рейкаст снарядов их пропускает. ▸ Запасной вариант для жидкостей: Сначала сканирует воду и лаву по ID жидкости, затем откатывается к ID ведра (`water_bucket` / `lava_bucket`), если привязка для самой жидкости не найдена. ▸ Накопительный индекс: Сканер читает из `itemToChapterRefMap` — второго индекса, который переживает перезагрузки книг и охватывает все видимые книги — открывать книгу заранее не нужно.
⌨️ Горячие клавиши руководства	▸ Две горячие клавиши: `B` открывает меню выбора книг, а `N` — дневник. Обе привязаны к категории `Guide` и могут быть переназначены в любой момент в Настройки → Управление → Guide. ▸ Учитывает инвентарь: Каждая клавиша срабатывает, только если соответствующий предмет (`guide_book` или `guide_diary`) находится в основном инвентаре, во второй руке или в слоте Curios. Нет предмета — нет действия: это не позволяет обойти систему разблокировки книг горячей клавишей.
📚 Автономность конфигурации нескольких книг	▸ Компиляция прямо с диска: Автоматически находит и загружает руководства с вашего компьютера по пути `config/guide/books/[book_id]/`. Больше не нужно упаковывать файлы внутрь JAR-архивов модов. ▸ Автоматическая генерация шаблона: При самом первом запуске мод извлекает в папку конфигов полный, готовый к сборке шаблон руководства, защищая ваши собственные файлы от перезаписи при обновлениях сборки. ▸ Чистый выбор книг: Полностью адаптивный каталог книг с активной фильтрацией, аккуратно разделяющий пространства имён книг с нулевыми конфликтами по mod-ID. Порядок книг задаётся необязательным полем `index` в каждом `book.json`.
⚙️ Горячая перезагрузка и удобство для разработки	▸ Смена вёрстки на лету (`/guide reload`): Редактируйте markdown-файлы, узлы вёрстки, текстуры или JSON-таблицы локализации прямо на диске и мгновенно обновляйте память руководства в игре. Доступно всем игрокам по умолчанию, без прав оператора и читов. ▸ Быстрый доступ через чат (`/guide`): Отдельная команда в чате, которая из любого места отправляет игрока прямо в главный каталог книг, избавляя от привязки к предметам. ▸ Список книг и прямое открытие: `/guide list` выводит все книги, видимые клиенту (с индексом, пространством имён, флагом разработчика и отображаемым именем); `/guide list server` показывает, что раздаёт сервер; `/guide open <namespace>` открывает любую книгу по ID с автодополнением. ▸ Ярлыки предметов: `/guide give <book\|scanner\|diary> [player]` выдаёт соответствующий предмет-руководство прямо в инвентарь, а если инвентарь полон — использует `player.drop()`. Есть секундная задержка на игрока и автодополнение для псевдонимов и игроков. ▸ Переключатель режима разработчика: Скрывайте обучающие руководства или шаблоны от игроков через `config/guide/guide-client.toml`, оставляя их активными для разработчиков.
🧭 Улучшенная навигация и курсор поиска	▸ Переработанное поле поиска: Оснащено аккуратным вертикальным курсором (`\|`), который безупречно отрабатывает перемещение и выделение текста как на английской, так и на кириллической раскладках клавиатуры. ▸ Умные подменю в боковой панели: Плавно вкладывает выпадающие подглавы (`@submenu:`) и спойлеры за кликами, оптимизируя частоту кадров и предотвращая обрезку вёрстки. ▸ Надёжное сохранение состояния и истории: Память навигации запоминает развёрнутое состояние подменю боковой панели, а зоны клика текстовых гиперссылок математически точно следуют за строками при любом смещении динамической полосы прокрутки. ▸ Полнотекстовый поиск: Поиск в боковой панели сканирует содержимое глав, а не только заголовки. При вводе запроса открывается окно с фрагментами вокруг каждого совпадения, сгруппированными по главам. Нажмите на фрагмент, чтобы открыть главу, прокрутить её до найденной строки и подсветить запрос на месте. Боковая панель также оставляет главы, совпавшие только по содержимому. ▸ Поиск внутри главы (Ctrl+F): Панель поиска в стиле браузера открывается внизу области главы. Каждое совпадение подсвечивается (активное — другим цветом); переключайтесь между совпадениями с помощью `↑` / `↓` или `Enter` / `Shift+Enter`, с живым счётчиком `N / M`. Спойлеры с совпадением раскрываются автоматически; спойлеры без совпадений остаются свёрнутыми. Цвета подсветки поиска настраиваются через `searchHighlightColor` и `searchHighlightCurrentColor`.
🧩 Продвинутый рендеринг контента	▸ Поддержка естественных отступов: Markdown-движок полностью учитывает блоки пробелов и табов в начале текста, позволяя строить структурированные вложенные списки без сбоя зон гиперссылок. ▸ Прямая трансляция медиа: Отображает статичные изображения (`@image:`) и анимированные GIF-файлы (`@gif:`) прямо из локальной папки книги, полностью устраняя глюк с шахматной текстурой-заглушкой. Поддерживаются PNG, JPEG, BMP и GIF (первый кадр). ▸ 3D-модели предметов и блоков (`@item:`): Отображает вращающиеся 3D-модели предметов и блоков прямо на странице. Размер задаётся для каждого экземпляра (16–128 px), выравнивание настраивается (слева / по центру / справа), а и плоские предметы, и полноценные блоки соблюдают заданный размер. Наведите курсор для подсказки с registry ID и названием мода. ▸ Объединённая проекция мультиблочных NBT: 3D-проектор голограмм (`PlacementProjector`) и рендерер страниц (`StructureRenderer`) собирают `.nbt`-шаблоны прямо из папки конфигов. Авторы могут встраивать мультиблочные структуры прямо в свои руководства без внешних датапаков.
🎬 Встроенная медиасистема	▸ Воспроизведение видео: Проигрывайте локальные и удалённые видеофайлы (`mp4`, `avi`, `mkv`, `webm`) прямо на страницах руководства с помощью команды `@video:`. Поддерживаются прямые HTTP(S)-ссылки с автоматическим кэшированием, а также встроен собственный плеер с воспроизведением/паузой, остановкой, повтором, ползунком громкости, полноэкранным режимом и перетаскиваемой полосой прогресса с поддержкой перемотки. ▸ Поддержка GIF и URL изображений: Используйте прямые HTTP(S)-ссылки в `@gif:` и `@image:` для загрузки анимированных GIF и статичных изображений (PNG, JPEG) из интернета. Файлы кэшируются в `config/guide/cache/media/` для повторного использования офлайн. ▸ Интеграция звука: Используйте команду `@sound:`, чтобы встроить кликабельные кнопки звука, проигрывающие пользовательские аудиофайлы из папки `sounds/` книги. Поддерживается воспроизведение на каждой странице с автоматическим приглушением музыки. ▸ Умное приглушение фоновой музыки: Когда начинается видео или пользовательский звук, мод автоматически ставит фоновую музыку на паузу и возобновляет её после окончания воспроизведения. ▸ Безопасность только для клиента: Все медиадекодеры, загрузчик нативной библиотеки FFmpeg, мост JavaCV и загрузчик текстур помечены `@OnlyIn(Dist.CLIENT)`. Выделенные серверы никогда не скачивают бинарники FFmpeg и не затрагивают клиентский видеокод.
🎨 Темы и фоны глав	▸ Полностью настраиваемый интерфейс: Каждый элемент интерфейса — панели, рамки, кнопки, полосы прокрутки, таблицы, медиаплеер, проектор — задаётся JSON-файлом темы. Пользовательские темы размещаются в `config/guide/themes/` (клиент или сервер). ▸ Переопределения для отдельных книг: Укажите поле `theme` в `book.json`, чтобы принудительно задать конкретную тему для книги; глобальная тема восстанавливается при закрытии книги. Приоритет: тема книги > заблокированная тема > глобальная тема. ▸ Фоны глав: Темы могут переопределять стандартный фон главы с помощью блока `chapterBackground` — сплошной цвет (с настраиваемой прозрачностью) или изображение. Изображения могут быть локальным файлом, файлом на стороне сервера или прямой ссылкой (скачивается и кэшируется автоматически). ▸ Встроенные визуальные эффекты: Необязательные эффекты для каждой темы: `bloodEffects`, `forestEffects`, `cyberTechEffects`, `matrixEffects`, `sakuraEffects`, `honeyEffects`.
🔗 Интеграция с модами и квестами	▸ Живые чекбоксы с серверной синхронизацией: Включает интерактивную систему квестов клиент-сервер. Завершения квестов привязаны к UUID игроков и надёжно сохраняются внутри серверной структуры NBT, защищая файлы прогресса от локальных сбросов данных. ▸ Готовность к навигации в JEI: Привязывайте главы к конкретным предметам с помощью `@bind:mod_id:item`, чтобы открывать соответствующие страницы руководства прямо в JEI, или кликайте по предметам-указателям руководства, чтобы мгновенно открыть активные листы рецептов. ▸ Слот пояса Curios: Книга и журнал объявляют совместимость со слотом `belt` Curios через тег данных. Когда Curios установлен, надетый предмет отображается на модели игрока, а клавиши `B` / `N` подбирают его оттуда, как если бы он был в инвентаре. Curios — мягкая зависимость: мод загружается и работает без него.

⌨️ Команда	Описание
`/guide`	Открывает основной каталог книг откуда угодно — предмет не нужен
`/guide reload`	Горячая перезагрузка всех markdown-файлов, текстур, JSON и тем без перезапуска игры
`/guide list`	Показывает все книги, видимые клиенту. Клик по строке вставляет `/guide open <namespace>` в чат; при наведении — подробности
`/guide list server`	Показывает книги, которые сейчас раздаёт сервер. Во всплывающей подсказке — индекс, namespace, метка разработчика и путь на диске
`/guide open <namespace>`	Открывает конкретную книгу по namespace прямо из чата. Поддерживает автодополнение по Tab
`/guide give <book\|scanner\|diary>` `[player]`	Выдаёт предмет Guide в ваш инвентарь или в инвентарь другого игрока с OP 2. Если инвентарь полон, срабатывает `player.drop()`. Кулдаун — 1 секунда на игрока
`/guide unlock <tag>` `[player]`	Выдаёт тег разблокировки себе или другому игроку (для других игроков нужен OP 2)
`/guide lock <tag>` `[player]`	Забирает тег разблокировки у себя или у другого игрока (для других игроков нужен OP 2)
`/guide unlocks`	Показывает все теги разблокировки, которые у вас есть
`/guide unlocks clear` `[player]`	Стирает все теги разблокировки у вас или у другого игрока с OP 2. Полезно для тестирования и админской уборки

_{▸ Все команды, кроме /guide list server, серверной части /guide reload и вариантов unlock / lock / give с указанием игрока, доступны всем игрокам по умолчанию — ни OP, ни читы не нужны.}

	⚙️ Загрузчик	🎮 Игра	📦 Версия	☕ JDK	🚦 Статус	🌿 Ветка
	Forge	`1.20.1`	`1.8.0+`	`17`	🟢 Стабильно	`forge-1.20.1`
	NeoForge	`1.21.1`	`1.6.0+`	`21`	🟢 Стабильно	`neoforge-1.21.1`

_{▸ Обе ветки имеют одинаковый набор функций — мультимедиа, рендеринг Markdown, проекция мультиблоков и блокировка книг на одном уровне. Одно небольшое отличие: на Forge клик правой кнопкой мыши по слоту пояса Curios открывает экран надетого предмета (через ICurioItem.curioRightClick); на NeoForge это больше не часть Curios API, так что используйте клавишу N / B.}

🧩 JEI	Привязывайте главы к предметам с помощью `@bind:mod_id:item`. Кликайте по переходам к предметам в руководстве, чтобы мгновенно открыть рецепты. Необязательно — руководство отлично работает и без него.
🎒 Curios	Мягкая зависимость. Если установлен, `guide_book` и `guide_diary` можно надеть в слот пояса; надетый предмет отображается на модели игрока, а клавиши `B` / `N` достают его оттуда. Сам слот появляется автоматически у любого игрока после загрузки мода — ручная настройка не требуется.
🎬 FFmpeg / JavaCV / JavaCPP	Декодирование видео, транскодирование и покадровый доступ к медиа через нативные бинарники FFmpeg, обёрнутые JavaCV и собранные через JavaCPP для Windows, macOS и Linux.
💾 Кэш медиа	Автоматическое приглушение фоновой музыки во время воспроизведения видео / звука, а также офлайн-кэширование медиа.
🔒 KubeJS / FTB Quests / Достижения	Блокировка книг цепляется к чему угодно, что может отправить команду. Выдавайте теги через `/guide unlock <tag>` из событий KubeJS, наград FTB Quests, функций достижений или скриптовых пакетов.

config/guide/books/<book_id>/
├── chapters/           # Разделы с содержимым
│   ├── index.md        # Основной индекс
│   ├── introduction.md # Первая глава
│   └── <language>/     # Файлы для конкретного языка
├── lang/               # Локализация
│   ├── en_us.json
│   └── <language>.json
├── models/             # Данные 3D-моделей
├── sounds/             # Фоновое аудио (.ogg)
├── videos/             # Локальные видеофайлы
├── textures/           # Ресурсы интерфейса и изображения
├── structures/         # Мультиблочные чертежи .nbt
└── book.json           # Метаданные

📄 Пример book.json:{   "name": "<book_id>.book.guide",   "namespace": "<book_id>",   "default_chapter": "introduction",   "icon": "your_logo.png",   "bg_music": "background_music",   "theme": "<theme_id>",   "dev_only": false,   "index": 0,   "unlock_tag": "" }
_{▸ index необязателен. По нему книги сортируются в списке выбора (меньше — раньше). Книги без index попадают в конец и сортируются по namespace.}
_{▸ unlock_tag необязателен. Оставь пустым, чтобы книга была доступна всем; укажи тег (например, "secret"), чтобы скрыть книгу, пока игрок не получит этот тег через /guide unlock secret. Теги привязаны к игроку и сохраняются между сессиями.}

Каждый элемент интерфейса настраивается через JSON. Пользовательские темы лежат в config/guide/themes/ — скопируй шаблон ниже, поменяй цвета и сохрани как новый файл (например, my_theme.json).
Два отдельных цвета управляют и панелью Ctrl+F, и оверлеем полнотекстового поиска: searchHighlightColor (все совпадения) и searchHighlightCurrentColor (активное совпадение). Встроенные палитры идут с настроенными значениями по умолчанию для каждой темы.
Каждая тема также может задавать свой фон глав — сплошной цвет или изображение, которое заменяет стандартный фон для всех глав в книгах, использующих эту тему.
📄 Пример standard.json (config/guide/themes/standard.json):{   "id": "standard", // уникальный идентификатор темы   "displayName": "guide.theme.standard", // отображаемое имя (обычная строка или ключ перевода)   "chapterBackground": { // необязательная замена фона глав     "type": "color", // "color" или "image"     "value": "0x0A0A0A", // RGB-цвет (0xRRGGBB), когда type = "color"     "alpha": 230 // 0 = прозрачный, 255 = непрозрачный   },   "colors": {
// ===== Общий интерфейс =====     "panelBackgroundColor": "0xCC1A1A1A", // фон панелей (страницы книги, боковые меню)     "panelHeaderBackgroundColor": "0xCC111111", // фон заголовка панели     "borderColor": "0xFF4A4A4A", // рамка панелей и окон по умолчанию     "borderFocusedColor": "0xFF00D0FF", // рамка элемента в фокусе     "textColor": "0xFFFFFF", // основной цвет текста     "textSecondaryColor": "0x888888", // вторичный текст     "scrollbarTrackColor": "0x55111111", // фон дорожки полосы прокрутки     "scrollbarThumbColor": "0xFF8B8B8B", // ползунок полосы прокрутки     "buttonColor": "0xFF2A2A2A", // кнопка по умолчанию     "buttonHoverColor": "0xFF3A3A3A", // кнопка при наведении     "buttonDisabledColor": "0xFF1A1A1A", // неактивная кнопка
// ===== Поля ввода =====     "editBoxBackgroundColor": "0xFF000000", // фон поля ввода     "editBoxBorderColor": "0xFFA0A0A0", // рамка поля ввода     "editBoxBorderFocusedColor": "0xFFFFFFFF", // рамка поля ввода в фокусе     "editBoxTextColor": "0xFFFFFF", // текст поля ввода
// ===== Подсветка поиска (Ctrl+F) =====     "searchHighlightColor":         "0x80FFEB3B",       // подсветка всех совпадений     "searchHighlightCurrentColor":  "0xC0FF9800",       // текущее активное совпадение
// ===== Медиаплеер =====     "mediaFrameOuterColor": "0xFF2D2D2D", // внешняя рамка медиа     "mediaFrameInnerColor": "0xFF4A4A4A", // внутренняя рамка медиа     "mediaBackgroundColor": "0xFF000000", // фон области воспроизведения     "mediaControlPanelColor": "0xCC000000", // фон панели управления     "mediaTextColor": "0xFFAAAAAA", // текст медиаплеера     "mediaErrorTextColor": "0xFFFF5555", // текст ошибки     "mediaTimeTextColor": "0xFFCCCCCC", // текст времени воспроизведения     "progressBarTrackColor": "0xFF555555", // фон дорожки прогресс-бара     "progressBarFillColor": "0xFF00D0FF", // заполнение прогресс-бара     "progressBarThumbColor": "0xFFFFFFFF", // ползунок прогресс-бара     "progressBarThumbOutlineColor": "0xFF000000", // обводка ползунка прогресс-бара
// ===== Встроенные элементы =====     "spoilerTitleColor": "0xFFAA00", // заголовок спойлера     "inlineItemBackgroundColor": "0x550A0A0A", // фон встроенного предмета     "inlineItemBorderColor": "0x25FFFFFF", // рамка встроенного предмета     "inlineItemTextColor": "0xFFAAAAAA", // текст встроенного предмета     "soundButtonBackgroundColor": "0xFF2E2E2E", // фон кнопки звука     "soundButtonBorderColor": "0xFF5A5A5A", // рамка кнопки звука     "soundButtonTextColor": "0xFFFFFF", // текст кнопки звука     "questStrikethroughColor": "0x77777777", // зачёркнутый текст задания
// ===== Таблицы =====     "tableHeaderBackgroundColor": "0xFF222222", // фон заголовка таблицы     "tableHeaderTextColor": "0xFFAA00", // текст заголовка таблицы     "tableRowBackgroundColor": "0x11000000", // фон чередующихся строк     "tableBorderColor": "0xFF3A3A3A", // рамки таблицы     "tableCellTextColor": "0xFFFFFF", // текст ячеек таблицы     "dividerColor": "0xFF3A3A3A", // разделители блоков
// ===== Заголовок видео =====     "videoTitleBackgroundColor": "0xCC2D2D2D", // фон панели заголовка видео     "videoTitleBorderColor": "0xFF5A5A5A", // рамка панели заголовка видео     "videoTitleTextColor": "0xFFFFFF", // текст заголовка видео
// ===== Предупреждения и уведомления =====     "warningTextColor": "0xFF5555", // основной текст предупреждения     "warningTextSecondaryColor": "0xFFAAAAAA", // вторичный текст предупреждения     "toastBackgroundColor": "0xD0101215", // фон всплывающего уведомления     "toastTextColor": "0xFFFFFF", // текст всплывающего уведомления
// ===== Панель структур =====     "structureFrameColor": "0x4000FFFF", // рамка 3D-превью структуры     "structureTabActiveBackgroundColor": "0xFF555555", // фон активной вкладки     "structureTabInactiveBackgroundColor": "0xFF222222", // фон неактивной вкладки     "structureTabActiveTextColor": "0x00FFCC", // текст активной вкладки     "structureTabInactiveTextColor": "0x888888", // текст неактивной вкладки     "structureLayerTextColor": "0x55FF55", // подпись слоя структуры
// ===== Placement Projector =====     "projectorPanelBackgroundColor": "0xD0101215", // фон панели проектора     "projectorPanelBorderColor": "0x4000D0FF", // рамка панели проектора     "projectorTitleTextColor": "0x00D0FF", // заголовок панели проектора     "projectorButtonBackgroundColor": "0x15FFFFFF", // фон кнопки по умолчанию     "projectorButtonHoverBackgroundColor": "0x3000D0FF", // фон кнопки при наведении     "projectorButtonBorderColor": "0x25FFFFFF", // рамка кнопки по умолчанию     "projectorButtonHoverBorderColor": "0xFF00D0FF", // рамка кнопки при наведении     "projectorButtonTextColor": "0xBBBBBB", // текст кнопки     "projectorButtonHoverTextColor": "0xFFFFFF", // текст кнопки при наведении     "projectorDoneButtonHoverBackgroundColor": "0x3000FF55", // фон кнопки "Done" при наведении     "projectorDoneButtonHoverBorderColor": "0xFF00FF55", // рамка кнопки "Done" при наведении     "projectorCancelButtonHoverBackgroundColor": "0x30FF2244", // фон кнопки "Cancel" при наведении     "projectorCancelButtonHoverBorderColor": "0xFFFF2244", // рамка кнопки "Cancel" при наведении     "projectorHudTextColor": "0xFFFFFF" // текст подсказки HUD проектора   } }
🖼️ Фон главы (необязательно)Добавь блок chapterBackground в свою тему, чтобы переопределить фон по умолчанию (размытие на NeoForge, градиентная накладка на Forge). Поддерживаются три типа источников:
// Сплошной цвет с альфой (0 = прозрачный, 255 = непрозрачный) "chapterBackground": {   "type": "color",   "value": "0x1A0F2E",   "alpha": 230 }
// Локальное изображение или изображение на стороне сервера (ищется относительно текущей папки книги) "chapterBackground": {   "type": "image",   "path": "textures/bg/my_bg.png" }
// Прямая ссылка (скачивается в фоне, кэшируется на диске) "chapterBackground": {   "type": "image",   "path": "https://example.com/background.jpg" }
_{▸ Полностью пропусти chapterBackground, чтобы оставить фон по умолчанию. Изображения по ссылке появляются с небольшой задержкой при первой загрузке; при последующих открытиях используется кэш. Поддерживаются PNG, JPEG, BMP и GIF (первый кадр).}
Цвета записываются в формате 0xAARRGGBB:
Канал Диапазон Описание
AA 00 – FF Альфа-канал (прозрачность). FF = полностью непрозрачный, 00 = полностью прозрачный
RR 00 – FF Красный канал
GG 00 – FF Зелёный канал
BB 00 – FF Синий канал
_{▸ Совет: установите альфу ниже FF (например, 80), чтобы сделать панели полупрозрачными.}
Компонент Минимум Рекомендуется Примечания
Minecraft 1.20.1 · 1.21.1 1.20.1 или 1.21.1 Выберите ветку под ваш загрузчик
Загрузчик Forge 47.x+
NeoForge 21.x+ Последний стабильный релиз Нужен только один — выбирайте по ветке
Java JDK 17
JDK 21 17 для Forge
21 для NeoForge Версия должна соответствовать ветке загрузчика
JEI _{(опционально)} — Последняя для вашей сборки MC Нужен только для интеграции рецептов через @bind:
Curios _{(опционально)} — Последняя для вашей сборки MC Нужен только для интеграции слота пояса и отрисовки на модели
_{▸ Гайд работает автономно — JEI, Curios, Quests и другие интеграции полностью опциональны.}
Нашли баг или столкнулись с крашем? Откройте тикет в трекере задач.
Необходимая информация Пример
Версия Minecraft 1.20.1 · 1.21.1
Загрузчик + версия Forge 47.4.20+ · NeoForge 21.1.0+
Версия мода Guide 1.8.0 · 1.6.0-NeoForge
Связанные моды Список модов, которые могут взаимодействовать с Guide (JEI, Curios и т. д.)
Скриншоты Прикрепите, если проблема связана с вёрсткой
Отчёт о краше Полный latest.log или crash-report в блоке кода
_{▸ Чем больше деталей вы предоставите, тем быстрее удастся решить проблему.}
✦ 🧩 Проект 👤 Автор / Команда ⚡ Вклад
🧩 Just Enough Items _(JEI) mezz Интеграция рецептов в игре
🎒 Curios TheIllusiveC4 Фреймворк слотов, использованный для интеграции пояса
⚒️ Minecraft Forge LexManos · cpw Экосистема FML · инструменты MCP
🦊 NeoForge NeoForge Team Современная платформа для моддинга на 1.21.1
🎬 JavaCV bytedeco Кроссплатформенная Java-обёртка для нативных медиабиблиотек
🎬 JavaCPP bytedeco Нативные привязки и готовые бинарники для FFmpeg / OpenCV
🎞️ FFmpeg FFmpeg Team Декодирование, транскодирование видео и работа с потоками
💙 Сообщество открытого исходного кода Everyone Баг-репорты, документация и поддержка
Лицензировано под MIT License.
Вы можете включать Guide в свой модпак.
Любой модпак, использующий Guide, несёт полную ответственность за запросы пользователей по поддержке.
Мы поддерживаем только официальные сборки, а не кастомные изменённые jar-файлы.

Канал	Диапазон	Описание
`AA`	`00` – `FF`	Альфа-канал (прозрачность). `FF` = полностью непрозрачный, `00` = полностью прозрачный
`RR`	`00` – `FF`	Красный канал
`GG`	`00` – `FF`	Зелёный канал
`BB`	`00` – `FF`	Синий канал

Компонент	Минимум	Рекомендуется	Примечания
Minecraft	`1.20.1` · `1.21.1`	`1.20.1` или `1.21.1`	Выберите ветку под ваш загрузчик
Загрузчик	`Forge 47.x+` `NeoForge 21.x+`	Последний стабильный релиз	Нужен только один — выбирайте по ветке
Java	`JDK 17` `JDK 21`	`17` для Forge `21` для NeoForge	Версия должна соответствовать ветке загрузчика
JEI _{(опционально)}	—	Последняя для вашей сборки MC	Нужен только для интеграции рецептов через `@bind:`
Curios _{(опционально)}	—	Последняя для вашей сборки MC	Нужен только для интеграции слота пояса и отрисовки на модели

Необходимая информация	Пример
Версия Minecraft	`1.20.1` · `1.21.1`
Загрузчик + версия	`Forge 47.4.20+` · `NeoForge 21.1.0+`
Версия мода Guide	`1.8.0` · `1.6.0-NeoForge`
Связанные моды	Список модов, которые могут взаимодействовать с Guide (JEI, Curios и т. д.)
Скриншоты	Прикрепите, если проблема связана с вёрсткой
Отчёт о краше	Полный `latest.log` или `crash-report` в блоке кода

✦	🧩 Проект	👤 Автор / Команда	⚡ Вклад
🧩	Just Enough Items _(JEI)	`mezz`	Интеграция рецептов в игре
🎒	Curios	`TheIllusiveC4`	Фреймворк слотов, использованный для интеграции пояса
⚒️	Minecraft Forge	`LexManos` · `cpw`	Экосистема FML · инструменты MCP
🦊	NeoForge	`NeoForge Team`	Современная платформа для моддинга на 1.21.1
🎬	JavaCV	`bytedeco`	Кроссплатформенная Java-обёртка для нативных медиабиблиотек
🎬	JavaCPP	`bytedeco`	Нативные привязки и готовые бинарники для FFmpeg / OpenCV
🎞️	FFmpeg	`FFmpeg Team`	Декодирование, транскодирование видео и работа с потоками
💙	Сообщество открытого исходного кода	`Everyone`	Баг-репорты, документация и поддержка

Частые вопросы

Как установить Guide?

Установите NeoForge под свою версию Minecraft, скачайте Guide под ту же версию и загрузчик, положите файл в папку mods и запустите игру с профилем загрузчика.

Для каких версий Minecraft есть Guide?

У Guide есть сборки для Minecraft 1.20.1, 1.21.1.

Нужен ли Guide на сервере?

Нужен и в игре, и на сервере

Лицензия и источник

MIT Licenseможно свободно использовать и распространять с указанием автора

Оригинал — Modrinth↗Файлы — без изменений, проверены по SHA-512Это ваш мод? Правообладателям

Скачать для моей игры

Скачать1.7.0 · для 1.21.1 · NeoForge · 9,13 МБ

Все версии (24)без таймеров и рекламы

Скачать1.7.0 · 9,13 МБ

Совместимость

Загрузчики

NeoForgeForge

Версии игры1.20.1, 1.21.1

1.211.21.1

1.201.20.1

Показать все · 2 версииСвернуть

Где нужен

В игреобязателенНа сервереобязателен

Нужен и в игре, и на сервере

Лицензия и источник

MIT Licenseможно свободно использовать и распространять с указанием автора

Оригинал — Modrinth↗Файлы — без изменений, проверены по SHA-512Это ваш мод? Правообладателям

Ссылки

Исходный код↗Баг-трекер↗Discord↗

Авторы

deaddieselВладелец

Коротко о моде

📚 Интерактивные книги

🧱 Проекция мультиблоков

📝 Движок Markdown

🎬 Мультимедиа

📔 Журнал исследователя

🔭 Сканер руководства

⌨️ Горячие клавиши руководства

🎨 Темы и фоны

🖼️ Универсальные изображения

🎒 Интеграция с Curios

🧩 Хуки модов и квестов

🔒 Блокировка книг

🔒 Разблокировка книг

📔 Дневник исследователя

🔭 Сканер руководства

⌨️ Горячие клавиши руководства

📚 Автономность конфигурации нескольких книг

⚙️ Горячая перезагрузка и удобство для разработки

🧭 Улучшенная навигация и курсор поиска

🧩 Продвинутый рендеринг контента

🎬 Встроенная медиасистема

🎨 Темы и фоны глав

🔗 Интеграция с модами и квестами

Частые вопросы

Похожие моды