Skip to main content

Sleep overlay

When the player goes to bed, they see an overlay.

Sleep overlay

The overlay includes an image of the moon and random facts, or an image of a skull and corresponding nightmares.

Nightmares

The moon displays the current phase of the Minecraft world.

Moon phases

To trigger nightmares, the sleeping comfort must be less than 0. If it's greater than -1, the player won't be able to sleep at all. More information about comfort is available in the comfort system tab.

The overlay is fully customizable.


Config

ParameterDefaultDescription
minSlideDisplayTimeMs2500Minimum slide duration in milliseconds
maxSlideDisplayTimeMs4000Maximum slide duration in milliseconds
fadeInDurationMs300How quickly a new slide appears
fadeOutDurationMs300How quickly a slide disappears

The final slide time is randomly chosen between minSlideDisplayTimeMs and maxSlideDisplayTimeMs, allowing more vibrant slides with varying durations.

warning

fadeInDurationMs and fadeOutDurationMs are not available in Forge 1.20.1.


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

Supported languages

Useless Facts API + local database (~500 entries).

For all languages there is a local fact database of approximately 500 entries, which is activated if the API is unavailable, there is no internet connection, or other factors, including a disabled function in the configuration.