Evo Biomes

EvoBiomes

Dynamic biome evolution for Paper/Spigot/Purpur. EvoBiomes gradually transitions selected regions through configurable biome chains (e.g., Plains → Savanna → Desert), applying visual and ecosystem effects along the way.

Highlights

- Configurable biome evolution chains and transitional effects - Gradual transitions: particles, messages, entities, and blocks - Async selection, safe main-thread world updates - Live‑reloadable rules (`rules.yml` in plugin data folder) - Weather-aware pacing and player-density slowdowns (with TTL) - Admin commands and developer API hooks

Compatibility

- Servers: Paper/Spigot/Purpur - Versions: 1.20, 1.20.1–1.20.6, 1.21, 1.21.1–1.21.10 - Built against `spigot-api 1.20.1` with `api-version: 1.20` for forward compatibility

Installation

- Drop `EvoBiomes-1.0.0.jar` into `plugins` - Start the server to generate config and rules - Optional: edit `plugins/EvoBiomes/rules.yml` and run `/evobiomes reload`

Commands

- `/evobiomes info` — show runtime settings - `/evobiomes reload` — reload config and rules from disk - `/evobiomes evolve <biome> <radius>` — force-evolve area around the player

Permissions

- `evobiomes.admin` — access to all `evobiomes` commands (default: op)

Configuration

`config.yml` - `safe_mode`: limit biome updates per tick (default: true) - `max_chunk_updates_per_tick`: budget for chunk processing (default: 5) - `cycle_interval_ticks`: evolution cycle interval (default: 1200) - `worlds`: list of world names to process - `use_protocol_lib`: visual enhancements toggle (no compile dependency; falls back to Bukkit particles) - `transitions`: toggles for `messages`, `particles`, `entities`, `blocks` - `player_density`: `radius`, `slowdown_factor` - `weather`: `rain_acceleration`, `thunder_acceleration`, `clear_slowdown`

Rules & Effects

`rules.yml` (data folder) - `chains` define ordered biome sequences per starting biome - `effects` define transitional effects between steps using key `from->to` - Effects include lists: `entities`, `blocks`, `particles`, and `message`

Example chains: - `plains: [savanna, desert]` - `forest: [dark_forest, jungle]` - `taiga: [snowy_taiga, ice_spikes]`

How It Works

- Scheduler runs asynchronously to select chunks; each chunk’s work is executed on the main thread for safety - Transitional effects are applied before the biome switch (particles/messages/entities/blocks) - Temperature/humidity hints are shown to nearby players - Weather and player density modify pacing without blocking the server