Region Discovery

Region Discovery

Adds a discovery notification when a player enters a new region for the first time — the kind of moment open-world games use to make a map feel worth exploring.

Walk into an Ancient City and it announces itself. Cross into a biome you have never seen. Step through a Nether portal. Each one shows once, then never again.

How it works

Everything runs server-side. Notifications are sent as ordinary vanilla title packets, so there is no custom networking involved.

• Singleplayer — works
• Dedicated server — works, including for players who do not have the mod
• Client only, vanilla server — nothing happens

For modpack authors: the same jar goes in both the client and server pack.

What gets announced

At most one notification is shown at a time. If you enter a dungeon inside a new biome, they arrive one after the other instead of stacking.

Biome names come from vanilla translation keys, so modded biomes are named correctly without any extra work. Structures fall back to a readable form of their ID (abandoned_temple becomes Abandoned Temple), and can be overridden with a resource pack.

Progress

Discoveries are stored per player UUID in the world save. They survive restarts and are independent of the client.

Commands

Short form: /rd

Configuration

config/region_discovery.json

• checkIntervalTicks — how often each player is checked, 20 = once per second
• repeatAnnounce — announce again when re-entering, not just the first time
• structuresRequireInside — require standing inside an actual piece rather than the structure bounding box. Useful with mods that generate very large structures
• ignoredBiomes / ignoredStructures / ignoredDimensions — supports namespace:* wildcards. Rivers, beaches and stony shores are excluded by default so coastal travel does not spam
• Title colour, fade timings, and the notification sound are all adjustable

Performance

Players are checked once per second by default, staggered across ticks so they never all check at once. Structure detection only tests candidates the current chunk actually references, which keeps the cost low even with dozens of structure mods installed.

Requirements

• Fabric Loader
• Fabric API
• Java 21