Sleep overlay
When the player goes to bed, they see an overlay.
The overlay includes an image of the moon and random facts, or an image of a skull and corresponding nightmares.
The moon displays the current phase of the Minecraft world.
A nightmare happens when the comfort around the bed drops to nightmareThreshold (-1 by default) or lower. Drop further, to sleepBlockThreshold (-2 by default), and the player cannot go to bed at all. Both numbers are configurable — see the comfort system tab.
Instead of the calm starfield of a normal night, a nightmare replaces the background with a dark red vignette that slowly closes in and opens back up, like laboured breathing. It is not a flashing effect — the movement is deliberately slow.
The overlay is fully customizable.
Config
- Timing
- Appearance
- Behavior
| Parameter | Default | Description |
|---|---|---|
minSlideDisplayTimeMs | 6000 | Minimum slide duration in milliseconds |
maxSlideDisplayTimeMs | 8000 | Maximum slide duration in milliseconds |
fadeInDurationMs | 300 | How quickly a new slide appears |
fadeOutDurationMs | 300 | How quickly a slide disappears |
The final slide time is randomly chosen between minSlideDisplayTimeMs and maxSlideDisplayTimeMs, allowing more vibrant slides with varying durations.
| Parameter | Default | Description |
|---|---|---|
overlayOpacity | 0.4 | Transparency of the entire overlay background (excludes text and images) |
textOpacity | 1.0 | Transparency of text, where 1 = 100% |
imageOpacity | 0.6 | Transparency of images, where 1 = 100% |
specialSlideChance | 0.05 | Percentage chance of a special slide appearing |
enableImage | true | Enables or disables the overlay image (moon or skull) |
enableStarDust | true | The drifting starfield behind the text on a normal night |
showSlideProgress | true | A thin progress indicator showing how long the current slide has left |
enableStarDust only affects normal sleep. Nightmares always use the red vignette instead of stars, so turning stars off does not make nightmares plain.
| Parameter | Default | Description |
|---|---|---|
hideChatWhenSleeping | true | Blocks chat messages while the player is sleeping, allowing them to better see the overlay |
enableOverlay | true | Completely disables the overlay when set to false |
Text while sleeping
While sleeping, players receive different types of messages, including:
- Facts — real-world style random facts
- Lore — in-game universe lore and background details
- Surreal thoughts — abstract, dream-like messages
- Special messages — rare and unique events with higher significance
Nightmares draw from their own separate pool, so the unsettling lines never show up on a peaceful night.
Supported languages
The mod ships with 13 fully translated languages, each with the same 342 dream entries. The overlay follows your own client language, so players on the same server read dreams in different languages simultaneously.
The full table, entry counts and fallback rules are on the languages page.
The external Useless Facts API only exists for English and German. Every other language runs on the built-in database — which is the default anyway, see below.
The facts API
"useFactsApi": false
When enabled, English and German players get an extra stream of trivia pulled from an online service, mixed in with the built-in entries.
This is off by default. It reaches out to the internet, which is not something a Minecraft server should do without being asked, and the built-in database is large enough to stand on its own.
If you enable it and the service is unreachable — no connection, downtime, a firewall — the mod quietly falls back to the local database and retries later instead of hammering the endpoint. Players never see an error; they just see local facts.