[1.20-26.X] CustomBiomeAnnounce - Announce player biome change

[1.20-26.X] CustomBiomeAnnounce - Announce player biome change -----

Announce to players when they change biome

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
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

About
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.

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!