Ultimate Sleep

Ultimate Sleep

The advanced, all-in-one, fully admin-configurable sleep mod. It folds the useful
behaviors from ~180 surveyed Modrinth sleep mods (deduped to 52 distinct features) into a
single mod where everything is a toggle. In singleplayer the player is the admin; on a
server the controls are permission-gated. Ships for Fabric, NeoForge, and Forge across
Minecraft 1.20 through 26.x, plus a native Paper/Folia server plugin for each major line. The mod is required on the server only -- it works for
vanilla clients via chat/commands, and adds an optional in-game panel for clients that
also have it.

Why Ultimate Sleep

• One mod instead of five. Night-skip, sleep voting, auto-sleep, AFK handling, wake
  rewards, sleep-rule overrides, and world progression -- every behavior you would
  normally stack separate sleep mods for, in one place, each one a toggle.
• Predictable nights. The mod owns every skip; vanilla can never skip the night on
  its own, so the behavior you configure is the behavior you get.
• Zero client requirement. Install it on the server and every player is fully served
  -- vanilla clients get everything through chat and /usleep commands.
• Optional GUI for those who want it. Players who also install the mod client-side
  get an in-game control panel via /usleep gui.
• Delegate without op. A designated sleep-admin can configure everything with no
  operator level.

Download

Get Ultimate Sleep on Modrinth: https://modrinth.com/mod/ultimate-sleep

---

Sleep features

Night-skip engine

The core. One setting, requirement_mode, picks how a night gets skipped.

• SIMPLE mode (percentage). A skip fires when enough eligible players are asleep. The
  threshold is required_sleep_percentage (e.g. 50% of 4 players online = 2 needed). No voting
  -- just sleep and the night passes once the count is met.
• VOTE mode. The first player to climb into a bed auto-starts a server-wide vote (so nobody
  waits in bed alone). Everyone non-AFK votes during a countdown window; the result is tallied by
  the chosen pass rule and the night skips on a pass.
  • Vote via /usleep yes / /usleep no (works on any client), or with the on-screen prompt.
  • Getting into a bed mid-vote counts as an automatic YES.
  • Pass rules (vote_pass_rule): MAJORITY_CAST (yes > no), PERCENT_CAST (yes reaches
    vote_pass_percentage of votes cast), or MAJORITY_NON_AFK (majority of all non-AFK
    players -- the default).
• The mod owns every skip. A server-side gate stops vanilla's own sleep check so the game
  can never skip the night on its own -- even if every player piles into bed. The night
  advances only when Ultimate Sleep decides it should, which keeps behavior predictable. The mod
  is also the sole voice -- vanilla's own "x/y sleeping" message is suppressed.

Skip behavior (how the triggered skip is carried out)

• INSTANT. Jump straight to morning (vanilla-style).
• ACCELERATE. Time-lapse the night instead of jumping, by driving the overworld clock rate,
  at one of four named speeds (Slow / Slowish / Quick / Fast = ~10 / 7.5 / 5 / 2.5 real seconds).
• Preserve weather. Optionally keep rain/storms running across the skip instead of clearing
  them.

Auto-sleep

• Per-player opt-in with /usleep auto; the choice is saved per player. The feature is
  admin-gated by auto_sleep_enabled (on by default).
• Dusk auto-bed. At the earliest sleepable time, the server puts opted-in players to bed
  automatically if a bed is within reach -- exactly as if they'd right-clicked it.
• Home-bed targeting. Prefers your own spawn bed when it is reachable, otherwise the nearest
  reachable bed.
• Travelers' Backpack sleeping bag (soft dependency -- runtime-detected, no compile
  dependency). When no bed is reachable, auto-sleep can sleep in place using a loose sleeping-bag
  item or a bag attached to a worn Travelers' Backpack; the placed bag is removed on wake.
• Missed-sleep notice when neither a bed nor a sleeping bag is in reach.

AFK system

• Automatic AFK after afk_threshold_seconds idle (no move/look), plus a manual /usleep afk
  toggle. Any non-bed movement clears AFK; lying in bed does not.
• Admin force-AFK a player with /usleep admin afk <player>.
• Conditional /afk alias. If no other mod already provides /afk, Ultimate Sleep registers
  /afk as a direct alias of /usleep afk. If another mod owns it, we stand down.
• Feeds the engine. AFK players can be excluded from the sleep requirement
  (exclude_afk_from_requirement) and get no vote and no vote prompt.

Rewards on waking

Granted on a successful sleep/skip; each is an independent admin toggle, usable in any combo.

• Regeneration for reward_regeneration_minutes (default 5).
• Golden carrot -- one per wake; drops at your feet if your inventory is full so it's
  never lost.
• Speed boost of reward_speed_boost_percent% (default 25) for reward_speed_boost_minutes
  (default 5). Applied via vanilla Speed levels, so the percentage is approximate.

Accessibility / sleep-rule overrides

• Sleep anytime -- bypass the day/time restriction on using a bed.
• Ignore monsters -- sleep even with hostile mobs nearby.
• Ignore "bed too far" -- skip the distance check when entering a bed.
• Highlight blocking mobs -- outline the monsters that would stop you sleeping, visible only
  to you (a per-viewer glow with a timed revert).

World progression while sleeping

Skipping the night can optionally advance the world, not just the clock. A master toggle
(world_progression_enabled) plus per-category sub-toggles so admins can scope the performance
cost.

• Crops & plants -- crop growth, saplings/tree growth, and plant growth.
• Animal husbandry -- breeding cooldowns and baby-animal growth.
• Smelting -- furnaces, smokers, blast furnaces continue.
• Despawn timers -- item/entity despawn timers advance (off by default).

Sleeper visibility & feedback

• Sleep status in chat (show_sleepers_in_chat) -- a concise broadcast as players start/stop
  sleeping, e.g. <name> is sleeping, 1 of 2 required. Need 1 more. This also serves vanilla
  clients with no UI.
• Non-blocking vote prompt -- a bottom-of-screen action-bar message (never a blocking screen,
  so gameplay is never frozen) plus a private "your vote carried / you were outvoted" result.
• Live vote tally (show_sleepers_on_vote_screen) -- the vote prompt can also show the running
  yes/no count and who is currently in bed.
• Wake announcement (notify_wake) -- a short broadcast once the night has been skipped, so
  everyone knows morning has arrived.

In-game admin panel (optional client UI)

• Server-driven panel opened with /usleep gui. The server pushes the open request and the
  current config to a client that has the mod; the client renders a paginated control panel
  (9 pages) and writes changes back over a private, permission-checked back-channel. Clients
  without the mod simply use the commands instead.

Flexible settings input

• Forgiving values. Booleans accept true/yes/1/on and false/no/0/off (case-insensitive);
  percentages accept 50, 50%, 1/2, or 0.5. Every set confirms the resolved value back to
  you.
• Tab completion for setting keys and values.

---

Settings reference

Typed (bool / int / enum / percent), JSON-persisted. Per-player state (AFK status, auto-sleep
opt-in, home bed) is runtime player data, not in this global table.

key	type	default
enabled	bool	true
requirement_mode	SIMPLE | VOTE	SIMPLE
required_sleep_percentage	percent	50
exclude_afk_from_requirement	bool	true
vote_duration_seconds	int	30
vote_pass_rule	MAJORITY_CAST | PERCENT_CAST | MAJORITY_NON_AFK	MAJORITY_NON_AFK
vote_pass_percentage	percent	50
skip_mode	INSTANT | ACCELERATE	INSTANT
accelerate_speed	SLOW | SLOWISH | QUICK | FAST	QUICK
preserve_weather	bool	false
sleep_anytime	bool	false
sleep_ignore_monsters	bool	false
ignore_bed_too_far	bool	false
highlight_blocking_mobs	bool	false
show_sleepers_in_chat	bool	true
show_sleepers_on_vote_screen	bool	true
notify_wake	bool	true
reward_regeneration	bool	false
reward_regeneration_minutes	int	5
reward_golden_carrot	bool	false
reward_speed_boost	bool	false
reward_speed_boost_percent	percent	25
reward_speed_boost_minutes	int	5
world_progression_enabled	bool	false
progress_crops	bool	true
progress_animal_husbandry	bool	true
progress_smelting	bool	true
progress_despawn_timers	bool	false
auto_sleep_enabled	bool	true
afk_threshold_seconds	int	180
provide_afk_command	bool	true

---

Commands

Everything lives under /usleep. The player and informational commands are open to everyone;
the configuration commands are permission-gated. A designated sleep-admin needs no operator
level and is treated as op-4 for every Ultimate Sleep command, so owners can delegate sleep
configuration without handing out vanilla operator.

Open the control panel

• /usleep gui -- open the in-game admin panel. Requires the Ultimate Sleep client mod; vanilla
  clients use the chat commands below instead.

Everyday player commands (everyone)

• /usleep status -- short status line: mode, requirement percentage, and current AFK count.
• /usleep query -- full settings dump (key = value) plus who currently owns /afk.
• /usleep afk -- toggle your own AFK state.
  • /afk -- alias of /usleep afk, registered only when no other mod already provides it.
• /usleep auto -- toggle your personal auto-sleep opt-in.
  • Available only while the admin has auto_sleep_enabled turned on.

During a sleep vote (VOTE mode, while a vote is running)

• /usleep yes -- vote to skip the night.
• /usleep no -- vote against skipping.

Change settings (sleep-admin, or op level 2+)

• /usleep set <key> <value> -- change a setting. Setting keys tab-complete, and boolean/enum
  values tab-complete once a key is typed.

Administration (sleep-admin, or op level 3+)

• /usleep admin set <key> <value> -- change any setting at the administration tier.
• /usleep admin afk <player> -- force another player into AFK.
• /usleep admin admins -- manage the sleep-admin roster:
  • /usleep admin admins add <player> -- grant sleep-admin to a player.
  • /usleep admin admins remove <player> -- revoke a player's sleep-admin.
  • /usleep admin admins list -- list the current sleep-admins.

---

Source code

The full multi-loader source (with build instructions) lives on the
minecraft-1.20-26.3 branch.

Report issues / Support

Please file bug reports and feature requests at the shared support hub:
https://github.com/Kishku7/mod_support

License

All Rights Reserved (c) Kishku7.