# Manual de usuario de Eclipse Imperia

Edición avanzada 2.1.2 — manual incluido dentro del juego y en las distribuciones para Windows, desarrolladores y servidor.

Eclipse Imperia es un juego original y accesible de estrategia espacial. Puede jugarse localmente por una sola persona contra imperios controlados por IA, sin cuenta en línea, o desplegarse como servidor con cuentas y universos humanos, de IA o mixtos. En local, cada universo, preferencia y progreso se guarda en un contenedor `.dat` protegido.

## 1. Inicio rápido

1. Ejecuta `jugar.bat` durante el desarrollo o `EclipseImperia.exe` en la versión compilada.
2. Pulsa **Iniciar servidor**. El juego abre el navegador predeterminado.
3. Crea un universo o continúa uno guardado.
4. En Economía, construye Planta solar, Mina de metal y Mina de cristal.
5. Sube Robótica para reducir tiempos y desbloquear Astillero.
6. Construye cargueros, Laboratorio y las primeras tecnologías de motores.
7. Abre Galaxia antes de enviar una flota y conserva deuterio para combustible.
8. Revisa Informes después de cada cola, viaje, combate o expedición.

Una apertura segura es: Solar 2 → Metal 3 → Cristal 2 → Robótica 2 → Astillero 2 → Laboratorio 2. No existe una única apertura correcta; energía, campos y reservas deben permanecer equilibrados.

## 2. Estructura de la interfaz

La barra superior muestra recursos y herramientas de visualización. La barra lateral contiene el selector de planeta y todas las secciones del juego. El contenido principal empieza con un único título de nivel 1.

La interfaz ofrece dos organizaciones completas:

- **Modo normal:** muestra todos los apartados de cada pantalla uno después de otro y conserva la lista completa de secciones.
- **Modo por pestañas:** muestra un apartado cada vez en las pantallas densas y agrupa la navegación lateral en Mando, Economía y colonias, Ciencia e industria, Flotas y exploración, Relaciones y sociedad, Historia y comunidad y Sistema.

La elección se realiza al crear el universo o desde Configuración y se guarda dentro de cada partida. Ningún modo elimina funciones, formularios, resultados ni enlaces directos.

En el modo por pestañas, un encabezado de nivel 2 aparece antes del conjunto. Tab entra una sola vez en la pestaña enfocada; Flecha izquierda y derecha recorren los nombres; Inicio y Fin saltan a los extremos; Enter o Espacio activa la pestaña; el siguiente Tab entra en el panel. La activación es manual para que recorrer nombres no cambie el contenido inesperadamente. El fragmento de la URL y el botón Atrás restauran el apartado, y un error de formulario abre automáticamente la pestaña que contiene el campo.

La portada usa paneles plegables:

- Estado general y Actividad empiezan abiertos.
- Clasificación e Informes empiezan cerrados en modo compacto.
- Enter o Espacio abre y cierra el panel enfocado.
- Configuración permite desactivar el modo compacto.
- El estado se comunica al lector de pantalla y no depende del símbolo visual.

Los desplegables colocan su opción activa al principio al recibir foco. El valor no cambia; únicamente se reordena la lista para que Flecha abajo permita recorrer todas las alternativas. Este comportamiento es opcional.

## 3. Teclado y lector de pantalla

Los atajos globales usan Control+Alt de forma predeterminada. En Configuración puedes activar **Añadir Shift a todos los atajos**; desde ese momento pasan a usar Control+Alt+Shift y la elección se guarda en la partida. También puedes remapear por separado las 34 acciones mediante selectores y casillas normales, sin tener que pulsar acordes simultáneos. El juego rechaza duplicados y combinaciones reservadas, permite restaurar todos los valores y actualiza al momento la tabla de ayuda y los nombres accesibles. Funcionan desde botones, enlaces y desplegables. Se desactivan dentro de campos de texto y áreas editables para no interferir con AltGr.

> **Aviso para usuarios de lectores de pantalla:** si NVDA, JAWS, Narrador u otro lector tiene asignada la misma combinación, el atajo del lector de pantalla tendrá prioridad y el juego no recibirá esas teclas. Puedes cambiar esa combinación en el lector, usar los enlaces y botones equivalentes o activar el Shift adicional en Configuración para utilizar Control+Alt+Shift más la tecla indicada.

El juego reconoce la tecla física y no el carácter que produce la distribución. Por ello, si Control+Alt+1 escribe `|` en un teclado español, el juego seguirá interpretando la tecla `1` y abrirá Resumen. La lista siguiente muestra la combinación predeterminada; cuando el Shift adicional esté activo, inserta Shift después de Alt.

### Atajos de lectura

- Control+Alt+R: recursos actuales.
- Control+Alt+H: índice de secciones en modo normal; en modo por pestañas enfoca la pestaña activa.
- Control+Alt+N: navegación principal.
- Control+Alt+P: selector de planeta.
- Control+Alt+K: tabla completa de teclas; al abrirse, el foco queda en el título y al principio del cuadro para leer hacia abajo. Escape la cierra y devuelve el foco al control anterior.

### Atajos de pantallas

- Control+Alt+1: Resumen.
- Control+Alt+0, tecla cero: Manual completo en otra pestaña; la pestaña de la partida permanece abierta.
- Control+Alt+Y: Ayuda breve.
- Control+Alt+J: Centro estratégico.
- Control+Alt+W: Enciclopedia.
- Control+Alt+B: Economía.
- Control+Alt+I: Investigación.
- Control+Alt+A: Astillero.
- Control+Alt+U: Agricultura.
- Control+Alt+C: Comercio.
- Control+Alt+V: Mercado.
- Control+Alt+F: Frontera.
- Control+Alt+X: Expediciones.
- Control+Alt+G: Galaxia.
- Control+Alt+L: Flotas.
- Control+Alt+D: Diplomacia.
- Control+Alt+Q: Gobernadores.
- Control+Alt+O, letra O: Operaciones.
- Control+Alt+M: Informes.
- Control+Alt+S: Configuración.
- Control+Alt+Z: Acerca de.
- Control+Alt+T: Historia del universo.
- Control+Alt+E: Política interna.
- Control+Alt+F2: Senado galáctico.
- Control+Alt+F3: Redes de espionaje.
- Control+Alt+F4: Diseñador de naves.
- Control+Alt+F6: Fuerzas terrestres.
- Control+Alt+F7: Encuentros y crisis.
- Control+Alt+F8: Escenarios y mods.

Control+Alt+G funciona aunque el foco esté en el selector de planeta. Si has recorrido el selector sin pulsar Cambiar planeta, Galaxia usa la opción que está seleccionada y coloca el foco en el título del mapa.

La interfaz ofrece foco visible, enlaces de salto, encabezados jerárquicos, regiones con nombre, tablas con título, etiquetas de formulario, texto ampliado, alto contraste, colores forzados de Windows, reducción de movimiento y reflujo hasta 320 píxeles. Las pistas musicales cambian sin generar anuncios. Los avisos en vivo se reservan para resultados importantes y errores.

Referencias de diseño: [WCAG 2.2](https://www.w3.org/TR/WCAG22/), [prácticas de teclado WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/), [patrón de pestañas WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/) y [patrón de acordeón WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/patterns/accordion/).

## 4. Recursos y energía

### Recursos planetarios

- Metal: infraestructura, cascos y defensas.
- Cristal: electrónica, laboratorios, sensores y escudos.
- Deuterio: combustible, motores, ciencia y proyectos avanzados.
- Energía: no se almacena. Su porcentaje modifica la producción minera.
- Alimento: población, moral, ayuda, comercio y expediciones.

### Recursos imperiales

- Créditos: mercado y rutas comerciales.
- Materia oscura, antimateria y materia exótica: industria de frontera.
- Datos cuánticos: cartografía y proyectos científicos.
- Muestras biológicas: ecología y mundos vivientes.
- Influencia: diplomacia y alianzas.
- Fragmentos de reliquia y cronones: arqueología y mecánica temporal.

La producción se actualiza cuando se abre una pantalla o se ejecuta una acción. El porcentaje de energía, población, moral, política, riqueza del universo, contaminación, bloqueo, Plasma, artefactos y megaproyectos pueden modificarla.

## 5. Construcción y campos

Cada planeta admite una cola de edificios. Cancelarla recupera el 75 % del coste. Robótica, Nanobots y política automatizada reducen tiempos.

Los campos planetarios ocupados son la suma de niveles de edificios no lunares. Terraformador aumenta el límite. Los edificios lunares usan campos de la luna y no consumen superficie planetaria.

Hay 46 edificios, entre ellos minas, almacenes, agricultura, comercio, ecología, laboratorios, defensa, hábitats, industria estratégica, infraestructura orbital y cuatro instalaciones lunares.

### Edificios lunares

- Base lunar: primer requisito para toda infraestructura lunar.
- Falange sensora lunar: reconocimiento y redes tácticas.
- Portal de salto lunar: reduce la duración de vuelos desde ese mundo.
- Astillero lunar: acelera producción naval y desbloquea el Constructor lunar.

Sin luna, la interfaz muestra “Luna formada” como requisito y el motor rechaza la construcción.

## 6. Investigación

La investigación es imperial y solo existe una cola científica. Puede pagarse desde el planeta activo o mediante la **Red científica imperial**, que reparte metal, cristal y deuterio entre planetas conectados. Antes de confirmar se muestra la aportación de cada mundo; el reparto puede ser automático o manual y los recursos quedan reservados para impedir un doble gasto. Si se cancela, el 75 % vuelve proporcionalmente a cada planeta de origen.

La velocidad de investigación es una regla propia, separada de economía y flotas. Laboratorio, Supercomputador planetario, política científica, doctrina de Descubrimiento, artefactos, Archivo de alianza, eras temporales y proyectos modifican además la duración. Las IA investigan y financian su ciencia con estas mismas reglas.

Las 49 tecnologías se agrupan de forma práctica en:

- Energía, computación, espionaje y sensores.
- Motores y física hiperespacial.
- Armas, escudos, blindaje, doctrina de flota y gravitación.
- Astrofísica, cartografía, expediciones e ingeniería lunar.
- Biología, agronomía, clima, genética, ecología de drones y terraformación.
- Diplomacia, alianzas, logística y comunicaciones cuánticas.
- Inteligencia sintética, cibernética y enjambres.
- Materia oscura, antimateria, dimensiones, tiempo y singularidades.

Cada ficha muestra coste del siguiente nivel, laboratorio mínimo y requisitos enlazados. La Enciclopedia ofrece costes comparados de los niveles 1, 5 y 10 y una calculadora para cualquier nivel objetivo entre 1 y 100. Esta informa del coste exacto del nivel, la inversión acumulada desde nivel 1, el tiempo base antes de velocidad y bonificaciones y, cuando corresponde, la producción, energía, capacidad o bonificación proyectada. Por ejemplo, se puede consultar directamente una Mina de metal de nivel 36.

## 7. Astillero, naves y defensas

Cada planeta tiene una cola de astillero compartida por naves y defensas. Astillero, Dique orbital, Astillero lunar, Robótica, Nanobots, política militar y proyectos modifican el tiempo.

Las 34 naves cubren carga, combate, colonización, espionaje, reciclaje, exploración, ciencia, rescate, diplomacia, minería, mando, sigilo y megaingeniería. Las 27 defensas abarcan armas cinéticas, láser, iones, plasma, drones, minas cuánticas, interferencia, reparación, antimateria y escudos planetarios.

Las cúpulas y la Ciudadela planetaria son defensas singulares: solo se permite una unidad de cada tipo por planeta.

## 8. Galaxia, lunas y escombros

Cada sistema tiene quince posiciones. La tabla de Galaxia muestra:

- planeta o espacio vacío;
- imperio y comandante;
- luna, diámetro y campos;
- campo de escombros, metal, cristal y deuterio por separado;
- puntuación;
- anomalías conocidas;
- enlaces contextuales para misión, colonización, reciclaje, expedición o marcador.

Al crear el universo se fijan por separado los porcentajes de naves, defensas y deuterio destruidos que pasan a escombros. La misma regla alimenta el simulador, el combate real, la vista de Galaxia, el reciclaje y las decisiones de la IA. Una concentración suficiente puede formar una luna; la probabilidad crece con el campo y está limitada al 20 %. La luna recibe entre 8 y 18 campos según su diámetro.

Una misión de Reciclaje admite Recicladores o Cortadores de salvamento. Reciclaje de precisión aumenta capacidad efectiva. Cuando metal, cristal y deuterio llegan a cero, el campo se elimina.

La topología se elige por separado para sistemas y galaxias. En modo lineal los extremos quedan alejados; en modo circular el último enlaza con el primero. Galaxia explica los vecinos efectivos y la regla se usa para duración, combustible, expediciones, mercado, logística, misiles, previsiones e IA.

Las anomalías permanecen ocultas hasta que Cartografía o una expedición las revela a tu imperio.

## 9. Flotas y combustible

Una flota necesita:

- al menos una nave disponible;
- una ranura libre de Computación;
- destino válido;
- relación diplomática compatible;
- capacidad para la carga;
- deuterio para carga y combustible;
- nave especializada cuando la misión lo exige.

La nave más lenta determina la velocidad. Los motores mejoran velocidad; distancia, velocidad de universo, topología, portales lunares, Cálculo de salto, artefactos, eras y megaproyectos alteran duración.

Retirar una flota antes de llegar calcula un regreso proporcional al tiempo ya viajado. Por defecto primero aparece una revisión completa con misión, origen, destino, estado, naves, carga, hora de retorno anterior y nueva, combustible no recuperable y consecuencias como perder un bloqueo o una escolta. El foco empieza en el título. La confirmación puede omitirse desde Asistencia para quien priorice rapidez.

Las plantillas solo rellenan el formulario. Siempre hay que revisar y confirmar.

## 10. Las quince misiones

- Atacar: combate, saquea y declara guerra.
- Transportar: entrega recursos y regresa.
- Espiar: obtiene detalle según diferencia tecnológica.
- Colonizar: consume una Nave colonizadora y funda un mundo.
- Desplegar: mueve permanentemente naves a un planeta propio.
- Reciclar: recoge escombros.
- Expedición: encuentro aleatorio con Explorador.
- Cartografiar: revela anomalías y obtiene datos cuánticos.
- Ayuda humanitaria: entrega carga, moral y confianza.
- Ruta comercial: entrega carga a un socio y genera créditos.
- Bloqueo orbital: combate y reduce producción temporalmente.
- Patrulla aliada: rompe bloqueos y mejora moral.
- Extracción orbital: Barcazas o Recolectores generan metal y cristal hasta su capacidad.
- Convoy de rescate: Nave hospital o Buque de rescate recupera población y confianza.
- Sabotaje: Explorador furtivo o Infiltrador intenta retrasar una cola y declara guerra.

## 11. Combate

El combate dura hasta seis rondas. Ataque, escudos y casco se modifican mediante Armas, Escudos, Blindaje, Doctrina de flota, doctrina imperial, política, Escudo planetario, Mando de defensa, artefactos y proyectos.

El vencedor atacante saquea hasta la mitad de los recursos dentro de la capacidad libre. Ambos imperios reciben informe con rondas, pérdidas, botín, escombros y posible luna.

El Simulador del Centro estratégico ejecuta escenarios sin alterar la partida y usa un informe de inteligencia guardado.

## 12. Expediciones profundas

Una expedición profunda necesita Explorador, ranura, alimento y deuterio. Se eligen:

- objetivo;
- especialista;
- protocolo de riesgo;
- nombre de nave;
- coordenadas.

Los protocolos van de Blindada a Desesperada y modifican duración, recompensa, éxito y regreso. El especialista cuya especialidad coincide con el objetivo aporta una mejora importante.

Los objetivos cubren arqueología, xenobiología, rescate, primer contacto, cartografía, vacío, naufragios, tiempo, megafauna, ingeniería estelar, mercado de sombras y peregrinación. La versión 6 añade observación lunar, nubes interestelares, señales de civilizaciones, tormentas de materia oscura, jardines orbitales y cartografía de portales.

Los resultados pueden otorgar recursos, naves, población, habitabilidad, confianza, anomalías, recursos estratégicos o artefactos. Una nave perdida no regresa al inventario.

## 13. Agricultura, población y ecología

Complejo agrícola añade parcelas. Cada granja tiene cultivo, trabajadores, nivel, capacidad, progreso y automatización opcional. Cosechar transfiere alimento al planeta.

La población mejora producción dentro de límites. Hambre y contaminación reducen moral, habitabilidad y crecimiento. Políticas, Biosfera, Hábitat orbital, Centro de restauración, Matriz meteorológica, Bóveda genómica, Nanomedicina y tecnologías ecológicas permiten especializar mundos.

## 14. Comercio y mercado

Comercio planetario convierte alimento en metal, cristal o deuterio. Nexo comercial y pactos mejoran precios.

El Mercado galáctico admite ofertas persistentes de doce recursos. Lo ofrecido queda en depósito; la orden puede llenarse, caducar o cancelarse. El historial permite valorar el intercambio.

Las rutas comerciales necesitan pacto comercial o alianza. El Convoy de rescate y la Ayuda humanitaria no generan el mismo beneficio económico, pero elevan confianza.

## 15. Diplomacia y alianzas

Las relaciones posibles son neutral, comercio, no agresión, alianza y guerra. La personalidad, confianza y tecnología influyen en respuestas de la IA.

Las alianzas admiten nombre, sigla, declaración, rangos, invitaciones, defensa compartida y sucesión de liderazgo. Depósito de alianza y Coordinación de alianzas mejoran rescate y operaciones cooperativas.

Ataque, bloqueo y sabotaje son hostiles. Un acuerdo de no agresión o alianza impide iniciarlos. El período inicial de paz también se valida en el servidor.

Los rivales normales comienzan con los mismos recursos, alimento, población, moral, edificios, tecnologías, unidades y condición inicial especial que el jugador. La dificultad no regala desarrollo: solo cambia su frecuencia, precisión y audacia. Cada IA puede construir en todos sus planetas, investigar, fabricar, cultivar, comerciar con humanos u otras IA, usar las quince misiones, colonizar, reciclar, explorar, mantener diplomacia y alianzas, votar con favores reales, resolver su propia narrativa, gobernar facciones, espiar, diseñar naves, invadir, administrar ocupaciones y vasallos, participar en crisis, usar museo, logística y guerra orbital y perseguir megaproyectos. El juego nunca decide ni vota en nombre del jugador.

Las cooperativas agrícolas de IA son una categoría neutral especial elegida aparte al crear la partida. Su infraestructura agrícola deliberadamente distinta no se considera un rival estratégico normal.

## 16. Centro estratégico

Incluye:

- libro mayor de colonias;
- consejero explicable;
- plantillas de flota y carga;
- planificador de vuelo;
- memoria de inteligencia;
- marcadores con prioridad y notas;
- simulador de combate;
- órdenes logísticas;
- amortización económica;
- calculadora de recicladores.

Estas herramientas no realizan acciones irreversibles automáticamente.

## 17. Gobernadores

Cada planeta puede activar un gobernador con enfoque, plan, reserva mínima y cosecha opcional. El gobernador puede construir y cosechar dentro del mandato. Nunca ataca, declara guerras, cancela colas ni gasta la reserva protegida.

## 18. Frontera y megaproyectos

Los edificios de frontera producen recursos estratégicos. Artefactos y expediciones aportan bonificaciones o materiales adicionales.

Los ocho megaproyectos son únicos por imperio, tienen requisitos elevados y otorgan efectos permanentes de minería, investigación, defensa, expedición, gobierno, velocidad o astillero.

## 19. Informes, operaciones y logros

Informes guarda resultados. Se puede buscar, filtrar, marcar favorito, archivar y restaurar. Operaciones contiene sucesos narrativos con decisiones y consecuencias expresadas antes de confirmar.

Los logros son permanentes dentro del universo. Los modos de victoria por puntuación o dominación declaran vencedor, pero permiten continuar.

## 20. Audio

Música y efectos se configuran por separado. Además hay mezcladores independientes para interfaz, avisos, combate y ambiente. La música solo empieza después de una interacción por las reglas de reproducción de los navegadores.

Cambiar una pista, elegir la siguiente o terminar una composición no genera anuncios del lector de pantalla. Los efectos identificativos siguen teniendo texto equivalente y se pueden desactivar.

Configuración incluye un catálogo plegable de 31 efectos. Cada ficha indica la familia, las acciones en las que se reproduce, una descripción de su forma sonora y un botón de prueba. Los sonidos de astillero, reciclaje, cartografía, gobernador, alianza, pausa, rescate, planificación, recordatorio, artefacto, temporada, misil y recuperación son independientes de las señales generales para facilitar su aprendizaje. Las pruebas deliberadas pueden escucharse aunque los efectos automáticos estén desactivados.

La salida mono mezcla los canales sin eliminar información. La reducción para lector de pantalla baja el ambiente cuando se anuncia texto; también existe un botón de reducción manual durante veinte segundos. El historial textual conserva las señales importantes con fecha y acción asociada. Los perfiles de audio se exportan e importan como códigos validados.

## 21. Configuración

Permite:

- elegir de forma persistente entre modo normal y modo por pestañas;
- texto ampliado y alto contraste;
- pausa de avisos;
- portada compacta;
- desplegables desde la opción activa;
- remapeo completo de teclas y Shift global;
- perfiles de asistencia independientes de la dificultad;
- música, efectos, mezcla por categorías, mono y reducción para lector;
- pausa del universo;
- comportamiento persistente al cerrar el servidor: universo detenido o tiempo real;
- velocidades y riqueza;
- agresividad, eventos, ecología y expediciones;
- expansión de galaxias, sistemas, rivales y mundos-granja;
- cambio de nombre;
- modo trampas confirmado mediante la palabra exacta `TRAMPAS`;
- copia de seguridad;
- exportación e importación entre ordenadores desde el panel wxPython;
- regreso a la lista de universos.

Los cambios de reglas afectan al futuro y no borran progreso.

### Tiempo con el servidor cerrado

Cada universo guarda de forma independiente cómo debe comportarse cuando pulsas **Detener servidor** o cierras correctamente el panel:

- **Universo detenido** es el valor predeterminado. Al cerrar se registra el instante exacto y, al volver, se desplazan todos los relojes internos. No se producen recursos ni alimento, no crece o disminuye la población, no terminan colas, flotas, expediciones, proyectos, operaciones, invasiones, convoyes o misiles y ninguna IA decide, comercia o ataca. También se conservan la paz inicial, bloqueos, protecciones, temporadas, votaciones y recordatorios.
- **Tiempo real** reconstruye el período ausente. La producción y los sistemas continuos reciben todo el tiempo transcurrido; colas, flotas y operaciones vencidas se resuelven. La IA recibe rondas estadísticas con una semilla reproducible de azar, respetando recursos, naves, relaciones, personalidad, dificultad y agresividad. Puede construir, investigar, comerciar, enviar flotas y atacar al jugador. Un ataque temprano puede haberse resuelto y uno tardío puede seguir en camino cuando regreses.

En universos grandes no se ejecuta literalmente una decisión cada pocos segundos de ausencia, porque miles de turnos bloquearían el inicio. El motor calcula los turnos teóricos y toma hasta 24 rondas representativas, reducidas según el número de rivales para mantener un presupuesto máximo de decisiones. Esto conserva la producción completa y los vencimientos reales, pero usa una reconstrucción estadística para las decisiones autónomas. **Resumen** anuncia qué modo se aplicó y **Configuración > Universo** conserva el informe: duración, rondas, decisiones de IA, colas y flotas resueltas, ataques, tirada de azar y cambio neto de recursos, alimento y población.

La **pausa manual** tiene prioridad sobre ambos modos: un universo pausado permanece congelado aunque esté seleccionado Tiempo real. Para que el instante de cierre quede registrado, utiliza **Detener servidor** antes de salir. Las partidas antiguas que todavía no tienen esta preferencia adoptan Universo detenido.

### Tamaños máximos del universo

Una partida nueva admite hasta 128 rivales estratégicos, 64 cooperativas agrícolas de IA, 12 galaxias, 250 sistemas por galaxia y 12 agromundos propios iniciales. Configuración permite ampliar una partida existente hasta esos máximos, incluidos sus sistemas, sin mover planetas ni borrar progreso. Los tamaños extremos consumen más memoria y hacen más costosas las rondas de IA; por eso el modo Tiempo real ajusta automáticamente su muestreo estadístico.

### Modo trampas

En **Configuración > Modo trampas**, escribe `TRAMPAS` exactamente en mayúsculas y pulsa **Validar y activar el modo trampas**. La palabra no se guarda. Solo el imperio humano puede activar y usar el editor; cada planeta propio se modifica seleccionándolo primero como planeta activo.

Al activarse, el editor respeta la organización elegida para toda la partida. En **modo normal** muestra seguidos sus siete apartados: **Recursos y planeta**, **Edificios**, **Ciencia**, **Naves y defensas**, **Recursos especiales**, **Fuerzas y agricultura** y **Luna y artefactos**. En **modo por pestañas** presenta esos mismos siete apartados de uno en uno. En la lista de pestañas, las flechas izquierda y derecha mueven el foco, Inicio y Fin saltan a los extremos y Enter o Espacio abren el apartado; después, Tab entra en sus controles. Cambiar de organización no oculta ni elimina ninguna función ni modifica los valores escritos.

El editor permite fijar o poner a cero recursos, alimento, población, moral, contaminación, habitabilidad, temperatura, campos, política, créditos, edificios, estructuras lunares, tecnologías, naves, defensas, recursos estratégicos, fragmentos, fuerzas terrestres, granjas y cantidades de diseños personalizados. También permite crear o eliminar la luna y crear o retirar artefactos. **Guardar todos los cambios de progreso** valida conjuntamente los valores escritos en las seis pestañas de progreso antes de guardar: si un valor es inválido, abre la pestaña que lo contiene, lleva el foco al campo y no aplica cambios parciales. Las acciones independientes de luna y artefactos están en la séptima pestaña. Las reservas introducidas por encima de la capacidad del almacén se conservan; la producción normal no las aumenta hasta que vuelven a quedar por debajo del límite.

Desactivar el modo oculta y bloquea el editor, pero conserva lo modificado. La activación marca permanentemente el universo como **partida con trampas**, incluso si después se desactiva, y esa condición aparece en los informes generales exportados.

El modo por pestañas se aplica a Nueva partida, Configuración, Centro estratégico, Enciclopedia, Escenarios y mods, Informes, Planificación, Diplomacia, Panel imperial, Encuentros y crisis, Expediciones, Espionaje, Invasiones, Logística, Mercado, Museo, Guerra orbital, Senado e Historia del universo. En la Enciclopedia, la búsqueda recorre las 16 categorías aunque solo una esté visible, muestra el número de coincidencias en cada pestaña y abre la primera categoría con resultados. Resumen, Ayuda, Manual y los catálogos de producción mantienen su presentación adecuada para lectura continua.

## 22. Historia estratégica e informes de combate

**Historia del universo** reúne tratados, guerras, colonizaciones, proyectos, decisiones, elecciones y mensajes importantes. Sus filtros permiten limitar por categoría y período. Puedes fijar una entrada con etiqueta y nota, crear instantáneas de reservas y puntuación y comparar dos momentos. Al volver a una partida, el resumen indica qué cambió desde la última sesión.

Los combates conservan sus seis rondas con daño infligido y absorbido, bajas por clase, tecnologías, doctrina, política, botín y escombros. El informe compacto resume el resultado; el detalle semántico explica los factores decisivos sin depender de gráficos. Dentro de cada batalla puedes descargar una copia en **BBCode** para pegarla en foros, en **Markdown** o en **JSON**. Solo el atacante y el defensor pueden exportarla.

Desde **Informes** y **Estadísticas** también puedes generar un informe general en BBCode, Markdown o JSON. Incluye configuración y estado del universo, indicación de trampas, imperio, reservas, producción, planetas, edificios, investigaciones, unidades, granjas, lunas, rutas, flotas, diplomacia, artefactos, logros y estadísticas de expediciones y combate. La exportación se genera localmente y no contiene la palabra de activación, tokens de la API ni claves de guardado.

## 23. Situaciones, orígenes y primeros contactos

Las situaciones son cadenas de cuatro etapas: descubrimiento, análisis, reacción y desenlace. Cada elección queda en la base y modifica el texto y el resultado de la etapa siguiente. Las cadenas integradas son **La señal bajo el manto**, **El arca de los ausentes** y **La cosecha temporal**.

Los siete orígenes tienen tres capítulos propios y una bonificación inicial: Colonia perdida, Supervivientes de una guerra, Civilización orbital, Protectores de un mundo viviente, Red de máquinas emancipada, Imperio dividido y Deuda ancestral. El origen se elige al crear el universo y no es una etiqueta decorativa.

Las civilizaciones preespaciales atraviesan eras y recuerdan el trato recibido. Puedes observar, ayudar, infiltrar o proteger; la contaminación cultural, confianza y desarrollo cambian con cada intervención. Una sociedad que asciende se incorpora al universo y conserva su memoria.

## 24. Política interna y Senado galáctico

Las cinco facciones —científica, militar, ecológica, comercial y soberanista— calculan apoyo a partir del estado y de las decisiones del imperio. El descontento puede producir huelgas, protestas, coaliciones o reformas. Las diez leyes consumen influencia y mantenimiento y aplican efectos reales a ciencia, defensa, ecología, comercio, reservas, fronteras y autonomía.

La forma de gobierno determina la sucesión: democracia con elecciones periódicas, consejo formado por las facciones principales o nombramiento directo. Cada elección queda registrada.

El Senado permite proponer y votar siete clases de resolución. Los favores refuerzan votos; las resoluciones aprobadas pueden crear defensa colectiva, cartas ecológicas, mercados abiertos, control de armamento, investigación común, sanciones o un custodio para la crisis. Las votaciones tienen fecha de cierre y resultado persistente.

## 25. Redes de espionaje

Cada rival puede tener una red con infiltración, contrainteligencia, última observación y confianza de la información. Los agentes poseen nombre y especialidad. Los activos mejoran operaciones concretas.

Las cinco operaciones son robo de tecnología, desinformación, sabotaje, adquisición de activos y análisis de fuentes. Exigen influencia, preparación e infiltración; pueden fallar, ser detectadas y empeorar relaciones. La información dudosa siempre se marca con texto y antigüedad.

## 26. Diseñador de naves e invasiones

El diseñador ofrece cinco cascos y catorce componentes de armas, escudos, blindaje, motores, sensores, sigilo, carga y reactor. La validación comprueba ranuras por tipo, masa y energía antes de guardar. Cada diseño muestra coste, mantenimiento, ataque, casco, escudo, velocidad, carga, precisión, sigilo, rol y potencia. Las unidades construidas cuentan para defensa, puntuación, invasiones y crisis.

Las fuerzas terrestres consumen población, recursos y suministros. Una invasión requiere guerra, planeta de origen, tropas y apoyo orbital; avanza por aproximación, asalto y ocupación. Tras vencer puedes administrar, negociar, integrar, vasallizar o liberar. La resistencia y el coste administrativo persisten. La presión diplomática permite una rendición sin combate cuando se cumplen confianza, influencia y condiciones defensivas.

El vasallaje no se reduce a una alianza nominal: el imperio vencido conserva sus mundos, figura como vasallo persistente y entrega periódicamente un porcentaje de sus créditos. Desde Fuerzas terrestres puedes concederle autonomía —reduce el tributo y mejora su moral—, exigir más tributo a cambio de autonomía y confianza, o reconocer su soberanía. La cronología y ambos imperios reciben constancia de estos cambios.

## 27. Crisis galácticas

Hay siete crisis: enjambre extragaláctico, inteligencia de singularidad, colapso ecológico, fractura temporal, imperio antiguo, rebelión de portales y guerra de recursos. Cada una atraviesa aviso, fase activa, clímax y resolución; su fuerza escala con el tamaño y progreso del universo.

El jugador puede contribuir mediante flota, investigación, diplomacia o recursos. Las leyes, resoluciones, diseños y el custodio alteran la eficacia. Los objetivos de cada fase y el progreso total siempre se muestran como texto.

## 28. Semillas, escenarios, mods y aplicación instalable

La semilla visible hace reproducibles coordenadas, anomalías, contactos y crisis. El editor genera un código corto con semilla, número de rivales, galaxias, velocidad, dificultad, gobierno, victoria, origen, situación e imperios predefinidos. Ese código se pega en **Nueva partida** y no contiene progreso ni datos personales. El desafío semanal se calcula localmente.

Los mods son carpetas declarativas dentro de `mods`. Necesitan `manifest.json`, versión compatible e identificador `autor.mod`; sus catálogos JSON solo pueden añadir orígenes, situaciones y escenarios con espacio de nombres. Se validan tamaño, estructura, dependencias y compatibilidad. Al elegir un origen o una cadena de mod para una partida nueva se activan automáticamente el mod y sus dependencias.

El modo seguro desactiva todos los mods. Un origen o una cadena ya iniciados no se borran: se muestran como pausados y conservan su estado hasta restaurar el mod. Esto permite abrir y administrar la partida sin producir un error de servidor. El juego nunca importa ni ejecuta Python procedente de un mod.

La distribución contiene ocho mods completos con 16 orígenes, 16 situaciones de cuatro etapas y 16 escenarios. Sus dependencias forman campañas conectadas y, en conjunto, muestran las siete bonificaciones de origen y todas las reglas de escenario registradas en esta versión. La demostración integral hereda automáticamente cualquier regla que se incorpore en versiones futuras.

Para crear o modificar archivos, detén el servidor y pulsa **Editor de mods** en el panel wxPython. Está situado encima de **Importar o exportar partidas**. Sus páginas permiten administrar manifiesto, dependencias, orígenes, etapas, opciones y escenarios; **Guardar y validar** utiliza las mismas reglas que el juego. Cada campo, selector y lista tiene una etiqueta visible encima y un nombre accesible explícito para que el lector anuncie el destino de cada pulsación de `Tab`. La lista de dependencias comunica el estado de sus casillas y los diálogos utilizan **Aceptar** y **Cancelar**. Pulsa `Control+H` en cualquier campo, lista, selector o botón para obtener su explicación, valores válidos y un ejemplo. El manual técnico completo está en `mods\LEEME.md`.

La pantalla web no edita archivos de mods: muestra validación y estado, activa contenido por universo, aplica escenarios y ofrece modo seguro. Su «Editor declarativo de escenarios» genera códigos de configuración de universo y es independiente del editor wxPython.

El manifiesto web permite instalar la interfaz. El service worker guarda únicamente CSS, JavaScript, audio, icono y ayuda estática. No almacena páginas de la partida, formularios, sesión, recursos ni exportaciones; el motor Flask y el lanzador siguen siendo necesarios.

## 29. Planificación, comunidad y administración avanzada

**Planificación** mantiene una cola de hasta diez intenciones separada de las colas que ya se están ejecutando. Muestra requisitos, recursos reservados, espera estimada, duración, coste acumulado y finalización prevista. Se puede reordenar, pausar o retirar una intención sin cancelar una construcción real. La agenda combina esas previsiones con flotas, elecciones, votaciones, tratados, crisis, temporadas, guerras y recordatorios propios; sus filtros no modifican la partida y la exportación `.ics` permanece local.

**Notificaciones** conserva un historial accesible y permite activar por categoría los avisos del sistema operativo, agruparlos, ocultar nombres y cantidades y anticiparlos 0, 5 o 30 minutos. El lanzador debe seguir activo para que Windows pueda mostrarlos. No se generan avisos repetidos por el simple cambio continuo de recursos.

**Imperio** amplía el libro mayor con producción, energía, alimento, población, campos, colas, flota y defensa de cada planeta. El orden, alias, grupo, etiqueta y color se guardan, pero el color siempre tiene un equivalente textual. Planeta anterior y siguiente conservan la sección. La tabla se exporta en CSV o JSON.

**Flotas** usa un selector nativo de velocidad. Antes de lanzar presenta origen, destino, misión, porcentaje, salida, llegada, regreso, combustible, capacidad y carga. Las plantillas recuerdan su propia velocidad. Después de confirmar se puede preparar otra misión con los mismos parámetros; las cantidades se limitan de nuevo a la disponibilidad y siempre se vuelve a previsualizar.

**Mercado** expresa la proporción normalizada y clasifica cada oferta como muy desfavorable, desfavorable, justa, favorable o excepcional. La explicación compara el valor equivalente con precios observados en esta partida: no afirma que exista un precio universal.

**Alianzas de IA** pueden fundarse, formar coaliciones, mantener doctrina y tesorería, construir observatorio, corredor logístico, hospital, red defensiva y archivo, aceptar encargos y disputar guerras con puntuación. Los objetivos incluyen destrucción, control de sistemas, resistencia temporal y cooperación. La mediación, la protección del bando inferior y el historial de pactos, rupturas, victorias, derrotas y empates permanecen visibles.

**Museo** permite desmontar piezas en fragmentos, descubrir recetas, fabricar, restaurar con resultado reproducible y comerciar piezas no únicas. Dos piezas de una colección activan una bonificación moderada aplicada por el motor a exploración, minería, combate o recursos estratégicos.

**Estadísticas** calcula expediciones por objetivo, especialista, riesgo y período, con beneficio bruto, suministros y valor neto; el combate muestra evolución y distribución de bajas. Los datos no se envían fuera del equipo y se pueden exportar. **Informes** añade reglas guardadas, búsquedas, etiquetas, destacados, silencio, archivado, conversaciones agrupadas y retención configurable con copia previa. Ambas pantallas ofrecen el informe general en BBCode, Markdown y JSON; cada batalla detallada ofrece además su propia exportación en esos tres formatos.

**Logística** no teletransporta recursos. Un depósito habilita rutas físicas, reservas y convoyes con origen, destino, tiempo y capacidad; un bloqueo o una crisis pueden interrumpirlos. **Temporadas** usa semillas locales, objetivos alternativos para economía, exploración, diplomacia, ecología o combate, títulos sin poder comprado, archivo y repetición programable.

**Recuperación** ofrece una tregua opcional y decreciente después de una derrota devastadora, una única misión disponible y ayuda aliada moderada; la dificultad alta puede desactivarla. **Guerra orbital** añade munición con capacidad, recarga mediante astillero, interceptores, señuelos, defensa de portal, información dependiente de sensores, consecuencias diplomáticas, contaminación y simulador previo.

En **Configuración**, la API local de solo lectura está desactivada por defecto. Al habilitarla crea un token temporal con permisos separados para estado, planetas, flotas, calendario, informes y estadísticas bajo `/api/local/v1/`. Solo acepta conexiones desde este equipo, no ofrece acciones y puede revocarse. La exportación manual sigue disponible.

Esta versión conserva toda la interfaz y la documentación en español. No se han incorporado paquetes de traducción por decisión expresa de diseño.

### Sistemas de la ronda comunitaria 3

**Previsión imperial.** Planificación combina todas las colas activas con las intenciones pendientes, calcula el tiempo hasta vaciar construcción, ciencia y astillero, señala los puntos que dependen de producción futura y permite exportar el resultado en CSV o JSON.

**Infraestructura colectiva.** Cada Depósito de alianza de un miembro activo aporta capacidad real. Los imperios derrotados, inactivos o que abandonan dejan de contribuir. Observatorio, corredor logístico, hospital, red defensiva, archivo y Astillero de socorro muestran nivel, progreso, mantenimiento, estado operativo, capacidad disponible, miembros beneficiarios y efecto. Las aportaciones salen de la tesorería o de reservas reales y las IA no reciben recursos gratuitos.

**Eras temporales.** Configuración permite programar Renacimiento científico, Impulso industrial, Crisis logística, Edad de rutas abiertas o Vacío sereno. Cada era muestra comienzo, final y modificadores; no puede solaparse con otra y queda en el historial. El motor aplica el mismo efecto a jugador, IA, previsiones y simuladores.

**Contrainteligencia.** Redes de espionaje ofrece posturas transparente, equilibrada, señuelos activos y cierre informativo. Cada categoría del informe conserva su confianza; los valores no confirmados aparecen como intervalos y estimaciones, nunca como cifras exactas sin aviso. Se pueden comparar dos informes y el simulador ofrece intervalos de victoria cuando la información no es segura.

**Directivas consumibles.** Planificación mantiene un inventario obtenido solo por expediciones, temporadas, situaciones y logros. Protocolo ecológico, Acelerador temporal, Baliza de expedición e Impulso logístico se aplican a un objetivo y cantidad elegidos. La revisión anuncia efecto total, límite y posible desperdicio. Después de confirmar se puede deshacer exactamente mientras no haya transcurrido otro ciclo. Las IA almacenan y gastan estas directivas bajo los mismos límites.

## 30. Acerca de, versión y licencia

La pantalla **Acerca de** muestra los datos oficiales del programa:

- creador: Héctor J. Benítez Corredera;
- versión: 2.1.2;
- copyright: © 2026 Héctor J. Benítez Corredera;
- licencia de código abierto: MIT;
- descripción del juego y contenido de cada distribución.

Puede abrirse desde el enlace de la portada, desde la última opción de la navegación o con Control+Alt+Z. La licencia completa se incluye como `LICENSE` tanto en el paquete listo para jugar como en el paquete fuente. La licencia MIT permite usar, estudiar, modificar y redistribuir el código conservando el aviso de copyright y el texto de licencia.

## 31. Guardado protegido

Durante desarrollo:

`instance\eclipse_imperia.dat`

En la versión compilada:

`datos\eclipse_imperia.dat`

El archivo contiene la base SQLite cifrada y autenticada mediante AES-GCM. No conserva la cabecera de SQLite, no puede abrirse con sus herramientas y cualquier byte alterado provoca que Eclipse Imperia rechace la partida en vez de cargar datos manipulados.

La clave maestra pertenece al perfil del sistema: Windows DPAPI, macOS Keychain o Linux Secret Service. Las copias `.dat` de `datos\copias_de_seguridad` son para recuperar el estado en ese mismo perfil. La distribución compilada actual es para Windows, pero el código fuente selecciona el almacén correspondiente. Si existe una base antigua `.sqlite3`, el primer inicio la importa al nuevo formato y deja de usar el original. Si encuentra el contenedor DPAPI anterior, crea primero una copia exacta reversible y después lo migra al contenedor AES-GCM.

### Continuar en otro ordenador

El panel nativo de wxPython incluye un único botón **Importar o exportar partidas**, situado justo encima de **Salir**. Al activarlo aparece un menú contextual con **Exportar para otro ordenador** e **Importar desde otro ordenador**. Estas acciones solo se habilitan con el servidor detenido, para que ningún cambio quede a medias.

1. En el primer equipo, detén el servidor, pulsa **Importar o exportar partidas** y elige **Exportar para otro ordenador**.
2. Elige el destino y escribe dos veces una contraseña de al menos diez caracteres.
3. Lleva el archivo `.eitransfer` al segundo equipo. No guardes la contraseña junto al archivo.
4. En el segundo equipo, detén el servidor, abre el mismo menú, elige **Importar desde otro ordenador** y confirma la sustitución del guardado activo.
5. Escribe la contraseña y, cuando termine, inicia el servidor.

El archivo de traslado deriva una clave mediante Scrypt y cifra la base con AES-GCM. La autenticación impide aceptar contenido alterado: un cambio de un solo byte o una contraseña incorrecta cancela la importación. Antes de sustituir el guardado local se crea una copia `.dat` con el nombre `Eclipse-Imperia-antes-de-importar-...`; después la partida importada se protege con la clave custodiada por el sistema receptor. La transferencia contiene todos los universos del guardado de origen.

Esta protección evita editar recursos o niveles directamente. Como ocurre con cualquier juego completamente local, una persona capaz de modificar el ejecutable o la memoria del proceso podría eludir controles; no existe una defensa absoluta sin validar el estado en un servidor externo.

## 32. Compilación

Ejecuta `compilar.bat`. El proceso:

1. prepara el entorno virtual;
2. instala dependencias;
3. ejecuta todas las pruebas;
4. protege temporalmente datos personales;
5. compila con cx_Freeze;
6. incluye plantillas, estilos, audio, un `LEEME.md` breve para arrancar, `LICENSE` y este `MANUAL_USUARIO.md` completo;
7. prepara una carpeta de datos vacía;
8. genera `dist\EclipseImperia-Windows.zip`;
9. crea `dist\EclipseImperia-Desarrolladores.zip` con el código fuente, recursos, pruebas, licencia, dependencias declaradas e instrucciones;
10. restaura las partidas locales.

El ZIP de Windows abre con una única carpeta raíz `EclipseImperia`. El ZIP para desarrolladores abre con una única carpeta raíz `EclipseImperia-CodigoFuente` y dentro incluye `INSTRUCCIONES_DESARROLLADORES.md`. Al descomprimir cualquiera de ellos no quedan archivos sueltos. El paquete fuente no incorpora universos `.dat`, copias personales, `.venv`, cachés, binarios ni compilaciones anteriores.

## 33. Servidor multiusuario

El paquete fuente también puede desplegarse como servicio online. Este modo utiliza otra base de datos y no altera las partidas locales.

- Cada persona se registra y funda un imperio en un universo con plazas.
- El administrador puede crear varios universos solo humanos, solo IA o mixtos, con reglas diferentes.
- El reloj del servicio mantiene producción, colas, flotas, expediciones e IA aunque nadie tenga el juego abierto.
- Los jugadores pueden enviar reportes, conversar con moderación, descargar sus datos y formular solicitudes de privacidad.
- Los colaboradores reciben roles de administración, moderación, soporte, finanzas u observación; sus acciones quedan auditadas.
- Cada cuenta puede activar TOTP desde Cuenta y privacidad; recibe diez códigos de recuperación de un solo uso. Es especialmente recomendable para todo el equipo administrativo.
- El operador puede dejar la verificación del correo como opcional o exigirla antes del primer acceso. El jugador puede solicitar un nuevo enlace y la administración dispone de validación manual auditada.
- La tienda PayPal es opcional, está desactivada inicialmente y puede ofrecer recursos, naves, niveles tecnológicos o lunas. Cada captura se valida por importe y moneda y se entrega una sola vez.
- El modo trampas, la inmunidad narrativa, la pausa global individual, la API local y la descarga de la base completa están prohibidos para jugadores del servidor.

La instalación online no debe iniciarse con `app.py`, sino con `online_server.py` detrás de HTTPS. Consulta `docu_dev\DESPLIEGUE_SERVIDOR_ONLINE.md` para configurar dominio, correo, propietario, copias, PayPal, webhooks, privacidad y actualización.

## 34. Solución de problemas

### Control+Alt+G no responde

En un campo de texto, pulsa Tab antes del atajo. Desde un desplegable funciona directamente. Si el lector de pantalla captura la combinación, activa el Shift adicional en Configuración y usa Control+Alt+Shift+G. La nueva pantalla debe enfocar “Galaxia N, sistema N”.

### No suena música

Pulsa Activar música después de interactuar con la página. Comprueba volumen, pista y permisos de audio del navegador.

### No puedo construir

Revisa recursos, energía, requisitos, cola y campos. Un edificio lunar exige luna y campos lunares.

### No puedo enviar una misión

Comprueba nave especializada, coordenadas, relación diplomática, período de paz, combustible, carga y ranuras.

### No veo escombros o luna

Abre el sistema correcto y actualiza. Los escombros desaparecen al agotarse. Las lunas solo existen si se han formado tras un combate o han sido añadidas por la partida.

### El servidor no se detiene

Usa Detener servidor en el lanzador y espera el mensaje de confirmación antes de cerrar. Las acciones ya confirmadas permanecen guardadas.

### Necesito un dato exacto

La Enciclopedia se genera desde los catálogos reales y contiene costes, requisitos, estadísticas, sistemas recientes y guías. Su calculadora permite consultar un nivel objetivo entre 1 y 100 sin modificar la partida. Es la referencia técnica; este manual explica el flujo y la estrategia.
