UPDATE V2.3.0 IS HERE!

⚠️ This project is still under development and may contain bugs. Use carefully and report any issues.

I DO NOT INTEND TO MAKE ANY MONEY FROM THIS PROJECT. Contact: mrsuffix@olnk.tr

This plugin has no connection to the SinglePlayerSleep plugin on SpigotMC. It is merely a coincidence in name.

This plugin was created using AI and was developed solely to demonstrate that AI can write advanced code and build a functional system. You are welcome to fork and utilize it as you see fit.

🛌 SinglePlayerSleep Plugin

✨ A modern, lightweight Minecraft plugin to skip the night instantly in single-player worlds or with percentage-based voting — packed with rich features, visual effects, and fully configurable settings.

📥 Download from Modrinth

---

📜 About

SinglePlayerSleep is designed for Minecraft servers that aim to keep the immersive single-player feel, even in multiplayer mode, by allowing the night to be skipped when a single player sleeps or when a certain percentage of players vote to sleep.

Built with performance and flexibility in mind, it features configurable messages, particle & sound effects, automatic saving, AFK detection, PlaceholderAPI integration, sleep statistics, and automatic update checking.

Whether you run a small private SMP or a public server, SinglePlayerSleep seamlessly handles night skipping without requiring everyone online to sleep.

---

⚙️ Features

Core Features

• ✅ Skip the night when just one player sleeps (classic mode)
• ✅ Percentage-based sleep voting system
• ✅ AFK player detection and exclusion from sleep count
• ✅ Automatic GitHub update checker
• ✅ Fully configurable delay before skipping night
• ✅ Cooldown between sleep events to prevent spam
• ✅ Automatic weather clearing on new day
• ✅ PlaceholderAPI integration (%sps_*% placeholders)
• ✅ Sleep statistics tracking (global + per-player, persisted to stats.yml)
• ✅ Countdown before night skip (action bar + chat)
• ✅ Per-world enable/disable (whitelist or blacklist mode)
• ✅ Phantom timer reset on night skip (Paper-aware)

Visual & Performance

• ✅ Particle and sound effects for visual feedback
• ✅ Smart particle optimization based on player count
• ✅ Config cache system for fast performance
• ✅ Real-time sleep progress messages

Server Management

• ✅ Auto-save worlds after night skip
• ✅ Custom messages with color codes and placeholders
• ✅ World-specific activation
• ✅ Debug mode and detailed logging

---

🆕 What's New in v2.2.0

🐛 Critical Bug Fixes

• Fixed getSleepingPlayers() always returning empty set — The method was returning a newly created empty collection instead of the actual sleeping players. Any code relying on this (placeholders, stats) was silently broken.
• Fixed /sleep vote command bypassing cooldown — In percentage mode, players could bypass the sleep cooldown by using the /sleep command instead of entering a bed. Cooldown is now enforced on both paths.
• Fixed particles spawning in wrong world — If a player changed worlds during the countdown, particles would spawn at their current location in the wrong world. Players are now verified to still be in the session's world before effects are applied.
• Fixed CooldownManager missing from SleepCommand constructor — The cooldownManager field was declared but never assigned, causing a NullPointerException on every /sleep command execution.

🔧 High-Priority Fixes

• Implemented PhantomListener — The listener was registered but the event handler body was completely empty, meaning phantom spawns were never actually cancelled. Logic is now correctly implemented.
• Fixed stats not auto-saving — Stats were only written to disk on server shutdown or /sps reload. A crash would cause full stats loss. A periodic auto-save task now runs every 5 minutes.
• Fixed SleepSession thread safety — sleepingPlayers is now backed by a concurrent collection to prevent ConcurrentModificationException during async PlaceholderAPI queries.
• Fixed VoteModule.addVote() race condition — computeIfAbsent() and get() were two separate operations. They are now chained into a single atomic call.
• Fixed CooldownManager thread safety — Changed from HashMap to ConcurrentHashMap to prevent race conditions from async PlaceholderAPI thread access.
• Fixed AFK exclusion message spam — The "AFK players excluded" message was broadcasting on every single sleep attempt per session. It now sends only once per session.
• Migrated action bar from deprecated Bungee Chat API to Adventure API — net.md_5.bungee.api usages replaced with player.sendActionBar() via Adventure API, as recommended for Paper 1.21+.
• Fixed refreshRequirement() using raw player count — Now correctly uses getEffectiveSleepingCount() instead of sleepingPlayers.size() to account for /sleep votes in percentage mode.
• Fixed quit/kick handler missing sleeping players — Players tracked in sleepingPlayers but kicked before sleep animation completed were not being removed. onPlayerLeave() is now called unconditionally.
• Fixed getSession() creating empty sessions — In percentage mode, getSession(world) was called to retrieve the required count, which triggered computeIfAbsent and created an empty session even when no one had entered a bed. Now uses getSessionIfExists().
• Fixed vote world check missing — Votes were being counted without verifying the voter is still in the same world as the sleep session.
• Fixed default GitHub repository name — Update checker default was SinglePlayerSleep instead of SinglePlayerSleepV2, causing update checks to fail on fresh installs.

⚡ Performance & Medium Fixes

• Introduced TimeUtil class — Magic numbers 12541 (sunset) and 23458 (sunrise) were hardcoded across SleepSession.java, SleepManager.java, and PlaceholderHook.java. These are now named constants (SUNSET_TICKS, SUNRISE_TICKS) in a shared TimeUtil class.
• Optimized getEffectiveSleepingCount() — Replaced set-union allocation (creating a new HashSet on every call) with a simple counter loop, reducing GC pressure on busy servers.
• Fixed calculateRequired() called multiple times — Result is now cached in a local variable within checkSleepCondition().
• Unified leaderboard cache updates — topSleepersCache, topContributorsCache, and lastLeaderboardRefresh are now updated atomically via a single LeaderboardSnapshot object to prevent inconsistent reads across threads.
• Fixed empty world session memory leak — Sleep sessions now clean themselves up when a world becomes empty, preventing unbounded session map growth on servers with many temporary worlds.
• Added stats cleanup for old player data — stats.yml no longer grows unbounded. A configurable stats.cleanup-days option (default: 90) purges entries for players who haven't been seen recently.
• Removed redundant null checks — Player.getWorld() is never null in the Bukkit API. Removed misleading defensive checks from VoteModule and SleepListener.
• Removed redundant isPrimaryThread() check in AfkListener — AsyncPlayerChatEvent is always async by Bukkit contract; the check was misleading.
• Removed redundant null check in AfkModule.scheduledCheck() — sleepManager is never null at the call site.
• Fixed VoteModule.getVotes() unnecessary copy — Changed from Set.copyOf() (full allocation) to Collections.unmodifiableSet() (view only).
• Fixed PhantomModule broadcasting when no players were reset — The phantom-reset message now only broadcasts if at least one player's timer was actually reset.

🎨 Code Quality

• Added TimeUtil class with isNight(World) helper method
• Fixed fully qualified class names in SpsCommand.java and SleepManager.java — proper imports added, simple class names used consistently
• Removed unnecessary null checks on Bukkit events — Bukkit never fires null events; defensive checks removed from SleepListener

---

📂 Installation

1. Download the latest release from Releases or Modrinth.
2. Place the .jar file into your server's /plugins folder.
3. Restart or reload your server.
4. Edit plugins/SinglePlayerSleep/config.yml as needed.
5. Use /sps reload to apply configuration changes.

Requirements:

• Minecraft 1.21.1+
• Java 21+
• Paper (recommended) or Spigot

Optional: Install PlaceholderAPI to enable %sps_*% placeholders.

---

🛠️ Commands

Command	Description	Permission
/sleep	Vote to skip the night (percentage mode)	singleplayersleep.sleep
/sps reload	Reload config and reset sessions	singleplayersleep.admin
/sps stats [player]	View global or per-player sleep stats	singleplayersleep.admin
/sps afk	Toggle your AFK status manually	singleplayersleep.admin
/sps version	Show plugin info and update status	singleplayersleep.admin
/sps debug	Toggle debug logging	singleplayersleep.admin

---

🔑 Permissions

Permission	Default	Description
singleplayersleep.sleep	true	Use /sleep
singleplayersleep.admin	op	Use /sps and admin features
singleplayersleep.bypasscooldown	op	Bypass sleep cooldown
singleplayersleep.bypassafk	op	Never marked as AFK
singleplayersleep.stats	true	View statistics (reserved)

---

📊 PlaceholderAPI

Requires PlaceholderAPI installed. Expansion identifier: sps

Placeholder	Description
%sps_sleeping%	Current sleeping players in the viewer's world
%sps_required%	Required sleepers in the viewer's world
%sps_is_night%	true/false — is it currently night
%sps_is_processing%	true/false — is night skip in progress
%sps_cooldown%	Remaining cooldown in seconds
%sps_is_afk%	true/false — is the player AFK
%sps_nights_skipped%	Total nights skipped (global)
%sps_player_times_slept%	Times this player has slept
%sps_mode%	single or percentage
%sps_percentage%	Required percentage

---

🧩 Configuration Overview

Config file: plugins/SinglePlayerSleep/config.yml

Sleep Behavior

Key	Default	Description
sleep.mode	single	single or percentage
sleep.percentage	50	Required % of non-AFK players
sleep.delay-ticks	100	Delay before night skip (20 = 1 second)
sleep.cooldown-seconds	60	Cooldown between sleep sessions
sleep.clear-weather	true	Clear rain/thunder after skip
sleep.auto-save	true	Call world.save() after skip

AFK System

Key	Default	Description
afk.enabled	true	Enable AFK tracking
afk.timeout-seconds	300	Inactivity before AFK
afk.exclude-from-count	true	Exclude AFK players from required count
afk.check-interval-ticks	200	How often AFK checks run

Countdown

Key	Default	Description
countdown.enabled	true	Enable countdown before skip
countdown.duration-seconds	5	Countdown length
countdown.show-actionbar	true	Show countdown in action bar
countdown.show-chat	false	Also post countdown to chat
countdown.sound-on-each-tick	true	Play tick sound each second

Statistics

Key	Default	Description
stats.enabled	true	Enable stats tracking
stats.persist	true	Save stats to stats.yml
stats.track-per-player	true	Track per-player stats
stats.cleanup-days	90	Purge stats for players unseen this many days

World Filtering

Key	Default	Description
worlds.enabled	["world"]	World list
worlds.mode	whitelist	whitelist or blacklist

---

🤝 Contributing

Contributions are welcome!

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Commit your changes: git commit -m "Add my feature"
4. Push: git push origin feature/my-feature
5. Open a Pull Request

# Clone and build
git clone https://github.com/MRsuffixx/SinglePlayerSleep.git
mvn clean package
# Output: target/SinglePlayerSleep-2.2.0.jar

---

📞 Support

• GitHub Issues
• Modrinth Page

When reporting a bug, please include: Minecraft version, plugin version, server software, config.yml, and any error logs.

---

🗺️ Roadmap

• Bossbar progress indicator
• MySQL/SQLite database support for statistics
• Multi-language support
• Discord webhook integration
• Per-world configuration overrides

---

📃 License

Distributed under the MIT License. See LICENSE for details.

---

🏆 Credits

Author: MRsuffix — Current Version: 2.2.0 — Minecraft: 1.21.1+

🧡 Built with love for the Minecraft community.

Current Version: 2.2.0
Last Updated: April 2026
Minecraft Compatibility: 26.1+