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.

/vbs help

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.

Swap Menu

Swap Item

Requirements

  • Supports Paper Minecraft 1.21

  • Expanding supported versions is planned.

Installation

  1. Stop the Server

  2. Place the .jar file inside the plugins folder.

  3. Restart the Server

  4. Check /plugins to ensure the plugin is in green and test a few commands to confirm the installation was successful.

Support

Last updated