Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for Vystorm

Fatigue, meaningful sleep, cozy bedrooms, hallucinations, insomnia mobs and a procedural dream world.

Report Vystorm-Insomnia?

Requires Vystorm Core 0.65.0 or newer (free)

Vystorm Insomnia

Vystorm Insomnia gives every player a fatigue value that rises while they play and only drops with real sleep in a bed. Tired players hear and see things that are not there, well-rested players get a small bonus, and anyone tired enough can travel into a dream world with its own dungeons.

A player awake at night in Vystorm Insomnia

What players get

  • A reason to build a bedroom and to go to bed: sleep takes about a minute and its quality depends on the room.
  • Five stages of tiredness, from Rested to Sleep-deprived, with hallucinations and short blackouts at the far end.
  • Personal mobs that only attack the tired player and only drop loot for them.
  • Coffee and a campfire as a stopgap on long trips.
  • A dream world with three dungeons, a story with four endings and a weekly challenge.

Features

Fatigue

  • Fatigue and sleep debt run from 0 to 100. With the default settings one stage takes about 160 minutes of normal play.
  • Sprinting, swimming, mining and fighting make players tired faster, boss fights twice as fast.
  • Fatigue pauses in Creative and Spectator, and optionally while a player is idle.
  • Hallucinations start at the Exhausted stage: yawning, footsteps, a door, a creeper hiss, shadows or a dark screen. /insomnia triggers explains afterwards what happened and why.
  • Microsleep: from 80 fatigue players nod off for a few seconds now and then.
  • Insomnia mobs appear from 70 fatigue in three tiers. Only their owner can fight them and pick up the drops. The top tier can drop echo shards, with a limit per 15 minutes.
  • Coffee (a honey bottle by default) and energy drinks hide fatigue for a while. Each further cup works less, a crash follows, and the sleep debt stays. More drinks can be added in stimulants.yml.
  • A reminder tells players with high sleep debt that only a bed repays it. Each player can turn it off in /vsettings.

A tired player surrounded by things that are not really there

Sleep

  • Sleep runs in real time through falling asleep, light sleep and deep sleep. A short rest lowers fatigue and debt, a full sleep clears both.
  • A roof and darkness improve sleep quality. Open sky, a thunderstorm or monsters nearby make it worse.
  • Cozy bedrooms: carpet or wool, a potted plant, a bookshelf, a lantern or candle, a painting or item frame and a chest or barrel within 4 blocks of the bed each add 4 % quality.
  • Daytime naps work as well.
  • A dialog asks on lying down whether to sleep until a chosen time, enter the dream or get up. On Bedrock and on 1.20.6 the same choice comes as clickable chat.
  • The night no longer skips at once. Time runs faster the more players sleep, and everyone sees the count in the action bar.
  • Getting up early shows a summary of how long the nap was and what it took away.
  • Rested bonus after a full sleep: 45 minutes with 5 % more XP, light regeneration and less hunger.
  • Campfire rest: standing still next to a lit campfire lowers fatigue slowly, but never below 30. Sleep debt still needs a bed.

A furnished bedroom for a good night's sleep

Dream Realm

  • /dream near a safe bed starts a visit of 5 to 20 minutes, shown as a boss bar. The inventory is stored by Core and returned on waking, and /wake ends the visit at any time.
  • The dream world is a floating landscape built from a seed, with five biomes, sky islands, plants and rock formations.
  • Three dungeons: Cloud Ruins (find the waypoints), Crystal Vault (a sequence puzzle) and Nightmare Keep (waves of wardens).
  • Loot goes into a dream pouch and is collected after waking with /dreamloot.
  • The campaign "The Shattered Dream" leads through all three dungeons. Two decisions give one of four endings, each with its own reward. /dream quest start, status, pause.
  • Shared dreams: /dream invite <player> brings up to 3 other dreamers into your fight. /dream join accepts, /dream leave ends it.
  • Weekly nightmare: every Monday the Nightmare Keep gets new modifiers. /dream weekly shows them, the five fastest clears and the time left. The first clear of the week pays an extra reward.

Floating islands of the dream world

Menus and admin tools

  • /insomnia opens the fatigue menu. /insomnia status shows the stage, the time to the next stage, the coffee forecast and the sleep quality. /insomnia history lists the current session.
  • Core's player menu (sneak and right-click a player) shows how tired the other player looks.
  • Players set their sleep prompt, wake-up time and reminders under /vsettings.
  • /insomnia admin overview lists all online players, most tired first, with quick actions. /insomnia admin get|setfatigue|setdebt|sleep|effect|spawnmob|reload do the rest.
  • With VystormCityClaim, sleep in towns and rented rooms is better. With BloodMoon, sleep is worse during a blood moon and insomnia mobs come more often.
  • Fatigue is stored in a file or, for networks, in MySQL or MariaDB through Core.
  • Players with the Vystorm client mod see fatigue bars and stage toasts. The Core web page shows a fatigue page.
  • Insomnia registers 10 placeholders under the namespace sleep (fatigue, sleep debt, stage, sleeping, rested bonus, caffeine), for example %vystorm_sleep_fatigue_int% and {sleep:stage_name}. Core passes them on to PlaceholderAPI, so other plugins can show them when PlaceholderAPI is installed.
  • A first-run setup asks a few questions, a tutorial sits in the Core menu, and commands work in the player's language.

Switch features on and off

Every feature has its own switch in config.yml and in game under /vadmin features, each with a label and a one-line description in seven languages. Sleep has a master switch, sleep.enabled: with it off, beds behave as in vanilla and the Dream Realm keeps working through /dream. Single hallucination effects, cozy bedrooms, activity factors, the dream landscape layers, the dungeons, the menus, the admin tools, the client mod bars and the web page have switches of their own.

A change applies at once, without a restart. The restart cases are web_page.enabled, tutorial.enabled, integrations.cityclaim, integrations.bloodmoon, the dream world layout (dream.world.*) and the storage type. A command of a switched-off feature answers "This feature is switched off on this server." It also disappears from tab completion and help at once. Stored data is never deleted.

Four things have no switch: your players' personal choices in /vsettings (they only hold settings for the sleep dialog and the debt reminder, which have switches), the first-run setup, the developer API for other plugins, and /insomnia admin reload, which applies the switches.

Setup

  • Put Vystorm Core 0.65.0 or newer and Vystorm Insomnia into plugins/ and start the server.
  • The plugin comes preconfigured. On the first start admins can answer a few setup questions or keep the recommended values.
  • Edit config.yml, stimulants.yml and mobs.yml as files or in game with /vadmin config VystormInsomnia. An invalid change is rejected and the old configuration stays active.
  • Seven languages: English, German, French, Italian, Brazilian Portuguese, Russian and Simplified Chinese. Each player gets the language of their client.
  • Tested on Paper and Purpur 26.2, Paper 1.20.6 and Spigot 26.2. Java 25 (the version it was tested with; the plugin is compiled for Java 21).
  • Dream visits, campaign progress and pouches are stored per server. Back up world and player data before the first start.

Permissions: insomnia.use, insomnia.dream and insomnia.dream.quest for everyone, insomnia.admin for operators. Every command is listed in the README on GitHub.

There is one update every month. If the plugin works well on your server, please leave a review.

More from Vystorm: Vystorm Core, Rails, Portals, CustomTrees, XPVaultEconomy, BlockIntegrations, Veins, Winter Is Coming, Gallery, Paddock, Snapshot, Boards, Estates, Chat, Worlds and Locks, all free.

Free and open source (GPL-3.0): source code on GitHub

Information

Category
Gameplay
Published
October 29, 2026
License
MIT
2Downloads
0Stars

Pinned Versions

Members

1