![[1.20-26.X] CustomBiomeAnnounce - Announce player biome change](https://www.spigotmc.org/data/resource_icons/120/120133.jpg?1728591013){kind=icon}
CustomBiomeAnnounce
Bring every biome to life — beautiful titles, custom sounds and full exploration tracking
✓ 1.20.x — 1.21.x — 26.1+ • Lightweight • Fully configurable
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
CustomBiomeAnnounce is a lightweight yet powerful plugin that notifies players whenever they enter a new biome. With custom titles, chat messages, sounds and a per-player exploration tracker, it's the perfect companion for survival, adventure and RPG servers.
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
✨ Features
- Title announcements — fully customizable fade, stay and prefix
- Chat messages — with biome name placeholder
- Custom sounds — one per biome, with volume and pitch control
- Exploration GUI — paginated inventory showing explored vs. unexplored biomes with live progress (32/65)
- World blacklist — disable the plugin on any worlds you choose
- Per-biome customization — colors, display names, sounds and icons for every single biome
- Multi-language ready — change any text to any language or style directly in the config
- Cooldown system — prevent announcement spam on biome edges
- PlaceholderAPI support — current biome, explored count, total count and progress percentage
- Admin tools — check any player's exploration progress with /cba who
- High performance — in-memory cache + async database writes = zero main-thread lag
- Automatic version detection — works seamlessly on 1.20 through 26.1 and future releases
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Installation
- Download the latest .jar
- Drop it into your /plugins folder
- Restart your server
- (Optional) Customize config.yml to your liking and run /cba reload
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
⚙️ Configuration
The plugin auto-generates a ready-to-use config.yml on first run. Every biome, sound, color and icon can be freely edited.
Spoiler: Click to see a config.yml sample
# Inventory GUI settings
inventory-settings:
title : "&8Biomes Explored"
size : 54 # Must be a multiple of 9
explored-text : "&eExplored"
not-explored-text : "&eNot Explored"
next-page-text : "&eNext Page"
previous-page-text : "&ePrevious Page"
# Cooldown between announcements (per biome, per player)
biome_cooldown:
enabled : true
seconds : 120
# Worlds where the plugin is disabled
blocked_worlds :
- example_world
- another_world
# Title on biome entry
title:
enabled : true
message_prefix : "You are entering: "
fade_in : 10
stay : 70
fade_out : 20
# Chat message on biome entry
message:
enabled : true
text : "Entered biome: %biome%"
# Sound on biome entry
sound:
enabled : true
volume : 1.0
pitch : 1.0
# Per-biome customization (65 biomes supported out of the box)
biome_config:
plains:
display_name : "&e Plains"
sound : "ENTITY_COW_AMBIENT"
material : GRASS_BLOCK
cherry_grove:
display_name : "&d Cherry Grove"
sound : "BLOCK_CHERRY_LEAVES_BREAK"
material : CHERRY_LOG
deep_dark:
display_name : "&3 Deep Dark"
sound : "ENTITY_WARDEN_AMBIENT"
material : SCULK
pale_garden:
display_name : "&7 Pale Garden"
sound : "BLOCK_CREAKING_HEART_HIT"
material : PALE_MOSS_BLOCK
# ... and 61 more biomes, all fully editable
Code (YAML):
# Inventory GUI settings
inventory-settings:
title : "&8Biomes Explored"
size : 54 # Must be a multiple of 9
explored-text : "&eExplored"
not-explored-text : "&eNot Explored"
next-page-text : "&eNext Page"
previous-page-text : "&ePrevious Page"
# Cooldown between announcements (per biome, per player)
biome_cooldown:
enabled : true
seconds : 120
# Worlds where the plugin is disabled
blocked_worlds :
- example_world
- another_world
# Title on biome entry
title:
enabled : true
message_prefix : "You are entering: "
fade_in : 10
stay : 70
fade_out : 20
# Chat message on biome entry
message:
enabled : true
text : "Entered biome: %biome%"
# Sound on biome entry
sound:
enabled : true
volume : 1.0
pitch : 1.0
# Per-biome customization (65 biomes supported out of the box)
biome_config:
plains:
display_name : "&e Plains"
sound : "ENTITY_COW_AMBIENT"
material : GRASS_BLOCK
cherry_grove:
display_name : "&d Cherry Grove"
sound : "BLOCK_CHERRY_LEAVES_BREAK"
material : CHERRY_LOG
deep_dark:
display_name : "&3 Deep Dark"
sound : "ENTITY_WARDEN_AMBIENT"
material : SCULK
pale_garden:
display_name : "&7 Pale Garden"
sound : "BLOCK_CREAKING_HEART_HIT"
material : PALE_MOSS_BLOCK
# ... and 61 more biomes, all fully editable
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
⌨️ Commands & Permissions
| Command | Description | Permission | Default |
| /cba gui | Open the biome exploration GUI | custombiomeannounce.gui | Everyone |
| /cba who <player> | Check another player's progress | custombiomeannounce.who | OP |
| /cba reload | Reload configuration | custombiomeannounce.reload | OP |
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
PlaceholderAPI
Requires PlaceholderAPI.
- %biome_current% — player's current biome (display name)
- %biome_explored_count% — biomes explored
- %biome_total_count% — total biomes configured
- %biome_progress% — e.g. 32/65
- %biome_progress_percent% — e.g. 49
- %biome% — legacy alias for current biome
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Planned Features
- Particle effects on biome entry
- Action bar messages
- Additional GUI layout options
- MySQL / MariaDB support for network-wide progress
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Support
Need help or found a bug?
- Open an issue on the GitHub repository
- Leave a comment on this resource page
- Join my Discord server
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
License
Released under the MIT License. Free to use, modify and redistribute.
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Version History
1.0.4 — Minecraft 26.1 support · performance overhaul · new placeholders · /cba who command · GUI live progress · bug fixes
1.0.3 — Added %biome% PlaceholderAPI support
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
If you enjoy the plugin, consider leaving a ⭐ review — it really helps!
If you enjoy the plugin, consider leaving a ⭐ review — it really helps!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
[1.20-26.X] CustomBiomeAnnounce - Announce player biome change is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21, 26.1. Downloaded 776 times (via Spigot). Download it and open it directly in the game.