Книга-путівник

alaindustrial:guide_book

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

Зведення

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

Книга енергії не потребує й нічого не «робить» механічно — це чисте чтиво. Її вміст зібраний з того самого джерела, що й вікі-сайт моду, тому числа в книзі не розходяться з грою.

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

Як отримати

• Автовидача при першому вході. При першому заході гравця у світ книга кладеться йому в інвентар рівно один раз. Прапорець «кому вже видано» зберігається у per-world збереженні — переживає смерть/респавн/зміну виміру й не дублює видачу при повторних входах.
• Наявні гравці при оновленні моду теж отримують книгу один раз: їхнього UUID ще немає в множині «видано» → при першому вході після апдейта книга видається.
• Відновлення при втраті — дві страховки, обидві НЕ гейтять автовидачу:
  • крафт (дешевий, LV-доступний, без гейта за схемою);
  • команда /alaindustrial guide (видає/відкриває книгу). Гравець ніколи не лишається без туторіалу.
• Якщо інвентар повний при автовидачі — книга випадає під ноги гравця (не губиться).

Інтерфейс

Відкривається по ПКМ — повноекранне вікно (не скриня: слотів та інвентаря немає). Складається з:

• Вкладки (розділи верхнього рівня) ліворуч/зверху — повторюють групування категорій вікі-сайту
  1. З чого почати (Getting Started) — ручний онбординг: перший генератор → перший кабель → перша машина;
  2. Енергія — що таке EU/FE, тири LV/MV/HV, кабелі й втрати за довжиною, порти граней;
  3. Генератори, 4. Машини, 5. Накопичувачі, 6. Передача енергії,
  4. Матеріали, 8. Предмети та інструменти, 9. Компоненти, 10. Утиліти.
• Список записів усередині вкладки (по одному на блок/предмет/механіку), з прокруткою.
• Сторінка запису — розворот із посторінковою навігацією (стрілки вперед/назад) і кнопкою «назад» до списку.
• Клікабельні посилання всередині тексту — перехід до іншого запису.
• Віджет рецепта на сторінці — сітка крафта/переробки (малює інгредієнти й результат; працює й без встановлених JEI/REI).
• Текст переноситься по рядках, а довгі списки прокручуються.

Візуально книга витримана в стилі моду — та сама палітра й панелі-бевели, що й в решті інтерфейсів.

Контент

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

Властивості блока

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

Рецепти

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

Прогресія

• Тир: немає (утиліта, не частина енерголанцюжка). Доступна одразу — це точка входу в прогресію, а не її щабель. Веде гравця реальною прогресією моду (руда → генератор → кабель → машина → тири).

Локалізація

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

Пов'язане

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

Крафт

Безформний крафт

▶

Книга-путівник