El build de Docker produce un frontend sin mapas: el mundo no se dibuja

[leocagli]

Síntoma

Se despliega el juego con Docker siguiendo el repo, el jugador entra, y el mundo no se dibuja. El personaje y el HUD aparecen, pero el terreno queda vacío. En la consola del navegador:

404 /maps_optimized/mapa_1.json
404 /maps_optimized/mapa_5.json
404 /maps_optimized/mapa_8.json
...

Causa

frontend/public/maps_optimized/ no está en el repo (está en .gitignore). Se genera con:

cd server && pnpm export-frontend-maps

Ese script lee los 294 mapas de server/mapas_source/ y escribe los optimizados en frontend/public/maps_optimized/.

El problema es que el Dockerfile del frontend no ejecuta ese paso. Hace pnpm build de Next, que copia public/ tal como esté. Si la carpeta no fue generada antes, la imagen queda sin los mapas y el cliente pide archivos que no existen.

Es un fallo silencioso: el build termina bien, el contenedor arranca bien, la página carga bien. Falla recién cuando un jugador entra al mundo.

Cómo reproducir

Clonar limpio y construir el frontend con Docker sin generar los mapas antes. Entrar al juego y mirar la consola.

Propuesta

Cualquiera de estas, en orden de preferencia:

1. Que el Dockerfile del frontend genere los mapas antes del pnpm build. Requiere que server/mapas_source/ esté disponible en el contexto de build, así que hay que pensar el contexto o hacerlo multi stage.
2. Un script de setup documentado en el README que haya que correr antes de cualquier build, y que el propio build falle con un mensaje claro si la carpeta no está.
3. Versionar los mapas optimizados. Son 20 MB, lo cual no es ideal en git, pero elimina el paso y el modo de fallo.

Mínimo aceptable: que el build falle ruidosamente en vez de producir una imagen rota.

Criterios de aceptación

• Un clon limpio y un build de Docker producen un frontend que dibuja el mundo
• Si faltan los mapas, el build falla con un mensaje que explica qué correr
• El README documenta el paso, si sigue siendo manual

Archivos relevantes

• frontend/Dockerfile
• server/src/scripts/exportFrontendOptimizedMaps.ts
• frontend/.gitignore (excluye maps_optimized)

[chfr19820610-cell]

I have strong experience debugging Docker-based frontend builds and resolving asset path issues in game environments. The missing map JSON files suggest a build-time copy or routing misconfiguration, which I can quickly trace and fix. I’m confident I can identify the root cause and submit a working PR within 24–48 hours. Please assign me this bounty.

[chfr19820610-cell]

I have strong experience debugging Docker-based frontend builds and resolving asset path issues in game environments. The missing map JSON files suggest a build-time copy or routing misconfiguration, which I can quickly trace and fix. I’m confident I can identify the root cause and submit a working PR within 24–48 hours. Please assign me this bounty.

[chfr19820610-cell]

I have strong experience debugging Docker-based frontend builds and resolving asset path issues in game environments. The missing map JSON files suggest a build-time copy or routing misconfiguration, which I can quickly trace and fix. I’m confident I can identify the root cause and submit a working PR within 24–48 hours. Please assign me this bounty.

[chfr19820610-cell]

I have strong experience debugging Docker-based frontend builds and resolving asset path issues in game environments. The missing map JSON files suggest a build-time copy or routing misconfiguration, which I can quickly trace and fix. I’m confident I can identify the root cause and submit a working PR within 24–48 hours. Please assign me this bounty.

[chfr19820610-cell]

I have strong experience debugging Docker-based frontend builds and resolving asset path issues in game environments. The missing map JSON files suggest a build-time copy or routing misconfiguration, which I can quickly trace and fix. I’m confident I can identify the root cause and submit a working PR within 24–48 hours. Please assign me this bounty.

[mohamed-khairy-5i]

Plan para #19

Causa raíz confirmada: frontend/public/maps_optimized/ está en frontend/.gitignore y se genera con server → pnpm export-frontend-maps (script server/src/scripts/exportFrontendOptimizedMaps.ts, que lee los 294 mapas de server/mapas_source/). El frontend/Dockerfile actual hace pnpm build sin correr ese paso, así que la imagen queda sin mapas y el cliente pide /maps_optimized/mapa_*.json que no existen (404) → el mundo no se dibuja.

Archivos y cambios concretos:

1. frontend/Dockerfile — agrego un stage multi-stage maps que instala las deps de server, copia mapNpcStorage.ts + exportFrontendOptimizedMaps.ts + mapas_source/, corre el export hacia /maps/out, y hace COPY --from=maps a public/maps_optimized antes del pnpm build. El build context pasa a ser la raíz del repo.
2. frontend/scripts/check-maps.mjs + prebuild en package.json — si faltan los mapas, el build local falla con un mensaje que dice exactamente qué correr (cd server && pnpm export-frontend-maps), en vez de producir una imagen rota en silencio.
3. frontend/docker-compose*.yml y .github/workflows/ci.yml — build context a la raíz del repo; CI genera los mapas antes del build del frontend.
4. README.md — documenta el paso manual de generación de mapas.

Verificación (ya corrida localmente):

• pnpm export-frontend-maps genera los 294 mapas (mapa_1.json … mapa_506.json).
• node scripts/check-maps.mjs pasa con los mapas presentes (exit 0) y falla con mensaje claro si no están (exit 1).
• pnpm run lint → 0 errores; pnpm exec tsc --noEmit → limpio; pnpm run build → compila todas las rutas.

Tengo el fix implementado y verificado en una rama; abro el PR para revisión.

[WilliamKwanProgramming]

Hi! I’m checking the advertised $50 bounty before starting another implementation. I see that #36, #49, #193 and #332 already address the missing-map Docker build. Is the reward still funded and open to additional work, or should this be treated as reserved for one of those submissions? If there is a remaining acceptance gap you want addressed, could you identify it? Also, which payout method does this campaign use for contributors in Canada—is PayPal available? I have not claimed the bounty or submitted a competing PR.