SinglePlayerSleep - Sleep Plugin

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： bukkit paper purpur spigot

标签： game-mechanics

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

? Permissions

? PlaceholderAPI

Requires PlaceholderAPI installed. Expansion identifier: sps

? Configuration Overview

Config file: plugins/SinglePlayerSleep/config.yml

Sleep Behavior

AFK System

Countdown

Statistics

World Filtering

? 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+