# \ud83d\udccc About Biomentry<\/p>\n
**Biomentry** is not just a biome notifier \u2013 it\u2019s a full **immersion system** for Minecraft.
\nIt makes each biome feel **alive, unique, and reactive**. <\/p>\n
From **animated titles** and **ambient sounds** to **advanced conditional rules**, Biomentry connects the environment to the player\u2019s journey \u2014 whether they\u2019re crossing deserts, exploring lush caves, or wandering in modded dimensions. <\/p>\n
Perfect for **RPG, adventure, survival, and storytelling servers**, Biomentry turns exploration into an experience.<\/p>\n
—<\/p>\n
## \u2728 Core Features<\/p>\n
### \ud83d\udccd Intelligent Biome Detection
\n– Real-time detection **above ground and underground**.
\n– Enhanced with **custom logic** for accurate cave recognition (light levels, block density, sky access, Y-level, structures).
\n– Supports **special cave biomes**: `lush_caves`, `deep_dark`, `dripstone_caves`.<\/p>\n
— <\/p>\n
## \ud83d\udd73\ufe0f Advanced Cave Detection
\nA multi-criteria scoring system determines whether a player is truly in a cave, factoring in:
\n– ambient light level,
\n– block density around the player,
\n– sky access,
\n– Y-level and natural structure context.<\/p>\n
This allows accurate detection even in artificial caves or open ravines.<\/p>\n
—<\/p>\n
### \ud83d\udda5\ufe0f Immersive Visual Notifications
\n– Animated **titles & subtitles** (fade, typewriter, etc.) on biome entry.
\n– **Customizable styles** per biome or biome group.
\n– **Biome grouping** to reduce message spam (e.g., forests, oceans).<\/p>\n
—<\/p>\n
### \ud83d\udd0a Ambient Sounds
\n– Unique looping sounds per biome:
\n – Desert camels
\n – Jungle parrots
\n – Swamp frogs
\n – Mountain winds
\n– **Goodbye repetitive rain noise \u2192 hello immersion**.<\/p>\n
—<\/p>\n
### \u2699\ufe0f Player Customization —<\/p>\n ### \ud83d\udee1\ufe0f Region & Server Integration —<\/p>\n ## \ud83d\udd25 New in v0.3 \u2013 Sappling Update<\/p>\n ### 1\ufe0f\u20e3 Advanced Condition System —<\/p>\n ### 2\ufe0f\u20e3 Custom Biome & Cave Support —<\/p>\n ### 3\ufe0f\u20e3 Enhanced Immersion & Stability —<\/p>\n ## \ud83d\ude80 Why Biomentry? Ideal for servers that want: With Biomentry, **every step into a new biome \u2014 surface or cave, vanilla or modded \u2014 feels like a new chapter**.<\/p>\n ## Config files<\/p>\n “` # Title display settings # Priority system for display management # Biome groups \u2013 Biomes in the same group won\u2019t trigger a notification # WorldGuard regions where notifications are disabled # List of worlds where the plugin is completely disabled (just exemple here) “` ambient_sound: ambient_sound: ambient_sound: ambient_sound: ambient_sound: ambient_sound: ‘clifftree:desert_cliff’: “`<\/p>\n<\/details>\n “` rules: # — EXAMPLE 2: “IF IN CAVE” condition — conditions: # — EXAMPLE 3: “IF NOT …” condition (NOT) — # — EXAMPLE 4: “IF NEITHER … NOR …” condition (NOT + OR) — # — EXAMPLE 5: Requested Actions — “`<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":" Immersive and dynamic Titles when enter a new Biome<\/p>\n","protected":false},"featured_media":31270,"template":"","meta":{"_minecraft_slug":"biomentry","_minecraft_project_id":"aVE0EPce","_minecraft_author":"Lye","_minecraft_license":"Apache-2.0","_minecraft_downloads":427,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"biomentry.zip","_minecraft_size_bytes":322821,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T10:54:15.688970Z","_minecraft_date_created":"2025-07-02T05:47:33.889131Z","_minecraft_date_modified":"2025-08-20T19:16:23.884888Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/biomentry","_minecraft_icon_attachment_id":31270,"_minecraft_imported_at":"2026-06-01T13:42:51+00:00","_minecraft_import_hash":"02962de1ffa017820189536b68abbfaa","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,127,128,129,123,92],"mod_loader":[132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-31269","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n– `\/biomentry toggle` \u2192 Enable\/disable notifications.
\n– `\/biomentry language
\n– **Preferences saved per player** for full control.<\/p>\n
\n– **WorldGuard support** \u2192 disable notifications in spawn, arenas, safe zones, or custom areas.
\n– **Multi-language ready** \u2192 English & French included; templates for German, Russian, Spanish.
\n– **Optimized performance** \u2192 smart caching reduces redundant calculations.<\/p>\n
\n– Brand-new **`conditions.yml`** unlocks deep customization:
\n – **Triggers** \u2192 biome entry, surface vs cave, time of day, player stats
\n – **Logic gates** \u2192 combine `and`, `or`, `not` for complex rules
\n – **Conditions** \u2192 permissions, health, armor, potion effects, world time
\n – **Actions** \u2192 run commands, apply effects, grant temporary permissions, heal, give saturation<\/p>\n
\n– Full support for **modded and datapack biomes** (Terralith, Biomes O\u2019 Plenty, etc.).
\n– **Custom caves recognized** automatically using `in_cave: true\/false`.
\n– **Full biome ID usage** (`terralith:skylands`) ensures conditions, sounds, and notifications apply to **any biome**, vanilla or modded.<\/p>\n
\n– Ambient sounds fully overhauled.
\n– Smarter cave detection.
\n– Reliable Boss Bars & notifications.
\n– Bug fixes \u2192 condition actions now always execute correctly.<\/p>\n
\nBiomes in Minecraft are **stories, atmospheres, and identities**.
\n**Biomentry gives them a voice.**<\/p>\n
\n– **Immersion** \u2192 RPG, semi-RP, adventure worlds
\n– **Storytelling tools** \u2192 triggers when entering zones
\n– **Atmosphere** \u2192 ambient sounds & visuals
\n– **Customization** \u2192 advanced configs & player preferences <\/p>\nconfig.yml<\/summary>\n
\n#configuration for Biomentry
\n# General settings
\ngeneral:
\n language: ‘en’ # Plugin language: ‘fr’ (French) or ‘en’ (English)
\n enableParticles: false # Enable or disable particle effects globally
\n enableCommands: false # Enable or disable command execution globally
\n enableAmbientSounds: true # Enable or disable ambient sounds globally<\/p>\n
\ntitleInfo:
\n fadeIn: 10 # Fade-in time (in ticks)
\n stay: 70 # Display duration (in ticks)
\n fadeOut: 20 # Fade-out time (in ticks)
\n animationType: ‘fade’ # Animation type: ‘fade’, ‘typewriter’, or ‘slide’
\n typewriterSpeed: 2 # Typewriter speed (characters per tick)<\/p>\n
\npriority:
\n enabled: true # Enable priority system
\n level: ‘medium’ # Priority level: ‘low’, ‘medium’, ‘high’
\n pauseOnOtherPlugins: true # Pause biome displays when other plugins show titles
\n resumeDelay: 40 # Delay (in ticks) before resuming after other plugin finishes
\n checkInterval: 5 # Interval (in ticks) to check for other plugin activities<\/p>\n
\n# when transitioning between each other
\nbiomeGroups:
\n # Birch forests
\n – [‘birch_forest’, ‘old_growth_birch_forest’]
\n # Taigas
\n – [‘taiga’, ‘old_growth_spruce_taiga’, ‘old_growth_pine_taiga’, ‘snowy_taiga’]
\n # Dark forests
\n – [‘dark_forest’]
\n # Oceans
\n – [‘ocean’, ‘deep_ocean’, ‘warm_ocean’, ‘lukewarm_ocean’, ‘cold_ocean’, ‘frozen_ocean’, ‘deep_cold_ocean’, ‘deep_frozen_ocean’, ‘deep_lukewarm_ocean’]
\n # Deserts
\n – [‘desert’]
\n # Mountains and peaks
\n – [‘windswept_hills’, ‘windswept_forest’, ‘windswept_gravelly_hills’, ‘windswept_savanna’, ‘jagged_peaks’, ‘frozen_peaks’, ‘stony_peaks’]
\n # Caves
\n – [‘deep_dark’, ‘dripstone_caves’, ‘lush_caves’]
\n # Badlands
\n – [‘badlands’, ‘eroded_badlands’, ‘wooded_badlands’]
\n # Savannas
\n – [‘savanna’, ‘savanna_plateau’, ‘windswept_savanna’]<\/p>\n
\ndisabledRegions:
\n – spawn
\n – safe_zone
\n – pvp_arena<\/p>\n
\ndisabled-worlds:
\n – “a_minigame_world”
\n – “world_the_end”
\n“`<\/p>\n<\/details>\nbiomes.yml<\/summary>\n
\n# And extract of the biome configurations
\n# Here you define the BEHAVIOR of each biome.
\n# The actual text for titles and subtitles is in the language files.
\nbiomes:
\n plains:
\n title: ‘biomes.plains.title’
\n subtitle: ‘biomes.plains.subtitle’
\n display: ‘actionbar’
\n animationType: ‘typewriter’
\n separator: ‘ | ‘
\n sound: ‘BLOCK_GRASS_BREAK’
\n commands: []
\n particle:
\n type: “VILLAGER_HAPPY”
\n count: 10
\n offset: 0.5
\n speed: 0.1
\n bossBar:
\n color: ‘WHITE’
\n style: ‘SOLID’<\/p>\n
\n sound: ‘ambient.weather.rain’
\n volume: 0.1
\n pitch: 1.0
\n delay: 200
\n forest:
\n title: ‘biomes.forest.title’
\n subtitle: ‘biomes.forest.subtitle’
\n display: ‘actionbar’
\n animationType: ‘typewriter’
\n separator: ‘ | ‘
\n sound: ‘BLOCK_CHERRY_WOOD_BREAK’
\n commands: []
\n particle:
\n type: “VILLAGER_HAPPY”
\n count: 10
\n offset: 0.5
\n speed: 0.1
\n bossBar:
\n color: ‘WHITE’
\n style: ‘SOLID’<\/p>\n
\n sound: ‘ambient.weather.rain’
\n volume: 0.1
\n pitch: 1.0
\n delay: 200
\n dark_forest:
\n title: ‘biomes.dark_forest.title’
\n subtitle: ‘biomes.dark_forest.subtitle’
\n display: ‘actionbar’
\n animationType: ‘typewriter’
\n separator: ‘ | ‘
\n sound: ‘AMBIENT_CAVE’
\n commands: []
\n particle:
\n type: “VILLAGER_HAPPY”
\n count: 10
\n offset: 0.5
\n speed: 0.1
\n bossBar:
\n color: ‘WHITE’
\n style: ‘SOLID’<\/p>\n
\n sound: ‘ambient.weather.rain’
\n volume: 0.1
\n pitch: 1.0
\n delay: 200
\n birch_forest:
\n title: ‘biomes.birch_forest.title’
\n subtitle: ‘biomes.birch_forest.subtitle’
\n display: ‘actionbar’
\n animationType: ‘typewriter’
\n separator: ‘ | ‘
\n sound: ‘BLOCK_CHERRY_WOOD_BREAK’
\n commands: []
\n particle:
\n type: “VILLAGER_HAPPY”
\n count: 10
\n offset: 0.5
\n speed: 0.1
\n bossBar:
\n color: ‘WHITE’
\n style: ‘SOLID’<\/p>\n
\n sound: ‘ambient.weather.rain’
\n volume: 0.1
\n pitch: 1.0
\n delay: 200
\n old_growth_birch_forest:
\n title: ‘biomes.old_growth_birch_forest.title’
\n subtitle: ‘biomes.old_growth_birch_forest.subtitle’
\n display: ‘actionbar’
\n animationType: ‘typewriter’
\n separator: ‘ | ‘
\n sound: ‘BLOCK_CHERRY_WOOD_BREAK’
\n commands: []
\n particle:
\n type: “VILLAGER_HAPPY”
\n count: 10
\n offset: 0.5
\n speed: 0.1
\n bossBar:
\n color: ‘WHITE’
\n style: ‘SOLID’<\/p>\n
\n sound: ‘ambient.weather.rain’
\n volume: 0.1
\n pitch: 1.0
\n delay: 200
\n flower_forest:
\n title: ‘biomes.flower_forest.title’
\n subtitle: ‘biomes.flower_forest.subtitle’
\n display: ‘actionbar’
\n animationType: ‘typewriter’
\n separator: ‘ | ‘
\n sound: ‘BLOCK_GRASS_BREAK’
\n commands: []
\n particle:
\n type: “VILLAGER_HAPPY”
\n count: 10
\n offset: 0.5
\n speed: 0.1
\n bossBar:
\n color: ‘WHITE’
\n style: ‘SOLID’<\/p>\n
\n sound: ‘ambient.weather.rain’
\n volume: 0.1
\n pitch: 1.0
\n delay: 200<\/p>\n
\n title: ‘biomes.clifftree.desert_cliff.title’
\n subtitle: ‘biomes.clifftree.desert_cliff.subtitle’
\n display: ‘actionbar’
\n animationType: ‘typewriter’
\n separator: ‘ | ‘
\n sound: ‘BLOCK_SAND_BREAK’
\n bossBar:
\n color: ‘YELLOW’
\n style: ‘SOLID’
\n duration: 120
\n particle:
\n type: “DUST”
\n count: 15
\n offset: 0.6
\n speed: 0.1<\/p>\nconditions.yml<\/summary>\n
\n# Configuration file for the Biomentry condition system.
\n# Each “rule” defines a trigger, conditions, and actions.<\/p>\n
\n # — EXAMPLE 1: Simple “IF … AND …” condition (AND) —
\n # The player receives speed in the desert, but only if it’s daytime AND they have the permission.
\n desert_speed_day:
\n trigger:
\n type: ‘ENTER_BIOME’
\n biome: ‘minecraft:desert’
\n conditions:
\n and: # “and” is a list of conditions that must ALL be true
\n – type: ‘WORLD_TIME’
\n operator: ‘LESS_THAN’
\n value: 12500 # Before sunset
\n – type: ‘HAS_PERMISSION’
\n permission: ‘biomentry.condition.desert_speed’
\n actions:
\n – type: ‘APPLY_EFFECT’
\n effect: ‘SPEED’
\n duration: 600 # in ticks (30 seconds)
\n amplifier: 0<\/p>\n
\n # The player receives a torch if they enter any cave and have the permission.
\n generic_cave_torch:
\n trigger:
\n type: ‘ENTER_BIOME’
\n in_cave: true # This rule only applies when the player is in a cave.<\/p>\n
\n or: # AT LEAST ONE condition must be true
\n – type: ‘HAS_PERMISSION’
\n permission: ‘biomentry.condition.torch_giver’
\n – type: ‘HAS_EFFECT’
\n effect: ‘NIGHT_VISION’
\n actions:
\n – type: ‘RUN_COMMAND’
\n command: ‘give %player_name% minecraft:torch 4’
\n – type: ‘SEND_MESSAGE’
\n message: ‘
\n # The player receives a warning if they enter the Nether WITHOUT full diamond armor.
\n nether_warning:
\n trigger:
\n type: ‘ENTER_BIOME’
\n biome: ‘minecraft:nether_wastes’
\n in_cave: false # Only applies on the “surface” of the Nether
\n conditions:
\n not: # “not” inverts the condition it contains
\n type: ‘HAS_ARMOR’
\n material: ‘DIAMOND’
\n pieces: 4 # 4 pieces for full armor
\n actions:
\n – type: ‘SEND_MESSAGE’
\n message: ‘<#FF6347>Warning!<\/b> The Nether is dangerous without proper equipment.’<\/p>\n
\n # The player takes damage in the Deep Dark if they have NEITHER the Regeneration effect, NOR the Resistance effect.
\n deep_dark_danger:
\n trigger:
\n type: ‘ENTER_BIOME’
\n biome: ‘minecraft:deep_dark’
\n conditions:
\n # The logic is: NOT (A OR B)
\n not:
\n or:
\n – type: ‘HAS_EFFECT’
\n effect: ‘REGENERATION’
\n – type: ‘HAS_EFFECT’
\n effect: ‘RESISTANCE’
\n actions:
\n – type: ‘APPLY_EFFECT’
\n effect: ‘WITHER’ # Applies the Wither effect
\n duration: 100
\n amplifier: 0
\n – type: ‘SEND_MESSAGE’
\n message: ‘<#8B0000>You feel a malevolent presence draining your life…’<\/p>\n
\n # Gives a temporary permission and health\/saturation upon entering a specific biome.
\n ancient_forest_bonus:
\n trigger:
\n type: ‘ENTER_BIOME’
\n biome: ‘minecraft:old_growth_pine_taiga’
\n conditions:
\n # No conditions, triggers for everyone
\n and: []
\n actions:
\n – type: ‘ADD_PERMISSION’
\n permission: ‘essentials.fly’
\n duration: 300 # in seconds (5 minutes)
\n – type: ‘HEAL’
\n amount: 4.0 # in half-hearts (here, 2 hearts)
\n – type: ‘GIVE_SATURATION’
\n amount: 5.0
\n – type: ‘SEND_MESSAGE’
\n message: ‘<#2E8B57>The strength of the ancient forest flows through you.’<\/p>\n