Vystorm-Insomnia

Requires Vystorm Core (free) – the shared base of all Vystorm plugins (English/German language files, in-game config editor, update check). Just drop one extra jar into plugins/, no setup.

Fatigue, meaningful sleep and adventures beyond your dreams. Every player gets a fatigue value that slowly rises while playing and only drops with real sleep in a bed. The more tired you are, the more your mind plays tricks on you: footsteps behind you, a creeper that isn't there, short blackouts. Sleep well and you get a rested bonus. Or, when you're tired enough, travel into a procedural dream world with its own dungeons.

Fatigue

• Fatigue and sleep debt. Two values from 0 to 100. Fatigue rises about one stage every 160 minutes of normal play, faster when sprinting, swimming, mining and fighting, twice as fast against bosses. Sleep debt builds and recovers more slowly.
• Five stages. Rested, Tired (20+), Exhausted (40+), Overtired (60+) and Sleep-deprived (80+), with a message on every change. /insomnia status shows the next stage and roughly how long until you reach it.
• Hallucinations. From Exhausted you hear yawning, footsteps, doors or a creeper, see shadows, or the screen goes dark for a moment. /insomnia triggers explains afterwards what was triggered and why.
• Microsleep. From 80 fatigue you occasionally nod off for a few seconds, only on solid ground and out of danger.
• Insomnia mobs. From 70 fatigue, personal mobs appear that only attack you and drop loot only for you, in three tiers up to Vindicators. The top tier can drop echo shards (at most three per 15 minutes).
• Coffee and energy drinks. Lower fatigue instantly, but each cup works less and a crash follows later. By default coffee is a honey bottle; add more stimulants in stimulants.yml.

Sleep

• Sleep that matters. In bed you pass through falling asleep, light and deep sleep (about one minute), whether or not the night is skipped. Daytime sleep is supported.
• Where you sleep counts. A roof, darkness and a town improve sleep quality; open sky, thunderstorms or nearby monsters make it worse.
• Cozy bedrooms. Furnishings within 4 blocks of the bed add up to +24 % sleep quality: carpet or wool, a potted plant, a bookshelf, a lantern or candle, a painting or item frame, a chest or barrel. Lying down shows what you already have and what is still missing.
• Rested bonus. After a full sleep: 45 minutes of +5 % XP, light regeneration and less hunger.

The dream world

• /dream near a safe bed (default 40+ fatigue) starts a limited exploration trip. Visits last 5 to 20 minutes depending on your fatigue, shown as a boss bar countdown.
• A seeded 3D dream landscape: floating terrain with hills, forested ridges, valleys, overhangs and caves, plus floating island groups above, across five connected biome types: open cloud meadows, a dense mirror grove, bright crystal cliffs, green twilight gardens and barren night-break land.
• Three procedural dungeons: Cloud Ruins waypoint exploration, Crystal Vault sequence puzzles and Nightmare Keep combat waves, connected to the start by walkable paths.
• Safe rewards. Loot is collected in a protected dream pouch and claimed after waking with /dreamloot. Your inventory is kept safe by Vystorm Core during the visit and returned afterwards.
• Dreams give partial recovery for time actually spent, not the full rested bonus. /wake returns you safely.

Menus and extras

• Menu via /insomnia or /vmenu → Character → Fatigue, plus an in-game tutorial.
• /insomnia history shows your recent values, sleep and drinks for the current session.
• Creative and spectator mode pause fatigue; an optional idle pause is available.
• With BloodMoon running, sleep is worse during a blood moon and insomnia mobs appear more often. With VystormCityClaim, sleeping in towns and rentals is better.
• English and German, per player.

Commands & permissions

Configuration

Edit in game with /vadmin config VystormInsomnia (covers config.yml, stimulants.yml and mobs.yml) or Settings → Server Settings → Fatigue & Sleep.

• fatigue.*: how fast fatigue and sleep debt rise, stage thresholds, pauses
• activity.*: factors for sprinting, mining, combat and bosses
• sleep.*: sleep phases, recovery, sleeping-spot and cozy-bedroom influence, daytime sleep
• dream.*: entry threshold, source worlds, time budget, world, rewards and nightmare waves
• hallucinations.*, microsleep.*, insomnia_mobs.*, rested.*: each system can be switched on or off
• storage.type: yaml by default, or mysql through Vystorm Core's shared database

Good to know

This is an early 0.x release. Dream visits and reward pouches are local to one server and not designed for cross-proxy handoff. Back up your world and player data before first use and try your configuration on a test server.

Requirements

• Paper or Purpur 26.2, Java 25
• Vystorm Core (free), 0.32.0 or newer
• Optional: VystormCityClaim, BloodMoon

More from Vystorm

Vystorm Core, Vystorm Rails, VystormPortals, CustomTrees, XPVaultEconomy, BlockIntegrations, Vystorm Veins, Winter Is Coming, Vystorm Gallery, Vystorm Paddock, Vystorm Snapshot, Vystorm Boards and Vystorm Estates, all free.

Free and open source (MIT).