📢 PATCH NOTE – Biomentry v0.3

🌱 Update "Sappling"

Welcome to Biomentry’s first major milestone update since 1 month!.

✨ Features

1️⃣ Advanced Condition System

The highlight of this update: a brand-new conditions.yml file (now in English by default), unlocking extremely powerful rule creation.

• Custom Triggers → trigger events when entering a biome.
• Logic Gates → combine and, or, not for complex rules (ex: if the player has X AND does not have Y...).
• New Conditions:
  • Permission checks
  • Player health
  • World time
  • Worn armor pieces
  • Active potion effects
• New Actions:
  • RUN_COMMAND → Execute commands
  • APPLY_EFFECT → Apply potion effects
  • ADD_PERMISSION → Grant temporary permissions via LuckPerms
  • HEAL → Restore health
  • GIVE_SATURATION → Provide saturation

2️⃣ Custom Biome Support (Mods & Datapacks)

Biomentry now supports every biome – vanilla, modded, or datapack-based.

• Works seamlessly with mods like Terralith, Biomes O’ Plenty, and others.
• Full compatibility with datapack-generated biomes.
• Simply use the full biome ID (example: terralith:skylands) in your configs.

➡ This makes it possible to link conditions, ambient sounds, and triggers to any biome your server can generate — no restrictions (there is a exemple config with a cliff-tree datapack biome).

🔧 Improvements & Changes

• Ambient Sound → New System to play sound not just when you enter in the biome but when you stay in
  (camels in deserts, parrots in jungles, frogs in swamps, icy winds in mountains, etc...).
• Improved Cave Detection → new trigger in_cave: true/false to differentiate surface vs underground and improve the detection conditions.
• Boss Bar Stability → notifications and boss bars are more reliable and stable.
• Multi-language Preparation → template files included for German (de.yml), Russian (ru.yml), Spanish (es.yml), will work for the next update.

🐛 Bug Fixes

• Biome Detection Fix → specific cave biomes (deep_dark, lush_caves) are now correctly detected.
• Trigger Logic Fix → reworked to be more intuitive and reliable, especially for cave-related conditions.

🗒️ Admin Notes

• A new conditions.yml will be generated → explore it carefully, it unlocks the full potential of Biomentry.
• For generic cave rules, do not use biome IDs → just use in_cave: true.
• Always use full biome IDs for modded/datapack biomes in both biomes.yml and conditions.yml.

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