CPVPSingleBiome

🎥 Showcase Video: Watch on YouTube

CPVPSingleBiome is a highly configurable single-biome world generator for Paper and Purpur servers, designed for Crystal PvP, practice servers, KitPvP, FFA arenas, events and competitive gameplay.

Best used together with: Multiverse-Core (multi-world management) and Chunky (world pregeneration). Both plugins are optional. CPVPSingleBiome works standalone, but these integrations make managing multiple worlds easier and help reduce lag spikes caused by chunk generation.

CPVPSingleBiome focuses on creating visually distinct worlds with open terrain, clear sightlines and predictable combat environments, while offering powerful tools for world management and automated resets.

---

Available Biomes

plains
desert
badlands
snow
mushroom
end

Each biome provides a distinct environment while maintaining terrain suitable for PvP combat.

---

Features

• PvP-focused terrain: Open sightlines, gentle elevation changes, minimal clutter and predictable combat areas.
• Highly configurable: Adjust terrain height, noise scale, flatness, decoration and tree density, world borders, reset behavior and Chunky settings.
• Safe by default: Automatic world resets and Chunky pregeneration are disabled by default and must be explicitly enabled.
• Automated world resets: Scheduled or manual resets for individual worlds or all configured worlds, including automatic restoration of WorldBorder, difficulty, gamemode and PvP settings, plus player join protection during resets.
• Chunky integration: Automatic or manual chunk pregeneration after world creation or resets to reduce lag spikes during gameplay.
• World management: Create worlds, teleport between them, inspect world information and monitor reset status directly through commands.
• Diagnostic tools: Export detailed plugin and server information for troubleshooting and support.

---

Commands

General commands:

/cpvpsb help
/cpvpsb version
/cpvpsb about
/cpvpsb status
/cpvpsb export
/cpvpsb reload
/cpvpsb biomes
/cpvpsb info

World management:

/cpvpsb create <world> [biome]
/cpvpsb tp <world>

World resets:

/cpvpsb reset now
/cpvpsb reset <world>
/cpvpsb reset status
/cpvpsb reset reload

Chunky integration:

/cpvpsb chunky start <world>
/cpvpsb chunky start-all

---

Diagnostic Export

The /cpvpsb export command generates a detailed diagnostic report containing:

• Plugin, server and Java versions
• Plugin configuration
• World information
• Chunky integration and pregeneration settings
• World reset configuration and status

Reports are saved in:

plugins/CPVPSingleBiome/exports/

This feature is useful for troubleshooting and support.

Important: Always review diagnostic reports before sharing them publicly, as they may contain server-specific information.

---

Installation

1. Download the latest compatible .jar file.
2. Place it in your server's plugins folder.
3. Restart the server.
4. Configure plugins/CPVPSingleBiome/config.yml.
5. Create your worlds using the commands below.

Examples:

/cpvpsb create plains plains
/cpvpsb create desert desert
/cpvpsb create badlands badlands
/cpvpsb create snow snow
/cpvpsb create mushroom mushroom
/cpvpsb create end end

If no biome is specified, the default biome from config.yml is used.

Important: The world name (first argument) must match the world entry in the worlds list of your config.yml for the reset system to recognize it. Adjust the example names to match your configuration.

Alternative: Create worlds with Multiverse-Core

/mv create plains normal -g CPVPSingleBiome:plains

Warning: Always back up existing worlds before enabling automatic resets or making significant changes to world settings.

---

Requirements

Server software: Paper or Purpur

Java requirements:

• Minecraft 1.21.11: Java 21 or newer
• Minecraft 26.1 and newer: Java 25 or newer

Check the Versions tab for supported Minecraft versions.

Recommended plugins:

• Multiverse-Core — Multi-world creation and management.
• Chunky — Chunk pregeneration to reduce world-generation-related lag.

Both integrations are optional.

Without Multiverse-Core, /mv commands are unavailable. Without Chunky, the integrated pregeneration features are unavailable.

Core world generation, world management and reset functionality remain available without these additional plugins.

---

Open Source

CPVPSingleBiome is open source and licensed under the GNU General Public License v3.0 only (GPL-3.0-only).

Source code, documentation and issue tracking are available on GitHub.

---

Disclaimer

This project is not affiliated with Mojang, Microsoft, Minecraft or PaperMC.

Minecraft is a trademark of Microsoft.