Dark Cloud Map Database

Batch render minimap images for the game Dark Cloud from binary data files.

Overview

render_minimaps.py processes binary minimap data and generates PNG images for each map variation. It supports rendering both the base minimap layout and an optional "revealed" version, which visualizes explored areas.

Usage

python render_minimaps.py --input ./bin --maps ./maps --tileset ./tileset.png [options]

Arguments

• --input: Input directory containing *_cells.bin and *_roomtable.bin files (default: output)
• --maps: Output directory for PNG images (default: maps)
• --tileset: Path to the tileset PNG (default: tileset.png)
• --grid: Grid size (default: 20)
• --tile-w: Tile width in pixels (default: 16)
• --tile-h: Tile height in pixels (default: 16)
• --scale: Output image scale factor (default: 4)
• --room-stride: Room table stride (default: 0x1D0)
• --skip-existing: Skip rendering if output already exists
• --only: Render only a specific variation number
• --render-revealed: Also render revealed minimaps if reveal flags exist
• --dim: Brightness for unrevealed tiles (default: 0.25)
• --hide-unrevealed: Hide unrevealed tiles instead of dimming
• --no-skip-frame: Do not auto-skip UI/frame roomId on borders
• --skip-roomid: Manually skip a specific roomId

Example

Render all minimaps in the output directory and save PNGs to maps:

python render_minimaps.py --input output --maps maps --tileset tileset.png --render-revealed

Requirements

• Python 3.7+
• Pillow

Install dependencies:

pip install pillow

Output

• For each variation, outputs maps/{variation}_layout.png and optionally maps/{variation}_revealed.png.