Crusader_Decomp/map_renderer

Crusader Map Renderer

Node web app that renders Crusader maps on the server and streams only finished PNG tiles to the browser.

Goals

• Keep Crusader source assets server-side.
• Detect maps from STATIC and STATIC_REGRET automatically.
• Build map render state on demand after the user selects a map.
• Serve large maps as draggable and zoomable image tiles.
• Run locally with Node or inside Docker.

Local Run

cd map_renderer
npm install
npm start

Open http://localhost:3000.

Viewer behavior:

• drag with the mouse or one finger to pan
• use the scroll wheel to zoom directly at the pointer
• pinch to zoom on touch devices
• toggle roofs and editor-only elements independently before building
• when editor-only elements are enabled, the base map stays server-rasterized while editor records render as interactive overlays with hover metadata

The app expects asset folders under the app root:

• map_renderer/STATIC
• map_renderer/STATIC_REGRET

Docker Run

The Docker image excludes the Crusader assets on purpose. Mount them at runtime so they stay outside the image and are never served directly to clients.

cd map_renderer
docker build -t crusader-map-renderer .
docker run --rm -p 3000:3000 `
  -v ${PWD}/STATIC:/app/STATIC:ro `
  -v ${PWD}/STATIC_REGRET:/app/STATIC_REGRET:ro `
  crusader-map-renderer

If only one game is available, mount only that folder.

Docker Compose

The compose file mounts STATIC and STATIC_REGRET from the host filesystem into the container as read-only volumes. They are excluded from the image build by .dockerignore, so the assets are never copied into the image.

cd map_renderer
docker compose up --build

HTTP Surface

• GET /api/maps returns the detected catalog.
• POST /api/builds starts or reuses a build.
• GET /api/builds/:id returns build status.
• GET /api/maps/:game/:mapId/metadata?buildId=... returns map bounds and tile settings.
• GET /api/maps/:game/:mapId/overlays?buildId=... returns interactive overlay records for editor-only content.
• GET /api/maps/:game/:mapId/tiles/:tileX/:tileY.png?buildId=... returns rendered PNG tiles.

No raw Crusader asset files are exposed over HTTP.