# Capture Biomes<\/p>\n
\n
\n
\n
\n
\n
\n
\n<\/p>\n
Ever dreamed of bringing a snowy tundra to your sunny desert world? Or maybe turn your forest into a swampy wonderland?
\nWith **Capture Biomes**, you can bottle up any biome and unleash it anywhere \u2013
\nreshape your own Minecraft world exactly the way you want!<\/p>\n
## Features
\n\ud83e\uddea Capture any biome in a **Biome Potion** using a Beacon
\n\ud83c\udfa8 Potion colors, names, and descriptions match the captured biome
\n\ud83d\udccf Bigger Biome Potions depending on the Beacon pyramid size
\n\u2699\ufe0f Full configuration support in the `config.yml`<\/p>\n
## Usage
\n1. Place a Beacon and power it with the usual pyramid
\n2. Drop the required amount of XP bottles on top of the beacon:
\n – Tier 1 Beacon + 16 XP bottles \u2192 4×4 Biome Potion
\n – Tier 2 Beacon + 32 XP bottles \u2192 8×8 Biome Potion
\n – Tier 3 Beacon + 48 XP bottles \u2192 16×16 Biome Potion
\n – Tier 4 Beacon + 64 XP bottles \u2192 32×32 Biome Potion
\n3. The beacon automatically creates a **Biome Potion** of the biome in which the beacon is located
\n4. Throw the potion on the ground in another biome to change the biome in the area <\/p>\n
The tier of the Beacon depends on the size of the pyramid:
\n– 1 layer \u2192 Tier 1
\n– 2 layers \u2192 Tier 2
\n– 3 layers \u2192 Tier 3
\n– 4 layers \u2192 Tier 4<\/p>\n
## Installation
\n1. Download the latest .jar from Modrinth or GitHub
\n2. Place it in your server’s `plugins` folder
\n3. (Optional) Configure the plugin via `config.yml` and restart the server or use the plugin’s reload command<\/p>\n
## Potion Size
\nThe size of a Biome Potion depends on the tier of the beacon used to create it.
\nWhen thrown, the potion affects a cuboid of `size` \u00d7 `size` \u00d7 `size` blocks, `size` being the matching value for the Beacon tier (configurable in the `config.yml`). <\/p>\n
**Example:** A potion created on a tier 2 Beacon affects an area of 8 \u00d7 8 \u00d7 8 blocks, with the location where the potion lands as the center.<\/p>\n
**Height behavior:**
\n– If there is a solid block above the center coordinate (e.g. in a cave), the biome extends up to **`size` blocks above that block**.
\n– If there is no solid block above the center, the biome extends up to the **world’s maximum height**.
\n– The biome always extends **`size` blocks below the point where the potion lands**.
\n– The amount of blocks to extend up- and downwards is **configurable in the config.yml** by modifying the `y-offset-multiplier`.<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission | ## Supported Versions ## Config enabled: true # Enable\/disable plugin functionality<\/p>\n # ========================================= # Required items per beacon tier # Vertical range of biome spread (multiplier) # ========================================= # ========================================= # ========================================= console: item-check: bstats: #### Resetting the config ## Supported Biomes and Dimensions #### \ud83d\udfe1 Hot #### \ud83d\udfe2 Forest \/ Plains #### \ud83d\udfe2 Jungle #### \ud83d\udd35 Oceans \/ Rivers #### \ud83d\udfe4 Swamps #### \u26aa Mountains \/ Stony #### \u26ab Caves \/ Underground #### \ud83d\udd18 Other ## Help ## bStats<\/p>\n This plugin uses bStats to collect **anonymous statistics** like player counts and server versions. ## License ## Credits<\/p>\n Developed by **mxiwbr**<\/p>\n","protected":false},"excerpt":{"rendered":" A PaperMC plugin that lets players capture a biome in a bottle and release it elsewhere.<\/p>\n","protected":false},"featured_media":36939,"template":"","meta":{"_minecraft_slug":"capture-biomes","_minecraft_project_id":"eKztZpPG","_minecraft_author":"REDcrafterM","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":28,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"capture-biomes.zip","_minecraft_size_bytes":3172977,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T22:10:32.311154Z","_minecraft_date_created":"2026-03-24T22:53:50.560252Z","_minecraft_date_modified":"2026-03-25T17:38:18.129398Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/capture-biomes","_minecraft_icon_attachment_id":36939,"_minecraft_imported_at":"2026-06-01T18:33:18+00:00","_minecraft_import_hash":"fc4245184a56593d1a9787900f241654","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,156,89,122,127,128,159],"mod_loader":[132,133],"minecraft_version":[40,41,78,79,80,81,82,83,167,163],"class_list":["post-36938","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-decoration","mod_category-game-mechanics","mod_category-magic","mod_category-paper","mod_category-purpur","mod_category-worldgen","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|————————————————-|———————————————————————————————————————|————|
\n| `\/capturebiomes disable` | Disables the plugin. | OP |
\n| `\/capturebiomes enable` | Enables the plugin. | OP |
\n| `\/capturebiomes givebiomepotion
**Example:** `\/capturebiomes givebiomepotion snowy_taiga 3` | OP |
\n| `\/capturebiomes reloadconfig` | Reloads the plugin\u2019s configuration (`config.yml`). | OP |
\n| `\/capturebiomes resetconfig` | Resets the plugin\u2019s configuration (`config.yml`) and automatically reloads it. | OP |
\n| `\/capturebiomes help` | Shows this command overview in the ingame chat. | OP |
\n| `\/biome` | Shows the biome you are currently standing in. | Everyone |<\/p>\n
\n– PaperMC on Minecraft Versions 1.21.5 – 26.1.2
\n– PurpurMC on Minecraft Versions 1.21.5 – 26.1.2<\/p>\n
\nEdit the `config.yml` in the plugin’s folder to adapt it to your preferences:
\n“`
\n# =========================================
\n# Capture Biomes – Configuration
\n# =========================================<\/p>\n
\n# Beacon Settings
\n# =========================================
\nbeacon:<\/p>\n
\n # Must be > 0 and <= max stack size of trigger_item\n required-item-count:\n tier-1: 16\n tier-2: 32\n tier-3: 48\n tier-4: 64\n\n # Size of biome potions (NxN area)\n # Must be > 0
\n biome-potions-size:
\n tier-1: 4
\n tier-2: 8
\n tier-3: 16
\n tier-4: 32<\/p>\n
\n # Determines how many blocks the biome extends:
\n # – BELOW the impact point
\n # – ABOVE the first solid block at the center’s y-axis
\n # The actual range (up and down) is calculated by multiplying the base size of the potion by this multiplier
\n # Must be a floating-point number >= 0.0 and <= 5.0\n # Setting this to 0.0 will completely disable the vertical offset\n y-offset-multiplier: 1.0\n\n trigger_item: EXPERIENCE_BOTTLE # Item used to trigger the ritual\n biome-potions-amount: 1 # Amount of potions to get each time (> 0)<\/p>\n
\n# Biome Potion Settings
\n# =========================================
\npotion-cooldown:
\n enabled: true # Enable cooldown
\n length: 15 # Seconds (> 0)<\/p>\n
\n# Biome Toggles
\n# =========================================
\n# Already created potions are NOT affected
\nbiomes:
\n enable-mushroom_fields: false
\n enable-deep_dark: false<\/p>\n
\n# Advanced Settings \u2013 only modify if you know what you’re doing!
\n# Misconfiguring these could potentially break the plugin or cause unexpected behavior.
\n# =========================================<\/p>\n
\n enable-logging: true
\n enable-additional-logging: false # Extra debug logs<\/p>\n
\n timeout-ticks: 200 # Total duration (20 ticks = 1s)
\n interval-ticks: 2 # Check interval<\/p>\n
\n enabled: true
\n“`<\/p>\n
\nIn order to reset the plugin’s config to its default values, either use the `\/capturebiomes resetconfig` command or delete the config.yml in the plugin’s folder and restart the server.<\/p>\n
\nThis plugin supports most **overworld biomes** (listed below).
\nNether and End biomes as well as custom biomes and dimensions are currently not supported and will be ignored.
\n#### \ud83d\udd35 Cold
\n`Deep Cold Ocean`, `Cold Ocean`, `Snowy Tundra`, `Snowy Plains`, `Snowy Slopes`, `Snowy Beach`, `Snowy Taiga`, `Ice Spikes`, `Frozen Peaks`, `Frozen Ocean`, `Frozen River`, `Deep Frozen Ocean`<\/p>\n
\n`Desert`, `Savanna`, `Savanna Plateau`, `Badlands`, `Eroded Badlands`, `Wooded Badlands`, `Windswept Savanna`, `Beach`<\/p>\n
\n`Forest`, `Birch Forest`, `Dark Forest`, `Flower Forest`, `Old Growth Birch Forest`, `Old Growth Pine Taiga`, `Old Growth Spruce Taiga`, `Windswept Forest`, `Grove`, `Taiga`, `Meadow`, `Cherry Grove`, `Sunflower Plains`, `Plains`, `Pale Garden`<\/p>\n
\n`Jungle`, `Bamboo Jungle`, `Sparse Jungle`<\/p>\n
\n`Ocean`, `Deep Ocean`, `Warm Ocean`, `Lukewarm Ocean`, `Deep Lukewarm Ocean`, `River`<\/p>\n
\n`Swamp`, `Mangrove Swamp`<\/p>\n
\n`Stony Peaks`, `Stony Shore`, `Jagged Peaks`, `Windswept Gravelly Hills`, `Windswept Hills`<\/p>\n
\n`Lush Caves`, `Dripstone Caves`, `Deep Dark` (disabled by default, configurable in config)<\/p>\n
\n`Mushroom Fields` (disabled by default, configurable in config)<\/p>\n
\nIf you need any help, please feel free to open an issue: Open an issue<\/p>\n
\nAll data collected is **anonymous and secure**, helping to improve the plugin.
\nIf you don’t want the plugin to send data, disable bStats in the config.yml.<\/p>\n
\nThis plugin is licensed under the **GNU General Public License v3**.
\n– You are free to **use, modify, and redistribute** the plugin **under the same GPLv3 license**.
\n– **Uploading** or sharing the plugin **without proper modifications** is **strictly prohibited**.
\n– You must always provide **credit to the original author**.
\n– **Commercial use is strictly prohibited without explicit permission from the original author.**
\n– For more information, see the full license: GNU GPL v3<\/p>\n