Etapa 2: importar y exportar mapas del editor oficial de escritorio

[leocagli]

Parte de #2 (modo construcción). Depende de la capa de persistencia. Se beneficia del research de #14.

La oportunidad

El editor de mapas de Argentum Online existe desde hace más de veinte años: ao-org/argentum-online-worldeditor, escrito en VB6, de escritorio, AGPL-3.0.

Eso significa dos cosas:

1. Hay mapas ya hechos. Veinte años de comunidad produciendo mundos con esa herramienta. Poder importarlos es contenido gratis.
2. Hay gente que ya sabe usarlo. Un mapper con experiencia no debería tener que empezar de cero: debería poder traer su trabajo.

El modo construcción in-game no compite con esa herramienta, la complementa. La diferencia es el acceso: instalar un editor VB6 de 2003 contra abrir una pestaña.

Alcance

1. Importar mapas en el formato del editor oficial (los .map, .inf y .dat clásicos) al formato de este proyecto (meta / terrain / npcs / specials).
2. Reportar qué se pudo traducir y qué no, en vez de fallar en silencio o perder datos.
3. Exportar en sentido inverso, para que alguien pueda seguir editando con la herramienta de escritorio si prefiere.
4. Un modo de validación que compare un mapa importado contra el original y liste las diferencias.

Lo difícil

Los formatos no son equivalentes. Cosas a resolver:

• Los índices de gráficos pueden no coincidir entre versiones del juego
• Los triggers y zonas especiales del formato original pueden no tener equivalente
• El editor oficial es AGPL-3.0: hay que revisar qué implica para reutilizar su código o su documentación de formato. Leer el formato no debería ser problema, copiar código sí lo es.

Criterios de aceptación

• Un mapa del editor oficial se importa y se puede jugar
• La importación reporta explícitamente lo que no pudo traducir
• Exportar e importar de vuelta produce un mapa equivalente
• Hay tests con al menos un mapa real de ejemplo
• Está documentada la situación de licencia

Por qué importa para el proyecto

Es lo que convierte el modo construcción de "una herramienta nueva que hay que aprender" en "la forma más fácil de seguir trabajando en lo que ya venías haciendo". Para una comunidad que ya existe, eso es la diferencia entre adopción y indiferencia.

[atiqur-rahman-pro]

Hola @Bitcoindefi!

Esta funcionalidad de importación/exportación del formato clásico de WorldEditor (.map, .inf, .dat) es clave para la compatibilidad con el contenido legacy de Argentum Online.

Puedo encargarme de implementar:

1. El parser limpio (Cleanroom parser) para la lectura/escritura de archivos .map, .inf y .dat.
2. La transformación bidireccional al esquema de OpenAO (meta, terrain, npcs, specials).
3. El reporte de advertencias para elementos no mapeables (índices gráficos / triggers especiales).
4. Pruebas unitarias de ida y vuelta (round-trip tests) usando un mapa clásico real de prueba.

¿Te gustaría que dividamos el trabajo en sub-módulos (Parser -> Translator -> Exporter) o prefieres una sola propuesta con los tests correspondientes?