ProjectX

Constructor de colonia espacial isométrico con RTS/tower-defense para iOS (Swift + SwiftUI + renderer Metal puro, sin SpriteKit). El jugador compite por las mismas vetas de recursos contra hasta 4 facciones IA simétricas en mapas diseñados a mano con relieve montañoso, o sobrevive a oleadas de enemigos.

• Plataforma: iOS 17+ · Swift 5 · SwiftUI · MetalKit · @Observable/@MainActor.
• Modos: Mundo Libre (colonias rivales IA), Survival (oleadas) y Campaña (pendiente).
• Recursos: metal + biomasa (minables) y energía (red de flujo). I+D en biomasa.
• Motor reentrante por facción: el mismo BuildSystem/MinionSystem/ExplorationSystem/ResearchSystem representa a cualquier facción; paridad jugador/IA por construcción. Sin trampas de IA.

Estructura

• ProjectX/Engine/ — motor Metal, geometría, cámara, mapas, iluminación.
• ProjectX/Game/ — lógica de juego, sistemas, IA, UI (SwiftUI).
• ProjectXSim/ — harness CLI headless de benchmarking IA-vs-IA (target activo).

Documentación

• projectx.md — documento general y autoritativo del juego (16 secciones): visión, modos, arquitectura, sistemas, balance, rendimiento. Empieza aquí.
• doctrina-tactica.md — doctrina táctica de la IA (localización, conversión, viraje al aire, anti-espejo).
• iluminacion.md — sistema de iluminación del renderer (sol día/noche, sombras, emisivas, luces puntuales, bloom HDR, partículas).
• reestructuracion-grupos.md — grupos de control por (planta, tipo) y consolidación del catálogo militar.

Notas de desarrollo

• La compilación se hace en Xcode (más ProjectXSim para benchmarks). Balance.swift es la fuente única de constantes.
• Las roturas de formato de guardado se aceptan (instalación limpia, sin migración).

Documentación revisada y reconciliada con el código fuente en jul 2026.