SleepPlugin

Enhanced sleep mechanics for Minecraft 1.21.x and 26.x. Instead of everyone having to sleep, only a configurable percentage of online players is needed to skip the night. Works on Paper, Purpur, Spigot and compatible servers.

Features

Configurable sleep percentage — default 50% of online players, configurable per world
Weighted sleep votes with LuckyPerms (optional, auto-detected)
Bossbar showing live sleep progress
Phantom prevention (spawn_phantoms game rule)
Storm and night skipping
Smooth time transition from night to morning
Multiple message modes (normal, minimal, silent)
Ignore players in Nether and End dimensions
Smart counting for odd player counts
Multi-world support with per-world overrides
Multi-language support (English, Russian, and custom languages)
Configuration update system that preserves your settings across updates
Admin command /sleep reload|status

Requirements

Minecraft: 1.21.x or 26.x
Server: Paper, Purpur, Spigot (or compatible)
Java: 21+ (1.21.x) / 25+ (26.x)

Installation

Download SleepPlugin-1.0.4.jar
Place it in your server's plugins/ folder
Restart the server

Examples

With default sleep-percentage: 50:

2 players online: 1 player needs to sleep
3 players online: 1 player needs to sleep ((3-1)/2 = 1)
4 players online: 2 players need to sleep
5 players online: 2 players need to sleep ((5-1)/2 = 2)
6 players online: 3 players need to sleep

With sleep-percentage: 25:

4 players online: 1 player needs to sleep
8 players online: 2 players need to sleep
20 players online: 5 players need to sleep

Configuration

The config file is created at plugins/SleepPlugin/config.yml on first start:

# SleepPlugin Configuration
# Do not change this version number manually
version: "1.0.4"

language: en_EN  
skip-delay: 3   
morning-time: 1000  
message-mode: normal 
min-players-required: 2 
ignore-nether-end-players: true 
sleep-percentage: 50 
prevent-phantoms: true 
bossbar:
  enabled: true
  color: YELLOW
  style: SOLID
  title: "Sleeping %s/%s"
smooth-time-transition:
  enabled: true 
  duration-ticks: 60 
  steps: 60 
storm-settings:
  skip-storms: true 
# world-settings:
#   world:
#     sleep-percentage: 50
#     min-players-required: 2

Settings

language: Plugin message language (en_EN or ru_RU, or any custom code)
skip-delay: Seconds before the night is skipped
morning-time: Time value set when skipping to morning
message-mode: Message verbosity (normal, minimal, silent)
min-players-required: Minimum players needed to activate sleep mechanics
ignore-nether-end-players: Exclude Nether/End players from calculations
sleep-percentage: Percentage of online players that must sleep (1-100, default 50). At least 1 player is always required
prevent-phantoms: Disables phantom spawning while the plugin is active
bossbar:
- enabled: Show the sleep progress bossbar
- color: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
- style: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
- title: Bossbar title (%s = sleeping count / required count)
smooth-time-transition: Smooth time change settings (enabled, duration-ticks, steps)
storm-settings: Storm skipping (skip-storms)
world-settings: Per-world overrides. Add a section named after a world to override sleep-percentage and min-players-required for that world only

Command

/sleep status — show percentage and per-world settings (permission: sleepplugin.admin)
/sleep reload — reload config and language files (permission: sleepplugin.admin)

LuckyPerms Integration

SleepPlugin optionally integrates with LuckyPerms as a soft-dependency. Without it, the plugin behaves exactly as before (every player counts as 1). Install LuckyPerms and it is detected automatically.

Weighted sleep votes — set the sleepplugin.weight meta so a player's sleep counts as multiple votes:

/lp group vip meta set sleepplugin.weight 2

A VIP with weight 2 counts as 2 sleeping players, so fewer donors are needed to skip the night. Weight is clamped to 1-100 and supports LuckyPerms contexts (e.g. per world/server):

/lp group vip meta set sleepplugin.weight 2 server=survival

Permissions:

sleepplugin.exempt — player is not counted for sleep calculations (e.g. admins in creative/spectator). Default: false.
sleepplugin.bypass.min-players — sleeping player skips the night even below min-players-required or when alone. Default: false.
sleepplugin.admin — access to /sleep command. Default: op.

Note: sleepplugin.exempt and sleepplugin.bypass.min-players are plain Bukkit permissions — they work with any permissions plugin.

Custom Language Files

You can create your own translations:

Navigate to plugins/SleepPlugin/lang/
Copy template.yml (created on first start) or en_EN.yml/ru_RU.yml
Rename it to your language code (e.g., de_DE.yml, fr_FR.yml, es_ES.yml)
Translate all message strings
Set language: de_DE in config.yml
Restart the server

The plugin automatically detects all custom language files! Use template.yml — it has helpful comments for translators.

sleep plugin