§6Глава 14: Создание книги

§7В этой главе вы узнаете, как добавить кастомный гайд через папку конфигураций, настроить его отображение в меню и полностью изолировать ресурсы путеводителя.
§6---
§bСтруктура папок в конфигах

§7Для изменения существующего руководства или создания новой книги перейдите в папку конфигураций вашей сборки:
§6`.minecraft/config/guide/books/[id_книги]/`

§7При первом запуске мода система автоматически сгенерирует готовый скелет-шаблон, защищённый от затирания:

    • §6`book.json`§7 — конфигурация книги (название, иконка, стартовая глава)
    • §6`chapters/`§7 — папка с файлами глав `.md` на английском (по умолчанию)
    • §6`chapters/ваш_язык/`§7 — папка с главами на вашем языке (опционально)
    • §6`lang/`§7 — файлы кастомных языковых переводов (например, `[ваш_язык].json`)
    • §6`textures/`§7 — кастомные картинки и логотипы (например, `textures/images/`)
    • §6`models/`§7 — кастомные модели
    • §6`structures/`§7 — кастомные структуры
§6---
§bНастройка book.json

§7Каждая книга обязана иметь свой файл §6`book.json`§7 в корне своей папки. Вы можете указать в качестве иконки как стандартный предмет, так и путь к собственной картинке:

    §6`{
    §7  "name": "[id_книги].manual.title",
    §7  "icon": "[id_книги]:textures/images/custom_icon.png",
    §7  "default_chapter": "intro",
    §7  "dev_only": false
    §6}`
§6---
§bНастройка book.json
§7Каждая книга обязана иметь свой файл §6`book.json`§7 в корне своей папки. Вы можете указать в качестве иконки как стандартный предмет, так и путь к собственной картинке:

    §6`{
    §7  "name": "[id_книги].manual.title",
    §7  "icon": "[id_книги]:textures/images/custom_icon.png",
    §7  "default_chapter": "intro",
    §7  "dev_only": false
    §6}`

§7Параметры:
§e`name`§7 — ключ локализации для названия вашей книги в меню (lang)
§e`icon`§7 — ID предмета или путь к кастомной картинке 16x16 в формате ResourceLocation.

§7Примеры заполнения параметра `§eicon§7`:

  - §6`"minecraft:book"`§7 — использовать ванильную книгу в качестве иконки.
  - §6`"twilightforest:minoshroom_trophy"`§7 — использовать предмет из другого мода.
  - §6`"[id_книги]:textures/images/custom_icon.png"`§7 — использовать кастомную текстуру `.png` из папки `textures/images/` вашей книги на диске.

    §e`default_chapter`§7 — имя файла стартовой главы книги (без .md)
    §e`dev_only`§7 — если `§6true§7`, книга скроется от обычных игроков
§6---
§bЛокализация названия

§7Добавьте перевод названия книги в файл локализации на диске:

    §6`config/guide/books/[id_книги]/lang/[ваш_язык].json`
    §6`{
    §7  "[id_книги].manual.title": "§6Кастомное руководство§7"
    §6}`

§7Система на лету инжектирует эти строки напрямую в память игры.
§6---
§bСкрытие руководства разработчика

§7Если вы используете §6Guide§7 как библиотеку, дефолтное руководство по умолчанию скрыто для игроков.
§7Чтобы включить или выключить его, откройте клиентский конфиг сборки:
§6`config/guide/guide-client.toml`
§7Найдите параметр:
§6`show_dev_manual = true`

§7Установите §6false§7, чтобы скрыть мануал. Разработчики модпаков могут изменять это значение по своему усмотрению.
§6---
§bКак это работает в 1.2.1:

    §7• При старте §6BookRegistry§7 сканирует внешнюю директорию §6config/guide/books/§7
    §7• Каждая книга имеет высший приоритет диска и полностью изолирована по своему имени папки
    §7• Любые изменения, внесённые вами в конфиг, никогда не будут затёрты JAR-файлом мода
    §7• Меню выбора (§6BookSelectorScreen§7) отрисовывает список книг на основе папок диска
    §7• При клике открывается §6GuideScreen§7, загружающий `.md` тексты, гифки и картинки напрямую из папки книги
§6---
§bСоветы

    • §e`Горячая перезагрузка`§7 — используйте клиентскую команду §6`/guide reload§7 для мгновенного обновления текстов, квестов и картинок прямо во время игры, без перезапуска Майнкрафта!
    • §e`Картинки и гифки`§7 — вы можете вызывать медиафайлы прямо из папки книги, указывая путь через её имя: §6`@image:[id_книги]:textures/images/logo.png`§7.
    • §e`Сторонние моды`§7 — теги предметов §6`@item:`§7 и мобов §6`@mob:`§7 автоматически поддерживают ID из любых чужих модов, если они установлены в сборке.
§6---
§7§lСмотрите также:
[Горячая перезагрузка](hot_reload) §7| [Картинки и Анимации](images_and_gifs) §7| [Интеграция кнопки](g_key_integration)
