{"id":31267,"date":"2026-06-01T16:42:47","date_gmt":"2026-06-01T13:42:47","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/"},"modified":"2026-06-01T16:42:47","modified_gmt":"2026-06-01T13:42:47","slug":"biomemap","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/","title":{"rendered":"BiomeMap"},"content":{"rendered":"
\n

# BiomeMap<\/p>\n

Generates a lightweight JSON file mapping each world region to its dominant biome. Ideal for creating stylized biome maps on external web apps.<\/p>\n<\/div>\n

## \ud83d\udccb Overview<\/p>\n

BiomeMap exports the dominant biome of a rectangular selection.
\nYou choose a world and 2 corners (`x\/z`), and the plugin builds a grid of cells over that area.
\nThen it samples biomes and writes:
\n– a JSON file
\n– optionally a PNG preview (`1 pixel = 1 cell`)<\/p>\n

## \u2728 Features<\/p>\n

– Rectangular selection defined by two coordinates (`\/biomemap world x1 z1 x2 z2 [cellSize] [preview]`)
\n– Cell size with chunk-friendly alignment (`8`, `16`, `32`, …)
\n– Chunk-based sampling to smooth biome transitions
\n– Asynchronous processing with frequent progress updates (no server freeze)
\n– One export at a time (global lock)
\n– Stop command to cancel running exports cleanly
\n– Structured JSON output with min\/max bounds per cell and namespaced biome IDs
\n– Optional PNG preview output (`1 pixel = 1 cell`) using a biome RGB palette<\/p>\n

## \ud83d\ude80 Installation<\/p>\n

1. Install PaperMC server with Java 21+
\n2. Download the latest `biomemap-x.x.x+mcx.x.x.jar` from the releases page
\n3. Drop the jar into your server\u2019s `plugins\/` folder
\n4. Restart the server or run `\/reload confirm`<\/p>\n

## \ud83d\udd79 Command Usage<\/p>\n

Only one export can run at a time.<\/p>\n

### Commands<\/p>\n

| Command | Description |
\n| — | — |
\n| `\/biomemap [cellSize] [preview]` | Starts a biome export (JSON + optional PNG). |
\n| `\/biomemap status [map]` | Shows current progress, ETA, outputs. Add `map` for compact ASCII completion map. |
\n| `\/biomemap stop` | Stops the current export and removes files from that run in `exports\/`. |<\/p>\n

### Arguments<\/p>\n

| Argument | Required | Description |
\n| — | — | — |
\n| `` | Yes | World name, for example `world` or `world_nether`. |
\n| ` ` | Yes | First corner of the area. |
\n| ` ` | Yes | Opposite corner of the area. |
\n| `[cellSize]` | No | Cell size in blocks. Default `16` (common values: `8`, `16`, `32`, `64`, …). |
\n| `[preview]` | No | Add `preview` to generate a PNG (`1 pixel = 1 cell`). |<\/p>\n

## \ud83d\udcc1 Output files<\/p>\n

All files are written to `plugins\/BiomeMap\/exports\/`.<\/p>\n

| File | Pattern | Created when |
\n| — | — | — |
\n| JSON | `__.json` | Always |
\n| PNG | `__.png` | Only if `preview` is used |<\/p>\n

Rules:
\n– `index` starts at `1` and increases if the filename already exists.
\n– If you run `\/biomemap stop`, files from the canceled export are removed.<\/p>\n

## \u2699\ufe0f Configuration<\/p>\n

[`config.yml`](src\/main\/resources\/config.yml) exposes performance throttles.<\/p>\n

| Key | Default | Description |
\n| — | — | — |
\n| `performance.chunks-per-tick` | `1` | How many new chunk jobs are started each tick. Lower = safer, slower. |
\n| `performance.max-in-flight` | `4` | Max number of BiomeMap jobs currently in pipeline (queued\/running). |
\n| `performance.max-concurrent-chunks` | `64` | Max real chunk loads at the same time (main server pressure knob). |<\/p>\n

Quick tuning guide:
\n– If players feel lag, lower `max-concurrent-chunks` first.
\n– If export feels too slow but server is stable, increase `chunks-per-tick` a bit.
\n– Keep `max-in-flight >= chunks-per-tick`.<\/p>\n

## \ud83d\uddfa JSON Format<\/p>\n

“`json
\n{
\n “cellSize”: 16,
\n “selectionMin”: { “x”: -200, “z”: -200 },
\n “selectionMax”: { “x”: -50, “z”: -20 },
\n “gridOrigin”: { “x”: -208, “z”: -208 },
\n “width”: 10,
\n “height”: 12,
\n “cells”: [
\n {
\n “i”: 0,
\n “j”: 0,
\n “bounds”: {
\n “min”: { “x”: -208, “z”: -208 },
\n “max”: { “x”: -193, “z”: -193 }
\n },
\n “biome”: “minecraft:plains”
\n },
\n {
\n “i”: 1,
\n “j”: 0,
\n “bounds”: {
\n “min”: { “x”: -192, “z”: -208 },
\n “max”: { “x”: -177, “z”: -193 }
\n },
\n “biome”: “minecraft:forest”
\n }
\n ]
\n}
\n“`<\/p>\n

| Field | Type | Description |
\n| — | — | — |
\n| `cellSize` | `number` | Cell size in blocks (minimum 8; values above that are aligned to the chunk grid). |
\n| `selectionMin\/Max` | `object` | Raw coordinates provided in the command. |
\n| `gridOrigin` | `object` | North-west corner of the grid (min X, min Z). |
\n| `width`, `height` | `number` | Number of cells on the X and Z axes. |
\n| `cells[].bounds.min\/max` | `object` | Inclusive bounds delimiting the cell. |
\n| `cells[].biome` | `string` | Namespaced biome ID (e.g. `minecraft:savanna`). |<\/p>\n

—<\/p>\n

\nCrafted by
\n
\nSukikui\n<\/div>\n","protected":false},"excerpt":{"rendered":"

Lightweight PaperMC plugin exporting dominant biomes from a selected area to JSON<\/p>\n","protected":false},"featured_media":31268,"template":"","meta":{"_minecraft_slug":"biomemap","_minecraft_project_id":"H8uMb3vr","_minecraft_author":"Sukikui","_minecraft_license":"MIT","_minecraft_downloads":70,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"biomemap.zip","_minecraft_size_bytes":958100,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T20:27:34.906965Z","_minecraft_date_created":"2025-11-13T00:34:13.457313Z","_minecraft_date_modified":"2026-03-01T13:10:32.119750Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/biomemap","_minecraft_icon_attachment_id":31268,"_minecraft_imported_at":"2026-06-01T13:42:48+00:00","_minecraft_import_hash":"49938d4884ce3965673bd62edf68d37c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128,129,92,159],"mod_loader":[132,133,134],"minecraft_version":[41],"class_list":["post-31267","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_category-worldgen","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-11"],"yoast_head":"\nBiomeMap - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"BiomeMap - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Lightweight PaperMC plugin exporting dominant biomes from a selected area to JSON\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/starlightskins.lunareclipse.studio\/render\/head\/_Suki_\/full?borderHighlight=true&borderHighlightRadius=7&dropShadow=true\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomemap\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomemap\\\/\",\"name\":\"BiomeMap - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomemap\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomemap\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/biomemap-icon-d8e82e39ab62da441e1dc05faa63ebc83fe3da7d_96.webp\",\"datePublished\":\"2026-06-01T13:42:47+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomemap\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomemap\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomemap\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/biomemap-icon-d8e82e39ab62da441e1dc05faa63ebc83fe3da7d_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/biomemap-icon-d8e82e39ab62da441e1dc05faa63ebc83fe3da7d_96.webp\",\"width\":96,\"height\":94},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomemap\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"BiomeMap\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"BiomeMap - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/","og_locale":"en_US","og_type":"article","og_title":"BiomeMap - Minecraft","og_description":"Lightweight PaperMC plugin exporting dominant biomes from a selected area to JSON","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/starlightskins.lunareclipse.studio\/render\/head\/_Suki_\/full?borderHighlight=true&borderHighlightRadius=7&dropShadow=true","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/","name":"BiomeMap - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/biomemap-icon-d8e82e39ab62da441e1dc05faa63ebc83fe3da7d_96.webp","datePublished":"2026-06-01T13:42:47+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/biomemap-icon-d8e82e39ab62da441e1dc05faa63ebc83fe3da7d_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/biomemap-icon-d8e82e39ab62da441e1dc05faa63ebc83fe3da7d_96.webp","width":96,"height":94},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomemap\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"BiomeMap"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/31267","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/31268"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=31267"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=31267"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=31267"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=31267"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}