# Introduction & Installation

### Introduction

The Villager Biome Swapper plugin allows players to swap the biome type of a villager through a clear GUI. Players are only able to swap the biome type if they have the Villager Biome Swapper Item and they have a permission to swap to the target biome. Only villagers that have no XP and are Lvl 1 are able to be swapped.



* Download: [https://www.spigotmc.org/resources/villager-biome-swapper.126357/](https://www.spigotmc.org/resources/villager-biome-swapper.126357/)
* Discord: [https://discord.gg/erDzWtEQXV](https://discord.gg/erDzWtEQXV)

<figure><img src="https://2317251061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvcb3UAmMs80vPPLpxZiM%2Fuploads%2FP7gaihO0VX0Pf3XDQAX7%2F2025-06-25_17.35.13.png?alt=media&#x26;token=faa8b7f0-5106-45e0-964e-ac38ae170c6b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2317251061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvcb3UAmMs80vPPLpxZiM%2Fuploads%2FxezmWjDhrnXC0dISoDIG%2F2025-06-25_17.59.36.png?alt=media&#x26;token=2ac09641-60f5-473e-8547-576894caa6a9" alt=""><figcaption><p>/vbs help</p></figcaption></figure>

### Features

* **Biome Swapping GUI** – Players can easily swap a villager’s biome type using a clear GUI.
* **Villager Biome Swapper Item** – Requires a specific item to initiate the biome swap process.
* **Permission-Based Swapping** – Players must have the permission to swap to the target biome, allowing you to only let players update the biome to specific types.
* **Villager Restrictions** – Only villagers with no XP and at Level 1 can have their biome swapped.
* **Messages support MiniMessage** - Messages can either support MiniMessage or Legacy Color Codes! By Default, Messages are written with MiniMessage!
* **Lightweight & Efficient** – Designed to have minimal impact on server performance.
* **Configurable Settings** – All settings are fully configurable.
* **Placeholder Support** – Includes placeholders for dynamic messages, explained in the Configuration section of the wiki.

<figure><img src="https://2317251061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvcb3UAmMs80vPPLpxZiM%2Fuploads%2F2icG5Uo68iAlZSKRXs1R%2F2025-06-25_18.03.37.png?alt=media&#x26;token=527b8298-3209-4dc5-a43b-3913ae9209cd" alt=""><figcaption><p>Swap Menu</p></figcaption></figure>



<figure><img src="https://2317251061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvcb3UAmMs80vPPLpxZiM%2Fuploads%2F7kGPINaZY2QZVkA757ZW%2F2025-06-25_17.25.58.png?alt=media&#x26;token=cda3cbcc-f9a7-4db7-9ccd-de3882ddba64" alt=""><figcaption><p>Swap Item</p></figcaption></figure>

### Requirements

* Supports Paper Minecraft 1.21
* Expanding supported versions is planned.

### Installation

1. Download the plugin from: [https://www.spigotmc.org/resources/villager-biome-swapper.126357/](https://www.spigotmc.org/resources/villager-biome-swapper.126357/)
2. Stop the Server
3. Place the .jar file inside the plugins folder.
4. Restart the Server
5. Check /plugins to ensure the plugin is in green and test a few commands to confirm the installation was successful.

### Support

* Discord: [https://discord.gg/erDzWtEQXV](https://discord.gg/erDzWtEQXV)
* [Commands and Permissions](../commands-and-permissions)
* [Configuration](../configuration)
