============================================================
DUNE 2000 ACCESIBLE - MANUAL DEL USUARIO
============================================================
Versión 2.5.0

ÍNDICE
------
1. Introducción
2. Requisitos del sistema
3. Instalación y ejecución
4. Menú principal
5. Modos de juego
6. Controles del juego
7. Facciones
8. Unidades
9. Edificios
10. Recursos y economía
11. Combate
12. Modo Historia
13. Sistema de guardado
14. Sistema de mods
15. Editor de mods y editor de historias
16. Crear historias personalizadas
17. Sistema de audio
18. Solución de problemas

============================================================
1. INTRODUCCIÓN
============================================================

Dune 2000 Accesible es un juego de estrategia en tiempo real
totalmente accesible para personas ciegas o con baja visión.
Está basado en el universo de Dune, donde tres grandes casas
luchan por el control del planeta desértico Arrakis y su
valioso recurso: la especia melange.

El juego utiliza audio posicional 3D y síntesis de voz (TTS)
para proporcionar toda la información necesaria al jugador.
Es compatible con lectores de pantalla como NVDA y JAWS.

============================================================
2. REQUISITOS DEL SISTEMA
============================================================

- Windows 7 o superior
- Python 3.8 o superior (solo para ejecución desde código)
- Lector de pantalla (NVDA, JAWS, o similar)
- Tarjeta de sonido
- 100 MB de espacio en disco

============================================================
3. INSTALACIÓN Y EJECUCIÓN
============================================================

DESDE CÓDIGO:
1. Ejecuta construir.bat
2. Selecciona opción 1 para crear entorno e instalar dependencias
3. Selecciona opción 2 para generar los archivos de audio
4. Selecciona opción 3 para ejecutar el juego

VERSIÓN COMPILADA:
1. Ejecuta Dune2000Accesible.exe para el juego
2. Ejecuta EditorMods.exe para el editor de mods

============================================================
4. MENÚ PRINCIPAL
============================================================

Al iniciar el juego se presenta el menú principal con las
siguientes opciones:

- Modo Historia: Juega una historia completa misión a misión
  hasta conquistar Arrakis. El progreso se guarda automáticamente.
- Campaña: Juega misiones individuales de cada facción
- Escaramuza: Partida rápida contra la IA en mapas predefinidos
- Cargar partida: Carga una partida guardada previamente
- Mapa personalizado: Juega en mapas creados por la comunidad
- Opciones: Configura volumen, velocidad de voz, nombre del
  jugador, velocidad de juego, idioma, música dinámica y
  alertas. Usa flechas izquierda y derecha para cambiar
  valores numéricos y listas. Enter para editar campos de texto.
- Enciclopedia: Información detallada de todas las unidades,
  edificios, mejoras y facciones del juego.
  En la lista de entradas, pulsa Espacio para escuchar la
  información rápida de la entrada seleccionada, o Enter
  para la descripción completa.
- Logros: Consulta tus logros desbloqueados y estadísticas.
- Mods: Activa o desactiva mods instalados
- Manual: Escucha este manual por voz
- Salir: Cierra el juego

Navegación en menús:
- Flechas arriba/abajo: Navegar entre opciones
- Enter: Confirmar selección
- Escape: Volver al menú anterior
- Tab: Siguiente opción
- Shift+Tab: Opción anterior
- Inicio: Primera opción
- Fin: Última opción
- F1: Ayuda
- Nota: Las flechas izquierda y derecha NO actúan en menús
  normales. Solo se usan en el menú de opciones para cambiar
  valores.

============================================================
5. MODOS DE JUEGO
============================================================

CAMPAÑA:
Sigue la historia de una de las tres casas a través de 9
misiones progresivas. Cada misión tiene objetivos específicos
y una narrativa que se presenta por voz al inicio.
Nota: Para jugar la campaña completa con progreso guardado,
usa el Modo Historia en su lugar.

MODO HISTORIA:
Juega una historia completa misión a misión. Al completar
cada misión, avanzas automáticamente a la siguiente. El
progreso se guarda entre sesiones. Si pierdes, puedes
reintentar la misión. Al completar todas las misiones,
conquistas Arrakis.

Historias disponibles:
- Tutorial Interactivo (3 lecciones): Aprende a jugar paso
  a paso con instrucciones guiadas por voz. Cubre navegación,
  selección, órdenes, recolección y construcción.
- Campaña Atreides (9 misiones): Honor y justicia
- Campaña Harkonnen (9 misiones): Dominación brutal
- Campaña Ordos (9 misiones): Astucia y sabotaje
- Los Hijos del Desierto (7 misiones): Juega como los Fremen
- La Guerra de las Casas (6 misiones): Guerra total
- El Mercader de Especia (5 misiones): Supervivencia económica
- Historias de mods: Las que instales desde mods activos

ESCARAMUZA:
Partida libre contra uno o más oponentes controlados por IA.
Selecciona tu facción, el mapa y comienza a jugar. El objetivo
es destruir a todos los enemigos.

Mapas disponibles:
- Desierto Pequeño (10x10, 2 jugadores)
- Desierto Mediano (15x15, 2 jugadores)
- Desierto Grande (20x20, 4 jugadores)
- Paso de Montañas (16x16, 2 jugadores): chokepoints
- Ruinas Antiguas (20x20, 2 jugadores): cobertura
- Cañón Profundo (24x24, 3 jugadores): tres zonas
- Guerra Total (32x32, 4 jugadores): épico

Mapa aleatorio: genera un mapa procedural balanceado con
bases equidistantes, recursos simétricos, terreno variado
y chokepoints naturales. Tamaños: 16x16, 20x20, 24x24, 32x32.

MAPA PERSONALIZADO:
Juega en mapas creados por la comunidad o por ti mismo usando
el editor de mods. Los mapas se colocan en data/mapas/personalizados/.

============================================================
6. CONTROLES DEL JUEGO
============================================================

NAVEGACIÓN POR EL MAPA:
- Flechas de dirección: Mover el cursor por el mapa
- T: Anunciar posición actual
- Espacio: Información detallada de la casilla actual
- B: Ir a la base principal
- N: Ir al siguiente evento importante

SELECCIÓN DE UNIDADES:
- S: Seleccionar unidades propias en la casilla actual
- A: Seleccionar todas las unidades (con conteo por tipo)
- Shift+A: Seleccionar solo unidades militares
- Shift+G: Seleccionar solo cosechadoras
- Tab: Ciclar entre unidades propias
- Shift+Tab: Ciclar entre unidades militares ociosas
- I: Información detallada de la selección
- Ctrl+1 a Ctrl+9: Asignar grupo de control
- 1 a 9: Seleccionar grupo de control

ÓRDENES:
- M: Mover selección a la casilla actual
- X: Atacar objetivo en la casilla actual
- P: Patrullar entre posición actual y casilla del cursor
- G: Recolectar especia en la casilla actual
- D: Detener todas las órdenes
- J: Capturar edificio enemigo (solo ingenieros)
- L: Transportar unidad terrestre (solo carryall)
- U: Descargar unidad transportada (solo carryall)
- Shift+orden: Encolar orden (Shift+M, Shift+X, etc.)

MODOS DE COMPORTAMIENTO (F3):
- Agresivo: Persigue y ataca enemigos cercanos
- Defensivo: Solo ataca si le atacan
- Mantener: No se mueve de su posición

CONSTRUCCIÓN Y PRODUCCIÓN:
- C: Menú de construcción de edificios
- E: Menú de entrenamiento de unidades
- V: Menú de investigación de mejoras
- Q: Ver cola de producción completa
- Shift+Q: Progreso rápido de producción (solo %)

PRODUCCIÓN RÁPIDA:
- Ctrl+T: Entrenar tanque de combate en la primera fábrica
- Ctrl+R: Entrenar cosechadora en la primera refinería
- Ctrl+I: Entrenar infantería ligera en el primer cuartel
Estos atajos buscan automáticamente el edificio productor
disponible, verifican especia y población, y encolan la
producción sin necesidad de navegar menús.

INFORMACIÓN:
- R: Anunciar recursos (especia, población)
- I: Información de la selección actual
- Shift+T: Indicador de amenaza por dirección (norte, sur,
  este, oeste) con nivel y tipo de enemigos visibles
- Shift+R: Resumen por región del mapa (9 zonas) con
  conteo de edificios, unidades, cosechadoras y enemigos
- F6: Resumen completo de batalla
- F7: Historial de mensajes

MARCADORES:
- F4: Marcar casilla con etiqueta personalizada
- F5: Navegar al siguiente marcador

VELOCIDAD:
- + (más): Aumentar velocidad de juego
- - (menos): Disminuir velocidad de juego

ECONOMÍA:
- O: Mercado del Puerto Espacial (comprar unidades)
- F9: Asignar rally point al edificio en casilla actual
- F10: Reparar edificio en casilla actual

SISTEMA:
- F1: Ayuda de teclas
- F2: Pausar/reanudar
- Escape: Menú de pausa

NOTIFICACIONES AUTOMÁTICAS:
- Progreso de producción: se anuncia al 50% y 75%
- Unidades ociosas: aviso periódico si hay militares sin
  órdenes. Usa Shift+Tab para ciclar entre ellas.

PERSONALIZACIÓN DE TECLAS:
Las teclas se pueden personalizar editando el archivo
data/teclas.ini. Cada acción tiene una tecla asignada
que se puede cambiar. Para restaurar las teclas por
defecto, borra el archivo y se regenerará.

============================================================
7. FACCIONES
============================================================

CASA ATREIDES:
Los Atreides son nobles y justos. Su fuerza reside en la
infantería de élite y la tecnología sónica. Cuentan con el
apoyo de los guerreros Fremen nativos de Arrakis.
Unidades especiales:
- Francotirador: Gran alcance y daño contra infantería
- Tanque Sónico: Daño en área con ondas de sonido
- Guerrero Fremen: Unidad de élite del Palacio

CASA HARKONNEN:
Los Harkonnen son crueles y despiadados. Confían en el poder
bruto de sus vehículos pesados y armas de destrucción masiva.
Unidades especiales:
- Trooper: Infantería pesada con misiles
- Devastador: Tanque ultra pesado con enorme poder de fuego
- Misil de la Muerte: Arma definitiva del Palacio

CASA ORDOS:
Los Ordos son astutos y calculadores. Prefieren la velocidad,
el sigilo y el sabotaje sobre la fuerza bruta.
Unidades especiales:
- Saboteador: Destruye edificios con explosivos
- Desviador: Convierte unidades enemigas temporalmente
- Raider: Vehículo rápido de asalto

============================================================
8. UNIDADES
============================================================

UNIDADES COMUNES (todas las facciones):
- Cosechadora: Recolecta especia. Sin armas. Esencial para
  la economía. Costo: 600 especia.
- Infantería Ligera: Soldado básico. Barato y rápido de
  entrenar. Costo: 50 especia.
- Infantería Pesada: Soldado con armadura. Más resistente
  y con mayor daño. Costo: 100 especia.
- Ingeniero: Puede capturar edificios enemigos. Sin armas.
  Costo: 500 especia.
- Triciclo: Vehículo ligero y rápido. Bueno para explorar.
  Costo: 250 especia.
- Quad: Vehículo medio con misiles. Costo: 350 especia.
- Tanque de Combate: Vehículo pesado principal.
  Costo: 500 especia.
- Tanque de Asedio: Artillería de largo alcance con daño
  en área. Costo: 600 especia.
- Lanzamisiles: Vehículo antiaéreo y de largo alcance.
  Costo: 550 especia.
- Carryall: Transporte aéreo. Costo: 400 especia.

============================================================
9. EDIFICIOS
============================================================

- Centro de Construcción: Edificio principal. Permite
  construir otros edificios. No se puede construir más.
- Generador Eólico: Provee población (5 unidades).
  Costo: 200 especia.
- Planta de Energía: Desbloquea edificios avanzados.
  Costo: 300 especia.
- Refinería: Procesa la especia recolectada. Entrena
  cosechadoras. Costo: 1500 especia.
- Cuartel: Entrena infantería. Costo: 400 especia.
- Fábrica Ligera: Produce vehículos ligeros.
  Costo: 600 especia.
- Fábrica Pesada: Produce vehículos pesados.
  Costo: 1000 especia.
- Centro de Alta Tecnología: Investiga mejoras.
  Costo: 1200 especia.
- Puerto Espacial: Produce unidades aéreas.
  Costo: 800 especia.
- Palacio: Desbloquea unidades especiales de facción.
  Costo: 2000 especia.
- Silo de Especia: Almacenamiento adicional.
  Costo: 150 especia.
- Torreta: Defensa automática. Costo: 300 especia.
- Muro: Barrera defensiva. Costo: 50 especia.

============================================================
10. RECURSOS Y ECONOMÍA
============================================================

La especia melange es el único recurso del juego. Se
recolecta enviando cosechadoras a los campos de especia
(casillas con especia en el mapa).

Ciclo de recolección:
1. La cosechadora va al campo de especia
2. Recolecta hasta llenar su capacidad (700)
3. Regresa a la refinería más cercana
4. Descarga la especia y repite

ALMACENAMIENTO DE ESPECIA:
La especia tiene un límite de almacenamiento. Si se excede,
la especia sobrante se pierde.
- Centro de Construcción: almacena 2000
- Refinería: almacena 1500
- Silo de Especia: almacena 1500
Construye silos para aumentar tu capacidad.

TASA DE RECOLECCIÓN:
Pulsa R para ver tu tasa de recolección actual (especia
por minuto). También se muestra en el resumen de batalla (F6).

RALLY POINTS:
Pulsa F9 sobre un edificio productor para asignar un rally
point. Las unidades producidas se moverán automáticamente
a esa casilla. Usa las flechas para elegir el destino y
Enter para confirmar.

REPARACIÓN DE EDIFICIOS:
Pulsa F10 sobre un edificio dañado para repararlo. La
reparación cuesta 50% del precio original del edificio y
se paga gradualmente mientras se repara.

MERCADO DEL PUERTO ESPACIAL:
Pulsa O para abrir el mercado. Permite comprar cualquier
unidad entrenable con un 50% de sobreprecio. La entrega
es instantánea en el Puerto Espacial. Requiere tener un
Puerto Espacial construido.

COLA DE REFINERÍA:
Si varias cosechadoras llegan a la misma refinería, hacen
cola y descargan una a la vez.

La población limita cuántas unidades puedes tener.
Construye Generadores Eólicos para aumentar el límite.

Consejo: Protege tus cosechadoras. Sin especia no puedes
producir nada.

============================================================
11. COMBATE
============================================================

El combate es automático cuando las unidades están en rango.
Las unidades atacan automáticamente a enemigos cercanos.

LÍNEA DE VISIÓN:
Las unidades de largo alcance necesitan línea de visión
directa al objetivo. Montañas y obstáculos bloquean los
disparos. Las unidades intentarán acercarse si no tienen
visión directa.

TIPOS DE DAÑO Y ARMADURA:
El juego tiene 4 tipos de daño y 4 tipos de armadura con
multiplicadores que afectan la efectividad:
- Normal: equilibrado contra todo
- Perforante: efectivo contra ligera (+20%), normal contra pesada
- Explosivo: devastador contra edificios (+50%) y pesada (+30%),
  débil contra infantería ligera (-50%)
- Concusivo: fuerte contra ligera (+50%), débil contra pesada (-30%)

Tipos de armadura: ligera (infantería, triciclo), pesada
(tanques, quad), edificio (todos los edificios).

VETERANÍA:
Las unidades ganan experiencia al combatir y suben de rango:
- Novato: sin bonificaciones
- Regular: +10% daño
- Veterano: +20% daño, +10% armadura, +5% velocidad
- Élite: +35% daño, +20% armadura, +10% velocidad
El rango se muestra con la tecla I (info de selección).

MORAL:
Cuando una unidad aliada muere cerca, las unidades cercanas
pierden moral. Con moral baja (<30%), las unidades no-élite
sufren -25% de daño durante un tiempo. La moral se recupera
gradualmente. Las unidades élite son inmunes.

COMBATE CUERPO A CUERPO:
Algunas unidades (infantería, Fremen) tienen bonus de daño
al atacar en la misma casilla que el enemigo. Las unidades
de largo alcance sufren -30% de daño si hay enemigos en su
misma casilla (supresión).

ATAQUE EN MOVIMIENTO:
Unidades rápidas como el Triciclo y el Raider Ordos pueden
disparar mientras se acercan al objetivo, con 50% de
precisión. Ideal para raids y hostigamiento.

FUEGO AMIGO:
El daño splash puede afectar a unidades aliadas. Esta opción
es configurable desde config.ini (fuego_amigo). Si está
activo, recibirás una alerta cuando tus unidades sean
dañadas por splash propio.

TERRENO TÁCTICO:
El terreno afecta al combate de forma significativa:
- Ruinas: las unidades dentro reciben +2 de armadura extra.
  Ideal para posiciones defensivas.
- Plataforma: las unidades encima ganan +1 de alcance.
  Perfecto para artillería y francotiradores.
- Acantilado: bloquea la línea de visión. Las unidades no
  pueden disparar a través de acantilados.
- Cañón: paso estrecho natural. Fácil de defender con pocas
  unidades. No se puede construir en cañones.
- Montaña: bloquea movimiento y visión. Crea barreras
  naturales en el mapa.

============================================================
12. MODO HISTORIA
============================================================

El Modo Historia es la forma principal de jugar. Avanzas
misión a misión hasta conquistar todo Arrakis.

CÓMO FUNCIONA:
1. Selecciona "Modo Historia" en el menú principal
2. Elige "Nueva historia" o "Continuar historia"
3. Para nueva historia: selecciona la historia y tu facción
4. Antes de cada misión puedes ver información o comenzar
5. Al ganar una misión, avanzas a la siguiente automáticamente
6. Si pierdes, puedes reintentar o guardar y salir
7. Al completar todas las misiones, ganas la historia

BRIEFING Y DEBRIEFING (8.1):
Antes de cada misión se reproduce música ambiental y se lee
un texto de briefing que describe el contexto, los objetivos
y la situación. Pulsa cualquier tecla para continuar.
Al ganar o perder, se lee un debriefing con el resultado
y las consecuencias de la misión.

CARRY-OVER DE UNIDADES (8.2):
Al ganar una misión, hasta 5 de tus unidades supervivientes
se conservan para la siguiente misión. Se priorizan las más
valiosas (mayor vida máxima). Conservan su vida proporcional,
experiencia y nivel de veteranía. Al inicio de la siguiente
misión aparecen cerca de tu base. Si pierdes una misión,
las unidades carry-over se pierden.

DECISIONES NARRATIVAS (8.3):
En ciertos puntos de la historia, se te presentará una
decisión con dos opciones. Tu elección determina qué misión
jugarás a continuación. Por ejemplo, en la campaña Atreides
puedes elegir entre contraatacar la base enemiga o defender
un convoy de especia, cada opción lleva a una misión diferente.
Las decisiones se guardan en tu progreso.

EVENTOS SCRIPTED (8.4):
Las misiones pueden incluir eventos que se activan durante
la partida según condiciones: al llegar a cierto turno,
al acumular especia, al explorar una casilla, etc. Los
eventos pueden enviar refuerzos aliados o enemigos, cambiar
el objetivo de la misión, dar bonus de especia o mostrar
mensajes narrativos.

DIFICULTAD PROGRESIVA (8.5):
La dificultad de la IA escala automáticamente según avanzas:
- Misiones 1-3: IA fácil
- Misiones 4-6: IA normal
- Misiones 7-9: IA difícil
- Misiones 10+: IA brutal
Si tienes una dificultad específica en opciones, se respeta.

OBJETIVOS VARIADOS (8.6):
Las misiones pueden tener diferentes condiciones de victoria:
- Destruir enemigos: el objetivo clásico
- Recolectar especia: acumular una cantidad específica
- Construir edificio: construir un edificio determinado
- Capturar: capturar un edificio enemigo específico
- Contrarreloj: sobrevivir un número de turnos
- Escoltar: mantener una unidad viva hasta el final

BONUS DE PROGRESO:
Al avanzar en la historia, recibes un bonus de especia
equivalente al 10% de toda la especia acumulada en misiones
anteriores. Esto recompensa jugar bien las misiones previas.

HISTORIAS INCLUIDAS:

Campaña Atreides - El Honor de Arrakis (9 misiones):
  Desde la llegada a Arrakis hasta la victoria final.
  Misiones de recolección, defensa y conquista.

Campaña Harkonnen - Puño de Hierro (9 misiones):
  Aplasta toda resistencia con fuerza bruta.
  Misiones de combate intenso y dominación.

Campaña Ordos - Sombras del Desierto (9 misiones):
  Usa la astucia y el engaño para prevalecer.
  Misiones de infiltración y estrategia.

Los Hijos del Desierto (7 misiones):
  Juega como los Fremen nativos de Arrakis.
  Defiende tu hogar de los invasores y libera el planeta.
  Misiones: El despertar del Sietch, Emboscada en las dunas,
  Recuperar el oasis, Asalto al puesto Harkonnen,
  La alianza Atreides, Guerra de guerrillas,
  Liberación de Arrakis.

La Guerra de las Casas (6 misiones):
  Guerra total entre las tres Casas por Arrakis.
  Misiones: Primer contacto, Escaramuza fronteriza,
  Batalla por los recursos, Asedio a la fortaleza,
  La gran ofensiva, Arrakis es nuestra.

El Mercader de Especia (5 misiones):
  Historia centrada en la economía y supervivencia.
  Acumula riquezas mientras te defiendes de rivales.
  Misiones: El primer cargamento, Expandir las operaciones,
  Proteger la inversión, El monopolio,
  El imperio comercial.

============================================================
13. SISTEMA DE GUARDADO
============================================================

GUARDAR PARTIDA:
Durante una partida, pulsa Escape y selecciona "Guardar
partida". La partida se guarda en data/guardado/ con toda
la información: unidades, edificios, recursos, terreno,
condiciones de victoria y progreso.

CARGAR PARTIDA:
Desde el menú principal, selecciona "Cargar partida".
Se muestra la lista de partidas guardadas con el título
del mapa, turno y fecha.

GUARDAR HISTORIA:
El Modo Historia guarda el progreso automáticamente antes
de cada misión. También puedes guardar y salir desde el
menú pre-misión. El progreso se guarda en
data/guardado/historias/.

CONTINUAR HISTORIA:
Desde "Modo Historia" > "Continuar historia" puedes
retomar cualquier historia en progreso. Se muestra la
misión actual, total de misiones y especia acumulada.

============================================================
14. SISTEMA DE MODS
============================================================

Los mods permiten modificar y ampliar el juego sin tocar
el código fuente. Se instalan en data/mods/.

Estructura de un mod:
  data/mods/nombre_mod/
    info.txt        - Información del mod
    reglas.txt      - Definiciones de unidades/edificios
    ia.txt          - Scripts de IA personalizados
    facciones.txt   - Facciones adicionales
    sonidos/        - Sonidos personalizados (.wav/.ogg)
    musica/         - Música personalizada (.wav/.ogg)
    mapas/          - Mapas adicionales
    campanas/       - Historias/campañas adicionales

Para activar un mod:
1. Coloca la carpeta del mod en data/mods/
2. En el menú principal, ve a "Mods"
3. Selecciona el mod y actívalo

Los mods se aplican en orden. Las definiciones del mod
sobreescriben las del juego base.

Las historias de mods activos aparecen automáticamente
en el Modo Historia.

============================================================
15. EDITOR DE MODS Y EDITOR DE HISTORIAS
============================================================

El editor de mods es una aplicación separada que permite
crear y editar mods de forma visual.

Para ejecutarlo:
- Desde código: construir.bat opción 4
- Compilado: EditorMods.exe

Funciones del editor:
- Crear nuevos mods
- Agregar/editar/eliminar unidades, edificios y mejoras
- Editar todas las propiedades numéricas y de texto
- Selectores desplegables para tipo_dano y tipo_armadura
- Checkbox para ataque_en_movimiento
- Validar el mod antes de guardarlo
- Validar balance de mapas (acceso a recursos, distancias,
  jugadores encerrados)
- Exportar el mod como archivo ZIP
- Editar información del mod (nombre, autor, versión)
- Editor de historias integrado (Ctrl+H)

EDITOR DE HISTORIAS (Ctrl+H):
Permite crear historias completas dentro de un mod:
- Crear nuevas historias con título y descripción
- Agregar, editar y quitar misiones
- Cada misión genera un archivo de mapa plantilla
- Editor de texto integrado para editar mapas directamente
- Las historias se guardan en campanas/ dentro del mod

Atajos del editor:
- Ctrl+N: Nuevo mod
- Ctrl+O: Abrir mod
- Ctrl+S: Guardar
- Ctrl+U: Agregar unidad
- Ctrl+B: Agregar edificio
- Ctrl+M: Agregar mejora
- Ctrl+D: Duplicar selección
- Ctrl+H: Editor de historias
- Delete: Eliminar selección
- F5: Validar mod
- Ctrl+E: Exportar como ZIP
- Ctrl+I: Información del mod

============================================================
16. CREAR HISTORIAS PERSONALIZADAS
============================================================

Puedes crear tus propias historias de dos formas:

MÉTODO 1: EDITOR DE MODS (recomendado)
1. Abre el editor de mods
2. Crea o abre un mod
3. Ve a Herramientas > Editor de historias (Ctrl+H)
4. Crea una nueva historia con un ID único
5. Agrega misiones una a una
6. Edita cada mapa de misión con el editor integrado
7. Guarda la historia
8. Activa el mod en el juego
9. La historia aparecerá en Modo Historia

MÉTODO 2: MANUAL (archivos de texto)
1. Crea una carpeta en data/campanas/nombre_historia/
   o en data/mods/tu_mod/campanas/nombre_historia/
2. Crea info.txt con:
     titulo: Mi Historia
     descripcion: Descripción de la historia
3. Crea misiones.txt con formato:
     mision_1|1|Nombre de la misión 1
     mision_2|2|Nombre de la misión 2
4. Crea carpeta mapas/ con un archivo por misión
5. Cada mapa sigue el formato estándar (ver abajo)

FORMATO DE MAPA:
  [mapa]
  titulo Nombre del Mapa
  columnas 10
  filas 10
  ancho_casilla 12
  objetivo Texto del objetivo.
  intro Texto de introducción narrado al inicio.
  condicion_victoria recolectar  ; o vacío para destruir enemigos
  objetivo_especia 5000          ; solo si condicion es recolectar
  objetivo_edificio cuartel      ; opcional, edificio requerido

  [terreno]
  ; col fila tipo [cantidad_especia]
  0 0 roca
  3 3 arena 3000

  [jugadores]
  ; nombre faccion equipo tipo col fila especia_inicial
  ; tipo: humano, facil, equilibrado, agresivo
  Jugador atreides 0 humano 0 0 5000
  Enemigo harkonnen 1 agresivo 9 9 4000

  [edificios]
  ; jugador_idx tipo col fila construido(1/0)
  0 centro_construccion 0 0 1
  1 centro_construccion 9 9 1

  [unidades]
  ; jugador_idx tipo col fila
  0 cosechadora 1 1
  1 infanteria_ligera 8 9

  [recursos]
  ; tipo col fila cantidad
  especia 3 3 4000

TIPOS DE TERRENO: arena, roca, especia, dunas, montaña,
  acantilado, cañón, ruinas, plataforma, especia_rica
TIPOS DE VICTORIA: destruir enemigos (por defecto),
  recolectar (acumular especia), construir (edificio específico)

EFECTOS DE TERRENO:
- Arena: terreno básico, transitable y construible
- Roca: terreno sólido, construible (para edificios)
- Montaña: intransitable, bloquea movimiento y visión
- Dunas: transitable pero no construible, ralentiza
- Acantilado: intransitable, bloquea visión (como montaña)
- Cañón: paso estrecho natural, transitable pero no construible
- Ruinas: cobertura defensiva, +2 armadura a unidades dentro
- Plataforma: terreno elevado, +1 alcance a unidades encima
- Especia rica: campo de especia de alta concentración

============================================================
17. SISTEMA DE AUDIO
============================================================

El juego cuenta con un sistema de audio avanzado diseñado para
máxima accesibilidad.

Música dinámica:
La música cambia automáticamente según el estado de la partida.
Hay 6 estados musicales: exploración (inicio), economía
(recolectando sin amenazas), escaramuza (combate menor),
tensa (combate activo), asedio (atacando base enemiga) y
desesperación (perdiendo). Las transiciones usan crossfade
suave para no interrumpir la experiencia.

Sonidos ambientales:
Al mover el cursor por el mapa, se reproduce un sonido de
fondo según el terreno: viento en arena y dunas, crujidos en
roca, silbido en montaña, ecos en ruinas, burbujeo en especia.

Feedback de órdenes:
Cada orden tiene un sonido y respuesta TTS diferenciada:
- Mover: "En camino"
- Atacar: "Objetivo localizado"
- Patrullar: "Patrulla iniciada"
- Recolectar: "Recolección iniciada"
- Detener: "Alto"
- Capturar: "Captura iniciada"
- Transportar: "Transporte en camino"
- Descargar: "Descarga iniciada"

Indicador sonoro de salud:
Al seleccionar una unidad, se reproduce un tono que indica su
estado: agudo (sana), medio (dañada), grave (baja), alarma
(crítica, menos del 25% de vida).

Sonar del mapa (Shift+S):
Barrido sonoro que reproduce secuencialmente la posición de
todas las entidades visibles, de izquierda a derecha con delay
entre cada sonido. Diferencia por tipo (infantería agudo,
vehículos medio, edificios grave, aéreos sierra) y bando
(aliados seno, enemigos cuadrada).

Audio posicional HRTF:
Los sonidos de combate y eventos usan posicionamiento estéreo
con HRTF básico: los sonidos detrás del oyente se atenúan y
los sonidos lejanos mezclan canales para simular difusión.

============================================================
18. STANCE INDIVIDUAL Y EVASIÓN (v2.7)
============================================================

STANCE INDIVIDUAL (Shift+F3):
Cada unidad puede tener su propio modo de comportamiento
independiente del modo global (F3). Esto permite tener un
grupo de tanques en modo agresivo mientras la infantería
defiende en modo mantener.

- Selecciona las unidades deseadas (S, Tab, o grupo)
- Pulsa Shift+F3 para ciclar entre: agresivo, defensivo,
  mantener, o "sin stance" (usa el modo global)
- El stance individual tiene prioridad sobre el modo global

EVASIÓN:
Las unidades rápidas tienen probabilidad de esquivar ataques:
- Triciclo: 15% de evasión
- Raider Ordos: 20% de evasión
- Fremen: 10% de evasión
- Veteranos nivel 2+: +5% adicional
La evasión se calcula por cada ataque recibido.

============================================================
19. SISTEMA DE ENERGÍA GRADUADO (v2.7)
============================================================

El sistema de energía ya no es binario (todo o nada).
Cada generador produce una cantidad de energía y cada
edificio avanzado consume una cantidad:

Producción:
- Planta de Energía: 100 energía
- Generador Eólico: 50 energía

Consumo:
- Palacio: 50 energía
- Centro de Alta Tecnología: 40 energía
- Fábrica Pesada: 30 energía
- Puerto Espacial: 20 energía

Si la producción es menor que el consumo:
- Los edificios más caros se apagan primero
- Edificios con energía parcial funcionan al 50% de velocidad
  (producción más lenta, torretas disparan menos)
- Sin generadores: todo se apaga

Consulta tu ratio de energía con R (recursos).

============================================================
20. BALANCE Y MEJORAS (v2.7)
============================================================

NUEVAS MEJORAS INVESTIGABLES:
- Rango Mejorado: +1 alcance (600 especia)
- Recolección Mejorada: -25% tiempo recolección (400 especia)
- Visión Mejorada: +2 rango de visión (350 especia)
Todas se investigan en el Centro de Alta Tecnología.

CAMBIOS DE BALANCE:
- Cosechadora: ahora tiene dano=5, alcance=1 (defensa mínima)
- Muro: armadura reducida de 8 a 6, costo de 50 a 100
- Misil de la Muerte: splash reducido de 5 a 3
- Tanque de Asedio: x2.0 daño contra edificios
- Fremen: máximo 5 activos simultáneamente
- Población: cuartel +3, fábricas +3/+5, puerto +3, palacio +10

EVENTOS ALEATORIOS:
Durante las partidas pueden ocurrir eventos aleatorios:
- Lluvia de meteoritos: daño en zona de arena
- Caravana de contrabandistas: bonus de especia
- Plaga de arena: reduce campos de especia temporalmente

============================================================
21. MODO SUPERVIVENCIA (v2.8)
============================================================

El modo Supervivencia es un desafío sin fin donde debes resistir
oleadas crecientes de enemigos.

CÓMO JUGAR:
- Selecciona "Supervivencia" en el menú principal
- Elige tu facción
- Se genera un mapa aleatorio de 16x16
- Empiezas con 8000 de especia

OLEADAS:
- Cada 200 turnos llega una nueva oleada de enemigos
- Las oleadas crecen en cantidad y tipo de unidades:
  Oleadas 1-2: infantería ligera
  Oleadas 3-4: + infantería pesada
  Oleadas 5-6: + triciclos
  Oleadas 7-9: + tanques de combate
  Oleadas 10-14: + lanzamisiles
  Oleadas 15+: + tanques de asedio
- Los enemigos aparecen en los bordes del mapa
- Se anuncia cada oleada con ubicación

VICTORIA:
- No hay victoria: el objetivo es sobrevivir el mayor
  número de oleadas posible
- La partida termina cuando pierdes todos tus edificios
  y unidades

============================================================
22. SISTEMA DE REPLAY (v2.8)
============================================================

Cada partida se graba automáticamente como replay.

GRABACIÓN:
- Se inicia automáticamente al empezar cualquier partida
- Se guardan todos los comandos con su turno
- Al finalizar, se guarda en data/replays/

ARCHIVOS:
- Formato: replay_YYYYMMDD_HHMMSS.json
- Contiene: semilla del mapa, jugadores, comandos

============================================================
23. NUEVA CAMPAÑA: LOS CONTRABANDISTAS (v2.8)
============================================================

Una nueva historia de 5 misiones donde lideras una banda de
contrabandistas en las sombras de Arrakis.

MISIONES:
1. Primer golpe: establece tu base y recolecta 3000 especia
2. Territorio disputado: destruye la base Atreides
3. La emboscada: sobrevive 80 turnos rodeado por Harkonnen
4. Asalto a la refinería: captura la refinería enemiga
5. El señor del desierto: batalla final contra dos Casas

Accesible desde Modo Historia o Campaña en el menú principal.

============================================================
24. FACCIÓN FREMEN (v2.9)
============================================================

Los Fremen son una nueva facción jugable, guerreros del
desierto y maestros de la supervivencia en Arrakis.

UNIDADES ÚNICAS:
- Guerrillero Fremen: infantería rápida con 15% evasión
- Fedaykin: élite cuerpo a cuerpo con 20% evasión
- Jinete de Gusano: vehículo pesado montado en gusano

EDIFICIO BASE: Sietch Fremen (reemplaza Centro de Construcción)

CAMPAÑA: 7 misiones "Los Guerreros del Desierto"
1. La Prueba del Desierto: recolecta especia
2. Asalto al Puesto Harkonnen: destruye base enemiga
3. La Cosecha Sagrada: recolecta 8000 especia
4. Defensa del Sietch: sobrevive 100 turnos
5. Alianza con Atreides: ataque conjunto
6. El Gusano Sagrado: construye un palacio
7. Liberación de Arrakis: batalla final

============================================================
25. UNIDADES NAVALES Y ANFIBIAS (v2.9)
============================================================

Nuevo terreno acuático "agua" en mapas. Las unidades navales
solo pueden moverse por agua, las anfibias por tierra y agua.

NUEVAS UNIDADES:
- Barcaza: transporte naval (capacidad 2)
- Fragata: combate naval con daño explosivo y splash
- Explorador Anfibio: vehículo rápido que va por tierra y agua

MAPA: "Costa de Arrakis" (escaramuza con zona acuática)

============================================================
26. SISTEMA DE ALIANZAS DINÁMICAS (v2.9)
============================================================

Tecla Y abre el menú de diplomacia durante la partida.
Puedes proponer, aceptar o romper alianzas con otros jugadores.

Las alianzas cambian el equipo del jugador para evitar ataques
entre aliados. La IA responde según su facción:
- Harkonnen: nunca acepta alianzas
- Ordos: acepta si tiene menos unidades que tú
- Atreides y Fremen: aceptan fácilmente

============================================================
27. SISTEMA DE SUMINISTROS (v2.9)
============================================================

Las unidades militares necesitan estar cerca de edificios
aliados (radio de 8 casillas) para mantener su efectividad.

Fuera de suministro: -30% de daño.
Se verifica cada 20 turnos. Mostrado en info de unidad (I).

Construye Depósitos de Suministros para extender el radio.

============================================================
28. ORIENTACIÓN DE EDIFICIOS (v2.9)
============================================================

Las torretas tienen un sector de disparo configurable.
Tecla F11 rota el edificio 90 grados.
TTS anuncia la dirección (norte/este/sur/oeste).

============================================================
29. SERIALIZACIÓN BINARIA (v2.9)
============================================================

Opción formato_guardado en config.ini:
- "json" (por defecto): guardado legible
- "binario": guardado rápido con pickle

Ambos formatos se detectan automáticamente al cargar.

============================================================
30. SOLUCIÓN DE PROBLEMAS
============================================================

El juego no inicia:
- Verifica que tienes Python 3.8 o superior
- Ejecuta construir.bat opción 1 para instalar dependencias
- Verifica que tu lector de pantalla está activo

No se escucha audio:
- Verifica el volumen del sistema
- Ejecuta construir.bat opción 2 para generar audio
- Verifica que la carpeta data/sonidos/ tiene archivos .wav

El TTS no funciona:
- Verifica que tienes un lector de pantalla activo
- NVDA o JAWS deben estar ejecutándose
- Verifica la instalación de accessible_output2

Los mods no se cargan:
- Verifica que el mod está en data/mods/
- Verifica que el mod está activado en el menú de mods
- Verifica que reglas.txt del mod tiene formato correcto

============================================================
Dune 2000 Accesible - Versión 2.8.0
============================================================
