Книга-путеводитель

alaindustrial:guide_book

Утилитарные блокиРеализованоguide-booktutorialonboardingdocumentationutility

Сводка

Книга-путеводитель — внутриигровой учебник по моду Ala Industrial. Новый игрок попадает в мир с нетривиальной механикой (EU/FE вместо FE, тиры напряжения LV/MV/HV, кабели с потерями, порты граней у машин) и без встроенного туториала вынужден гадать или читать внешнюю вики. Книга снимает барьер входа: игрок получает её в инвентарь автоматически при первом появлении в мире (ровно один раз), открывает правым кликом — на весь экран, с вкладками и постраничной навигацией — и по главам доходит до первой рабочей энергосети и машины, не выходя из игры. Книга энергии не требует и ничего не «делает» механически — это чистое чтиво. Её содержимое собрано из того же источника, что и вики-сайт мода, поэтому числа в книге не расходятся с игрой.

Мини-пример: зашли в новый мир → в инвентаре лежит «Книга-путеводитель» → ПКМ → открывается экран с вкладкой «С чего начать» → кликаете по ссылке «Солнечная панель» → читаете, сколько EU/FE она даёт и как её скрафтить.

Как получить

Автовыдача при первом входе. При первом заходе игрока в мир книга кладётся ему в инвентарь ровно один раз. Флаг «кому уже выдано» хранится в per-world сохранёнке (SavedData с множеством UUID) — переживает смерть/респавн/смену измерения и не дублирует выдачу при повторных входах. Существующие игроки при обновлении мода тоже получают книгу один раз: их UUID ещё нет во множестве «выдано» → при первом входе после апдейта книга выдаётся и UUID добавляется. Восстановление при потере — две страховки, обе НЕ гейтят автовыдачу: крафт (дешёвый, LV-доступный, без гейта за схемой); команда /alaindustrial guide (переиспользует существующий /ala-command; выдаёт/открывает книгу). Игрок никогда не остаётся без туториала. Если инвентарь полон при автовыдаче — книга выпадает под ноги игрока (не теряется).

Интерфейс

Открывается по ПКМ — полноэкранное окно (не сундук: слотов и инвентаря нет). Состоит из: Вкладки (главы верхнего уровня) слева/сверху — повторяют группировку категорий вики-сайта плюс ведущая онбординг-секция:

1. С чего начать (Getting Started) — ручной онбординг: первый генератор → первый кабель →

первая машина;

1. Энергия — что такое EU/FE, тиры LV/MV/HV, кабели и потери по длине, порты граней;
2. Генераторы, 4. Машины, 5. Накопители, 6. Передача энергии,
3. Материалы, 8. Предметы и инструменты, 9. Компоненты, 10. Утилиты.

Список записей внутри вкладки (по одной на блок/предмет/механику), с прокруткой. Страница записи — разворот с постраничной навигацией (стрелки вперёд/назад) и кнопкой «назад» к списку. Кликабельные ссылки внутри текста — переход к другой записи (и, в v1.1, к якорю внутри неё). Виджет рецепта на странице — сетка крафта/переработки (рисует ингредиенты и результат; работает и без установленных JEI/REI). Текст переносится по строкам, а длинные списки прокручиваются. Визуально книга выдержана в стиле мода — та же палитра и панели-бевелы, что и в остальных интерфейсах.

Контент

Книга покрывает все блоки и предметы, которые уже есть в игре: для каждого — краткое описание, характеристики (тир, EU/FE, буфер) и рецепт крафта. Числа в книге (EU/FE, тиры, буферы, рецепты) берутся из того же источника, что и вики-сайт мода, поэтому они всегда совпадают с игрой — расхождений нет. Ещё не добавленные и планируемые блоки в книгу не попадают: она не обещает того, чего пока нет в игре. Обрамляющие главы «С чего начать» и «Энергия» написаны как вводный туториал для новичка.

Свойства блока

Книга — предмет (не блок): не ставится в мир, стак до 1, без EU/FE-буфера. «Форма» — обычная предметная модель (models/item/guide_book.json → item/generated с иконкой textures/item/guide_book.png). Правым кликом открывает GUI (см. «Интерфейс»); никакой блок в мире не размещается, коллизий нет.

Рецепты

Крафт — супер-простой shapeless: ванильная minecraft:book + (деревянная шестерня — самый ранний, дешёвый компонент мода). Без гейта за схемой (книга и так выдаётся автоматически; крафт — только для восстановления после потери).

Прогрессия

Тир: none (утилита, не часть энерго-цепочки). Доступна сразу — это точка входа в прогрессию, а не её ступень. Ведёт игрока по реальной прогрессии мода (руда → генератор → кабель → машина → тиры).

Локализация

v1: en_us + ru_ru — полный контент глав (источник — en_us, как во всём моде). Остальные 18 языков получают переведённое название предмета, а содержимое глав пока показывается на английском; полный перевод глав — позже. Весь текст книги — через lang-ключи; хардкод-строк нет (правило проекта).

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

Просмотрщики рецептов (JEI/REI/EMI): книга самодостаточна (встроенный recipe-виджет по ID), не требует их. Deep-link «открыть рецепт в JEI/REI» — v2. Полнотекстовый поиск по содержанию — v2.

Связанное

Книга собрана из того же источника, что и вики-сайт мода: то же содержимое и те же числа, но прямо в руках у игрока.

Крафт

Бесформенный крафт

▶

Книга-путеводитель