BiomeLock

BiomeLock

BiomeLock restricts biome progression by blocking player actions until the required boss is defeated.

Private Keys System

BiomeLock uses a fully individualized progression system based on private keys. Each global world key (such as defeating a boss) automatically generates a corresponding private key for the player.

These private keys are assigned individually, meaning each player has their own progression, independent of other players on the server. All biome access checks, limits, and restrictions are performed exclusively based on these private keys.

When a biome boss is defeated, the corresponding private key is automatically granted to all players who participated in the boss defeat.

With this system, BiomeLock ensures:

• 100% individual progression per player
• Precise control over access and restrictions
• No direct dependency on the global world state
• Full compatibility with multiplayer servers and customized progression

While the player is inside a blocked biome

• Interaction Blocking

Blocks interactions with world objects, containers, items, and pickable objects while the effect is active.

• Combat Blocking

Blocks all types of attacks (melee, projectile, and area).

• Building and Terrain Blocking

Prevents building, repairing, removing structures, and modifying terrain using the hammer, hoe, or cultivator.

• Dungeon Blocking

Blocks entry into dungeons.

• Map Exploration Blocking

Prevents map exploration and fog of war reveal.

• Pickup Restrictions

Blocks both automatic and manual item pickup.

• On-Screen Warnings

Displays periodic center-screen messages informing players that the biome is locked.

• Trader Restrictions

Blocks interaction with traders until the required boss is defeated Haldor unlocks after defeating Eikthyr Bog Witch unlocks after defeating The Elder Hildir unlocks after defeating The Elder.

• Mob Spawn Blocking

Prevents mob spawning inside blocked biomes

• Map Pin Blocking

Prevents placing map pins while inside blocked biomes

Global restrictions based on private keys

• Skill CAP

Added a skill CAP system based on private keys.

• Guardian Power

Prevents the use of the guardian’s power if you have not defeated it yet.

• Boss Progression Restrictions

Blocks boss summoning until the previous boss has been defeated

Boss Summon Day Restriction

Optionally blocks interaction with boss altars until the minimum configured in-game day for each boss is reached. Each boss has its own individual and independent configuration, allowing you to define on which in-game day its summon will be unlocked.

Boss Summon Cooldown

Optionally sets how many full in-game days each player must wait before summoning the same boss again (section 10, disabled by default, 1 day per boss, 0 disables a boss). The cooldown is individual: it is saved on the character, separately for each boss and each world, and does not block other players or other bosses. Only summons confirmed by the altar start the cooldown, so failed attempts never consume it.

Features

• Admin Bypass

Allows administrators to bypass all restrictions when enabled.

• Fully Configurable

All features can be individually enabled or disabled via configuration, with full server synchronization.

• Mod Integration

Other mods can lift the biome restriction in specific areas through BiomeLockAPI, such as inside a player territory.

• Multi-language Support

Includes built-in translations for English, Portuguese, and German. Additional languages can be added via external YAML translation file. An example translation file is included in the plugin files.

Private Keys by Boss and Events

| Category | Biome / Context | Boss / Event | Granted Private Key | |---------------|-----------------|-----------------------|----------------------------| | Boss | Meadows | Eikthyr | bl_defeated_eikthyr | | Boss | Black Forest | The Elder | bl_defeated_gdking | | Boss | Swamp | Bonemass | bl_defeated_bonemass | | Boss | Mountain | Moder | bl_defeated_dragon | | Boss | Plains | Yagluth | bl_defeated_goblinking | | Boss | Mistlands | The Queen | bl_defeated_queen | | Boss | Ashlands | Fader | bl_defeated_fader | | Boss | Deep North | Kall — initial defeat | bl_defeated_frozenking | | Boss | Deep North | Kall — final defeat | bl_defeated_frozenking_p3 | | Creature Kill | Ocean | Serpent | bl_defeated_serpent | | Creature Kill | Black Forest | Troll | bl_killedtroll | | Creature Kill | Swamp | Surtling | bl_killed_surtling | | Creature Kill | Frost Caves | Bat | bl_killedbat | | Creature Kill | Writhan encounter | Writhan | bl_defeated_writhan | | Creature Kill | Hive encounter | Hive | bl_defeated_hive | | Creature Kill | Deep North | Frysling | bl_killed_frysling | | Quest / NPC | Black Forest | Hildir – Quest 1 | bl_hildir1 | | Quest / NPC | Mountain | Hildir – Quest 2 | bl_hildir2 |