🌙 Onlysleep

Skip the night with just one player sleeping — or configure it your way.

Supports: Bukkit · Spigot · Paper · Purpur · Folia · Any Paper fork

💖 Sponsored By

✨ Features

• One-Player Sleep — Default mode lets a single player skip the night
• Configurable Percentage — Require any % of players to sleep (50%, 75%, 100%, etc.)
• Per-World Sleep — Configure per-world or global sleep counting
• Multi-Platform — Works on Bukkit, Spigot, Paper, Folia, and all derivatives
• Weather Skip — Automatically clear storms and thunderstorms
• Visual Feedback — Boss bar, action bar, progress bar, and title support
• Sound Effects — Configurable sounds when night is skipped
• Smart Player Filtering — Ignores AFK, spectators, exempt players, and more
• AFK Detection — Supports EssentialsX and CMI AFK status
• PlaceholderAPI Support — Over 10 placeholders for integrations
• Update Checker — Automatically checks for new versions
• bStats Metrics — Anonymous usage statistics
• Disable Per World — Disable sleep skipping in specific worlds

📥 Installation

1. Download the latest Onlysleep-*.jar from Modrinth, Hangar, or Spigot
2. Place it in your server's plugins/ folder
3. Restart your server (or reload with /reload — though restart is recommended)
4. Configure plugins/Onlysleep/config.yml to your liking
5. Reload with /onlysleep reload

Requirements

• Java 21+ (The plugin requires Java 21+ to run)
• Minecraft 1.16.5+ (Bukkit, Spigot, Paper, Folia, or any compatible server)
• No other plugins required! (Works standalone)
• [Optional] PlaceholderAPI for placeholder expansion support

⚙️ Configuration

Quick Start

The plugin works out-of-the-box with sensible defaults. Just drop it in and go!

Main Settings (config.yml)

See the full config.yml for all options.

Messages (messages.yml)

All messages are fully customizable with color codes (&0-&f) and placeholders.

🎮 Commands

Aliases: /os, /sleep

🔐 Permissions

📊 PlaceholderAPI

Onlysleep provides 12+ placeholders when PlaceholderAPI is installed.

🏗️ Building from Source

Gradle (Recommended)

git clone https://github.com/DemonZ-Development/Onlysleep.git
cd Onlysleep
./gradlew clean build

The compiled JAR will be in build/libs/.

Maven (Alternative)

git clone https://github.com/DemonZ-Development/Onlysleep.git
cd Onlysleep
mvn clean package

The compiled JAR will be in target/.

🔌 API

Onlysleep provides a simple API for other plugins:

// Get the plugin instance
Onlysleep plugin = Onlysleep.getInstance();

// Get sleep manager
SleepManager sleepManager = plugin.getSleepManager();

// Check if a player is currently counted as sleeping
boolean sleeping = sleepManager.isPlayerSleeping(player);

// Get how many players are needed in a world
int required = sleepManager.getRequiredSleepingCount(world);

// Get how many are currently sleeping in a world
int sleeping = sleepManager.getSleepingCount(world);

// Check if a night skip is scheduled
boolean skipping = sleepManager.isSkipScheduled(world);

📊 bStats

This plugin uses bStats to collect anonymous usage statistics. No personal data is collected. You can opt-out in plugins/bstats/config.yml.

Live Statistics

🤝 Support & Links

• 🌐 Website
• 💻 GitHub
• 🎮 Modrinth
• 🐦 Twitter / X
• 🎥 YouTube
• 📸 Instagram
• 🔑 Discord
• 📋 Reddit
• 📧 demonzdevelopment@gmail.com

❤️ Credits

Developed by Demonz Development with love for the Minecraft community.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.