🌙 SleepSkipUltra

A modern Minecraft sleep plugin for Paper and Folia with smooth night skipping, sunrise transitions, bossbar & title UI, day counter, force skip, PlaceholderAPI support, AFK-aware logic, per-world sleep support, anti-abuse controls, and optional sleep rewards.

SleepSkipUltra replaces rough instant night skips with a cleaner multiplayer sleep flow. When enough eligible players go to bed, the night accelerates and transitions into morning instead of jumping forward abruptly.

Supports Paper/Folia 1.20.1 – 26.1.x.
Tested on Paper 1.21.1 / 1.21.11 and Folia 1.20.1 / 1.20.6 / 1.21.11 / 26.1.2.
Paper/Folia 1.21.x requires Java 21. Paper/Folia 26.1.x requires Java 25+.
Built on Adventure APIs — a Paper-based server is required. Pure Spigot is not supported.

---

✨ Features

🌅 Smooth night skip
Night transitions into morning in a more immersive way instead of using a rough instant jump.

🌙 Unified sleep flow
One consistent progression:

• waiting state
• accelerated night
• full skip

📊 Bossbar UI

• sleep progress as a clean top-screen bar
• modes: title, bossbar, or both
• configurable color & style per phase
• per-player toggle via /sleep bossbar

📅 Real day counter

• tracks the actual Minecraft world day
• sunrise title announcements
• %sleepskip_day_count% PlaceholderAPI support
• optional animated morning title and sound

⚡ Force skip commands

• /sleep forceskip
• /sleep forceskip [world]
• /sleep forceskip [world] [--instant]

👥 Flexible sleep requirements

• fixed player count
• percentage of eligible players
• optional weighted sleep via sleepskip.weight.<n>

🛡️ Anti-abuse controls

• minimum eligible players online
• per-world skip cooldown
• world allow list / block list
• bypass permission for excluded players

🎁 Optional sleep rewards

• heal
• feed
• XP
• potion effects
• personal message
• console commands with {player}

🌍 Per-world support
Useful for multi-world SMP and survival servers.

🚶 AFK-aware sleep logic
AFK players can be ignored automatically so they do not block sleep skips.

🌩️ Vanilla-like weather sleep

• night skips clear rain and thunderstorms
• players can sleep during thunderstorms in daytime
• normal daytime rain is not skipped

🎨 Overlay & title UI
Polished title and bossbar feedback for sleep progress and sunrise announcements.

🔌 Integrations

• Essentials
• CMI
• PlaceholderAPI

🌐 Built-in locales (15)

• en, ru, ua, de, es, fr, pl, pt, zh, it, cs, hi, tr, id, fi

🧩 Developer API

• SleepSkipStartEvent
• SleepSkipCompleteEvent
• SleepSkipCancelEvent

---

📊 PlaceholderAPI

• %sleepskip_sleeping%
• %sleepskip_needed%
• %sleepskip_active_players%
• %sleepskip_remaining%
• %sleepskip_percent%
• %sleepskip_state%
• %sleepskip_speed%
• %sleepskip_is_night%
• %sleepskip_world%
• %sleepskip_day_count%

---

🛠️ Commands

Command	Description
/sleep reload	Reload config and locale files
/sleep status	Show current sleep status
/sleep broadcaststatus	Broadcast current sleep status
/sleep forceskip [world] [--instant]	Force a smooth or instant night skip
/sleep bossbar <on|off|toggle|status>	Toggle your own sleep bossbar

---

🔐 Permissions

Permission	Description
sleepskip.admin	Access to admin commands
sleepskip.bypass	Excluded from sleep requirement
sleepskip.bossbar.toggle	Allows a player to toggle their own bossbar
sleepskip.weight.<n>	Counts the player as n sleepers when weighted sleep is enabled

---

🔄 New in 1.10.0

• Added 6 new locales: Italian, Czech, Hindi, Turkish, Indonesian, and Finnish.
• Added optional sleep rewards for players who actually slept.
• Added anti-abuse controls: minimum eligible players, cooldowns, world allow/block lists, and weighted sleep.
• Added developer API events for skip start, completion, and cancellation.
• Added GitHub Releases update checker with admin join notifications.
• Improved Folia compatibility, verified on 1.20.1, 1.20.6, 1.21.11, and 26.1.2.
• Built the plugin jar as Java 17 bytecode so older Folia 1.20.1 remapping can load it correctly.
• Fixed natural skip rewards so they reliably target the players who actually slept.
• Fixed /sleep reload warnings for bundled locale files that already exist.

---

🔄 New in 1.9.0

• Added bossbar UI with title / bossbar / both modes and per-phase color & style.
• Added per-player bossbar toggle — /sleep bossbar <on|off|toggle|status>.
• Added 5 placeholders: remaining, percent, state, speed, is_night.
• Added 6 locales: de, es, fr, pl, pt, zh.
• Cleaned up config and aligned defaults.
• Fixed bossbar freezing at 100% after a skip when day counter is enabled.

---

🔄 New in 1.8.0

• Added real day counter and %sleepskip_day_count%.
• Added sunrise titles, animation, and sound.
• Added /sleep forceskip [world] [--instant].
• Fixed real world day tracking.
• Fixed phantom reset after night skip.
• Fixed title flicker and early disappearance.
• Fixed RU/UA locale issues.
• Improved config and locale updates for existing installs.

---

💬 Contact

• Custom Minecraft plugin development
• Discord: @erotoro32
• Telegram: @Erotoro001