# UPDATE V2.2.0 IS HERE!
\n> ### \u26a0\ufe0f This project is still under development and may contain bugs. Use carefully and report any issues.
\n> **I DO NOT INTEND TO MAKE ANY MONEY FROM THIS PROJECT.** Contact: mrsuffix@olnk.tr
\n>
\n> This plugin has no connection to the SinglePlayerSleep plugin on SpigotMC. It is merely a coincidence in name.
\n>
\n> 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.<\/p>\n
# \ud83d\udecc SinglePlayerSleep Plugin<\/p>\n
\n
\n
\n
\n
\n
\n<\/p>\n
\n
\n<\/p>\n
> \u2728 A modern, lightweight Minecraft plugin to skip the night instantly in single-player worlds or with percentage-based voting \u2014 packed with rich features, visual effects, and fully configurable settings.<\/p>\n
\ud83d\udce5 Download from Modrinth<\/p>\n
—<\/p>\n
## \ud83d\udcdc About<\/p>\n
**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.<\/p>\n
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.<\/p>\n
Whether you run a small private SMP or a public server, SinglePlayerSleep seamlessly handles night skipping without requiring everyone online to sleep.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Features<\/p>\n
### Core Features
\n– \u2705 Skip the night when just **one** player sleeps (classic mode)
\n– \u2705 Percentage-based sleep voting system
\n– \u2705 AFK player detection and exclusion from sleep count
\n– \u2705 Automatic GitHub update checker
\n– \u2705 Fully configurable delay before skipping night
\n– \u2705 Cooldown between sleep events to prevent spam
\n– \u2705 Automatic weather clearing on new day
\n– \u2705 **PlaceholderAPI integration** (`%sps_*%` placeholders)
\n– \u2705 **Sleep statistics tracking** (global + per-player, persisted to `stats.yml`)
\n– \u2705 **Countdown** before night skip (action bar + chat)
\n– \u2705 **Per-world enable\/disable** (whitelist or blacklist mode)
\n– \u2705 **Phantom timer reset** on night skip (Paper-aware)<\/p>\n
### Visual & Performance
\n– \u2705 Particle and sound effects for visual feedback
\n– \u2705 Smart particle optimization based on player count
\n– \u2705 Config cache system for fast performance
\n– \u2705 Real-time sleep progress messages<\/p>\n
### Server Management
\n– \u2705 Auto-save worlds after night skip
\n– \u2705 Custom messages with color codes and placeholders
\n– \u2705 World-specific activation
\n– \u2705 Debug mode and detailed logging<\/p>\n
—<\/p>\n
## \ud83c\udd95 What’s New in v2.2.0<\/p>\n
### \ud83d\udc1b Critical Bug Fixes<\/p>\n
– **Fixed `getSleepingPlayers()` always returning empty set** \u2014 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.
\n– **Fixed `\/sleep` vote command bypassing cooldown** \u2014 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.
\n– **Fixed particles spawning in wrong world** \u2014 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.
\n– **Fixed `CooldownManager` missing from `SleepCommand` constructor** \u2014 The `cooldownManager` field was declared but never assigned, causing a `NullPointerException` on every `\/sleep` command execution.<\/p>\n
### \ud83d\udd27 High-Priority Fixes<\/p>\n
– **Implemented `PhantomListener`** \u2014 The listener was registered but the event handler body was completely empty, meaning phantom spawns were never actually cancelled. Logic is now correctly implemented.
\n– **Fixed stats not auto-saving** \u2014 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.
\n– **Fixed `SleepSession` thread safety** \u2014 `sleepingPlayers` is now backed by a concurrent collection to prevent `ConcurrentModificationException` during async PlaceholderAPI queries.
\n– **Fixed `VoteModule.addVote()` race condition** \u2014 `computeIfAbsent()` and `get()` were two separate operations. They are now chained into a single atomic call.
\n– **Fixed `CooldownManager` thread safety** \u2014 Changed from `HashMap` to `ConcurrentHashMap` to prevent race conditions from async PlaceholderAPI thread access.
\n– **Fixed AFK exclusion message spam** \u2014 The “AFK players excluded” message was broadcasting on every single sleep attempt per session. It now sends only once per session.
\n– **Migrated action bar from deprecated Bungee Chat API to Adventure API** \u2014 `net.md_5.bungee.api` usages replaced with `player.sendActionBar()` via Adventure API, as recommended for Paper 1.21+.
\n– **Fixed `refreshRequirement()` using raw player count** \u2014 Now correctly uses `getEffectiveSleepingCount()` instead of `sleepingPlayers.size()` to account for `\/sleep` votes in percentage mode.
\n– **Fixed quit\/kick handler missing sleeping players** \u2014 Players tracked in `sleepingPlayers` but kicked before sleep animation completed were not being removed. `onPlayerLeave()` is now called unconditionally.
\n– **Fixed `getSession()` creating empty sessions** \u2014 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()`.
\n– **Fixed vote world check missing** \u2014 Votes were being counted without verifying the voter is still in the same world as the sleep session.
\n– **Fixed default GitHub repository name** \u2014 Update checker default was `SinglePlayerSleep` instead of `SinglePlayerSleepV2`, causing update checks to fail on fresh installs.<\/p>\n
### \u26a1 Performance & Medium Fixes<\/p>\n
– **Introduced `TimeUtil` class** \u2014 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.
\n– **Optimized `getEffectiveSleepingCount()`** \u2014 Replaced set-union allocation (creating a new `HashSet` on every call) with a simple counter loop, reducing GC pressure on busy servers.
\n– **Fixed `calculateRequired()` called multiple times** \u2014 Result is now cached in a local variable within `checkSleepCondition()`.
\n– **Unified leaderboard cache updates** \u2014 `topSleepersCache`, `topContributorsCache`, and `lastLeaderboardRefresh` are now updated atomically via a single `LeaderboardSnapshot` object to prevent inconsistent reads across threads.
\n– **Fixed empty world session memory leak** \u2014 Sleep sessions now clean themselves up when a world becomes empty, preventing unbounded session map growth on servers with many temporary worlds.
\n– **Added stats cleanup for old player data** \u2014 `stats.yml` no longer grows unbounded. A configurable `stats.cleanup-days` option (default: 90) purges entries for players who haven’t been seen recently.
\n– **Removed redundant null checks** \u2014 `Player.getWorld()` is never null in the Bukkit API. Removed misleading defensive checks from `VoteModule` and `SleepListener`.
\n– **Removed redundant `isPrimaryThread()` check in `AfkListener`** \u2014 `AsyncPlayerChatEvent` is always async by Bukkit contract; the check was misleading.
\n– **Removed redundant null check in `AfkModule.scheduledCheck()`** \u2014 `sleepManager` is never null at the call site.
\n– **Fixed `VoteModule.getVotes()` unnecessary copy** \u2014 Changed from `Set.copyOf()` (full allocation) to `Collections.unmodifiableSet()` (view only).
\n– **Fixed `PhantomModule` broadcasting when no players were reset** \u2014 The phantom-reset message now only broadcasts if at least one player’s timer was actually reset.<\/p>\n
### \ud83c\udfa8 Code Quality<\/p>\n
– **Added `TimeUtil` class** with `isNight(World)` helper method
\n– **Fixed fully qualified class names** in `SpsCommand.java` and `SleepManager.java` \u2014 proper imports added, simple class names used consistently
\n– **Removed unnecessary null checks on Bukkit events** \u2014 Bukkit never fires null events; defensive checks removed from `SleepListener`<\/p>\n
—<\/p>\n
## \ud83d\udcc2 Installation<\/p>\n
1. Download the latest release from Releases or Modrinth.
\n2. Place the `.jar` file into your server’s `\/plugins` folder.
\n3. Restart or reload your server.
\n4. Edit `plugins\/SinglePlayerSleep\/config.yml` as needed.
\n5. Use `\/sps reload` to apply configuration changes.<\/p>\n
**Requirements:**
\n– Minecraft 1.21.1+
\n– Java 21+
\n– Paper (recommended) or Spigot<\/p>\n
> **Optional:** Install PlaceholderAPI to enable `%sps_*%` placeholders.<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Commands<\/p>\n
| Command | Description | Permission |
\n|—|—|—|
\n| `\/sleep` | Vote to skip the night (percentage mode) | `singleplayersleep.sleep` |
\n| `\/sps reload` | Reload config and reset sessions | `singleplayersleep.admin` |
\n| `\/sps stats [player]` | View global or per-player sleep stats | `singleplayersleep.admin` |
\n| `\/sps afk` | Toggle your AFK status manually | `singleplayersleep.admin` |
\n| `\/sps version` | Show plugin info and update status | `singleplayersleep.admin` |
\n| `\/sps debug` | Toggle debug logging | `singleplayersleep.admin` |<\/p>\n
—<\/p>\n
## \ud83d\udd11 Permissions<\/p>\n
| Permission | Default | Description |
\n|—|—|—|
\n| `singleplayersleep.sleep` | `true` | Use `\/sleep` |
\n| `singleplayersleep.admin` | `op` | Use `\/sps` and admin features |
\n| `singleplayersleep.bypasscooldown` | `op` | Bypass sleep cooldown |
\n| `singleplayersleep.bypassafk` | `op` | Never marked as AFK |
\n| `singleplayersleep.stats` | `true` | View statistics (reserved) |<\/p>\n
—<\/p>\n
## \ud83d\udcca PlaceholderAPI<\/p>\n
> Requires PlaceholderAPI installed. Expansion identifier: `sps`<\/p>\n
| Placeholder | Description |
\n|—|—|
\n| `%sps_sleeping%` | Current sleeping players in the viewer’s world |
\n| `%sps_required%` | Required sleepers in the viewer’s world |
\n| `%sps_is_night%` | `true\/false` \u2014 is it currently night |
\n| `%sps_is_processing%` | `true\/false` \u2014 is night skip in progress |
\n| `%sps_cooldown%` | Remaining cooldown in seconds |
\n| `%sps_is_afk%` | `true\/false` \u2014 is the player AFK |
\n| `%sps_nights_skipped%` | Total nights skipped (global) |
\n| `%sps_player_times_slept%` | Times this player has slept |
\n| `%sps_mode%` | `single` or `percentage` |
\n| `%sps_percentage%` | Required percentage |<\/p>\n
—<\/p>\n
## \ud83e\udde9 Configuration Overview<\/p>\n
Config file: `plugins\/SinglePlayerSleep\/config.yml`<\/p>\n
### Sleep Behavior<\/p>\n
| Key | Default | Description |
\n|—|—|—|
\n| `sleep.mode` | `single` | `single` or `percentage` |
\n| `sleep.percentage` | `50` | Required % of non-AFK players |
\n| `sleep.delay-ticks` | `100` | Delay before night skip (20 = 1 second) |
\n| `sleep.cooldown-seconds` | `60` | Cooldown between sleep sessions |
\n| `sleep.clear-weather` | `true` | Clear rain\/thunder after skip |
\n| `sleep.auto-save` | `true` | Call `world.save()` after skip |<\/p>\n
### AFK System<\/p>\n
| Key | Default | Description |
\n|—|—|—|
\n| `afk.enabled` | `true` | Enable AFK tracking |
\n| `afk.timeout-seconds` | `300` | Inactivity before AFK |
\n| `afk.exclude-from-count` | `true` | Exclude AFK players from required count |
\n| `afk.check-interval-ticks` | `200` | How often AFK checks run |<\/p>\n
### Countdown<\/p>\n
| Key | Default | Description |
\n|—|—|—|
\n| `countdown.enabled` | `true` | Enable countdown before skip |
\n| `countdown.duration-seconds` | `5` | Countdown length |
\n| `countdown.show-actionbar` | `true` | Show countdown in action bar |
\n| `countdown.show-chat` | `false` | Also post countdown to chat |
\n| `countdown.sound-on-each-tick` | `true` | Play tick sound each second |<\/p>\n
### Statistics<\/p>\n
| Key | Default | Description |
\n|—|—|—|
\n| `stats.enabled` | `true` | Enable stats tracking |
\n| `stats.persist` | `true` | Save stats to `stats.yml` |
\n| `stats.track-per-player` | `true` | Track per-player stats |
\n| `stats.cleanup-days` | `90` | Purge stats for players unseen this many days |<\/p>\n
### World Filtering<\/p>\n
| Key | Default | Description |
\n|—|—|—|
\n| `worlds.enabled` | `[“world”]` | World list |
\n| `worlds.mode` | `whitelist` | `whitelist` or `blacklist` |<\/p>\n
—<\/p>\n
## \ud83e\udd1d Contributing<\/p>\n
Contributions are welcome!<\/p>\n
1. Fork the repository
\n2. Create a feature branch: `git checkout -b feature\/my-feature`
\n3. Commit your changes: `git commit -m “Add my feature”`
\n4. Push: `git push origin feature\/my-feature`
\n5. Open a Pull Request<\/p>\n
“`bash
\n# Clone and build
\ngit clone https:\/\/github.com\/MRsuffixx\/SinglePlayerSleep.git
\nmvn clean package
\n# Output: target\/SinglePlayerSleep-2.2.0.jar
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udcde Support<\/p>\n
– GitHub Issues
\n– Modrinth Page<\/p>\n
When reporting a bug, please include: Minecraft version, plugin version, server software, `config.yml`, and any error logs.<\/p>\n
—<\/p>\n
## \ud83d\uddfa\ufe0f Roadmap<\/p>\n
– [ ] Bossbar progress indicator
\n– [ ] MySQL\/SQLite database support for statistics
\n– [ ] Multi-language support
\n– [ ] Discord webhook integration
\n– [ ] Per-world configuration overrides<\/p>\n
—<\/p>\n
## \ud83d\udcc3 License<\/p>\n
Distributed under the MIT License. See [LICENSE](LICENSE) for details.<\/p>\n
—<\/p>\n
## \ud83c\udfc6 Credits<\/p>\n
**Author:** MRsuffix \u2014 **Current Version:** 2.2.0 \u2014 **Minecraft:** 1.21.1+<\/p>\n
> \ud83e\udde1 Built with love for the Minecraft community.<\/p>\n
**Current Version:** 2.2.0
\n**Last Updated:** April 2026
\n**Minecraft Compatibility:** 26.1+<\/p>\n","protected":false},"excerpt":{"rendered":"
A modern Minecraft plugin that lets a single player sleep, skip the night with stylish effects, lightweight performance, and full configurability \u2014 entirely AI-crafted.<\/p>\n","protected":false},"featured_media":141853,"template":"","meta":{"_minecraft_slug":"singleplayersleep","_minecraft_project_id":"piy7OZtR","_minecraft_author":"MRsuffixx","_minecraft_license":"MIT","_minecraft_downloads":9735,"_minecraft_follows":8,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"singleplayersleep.zip","_minecraft_size_bytes":299324,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T02:00:34.976456Z","_minecraft_date_created":"2025-07-26T22:04:43.650509Z","_minecraft_date_modified":"2026-04-09T20:15:23.408751Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/singleplayersleep","_minecraft_icon_attachment_id":141853,"_minecraft_imported_at":"2026-06-08T10:23:52+00:00","_minecraft_import_hash":"cba16036a0abbc48c1bde39790c125cc","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-141852","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n