ChunkMap Pregenerator

<h2>Description</h2> <p>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.</p> <p><strong>Note</strong>: The generation in the screenshots was tested with the <a title="Plainsandvalleys" href="https://mods.vintagestory.at/plainsandvalleys" target="_blank" rel="noopener">Plainsandvalleys</a> mod.</p> <h2>What it does</h2> <p>⦁ Produces a PNG where 1 pixel = N&times;N chunks (scale parameter).<br />⦁ For speed and safety, surface data is obtained before full chunk generation, so the heavy worldgen phases are not triggered.<br />⦁ At scale = N the mod samples only every Nth grid position, greatly speeding up large-area processing.<br />⦁ Launched from chat/console and runs as a background task; progress is written to the log and (for the caller) to chat.</p> <h2>Key features</h2> <p>⦁ Fast generation of a land/sea overview PNG.<br />⦁ Configurable radius and scale.<br />⦁ Works both in single‑player and on servers.<br />⦁ Simple progress notifications to log/chat.</p> <h2>Limitations</h2> <p>⦁ Compatibility: Vintage Story 1.21.x-1.22.x<br />⦁<span style="text-decoration: line-through;"> Supported OS: Windows (build uses System.Drawing and was not tested on Linux/macOS).</span><br />⦁ Avoid extremely large radii with small scale &mdash; such tasks may take a long time and use a lot of memory.</p> <h2>Command (syntax)</h2> <p>⦁ /chunkmap here &lt;radius&gt; [scale] &lt;outPath&gt;<br />⦁ Generates a map around your current position.<br />⦁ /chunkmap &lt;chunkX&gt; &lt;chunkZ&gt; &lt;radius&gt; [scale] &lt;outPath&gt;<br />⦁ Generates a map centered at the specified chunk coordinates.</p> <h4><span style="color: #e67e23;">Important &mdash; chunk coordinates</span></h4> <p>⦁ chunkX and chunkZ are chunk coordinates, not world (absolute for 1.21.x) block coordinates.<br />⦁ To get chunk coordinates: obtain your absolute position (in blocks) and divide X and Z by 32 (integer division).</p> <h3>Examples</h3> <p>⦁ /chunkmap here 100 C:/users/map.png <br />Radius 100 chunks (result &asymp; 201&times;201 px at scale = 1), file saved as C:/users/map.png.<br />⦁ /chunkmap 0 0 500 4 C:/users/world_ocean_4x.png <br />Radius 500, scale = 4 &mdash; one pixel = 4&times;4 chunks; every 4th chunk is sampled; file C:/users/world_ocean_4x.png.</p> <p>&nbsp;</p> <div class="relative w-full mt-4 mb-1"> <div class=""> <div class="relative"> <div class="h-full min-h-0 min-w-0"> <div class="h-full min-h-0 min-w-0"> <div class="border border-token-border-light border-radius-3xl corner-superellipse/1.1 rounded-3xl"> <div class="h-full w-full border-radius-3xl bg-token-bg-elevated-secondary corner-superellipse/1.1 overflow-clip rounded-3xl lxnfua_clipPathFallback"> <div class="w-full overflow-x-hidden overflow-y-auto"> <div class="relative z-0 flex max-w-full"> <div id="code-block-viewer" class="q9tKkq_viewer cm-editor z-10 light:cm-light dark:cm-light flex h-full w-full flex-col items-stretch ͼk ͼy" dir="ltr"> <div class="cm-scroller"> <div class="cm-content q9tKkq_readonly"> <div class="spoiler"> <div class="spoiler-toggle"> <h1>📦Release Notes (v1.1.0)</h1> </div> <div class="spoiler-text"> <h2 data-section-id="6p2ral" data-start="250" data-end="263">🔹Summary</h2> <p data-start="264" data-end="430">Major update focused on stability, usability and server-side automation.<br data-start="336" data-end="339" />The mod is now more reliable, configurable and better suited for large-scale map rendering.</p> <hr data-start="432" data-end="435" /> <h2 data-section-id="hj92ra" data-start="437" data-end="454">✨ New Features</h2> <ul data-start="456" data-end="929"> <li data-section-id="866s3x" data-start="456" data-end="667"><strong data-start="458" data-end="488">JSON Configuration Support</strong> <ul data-start="491" data-end="667"> <li data-section-id="1179f16" data-start="491" data-end="543">The mod can now run without arguments: <code data-start="532" data-end="543">/chunkmap</code></li> <li data-section-id="qvu2nn" data-start="546" data-end="604">Settings are loaded from <code data-start="573" data-end="604">ModConfig/chunkmappregen.json</code></li> <li data-section-id="1jprqro" data-start="607" data-end="667">Includes radius, scale, output path and center coordinates</li> </ul> </li> <li data-section-id="10sw8bo" data-start="669" data-end="820"><strong data-start="671" data-end="705">Server-Side Friendly Execution</strong> <ul data-start="708" data-end="820"> <li data-section-id="1jh03wq" data-start="708" data-end="764">No longer depends on player position when using config</li> <li data-section-id="1kx044g" data-start="767" data-end="820">Fully compatible with server console and automation</li> </ul> </li> <li data-section-id="qpzod8" data-start="822" data-end="929"><strong data-start="824" data-end="851">Configurable Map Center</strong> <ul data-start="854" data-end="929"> <li data-section-id="h4wcy8" data-start="854" data-end="905">Added <code data-start="862" data-end="876">CenterChunkX</code> and <code data-start="881" data-end="895">CenterChunkZ</code> to config</li> <li data-section-id="1w83t84" data-start="908" data-end="929">Default is <code data-start="921" data-end="929">(0, 0)</code></li> </ul> </li> </ul> <hr data-start="931" data-end="934" /> <h2 data-section-id="1m8j3c8" data-start="936" data-end="954">⚙️ Improvements</h2> <ul data-start="956" data-end="1514"> <li data-section-id="8vwi9w" data-start="956" data-end="1129"><strong data-start="958" data-end="989">Improved Progress Reporting</strong> <ul data-start="992" data-end="1129"> <li data-section-id="1qincby" data-start="992" data-end="1034">Progress is now displayed in percentages</li> <li data-section-id="8v5o6n" data-start="1037" data-end="1079">Updates are throttled to avoid chat spam</li> <li data-section-id="1f0j0jz" data-start="1082" data-end="1129">More