ChunkMap Pregenerator

Description

A small tool for Vintage Story 1.21.x-1.22.x that quickly generates a colored PNG "land/sea" map for a selected area. One image pixel represents a group of chunks (configurable scale), making it easy to get an overview of large areas quickly.

Note: The generation in the screenshots was tested with the Plainsandvalleys mod.

What it does

⦁ Produces a PNG where 1 pixel = N×N chunks (scale parameter).
⦁ For speed and safety, surface data is obtained before full chunk generation, so the heavy worldgen phases are not triggered.
⦁ At scale = N the mod samples only every Nth grid position, greatly speeding up large-area processing.
⦁ Launched from chat/console and runs as a background task; progress is written to the log and (for the caller) to chat.

Key features

⦁ Fast generation of a land/sea overview PNG.
⦁ Configurable radius and scale.
⦁ Works both in single‑player and on servers.
⦁ Simple progress notifications to log/chat.

Limitations

⦁ Compatibility: Vintage Story 1.21.x-1.22.x
⦁<span style="text-decoration: line-through;"> Supported OS: Windows (build uses System.Drawing and was not tested on Linux/macOS).</span>
⦁ Avoid extremely large radii with small scale &mdash; such tasks may take a long time and use a lot of memory.

Command (syntax)

⦁ /chunkmap here &lt;radius&gt; [scale] &lt;outPath&gt;
⦁ Generates a map around your current position.
⦁ /chunkmap &lt;chunkX&gt; &lt;chunkZ&gt; &lt;radius&gt; [scale] &lt;outPath&gt;
⦁ Generates a map centered at the specified chunk coordinates.

<span style="color: #e67e23;">Important &mdash; chunk coordinates</span>

⦁ chunkX and chunkZ are chunk coordinates, not world (absolute for 1.21.x) block coordinates.
⦁ To get chunk coordinates: obtain your absolute position (in blocks) and divide X and Z by 32 (integer division).

Examples

⦁ /chunkmap here 100 C:/users/map.png
Radius 100 chunks (result &asymp; 201&times;201 px at scale = 1), file saved as C:/users/map.png.
⦁ /chunkmap 0 0 500 4 C:/users/world_ocean_4x.png
Radius 500, scale = 4 &mdash; one pixel = 4&times;4 chunks; every 4th chunk is sampled; file C:/users/world_ocean_4x.png.

&nbsp;