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

| Type | Example |
|—|—|
| Dimension | The Nether |
| Structure | Ancient City, Woodland Mansion |
| Biome | Cherry Grove, Deep Dark |

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

| Command | Permission |
|—|—|
| /regiondiscovery list [player] | own list free, others level 2 |
| /regiondiscovery count [player] | same |
| /regiondiscovery reset [player] | level 2 |
| /regiondiscovery resetall | level 4 |
| /regiondiscovery reload | level 2 |

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