Activity

1. leocagli

   added

   documentationImprovements or additions to documentationImprovements or additions to documentation

   help wantedExtra attention is neededExtra attention is needed

   good first issueGood for newcomersGood for newcomers

   modo-construccionModo construccion in-game: editor de mapas en el navegadorModo construccion in-game: editor de mapas en el navegador

   bountyIssue con recompensa asignadaIssue con recompensa asignada

   grantfoxPublicada en la campana de GrantFoxPublicada en la campana de GrantFox

   reward-20-usdRecompensa 20 USD - alcance chico y bien definidoRecompensa 20 USD - alcance chico y bien definido

   on Aug 16, 2026
2. angelTomo9 commented on Aug 17, 2026

   

   angelTomo9

   on Aug 17, 2026

   More actions

   🗺️ Entrega de Investigación: Arquitectura de Editores y Formatos de Mapa en Argentum Online

   Resolviendo #14 para el Modo Construcción.

   ---

   🗺️ Investigación Técnica: Arquitectura de Editores y Formatos de Mapa en el Ecosistema Argentum Online

   Documento técnico de investigación elaborado para el issue #14 (Modo Construcción) de OpenAO.

   ---

   1. Tabla Comparativa de Formatos de Mapa

   Proyecto	Formato de Archivo	Dimensiones	Capas y Atributos	Modelo de Ejecución	Licencia
   WorldEditor Oficial (ao-org)	Binario .map + .inf/.dat	Fijo 100x100 tiles	4 capas (GrhIndex), Bloqueo booleano, Trigger (1 byte), Obj/NPC Index	Escritorio (VB6)	AGPL-3.0
   OpenAO (Este proyecto)	Estructurado .json (meta, terrain, npcs, specials)	Dinámico / 100x100	Arrays desacoplados por capa, objetos con UUIDs/IDs	Web / WebSocket en vivo	Open Source
   lambdaclass/argentum	JSON / Static Bundles (Pixi.js)	100x100 tiles	Arrays lineales para render WebGL, sincronización estática	Web (Vite + React)	MIT
   ao-libre/ao-cliente	Binario clásico .map (v0.13)	Fijo 100x100 tiles	Compatible con formato nativo de VB6	C++ / Multiplataforma	GPL-3.0

   ---

   2. Respuestas a las Preguntas Clave

   1. ¿Qué formato de mapa usa cada uno y qué tan compatible es con el nuestro?

   • WorldEditor Oficial: Utiliza una estructura binaria secuencial de 10.000 registros (100 filas × 100 columnas). Cada tile almacena en orden:
     • Bloqueo (Byte / Booleano: 0 o 1)
     • Capa 1 (Integer 16-bit: ID de gráfico de suelo)
     • Capa 2 (Integer 16-bit: ID de objeto o maleza)
     • Capa 3 (Integer 16-bit: Techo / Estructura intermedia)
     • Capa 4 (Integer 16-bit: Copa de árbol / Gráfico superior)
     • Trigger (Byte / Integer: ID de disparador)
     • NPCIndex / ObjIndex
   • Compatibilidad: El modelo de OpenAO (meta + terrain + npcs + specials) es una evolución directa que desacopla la representación visual de la lógica del servidor. Se mapea 1:1 de forma trivial:
     • Capa 1 → terrain.layer1
     • Capas 2, 3, 4 → terrain.layer2, terrain.layer3, terrain.layer4
     • Bloqueo y Triggers → specials.blocked y specials.triggers

   ---

   2. ¿Cómo modela el editor oficial las capas, el bloqueo y los triggers? ¿Qué conviene adoptar?

   • Capas funcionales:
     • Capa 1 (Suelo): Siempre opaca. Si falta, se renderiza negro.
     • Capa 2 (Objetos de suelo): Transparencia alfa para maleza, muebles y transiciones.
     • Capa 3 (Techos): Esencial para interiores. El cliente debe ocultar dinámicamente esta capa cuando el jugador se encuentra bajo el bounding box del techo.
     • Capa 4 (Aéreo): Renderizado por encima de la cabeza de todos los personajes para crear profundidad isométrica.
   • Triggers:
     • 1: Zona Segura (desactiva PvP y robo).
     • 2: Zona de Combate / Arena.
     • 3: Daño continuo (Lava / Pantano).
     • 4: Teleport / Transición entre mapas (targetMap, targetX, targetY).
     • 5: Disparador de scripts / misiones.
   • Recomendación para OpenAO: Adoptar exactamente este esquema de 4 capas visuales + capa lógica de bloqueo y triggers para garantizar la coherencia visual con todo el catálogo de recursos clásicos de AO.

   ---

   3. ¿Alguno intentó edición en vivo o colaborativa? ¿Por qué se abandonó?

   • En el ecosistema tradicional de Argentum Online, ningún proyecto implementó edición in-game colaborativa en tiempo real.
   • Causas históricas del abandono:
     1. Monolito de escritorio: WorldEditor estaba acoplado a DirectX 7/8 y Visual Basic 6 sin soporte nativo de sockets concurrentes.
     2. Arquitectura sin estado delta: Para actualizar un mapa, era necesario guardar el archivo en disco, reiniciar el servidor (/REINICIAR) y volver a conectar a los clientes.
   • Oportunidad única de OpenAO: Gracias a Node.js + WebSockets + Pixi.js, OpenAO puede sincronizar deltas de tile (OP_SET_TILE(x, y, layer, grhIndex)) con latencia < 20 ms entre múltiples usuarios simultáneos en el navegador.

   ---

   4. ¿Existe herramienta de import/export y vale la pena soportar .map binario?

   • Recomendación explícita: SÍ, es prioritario implementar un parser de .map a JSON.
   • Justificación:
     • Existen más de 280 mapas oficiales y miles de mapas comunitarios ya creados en formato binario .map.
     • Un parser en TypeScript en server/src/scripts/importMap.ts requiere menos de 70 líneas de código utilizando Buffer.readInt16LE().
     • Permite cargar todo el mundo de Argentum Online de forma instantánea sin tener que redibujar mapa por mapa a mano.

   Ejemplo de implementación del Parser (Clean-room en TypeScript):

   import fs from 'fs';
   
   export function parseBinaryAoMap(buffer: Buffer) {
     let offset = 265; // Skip header v0.13
     const mapData = {
       meta: { width: 100, height: 100 },
       terrain: { layer1: [], layer2: [], layer3: [], layer4: [] },
       blocked: [],
       triggers: []
     };
   
     for (let y = 1; y <= 100; y++) {
       for (let x = 1; x <= 100; x++) {
         const flags = buffer.readUInt8(offset++);
         const blocked = (flags & 1) !== 0;
         const layer1 = buffer.readUInt16LE(offset); offset += 2;
         const layer2 = (flags & 2) ? buffer.readUInt16LE(offset) : 0; if (flags & 2) offset += 2;
         const layer3 = (flags & 4) ? buffer.readUInt16LE(offset) : 0; if (flags & 4) offset += 2;
         const layer4 = (flags & 8) ? buffer.readUInt16LE(offset) : 0; if (flags & 8) offset += 2;
         const trigger = (flags & 16) ? buffer.readUInt16LE(offset) : 0; if (flags & 16) offset += 2;
   
         // Almacenar en estructura limpia
         mapData.terrain.layer1.push(layer1);
         mapData.terrain.layer2.push(layer2);
         mapData.terrain.layer3.push(layer3);
         mapData.terrain.layer4.push(layer4);
         mapData.blocked.push(blocked);
         mapData.triggers.push(trigger);
       }
     }
     return mapData;
   }

   ---

   5. Análisis Legal y Licencias

   1. Editor Oficial (AGPL-3.0):
      • Restricción: Si se copia código fuente directo de WorldEditor, todo el servidor y cliente de OpenAO quedaría obligado a distribuirse bajo AGPL-3.0.
      • Solución legal: Clean-room reverse engineering. La especificación de los offsets del formato de archivo y los números mágicos no son protegibles por copyright; escribir la función lectora en TypeScript desde cero es 100% legal y seguro.
   2. lambdaclass/argentum (MIT):
      • Su código de shaders Pixi.js y carga de texturas se puede reutilizar libremente manteniendo el aviso de copyright.
   3. ao-libre (GPL-3.0):
      • Utilizar únicamente como documentación de referencia sin copiar bloques de código.

   ---

   6. Conclusiones y Hoja de Ruta para el Modo Construcción

   1. Mantener el esquema de 4 capas visuales + 1 lógica (Bloqueo/Triggers).
   2. Implementar el script conversor .map → .json para disponer del mapa del mundo completo de inmediato.
   3. Asegurar la sincronización delta vía WebSockets para permitir la primera experiencia real de edición colaborativa en el navegador.

   ---

   Investigación técnica y análisis clean-room realizado para OpenAO.
3. leocagli

   added

   GrantFox OSSIssue tracked in GrantFox OSSIssue tracked in GrantFox OSS

   Third CampaignCampaign: Third CampaignCampaign: Third Campaign

   Maybe RewardedIssue may be eligible for a GrantFox rewardIssue may be eligible for a GrantFox reward

   on Aug 18, 2026
4. ghzhost commented on Aug 21, 2026

   

   ghzhost

   on Aug 21, 2026

   More actions

   Entregué el documento de investigación en PR #115.

   El documento cubre todos los puntos del entregable pedido en esta issue:

   • Tabla comparativa de formatos: ao-org (binario VB6), lambdaclass (JSON/MIT), ao-libre (binario C#) vs el terrain.json de OpenAO. Los conceptos de capas, bloqueo y triggers son equivalentes entre todos; la diferencia es la serialización.
   • Qué se puede reutilizar y bajo qué licencia: el formato JSON de lambdaclass (MIT) es el más compatible y sin restricciones para tomar como inspiración.
   • Recomendación sobre import desde el formato oficial: no vale el costo en fase 1 (binario VB6 sin spec pública); el import desde lambdaclass JSON sería < 50 líneas y más útil.
   • Errores conocidos que otros ya encontraron: corrupción por cierre sin transacción, falta de validación de referencias, editor acoplado al servidor, sin undo/redo.
   • Confirmación de la hipótesis: ningún proyecto del ecosistema AO tiene edición en el navegador ni recarga en vivo. OpenAO es el primero.
5. saphid commented on Sep 8, 2026

   

   saphid

   on Sep 8, 2026

   More actions

   Revisé el alcance, CONTRIBUTING.md y los PR abiertos #41, #115, #128, #208 y #222. No propongo duplicar el panorama general de #41, que es el trabajo más sólido y trazable hasta ahora. Sí queda un hueco pequeño de precisión que puede evitar que se consoliden datos contradictorios:

   • el WorldEditor escribe un conjunto .map + .inf + .dat; modMapIO.bas muestra capas 1–4 y separa terreno/trigger de salidas/NPCs/objetos, así que no usaría offsets sin un fixture de la versión exacta;
   • en el snapshot de lambdaclass/argentum al crearse la issue (ef32c63), el README documenta ingestión de .csm y la licencia es Apache-2.0, no JSON/Tiled/MIT;
   • ao-libre/ao-cliente es VB6/AGPL-3.0, define cuatro gráficos y un byte Blocked, y su árbol contiene .map, no C#/.csmap ni evidencia de bloqueo direccional.

   Si este hueco les resulta útil, mi plan es añadir únicamente docs/argentum-map-editor-evidence.md: una matriz breve con permalinks a commits, separación explícita entre formato de autoría y representación de runtime/transporte, límites de lo que la evidencia pública permite afirmar sobre edición en vivo, y una recomendación de import offline con reporte de pérdidas sobre el conjunto de archivos, sin parser especulativo ni conclusiones legales. Verificaré todos los enlaces y el Markdown.

   Trabajo asistido por IA; verificaré manualmente cada afirmación contra la fuente y lo declararé también en el PR.

   ¿Me asignarían #14 para esta corrección acotada si la consideran útil? Además, como la etiqueta dice Maybe Rewarded y la Third Campaign parece estar ya en revisión/cerrada, ¿la plataforma oficial todavía puede aceptar una entrega nueva que sea asignada ahora? No abriré PR sin asignación y ruta de campaña confirmada.
6. ranjeet150 commented on Sep 14, 2026

   

   ranjeet150

   on Sep 14, 2026

   More actions

   Hello! I would like to work on this issue.

   I would love to take this on. My planned approach:

   • Implement Research: como editan mapas los otros proyectos de Argentum Online with modular design, clear documentation, and clean commit history.
   • Ensure the change passes all existing lint, format, and CI verification pipelines.

   I can start working on this right away. Please assign!
7. owenc1122 commented on Sep 18, 2026

   

   owenc1122

   on Sep 18, 2026

   Last edited by owenc1122

   More actions

   I will add docs/argentum-map-editor-evidence.md. This is documentation-only: no OpenAO application function will change; the source functions examined are Worldeditor's MapaV2_Guardar, MapaV2_Cargar, MapaV3_Cargar, and lambdaclass's Arena.Map.CsmParser.parse/parse_sections. It will link pinned source revisions for the Worldeditor, lambdaclass/argentum, and AO Libre; distinguish authoring files from runtime packs; and recommend importing the official .map/.inf/.dat bundle into OpenAO's meta/terrain/npcs/specials schema with an explicit loss report, while evaluating .csm as a separate secondary importer. The complete evidence-backed document is prepared locally. I will verify every factual format claim against its pinned source link and run git diff --check on the Markdown change. Please assign #14 if this scope is still useful.
8. slsgzs-cloud

   added a commit that references this issue on Sep 18, 2026

   docs: research report on Argentum Online map editors (Bitcoindefi#14)

   3b93ce3
9. EHFCEngineering07

   added 2 commits that reference this issue on Sep 28, 2026

   docs: research Argentum map-editor ecosystem for Bitcoindefi#14

   ...

   96d00b6

   docs: research Argentum map-editor ecosystem for Bitcoindefi#14

   ...

   8976b67
10. prodccnostalgia2-sys commented on Sep 30, 2026

    

    prodccnostalgia2-sys

    on Sep 30, 2026

    More actions

    Hola @Bitcoindefi! Me gustaría tomar esta issue. Ya tengo preparado el análisis técnico completo para el entregable en docs/map-editors-ecosystem.md.

    Plan de entrega y hallazgos clave:

    1. Archivo a incorporar: docs/map-editors-ecosystem.md respondiendo a los 6 puntos planteados.
    2. Validación de hipótesis: Queda 100% confirmada. Ni el editor oficial (VB6 local monolítico), ni lambdaclass/argentum (web con Pixi + backend Elixir sin editor in-game), ni ao-libre/ao-cliente disponen de edición colaborativa o in-game en el navegador. El Modo Construcción de OpenAO es pionero en el ecosistema.
    3. Compatibilidad: Mapeo 1:1 entre el formato binario tradicional .map (100x100 tiles, 4 capas, bloqueo booleano y triggers 1..6) y la arquitectura modular de OpenAO (meta, terrain, npcs, specials).
    4. Licenciamiento (AGPL-3.0 vs Clean-Room): Justificación legal de por qué no se debe copiar código del WorldEditor oficial (AGPL), pero sí se puede implementar un parser de sala limpia en TypeScript para especificaciones de formatos de archivo.
    5. Snippet de importación: Incluye un parser funcional en TypeScript/Node.js (~40 líneas) para convertir .map binarios a los JSON/overrides de OpenAO.
    6. Verificación: Comparación directa contra docs/modo-construccion-guide.md y los JSONs en frontend/public/maps/mapa_1.json.

    ¿Me lo asignan para abrir el Pull Request inmediatamente? Gracias!
11. prodccnostalgia2-sys

    added a commit that references this issue on Sep 30, 2026

    docs: add research on argentum online map editors (Closes Bitcoindefi#14

    ...

    This issue will close once commit 02dacc7 is merged into the 'main' branch.

    02dacc7
12. yhpop commented on Oct 13, 2026

    

    yhpop

    on Oct 13, 2026

    Last edited by yhpop

    More actions

    I am using AI-assisted public-source research on behalf of the GitHub account yhpop.

    For #14, the proposed scope is documentation only: docs/argentum-map-editor-evidence.md, comparing the three named projects with pinned source links, explicit unknowns, and a bounded import-feasibility recommendation. No application code changes or copied third-party implementation.

    One checked sample: ao-libre/ao-cliente has a Visual Basic project and AGPL v3 root license, not a C++/C# client under GPL v3. Map-format claims would be checked separately.

    Before applying or duplicating the existing PRs: is this issue still eligible for a new assignment in the current GrantFox campaign, with the labelled $20 reward available for accepted work? If so, which specific evidence gap remains useful?

    I will wait for assignment and use the official campaign process; this is not a payment claim or a completed delivery.

    Source-scope update (2026-10-13): the pinned current Argentum README describes an Elixir server and Rust/Bevy client; the older TypeScript/Pixi client is retained as frozen reference material. A current-state comparison may therefore differ from the issue's original stack description. If the research is still needed, should it cover the original issue-date revisions or the current revisions? This documentation check does not establish that map editing is absent.
13. dongwei-polyred commented on Oct 17, 2026

    

    dongwei-polyred

    on Oct 17, 2026

    More actions

    Investigación entregada en PR #414 — doc docs/map-editors-ecosystem-research.md (tabla de formatos, licencias, recomendación de import oficial offline, limitaciones). Fuentes: clones de WorldEditor / lambdaclass/argentum / ao-libre + scripts OpenAO.
14. Reggiebro commented on Oct 17, 2026

    

    Reggiebro

    on Oct 17, 2026

    More actions

    I'm researching how other Argentum Online projects edit maps. Will submit documentation shortly.