Capture Biomes

Capture Biomes

Java

Minecraft

API

bStats

License

Open Source

GitHub

Ever dreamed of bringing a snowy tundra to your sunny desert world? Or maybe turn your forest into a swampy wonderland? With Capture Biomes, you can bottle up any biome and unleash it anywhere – reshape your own Minecraft world exactly the way you want!

Features

🧪 Capture any biome in a Biome Potion using a Beacon 🎨 Potion colors, names, and descriptions match the captured biome 📏 Bigger Biome Potions depending on the Beacon pyramid size ⚙️ Full configuration support in the `config.yml`

Usage

1. Place a Beacon and power it with the usual pyramid 2. Drop the required amount of XP bottles on top of the beacon: - Tier 1 Beacon + 16 XP bottles → 4x4 Biome Potion - Tier 2 Beacon + 32 XP bottles → 8x8 Biome Potion - Tier 3 Beacon + 48 XP bottles → 16x16 Biome Potion - Tier 4 Beacon + 64 XP bottles → 32x32 Biome Potion 3. The beacon automatically creates a Biome Potion of the biome in which the beacon is located 4. Throw the potion on the ground in another biome to change the biome in the area

The tier of the Beacon depends on the size of the pyramid: - 1 layer → Tier 1 - 2 layers → Tier 2 - 3 layers → Tier 3 - 4 layers → Tier 4

Installation

1. Download the latest .jar from Modrinth or GitHub 2. Place it in your server's `plugins` folder 3. (Optional) Configure the plugin via `config.yml` and restart the server or use the plugin's reload command

Potion Size

The size of a Biome Potion depends on the tier of the beacon used to create it. When thrown, the potion affects a cuboid of `size` × `size` × `size` blocks, `size` being the matching value for the Beacon tier (configurable in the `config.yml`).

Example: A potion created on a tier 2 Beacon affects an area of 8 × 8 × 8 blocks, with the location where the potion lands as the center.

configurable in the config.yml - If there is a solid block above the center coordinate (e.g. in a cave), the biome extends up to configurable in the config.yml. - If there is no solid block above the center, the biome extends up to the configurable in the config.yml. - The biome always extends configurable in the config.yml. - The amount of blocks to extend up- and downwards is configurable in the config.yml by modifying the `y-offset-multiplier`.

Commands

| Command | Description | Permission | |-------------------------------------------------|---------------------------------------------------------------------------------------------------------------------|------------| | `/capturebiomes disable` | Disables the plugin. | OP | | `/capturebiomes enable` | Enables the plugin. | OP | | `/capturebiomes givebiomepotion <biome> <tier>` | Gives a Biome Potion of the specified biome and tier.<br>Example: `/capturebiomes givebiomepotion snowy_taiga 3` | OP | | `/capturebiomes reloadconfig` | Reloads the plugin’s configuration (`config.yml`). | OP | | `/capturebiomes resetconfig` | Resets the plugin’s configuration (`config.yml`) and automatically reloads it. | OP | | `/capturebiomes help` | Shows this command overview in the ingame chat. | OP | | `/biome` | Shows the biome you are currently standing in. | Everyone |

Supported Versions

- PaperMC on Minecraft Versions 1.21.5 - 26.1.2 - PurpurMC on Minecraft Versions 1.21.5 - 26.1.2

Config

Edit the `config.yml` in the plugin's folder to adapt it to your preferences: ```

=========================================

Capture Biomes - Configuration

=========================================

enabled: true # Enable/disable plugin functionality

=========================================

Beacon Settings

=========================================

beacon:

Required items per beacon tier

Must be > 0 and <= max stack size of trigger_item

required-item-count: tier-1: 16 tier-2: 32 tier-3: 48 tier-4: 64

Size of biome potions (NxN area)

Must be > 0

biome-potions-size: tier-1: 4 tier-2: 8 tier-3: 16 tier-4: 32

Vertical range of biome spread (multiplier)

Determines how many blocks the biome extends:

- BELOW the impact point

- ABOVE the first solid block at the center's y-axis

The actual range (up and down) is calculated by multiplying the base size of the potion by this multiplier

Must be a floating-point number >= 0.0 and <= 5.0

Setting this to 0.0 will completely disable the vertical offset

y-offset-multiplier: 1.0

trigger_item: EXPERIENCE_BOTTLE # Item used to trigger the ritual biome-potions-amount: 1 # Amount of potions to get each time (> 0)

=========================================

Biome Potion Settings

=========================================

potion-cooldown: enabled: true # Enable cooldown length: 15 # Seconds (> 0)

=========================================

Biome Toggles

=========================================

Already created potions are NOT affected

biomes: enable-mushroom_fields: false enable-deep_dark: false

=========================================

Advanced Settings – only modify if you know what you're doing!

Misconfiguring these could potentially break the plugin or cause unexpected behavior.

=========================================

console: enable-logging: true enable-additional-logging: false # Extra debug logs

item-check: timeout-ticks: 200 # Total duration (20 ticks = 1s) interval-ticks: 2 # Check interval

bstats: enabled: true ```

Resetting the config

In 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.

Supported Biomes and Dimensions

This plugin supports most overworld biomes (listed below). Nether and End biomes as well as custom biomes and dimensions are currently not supported and will be ignored.

🔵 Cold

`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`

🟡 Hot

`Desert`, `Savanna`, `Savanna Plateau`, `Badlands`, `Eroded Badlands`, `Wooded Badlands`, `Windswept Savanna`, `Beach`

🟢 Forest / Plains

`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`

🟢 Jungle

`Jungle`, `Bamboo Jungle`, `Sparse Jungle`

🔵 Oceans / Rivers

`Ocean`, `Deep Ocean`, `Warm Ocean`, `Lukewarm Ocean`, `Deep Lukewarm Ocean`, `River`

🟤 Swamps

`Swamp`, `Mangrove Swamp`

⚪ Mountains / Stony

`Stony Peaks`, `Stony Shore`, `Jagged Peaks`, `Windswept Gravelly Hills`, `Windswept Hills`

⚫ Caves / Underground

`Lush Caves`, `Dripstone Caves`, `Deep Dark` (disabled by default, configurable in config)

🔘 Other

`Mushroom Fields` (disabled by default, configurable in config)

Help

If you need any help, please feel free to open an issue: Open an issue

bStats

This plugin uses anonymous and secure to collect anonymous and secure like player counts and server versions. All data collected is anonymous and secure, helping to improve the plugin. If you don't want the plugin to send data, disable bStats in the config.yml.

License

This plugin is licensed under the Commercial use is strictly prohibited without explicit permission from the original author.. - You are free to Commercial use is strictly prohibited without explicit permission from the original author. the plugin Commercial use is strictly prohibited without explicit permission from the original author.. - Commercial use is strictly prohibited without explicit permission from the original author. or sharing the plugin Commercial use is strictly prohibited without explicit permission from the original author. is Commercial use is strictly prohibited without explicit permission from the original author.. - You must always provide Commercial use is strictly prohibited without explicit permission from the original author.. - Commercial use is strictly prohibited without explicit permission from the original author. - For more information, see the full license: Commercial use is strictly prohibited without explicit permission from the original author.

Credits

Developed by **mxiwbr**