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

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) — ручной онбординг: первый генератор → первый кабель → первая машина;
  2. Энергия — что такое EU/FE, тиры LV/MV/HV, кабели и потери по длине, порты граней;
  3. Генераторы, 4. Машины, 5. Накопители, 6. Передача энергии,
  4. Материалы, 8. Предметы и инструменты, 9. Компоненты, 10. Утилиты.
• Список записей внутри вкладки (по одной на блок/предмет/механику), с прокруткой.
• Страница записи — разворот с постраничной навигацией (стрелки вперёд/назад) и кнопкой «назад» к списку.
• Кликабельные ссылки внутри текста — переход к другой записи (и, в v1.1, к якорю внутри неё).
• Виджет рецепта на странице — сетка крафта/переработки (рисует ингредиенты и результат; работает и без установленных JEI/REI).
• Текст переносится по строкам, а длинные списки прокручиваются.

Визуально книга выдержана в стиле мода — та же палитра и панели-бевелы, что и в остальных интерфейсах.

Контент

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

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

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

Рецепты

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

Прогрессия

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

Локализация

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

Связанное

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

Крафт

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

▶

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