World Events and Ambience
The world keeps its own clock: constellations, groves, auroras and shorter nights. Here is what each one pays and when it happens.
Reading the stars
Stargazing needs an astrolabe. The recipe is seven gold ingots, one clock and one amethyst shard: gold across the top row, gold down both outer columns, the clock in the centre and the shard in the bottom middle. It is built on a clock rather than a spyglass, so it renders as a clock in your hand and still tells you the time of day when you hold it or hang it in a frame.
The astrolabe only answers at night. Its window is world time 13000 to 23000, and that same window is the plugin's single answer whenever anything else needs to know whether it is night, including the star-locked vault in an Observatory ruin. It deliberately does not ask the game engine whether it is daytime, because that answer is light based: a thunderstorm at noon would report darkness.
The sky is a clock, not a dice roll
Which of the eight constellations you read is decided by the world time, not by chance. The index is the world time divided by 1000, modulo 8, so the sky steps to the next constellation every 1000 ticks. Across the legal window that gives eleven slots and eight constellations, which means three of them come round twice a night and five come round once.
| World time | Constellation index | Notes |
|---|---|---|
| 13000 to 13999 | 5 | First slot after the gate opens |
| 14000 to 14999 | 6 | |
| 15000 to 15999 | 7 | The practical window for index 7 |
| 16000 to 16999 | 0 | |
| 17000 to 17999 | 1 | |
| 18000 to 18999 | 2 | Inside the Grand Alignment band |
| 19000 to 19999 | 3 | Inside the Grand Alignment band |
| 20000 to 20999 | 4 | The Herald. Gives a bearing to the nearest ancient ruin |
| 21000 to 21999 | 5 | Second window |
| 22000 to 22999 | 6 | Second window |
| 23000 | 7 | A single tick; the gate closes here |
The Herald is the reading that matters most and the hardest one to catch. It is index 4, it is reachable only in the 20000 slot, and that slot is roughly a tenth of the legal window. There are 60 ancient ruin sites in the world, and the Herald is the astrolabe's way of pointing at the closest one.
What a reading pays
Each constellation you read pays 50 to 200 coins and feeds Explorer experience. Which constellations you have read is stored as a bitmask on your player data, next to a stargaze cooldown, so the set survives a logout.
The reward resolves 80 ticks, four seconds, after you use the astrolabe. If you log out inside those four seconds the gaze does not pay.
Reading all eight is a one-time award: a Star Map plus the Astrologer title on your nametag. A persisted flag records that it happened, so a ninth reading adds nothing. If your inventory is full when the map is handed over, it drops at your feet and you are told so.
The Grand Alignment
The Grand Alignment is the one night event that changes what your time is worth rather than what is on screen. It carries its own band, world time 18000 to 20000, and its roll is 8 percent.
While it holds, two things change:
- Explorer experience is doubled. The multiplier sits on every path that awards Explorer experience, including the direct path the exploration systems use, so there is no way to earn it that misses the bonus.
- Rifts get likelier. The rift trigger chance is raised by 20 percentage points for the duration, so an alignment is also the best window for a tear to open near you.
The band overlaps constellation indices 2 and 3, which makes an alignment a sensible time to be carrying an astrolabe: the doubled experience applies to the reading as well as to every new chunk you cross while it lasts.
The 8 percent figure is shared. Both systems that check for an alignment, star navigation and the rift layer, read the same number, so the event cannot be half on.
Groves
A grove is a small daytime bloom of glow flowers that appears somewhere in the world and is announced to everyone. The roll runs roughly every 20 minutes with a 12 percent chance, and only during the day window, world time 0 to 12500.
The interval is not a flat timer. Twenty minutes is exactly 24000 ticks, which is exactly one Minecraft day, so a fixed timer would lock every roll to the same moment of the day and could silence groves for an entire uptime if that moment happened to fall at night. The trigger reschedules itself with up to 25 percent jitter in either direction, which breaks the phase lock.
The grove broadcast carries coordinates on purpose. Groves never generate inside a claimed chunk, so the announcement cannot be used to find someone's base, and the event is meant to be found and raced for.
What you get out of one
- Arriving pays 25 to 50 coins. Visitor credit is granted once per player, on the move that puts you inside the grove.
- The flowers are the harvest. Glow flowers drop
glow_essence, a glowstone-dust item that is the only ingredient the two grove recipes accept. - Two recipes use it: the Grove Potion and the Grove Candle, a green candle you can place and stack up to four per block. Plain glowstone dust will not satisfy either recipe; only the essence does.
- A first grove visit feeds the Rift skill discipline, and grove events count toward the field writ that asks for two of them.
Groves are a daytime event by design and there is no way to force one. If a whole day passes with no grove, the roll simply failed, twelve times out of a hundred being the odds.
The seven ambient effects
Ambient magic is the layer that makes the world feel inhabited. A periodic task checks where each player is standing, matches it against the biome, and plays particles and sound. There are seven effects, each one switchable on its own by staff, and all seven sit under one master switch.
| Effect | Where it plays |
|---|---|
| Aurora | Overhead at night |
| Ocean bioluminescence | Out over open water |
| Swamp fireflies | Swamps |
| Plains wind | Open plains |
| Nether embers | The Nether |
| Cherry petals | Cherry groves |
| Deep dark dread | The deep dark |
None of the seven pays anything, drops anything or changes a mob's behaviour. They are visual and audio only. If you see an aurora and nothing is happening in chat, that is the passive aurora effect rather than a solar storm.
Everything here is server side, which means it reaches Bedrock clients through Geyser the same way it reaches Java clients. There is no resource pack requirement and nothing to install.
Solar storms, meteor showers and the event cadence
Two of the ambient effects are rolled rather than continuous. Both ride the same pulse task, which fires every 40 ticks, two seconds, and both are night events.
The solar storm is a coronal mass ejection. Each pulse rolls a 1 in 500 chance while the night window is open. When one fires it runs for 150 pulses, about five minutes, and then a cooldown of 900 pulses, about thirty minutes, has to pass before another can be rolled. The cooldown keeps counting through the day; only the roll waits for night.
The meteor shower is its sibling, rolled at 1 in 900 per pulse in the same night window.
Both are night-locked for a practical reason rather than a thematic one: their visuals only render at night. Rolling one at noon would produce a chat announcement with nothing in the sky to go with it.
| Event | Window | Chance | Cadence and duration |
|---|---|---|---|
| Solar storm | Night | 1 in 500 per pulse | Pulses every 2 seconds; runs about 5 minutes; 30 minute cooldown |
| Meteor shower | Night | 1 in 900 per pulse | Pulses every 2 seconds |
| Grove | Day (0 to 12500) | 12 percent | Every 20 minutes, with jitter |
| Grand Alignment | 18000 to 20000 | 8 percent | Its own night band |
There is no single event scheduler behind these. Each system owns its own timer, which is why the numbers differ so much and why an event that is already running always finishes normally even if its window closes underneath it.
Rested Night: sleeping without a majority
Vanilla sleeping is all or nothing. Either enough players are in bed to meet the sleep percentage and the night is skipped outright, or nothing at all happens. Rested Night fills in the middle: if some of you sleep, the night runs faster in proportion to how many.
The rule is simple to state. Let f be the fraction of eligible players who are asleep. The night's remaining length is multiplied by 1 - f. One player in four asleep makes the night take 75 percent of its usual time, not zero.
| Sleepers | Clock speed | Night takes |
|---|---|---|
| 1 in 8 | about 1.14x | 87.5 percent |
| 1 in 4 | 1.33x | 75 percent |
| 1 in 3 | 1.5x | about 67 percent |
| 1 in 2 | 2x | 50 percent |
| 2 in 3 | 3x | about 33 percent |
| 3 in 4 | 4x | 25 percent |
| 7 in 8 | 8x (the cap) | 12.5 percent |
What you see
The first eligible sleeper starts the task and a boss bar appears for everyone in that world. A player sleeping alone also gets a chat line naming the current rate and how many sleepers would be needed to skip the night outright. The bar and the countdown recompute whenever the sleeper count changes.
Where it stands down
- At the gamerule threshold. Once enough players are asleep for vanilla to skip the night by itself, Rested Night stops. Two systems driving one clock would race each other.
- At dawn. The clock is clamped at the dawn tick and never stepped past it into a new day.
- When the last sleeper gets up. The task cancels itself, the bars clear and time returns to normal.
- When the daylight cycle is off. It never fights a gamerule.
- In worlds with no clock. The Nether and anything shaped like it are dropped from the rotation.
- When another plugin vetoes the time skip. The clock does not move and there is no retry. A veto is treated as a decision.
A partial acceleration does not clear the weather, so sleeping through a thunderstorm at half strength gets you to morning sooner but leaves the storm running. There is no cost when nobody is asleep: the task is started by someone entering a bed and cancels itself with the last sleeper, so an idle server runs no timer for this at all.
One honest gap: there is a switch for excluding away-from-keyboard players, but the server has no idle detection behind it yet, so a player who climbs into bed and walks away counts like any other sleeper.
Cartography: getting paid for new ground
The Cartographer buff pays you for entering a chunk you have not been paid for yet. It has five tiers and the payout is flat per chunk at each tier.
| Cartographer tier | Coins per newly entered chunk |
|---|---|
| 1 | 50 |
| 2 | 100 |
| 3 | 150 |
| 4 | 250 |
| 5 | 400 |
Alongside the coins, a new chunk gives 2.0 Explorer experience, or 4.0 if you have taken the Cartographer mastery. That figure goes through the normal job pipeline, which means the idle gate and the pattern checks apply to it like any other job income.
The set of chunks you have already been paid for is held in memory for your session and cleared when you log out. It is a session record, not a lifetime map.
The tools
- Waypoint marker. A compass-based item that plants a labelled marker in the world. You can hold five live markers at a time. The markers are deliberately non-persistent, so one disappears when its chunk unloads and the slot frees up again.
- Cartographer's quill. A paper-based tool from the same family of recipes.
- Map boards.
/mapboard pin <slot>and/mapboard unpin <slot>put a map into a board slot. Registering a board for the first time pays 25 Explorer experience. The register is held in memory only, so the same physical board can register again after a restart. - Chunk Reveal Token. Costs 1,500 coins and is consumed on use. It prints a three by three chat minimap of the chunk zones around you, north at the top, you in the centre in gold, with a legend. It only classifies chunks that are already loaded; an unloaded neighbour renders grey rather than forcing the world to generate.
The four zones the token shows are the same ones the Explorer reads in the world: rich, normal, depleted and dangerous. They are biome-weighted, seeded, and cached per chunk for the session, so a chunk does not change its zone under you while you work it.
Terralith: the world you are exploring
The overworld is generated by Terralith 2.6.2, shipped with the plugin as a datapack and copied into the first loaded world's datapack folder if it is not already there. It is not an optional add-on you install; it is the platform the rest of the exploration layer assumes.
Two systems read it directly.
Ore stamping
Every ore you break is stamped with the region it came from. The ore system cancels the vanilla drop and hands you a stamped replacement, honouring your tool's Fortune and Silk Touch on the way, so the ingot you smelt still carries its biome origin into the forge and the forged item's stats reflect where the metal came out of the ground.
Twelve biome groups add a bonus drop on top of the normal one.
| Biome group | Chance of a bonus drop |
|---|---|
| Volcanic | Quartz |
| Glacial | Diamond |
| Amethyst | Amethyst shards |
| Moonlight | Glowstone dust |
| Skylands | Echo shard |
| Mountain | Emerald |
| Lush forest and cloud forest | An extra copy of the ore's own drop |
| Magical desert | Gold nugget or gold ingot |
| Painted | Raw copper or raw iron |
| Yellowstone | Magma cream |
| Lavender | Purple dye |
| Sakura | Pink dye |
Ruin siting
Ancient ruins anchor to real Terralith structures. The table of structure ids the plugin looks for was rebuilt directly from the shipped datapack and holds 26 verified ids. Two more exist in the pack but are excluded with written reasons: one is in no structure set at all, and one has a biome predicate whose tag is empty, so neither could ever be found.
A ruin's tier is derived from the spacing of the structure set it belongs to rather than typed by hand, and its archetype comes from the biome it lands in. That is what makes a catacomb, a sunken shrine and an observatory feel like different places instead of the same room in three colour schemes.
How it all feeds the Explorer
Explorer is one of the 15 professions, and it is the one this whole layer is built around. Almost everything on this page routes into it.
| What you do | What it gives the Explorer |
|---|---|
| Enter a chunk you have not been paid for | 2.0 experience, or 4.0 with the Cartographer mastery, plus 50 to 400 coins by buff tier |
| Read a constellation | Experience plus 50 to 200 coins, and Rift skill experience |
| Walk into a grove | 25 to 50 coins, and Rift skill experience on your first visit |
| Register a map board | 25 experience |
| Do any of it during a Grand Alignment | Double experience |
The multipliers stack on top
Job income runs through per-action base tiers of 10, 35, 100 and 200 coins, multiplied by your rank and then by whatever situational multipliers apply. Two of those situational multipliers belong squarely to this layer: a rich chunk pays 1.3x, and working at night pays 1.3x. Night work is also when the astrolabe is usable, which is not a coincidence.
Rank multipliers run 1.0, 1.25, 1.5, 2.0 and 3.0 from Apprentice to Legend, with rank thresholds at 0, 5,000, 20,000, 60,000 and 150,000 experience.
Where it meets the skill trees
The skill layer has 81 base nodes across 10 disciplines plus 30 rank nodes. Both of this page's exploration hooks, a first grove visit and a constellation reading, feed the Rift discipline. Crossing into a new chunk feeds the Ruins discipline on the same verdict the Cartographer payout uses, so one chunk crossing is read once and paid once by both systems.
Much of this layer is newer material, and the figures are the intended values rather than fixed law. Treat exact numbers as the current defaults and report anything that does not match in game.