SleepSkipUltra

# 🌙 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. (https://img.shields.io/badge/Support%20SleepSkip-Ko--fi-29C7FF?style=for-the-badge&logo=kofi&logoColor=white&labelColor=101826)](https://ko-fi.com/erotoro) --- ## ✨ 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 ` - `/sleep forceskip ` 👥 **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 ` | 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`, `