Guía

alaindustrial:guide_book

UtilidadesImplementadoguide-booktutorialonboardingdocumentationutility

Resumen

La Guía es el manual dentro del juego de Ala Industrial. Una jugadora nueva aterriza en un mundo con mecánicas nada triviales (EU/FE en vez de FE, niveles de tensión LV/MV/HV, cables con pérdida por distancia, puertos en las caras de las máquinas) y, sin tutorial integrado, queda a expensas de adivinar o leer una wiki externa. El libro elimina esa barrera de entrada: la jugadora lo recibe en su inventario automáticamente en el primer spawn (exactamente una vez), lo abre con un clic derecho — una vista a pantalla completa con pestañas y navegación por páginas — y recorre los capítulos hasta una primera red eléctrica funcional y una máquina sin salir del juego.

El libro no necesita energía y no hace nada mecánico — es material de lectura puro. Su contenido se construye desde la misma fuente que el sitio wiki del mod, así que los números del libro nunca se desvían del juego.

Miniejemplo: entra en un mundo nuevo → la «Guía» está en tu inventario → clic derecho → se abre una pantalla en la pestaña «Primeros pasos» → haz clic en el enlace «Panel solar» → lee cuántos EU/FE produce y cómo fabricarlo.

Cómo la consigues

• Entrega automática al entrar por primera vez. La primera vez que una jugadora entra en un mundo, el libro se coloca en su inventario exactamente una vez. El registro de «ya entregada» vive en datos guardados por mundo (un SavedData con un conjunto de UUID) — sobrevive a muerte, respawn y cambios de dimensión, y nunca se entrega dos veces al reconectar.
• Las jugadoras existentes la reciben una vez con una actualización del mod también: su UUID aún no está en el registro, así que el libro se entrega en su primera conexión tras la actualización y el UUID se añade.
• Recuperación si se pierde — dos salvaguardas, ninguna de las cuales condiciona la entrega
  • una fabricación (barata, accesible en LV, sin requisito de esquema);
  • el comando /alaindustrial guide (reutiliza el comando /ala existente; entrega/abre el libro). Nunca quedas fuera del tutorial.
• Si el inventario está lleno durante la entrega, el libro cae a los pies de la jugadora (nunca se pierde).

Interfaz

Se abre con un clic derecho — una ventana a pantalla completa (no es un cofre: sin espacios, sin inventario). Tiene:

• Pestañas (capítulos de nivel superior) que reflejan la agrupación por categorías del sitio wiki más una sección de acogida inicial:
  1. Primeros pasos — acogida escrita a mano: primer generador → primer cable → primera máquina;
  2. Energía — qué son los EU/FE, los niveles LV/MV/HV, cables y pérdida por distancia, puertos de cara;
  3. Generadores, 4. Máquinas, 5. Almacenamiento, 6. Transferencia de energía,
  4. Materiales, 8. Objetos y herramientas, 9. Componentes, 10. Utilidades.
• Lista de entradas dentro de una pestaña (una por bloque/objeto/mecánica), con desplazamiento.
• Página de entrada — una doble página con navegación (siguiente/anterior) y un botón de «volver» a la lista.
• Enlaces clicables dentro del texto — saltan a otra entrada (y, en la v1.1, a un ancla dentro de ella).
• Widget de receta en una página — una rejilla de fabricación/proceso (dibuja ingredientes + resultado; funciona sin JEI/REI instalados).
• El texto se ajusta por palabras, y las listas largas se desplazan.

Visualmente sigue el estilo del mod — la misma paleta y los mismos paneles biselados que las demás interfaces.

Contenido

• El libro cubre todos los bloques y objetos ya presentes en el juego: para cada uno, una descripción breve, sus estadísticas (nivel, EU/FE, búfer) y su receta de fabricación.
• Los números del libro (EU/FE, niveles, búferes, recetas) vienen de la misma fuente que el sitio wiki, así que siempre coinciden con el juego — sin desviaciones.
• Los bloques planificados o aún no añadidos quedan fuera: el libro nunca promete lo que todavía no está en el juego.
• Los capítulos marco «Primeros pasos» y «Energía» están escritos como un tutorial introductorio para jugadoras nuevas.

Propiedades del bloque

El libro es un objeto (no un bloque): no se puede colocar, se apila a 1, no tiene búfer de EU/FE. Su «forma» es un modelo de objeto corriente (→ item/generated con el icono). El clic derecho abre la GUI (véase «Interfaz»); no se coloca ningún bloque en el mundo, sin colisión.

Recetas

La fabricación es una receta sencillísima sin forma: un minecraft:book del juego base + (el componente del mod más temprano y barato). Sin requisito de esquema (el libro se entrega automáticamente de todos modos; la fabricación solo recupera uno perdido).

Progresión

• Nivel: ninguno (una utilidad, no parte de la cadena de energía). Disponible de inmediato — es el punto de entrada a la progresión, no un peldaño de ella. Guía a la jugadora por la progresión real del mod (mena → generador → cable → máquina → niveles).

Localización

• v1: en_us + ru_ru — contenido completo de capítulos (en_us es la fuente, como en todo el mod).
• Las demás locales (todo excepto las generadas en_us y ru_ru) se ensamblan desde los mapas de traducción (build_book_locale.py apply): el contenido de los capítulos está totalmente traducido, y el libro existe en todas las locales del mod.
• Todo el texto del libro va por claves de idioma; sin cadenas hardcodeadas (regla del proyecto).

Relacionado

• El libro se construye desde la misma fuente que el sitio wiki del mod: el mismo contenido y los mismos números, pero directamente en las manos de la jugadora.

Fabricación

Fabricación sin forma

▶

Guía