SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedWorld generation

ChunkMap Pregenerator

by Chilimunyaka · for Vintage Story

Generates colored PNG land/sea maps with configurable scale.

3.8KDownloads
1.21.1Latest game version
Vintage Story ModDBSource

About ChunkMap Pregenerator

From Vintage Story ModDB

Generates colored PNG land/sea maps with configurable scale.

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
⦁ Supported OS: Windows (build uses System.Drawing and was not tested on Linux/macOS).
⦁ Avoid extremely large radii with small scale — such tasks may take a long time and use a lot of memory.

Command (syntax)

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

Important — chunk coordinates

⦁ 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 ≈ 201×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 — one pixel = 4×4 chunks; every 4th chunk is sampled; file C:/users/world_ocean_4x.png.

 

📦Release Notes (v1.1.0)

🔹Summary

Major update focused on stability, usability and server-side automation.
The mod is now more reliable, configurable and better suited for large-scale map rendering.


✨ New Features

  • JSON Configuration Support
    • The mod can now run without arguments: /chunkmap
    • Settings are loaded from ModConfig/chunkmappregen.json
    • Includes radius, scale, output path and center coordinates
  • Server-Side Friendly Execution
    • No longer depends on player position when using config
    • Fully compatible with server console and automation
  • Configurable Map Center
    • Added CenterChunkX and CenterChunkZ to config
    • Default is (0, 0)

⚙️ Improvements

  • Improved Progress Reporting
    • Progress is now displayed in percentages
    • Updates are throttled to avoid chat spam
    • More responsive feedback during large renders

Read the full description on Vintage Story ModDB →

Highlights

From source data

Game versions

Built for Vintage Story 1.21.1.

Footprint

Rated a light load on a server.

ChunkMap Pregenerator on Nxeon

From our catalogue
One-click install
Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.

Run ChunkMap Pregenerator on a Vintage Story server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Vintage Story ModDB as “Worldgen”

World generation

Changes or adds to how new terrain, biomes and structures are created.

Runs on your server

From source side support

Vintage Story ModDB lists ChunkMap Pregenerator as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Compatibility

Game
Vintage Story
Runs on
Serverrequired on the server
Game versions
1.21.1

Verified at the source

  • ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
  • ✓AuthorChilimunyaka, as published on Vintage Story ModDB
  • ✓LicenseNot published by the sourceFree

ChunkMap Pregenerator, answered

Generated from the mod’s own source data.

Do my players need to install ChunkMap Pregenerator?

Vintage Story ModDB lists ChunkMap Pregenerator as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Is it free?

Yes. ChunkMap Pregenerator is free to download from Vintage Story ModDB.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run ChunkMap Pregenerator on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add ChunkMap Pregenerator in one click.