Sueta

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

1.0.4

Announce to players when they change biome

·Plugin

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

  1. Download the latest .jar
  2. Drop it into your /plugins folder
  3. Restart your server
  4. (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.

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

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

⌨️ Commands & Permissions

CommandDescriptionPermissionDefault
/cba guiOpen the biome exploration GUIcustombiomeannounce.guiEveryone
/cba who <player>Check another player's progresscustombiomeannounce.whoOP
/cba reloadReload configurationcustombiomeannounce.reloadOP

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

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!

Similar projects

Plugin →