🌱 Biomentry v0.3-SEED-2 – Changelog

This update introduces new biome title display options, improved compatibility, and several important bug fixes.

✨ New Features

• Boss Bar Display for Biomes
  Titles can now be displayed using a Boss Bar at the top of the screen.

  • Configure color and style in biomes.yml per biome.
  • Supported Boss Bar colors: BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
  • Supported styles: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20

• New Title Animation: slide
  A new slide animation type has been added for biome titles, enabling a smooth sliding effect.

  • Set animationType: slide under titleInfo in config.yml

🛠 Improvements

• Commented biomes.yml File
  The biomes.yml file is now fully documented with comments explaining each parameter:

  • title, subtitle, display, sound, separator, commands, particle, and bossBar
  • Easier customization and better understanding of available features.

• Default Biomes Expanded
  The config now includes default entries for all known Minecraft biomes up to version 1.21.7

• Minecraft 1.21.x Support
  Official compatibility with Minecraft 1.21.x (tested on 1.21.7).

  • Maven dependencies and plugin.yml have been updated accordingly.

🐛 Bug Fixes

• Fixed an issue where Boss Bar properties were not properly loaded by ConfigManager.
• Fixed a missing import in BiomeListener.java.
• Fixed the animation dispatch logic in TitleAnimation.java to correctly handle all animation types.

🔔 Next Step:
Biomentry v0.3-SAPPLING will focus on contextual conditions, cooldowns, and dynamic title behavior based on weather and time of day.

🌿 Improvements & Configuration Refactor

🛠️ Complete Configuration Overhaul

📁 File Separation

• 🔄 The biome configuration has been reorganized:

  • 🎵 Sounds, display types (e.g., title, action bar), and visual effects are now handled directly in the language files:

    • 📄 fr.yml / en.yml → manage both translatable texts and immersive effects.

  • 📜 A new file biomes.yml has been introduced to manage:

    • ⚡ Commands to be executed per biome
    • ✨ Per-biome behavior settings

🌌 Command Management by Biome

• 💥 Each biome can now trigger one or more custom commands when the player enters or interacts with it, such as:

  • /title %player% title Welcome to the Jungle
  • /playsound minecraft:ambient.cave %player%
  • /effect give %player% minecraft:speed 5 1 true

• 🧩 Supports dynamic placeholders (%player%, %biome%, etc.)

🧹 Simplified config.yml

• The config.yml file now contains only global settings:

  • 🌐 General plugin behavior
  • ⚙️ Global toggles and performance options
  • 🔧 Default values and fallback settings

🌍 Streamlined Language Files

• fr.yml / en.yml now handle:

  • 🏷️ Titles and subtitles
  • 🎶 Sound types (ambience, effects)
  • 🖼️ Display modes (e.g., TITLE, ACTION_BAR, SUBTITLE)
  • ✨ List of visual effects (e.g., GLOWING, NIGHT_VISION)

• 💡 This allows a cleaner, unified immersive experience across multiple languages.

💻 Refactored Core Classes

• 🧠 The ConfigManager.java and LanguageManager.java classes have been fully refactored to:

  • 🧩 Support modular and dynamic configuration loading
  • 🧽 Clearly separate config logic from multilingual handling
  • 🔄 Improve future maintainability and scalability

🧮 New Versioning Convention

🏷️ Format: MAJOR-Phase.Build

• Example: 0.3-Seed.2

  • 0.3 → Main plugin version
  • Seed 🌱 → Current development phase (alpha / pre-beta)
  • 2 → Second build in the "Seed" phase

🧭 This format gives a clear view of the plugin’s development stage and iteration.

This also not the final version of the 0.3, pls wait for it, this version will have more features, if you have suggestion for the future version or got a problem, go to the discord server

🧭 Biomentry v0.2.0 — Performance Improvements & New Features

This update introduces significant optimizations and new features to deliver a smoother, more customizable experience with enhanced plugin integration. (it's a softdependance, not absolutly needed to make the plugin works)

✨ New Features

🔌 PlaceholderAPI Integration

Biomentry is now fully compatible with PlaceholderAPI, allowing you to display dynamic biome-related data in other compatible plugins.

Available placeholders:

• %biomentry_biome% → Displays the player’s current effective biome (including cave detection).
• %biomentry_biome_raw% → Displays the raw Minecraft biome name the player is currently in.
• %biomentry_is_in_cave% → Returns true if the player is detected inside a cave, false otherwise.
• %biomentry_notifications% → Returns enabled or disabled depending on whether the player has biome notifications turned on.

🌍 World Blacklist

You can now disable Biomentry in specific worlds by adding them to a blacklist in the configuration file.

⚙️ Optimizations & Improvements

• Optimized Cave Detection
  The cave detection system has been redesigned with throttling to reduce server load and improve overall performance.

• Faster Config and Language Loading
  Configuration and language file handlers have been optimized to minimize disk I/O, resulting in faster plugin startup.

• Preprocessed Color Management
  Color codes and gradients are now processed once during configuration loading, eliminating redundant calculations and improving responsiveness.

• Cleaner, Maintainable Code
  Magic numbers have been replaced with named constants for better readability and easier maintenance.