# CrownSleep<\/p>\n
> A lightweight survival enhancement plugin that rewards players for sleeping \u2014 buffs, health recovery, streaks, and more.<\/p>\n
—<\/p>\n
## Overview<\/p>\n
CrownSleep transforms the Minecraft sleeping mechanic from a simple night-skip into a meaningful survival ritual. Players who rest consistently are rewarded with potion effects, health and hunger restoration, sleep streaks, and optional random bonuses \u2014 all without changing the vanilla feel of the game.<\/p>\n
Designed for survival SMP servers. Polished, configurable, and optimized for performance.<\/p>\n
– **Discord Server:** discord.gg\/M48jfjrykS
\n– **Discord User:** `frostedtheguy`<\/p>\n
—<\/p>\n
## Compatibility<\/p>\n
| Platform | Supported |
\n|————-|———–|
\n| **Bukkit** | 1.21 \u2013 1.21.x |
\n| **Spigot** | 1.21 \u2013 1.21.x |
\n| **Paper** | 1.21 \u2013 1.21.x |
\n| **Purpur** | 1.21 \u2013 1.21.x |<\/p>\n
**Java:** 21+
\n**API:** Compiled against Paper API 1.21.4 (strict superset of Spigot\/Bukkit \u2014 runs identically on all platforms listed above)<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Core Mechanics<\/p>\n
– **Health & Hunger Restoration** \u2014 Sleeping restores configurable amounts of health, hunger, and saturation on wake.
\n– **Potion Effects on Wake** \u2014 Grant players a list of configurable effects (Speed, Regeneration, Saturation, etc.) with customizable durations and amplifiers.
\n– **Sleep Streak System** \u2014 Consecutive nights of sleep increase buff duration. Streaks reset if too many real-world hours pass without sleeping.
\n– **Random Rewards** \u2014 Configurable chance to receive bonus XP or a special potion effect on waking up.
\n– **Storm Bonus** \u2014 Sleeping through a thunderstorm grants an additional configurable effect (e.g. Luck).<\/p>\n
### Display & Feedback<\/p>\n
– **Actionbar messages** on wake \u2014 “Well Rested!” with streak counter
\n– **Title + subtitle** display on wake
\n– **Sound effect** played on wake (configurable key, volume, pitch)
\n– **Particle effect** spawned around the player on wake<\/p>\n
### System Features<\/p>\n
– **Per-world enable\/disable** \u2014 Enable CrownSleep in specific worlds or all worlds with `”*”`
\n– **PlaceholderAPI support** \u2014 Expose streak and bonus data to scoreboards, tab lists, and chat
\n– **Reload command** \u2014 Live reload of all config and message files without restarting
\n– **Full permissions support** \u2014 Separate `use` and `admin` nodes
\n– **Persistent streaks** \u2014 Streak data saved to `streaks.yml`, survives restarts<\/p>\n
—<\/p>\n
## Commands<\/p>\n
All commands use `\/crownsleep` or the alias `\/cs`.<\/p>\n
| Command | Permission | Description |
\n|———|———–|————-|
\n| `\/crownsleep help` | `crownsleep.use` | Show the in-game help menu |
\n| `\/crownsleep info` | `crownsleep.use` | View plugin version, your streak, and PAPI status |
\n| `\/crownsleep reload` | `crownsleep.admin` | Reload `config.yml` and `messages.yml` live |<\/p>\n
—<\/p>\n
## Permissions<\/p>\n
| Permission | Default | Description |
\n|———–|———|————-|
\n| `crownsleep.use` | **true** (all players) | Receive sleep rewards and use `\/crownsleep help` \/ `info` |
\n| `crownsleep.admin` | **op** | Access to `\/crownsleep reload` and admin features |<\/p>\n
—<\/p>\n
## PlaceholderAPI Placeholders<\/p>\n
Requires PlaceholderAPI to be installed.<\/p>\n
| Placeholder | Returns |
\n|————|———|
\n| `%crownsleep_streak%` | Player’s current sleep streak (integer) |
\n| `%crownsleep_bonus_seconds%` | Extra buff seconds granted by current streak |
\n| `%crownsleep_max_streak%` | Maximum streak level configured |<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Download `CrownSleep-1.0.0.jar`
\n2. Drop it into your server’s `plugins\/` folder
\n3. Restart or reload your server
\n4. Edit `plugins\/CrownSleep\/config.yml` to your liking
\n5. Run `\/crownsleep reload` to apply changes live<\/p>\n
> **First boot** automatically generates `config.yml`, `messages.yml`, and `streaks.yml` inside `plugins\/CrownSleep\/`.<\/p>\n
—<\/p>\n
## Configuration Overview<\/p>\n
`config.yml` is fully commented. Key sections:<\/p>\n
“`yaml
\nenabled-worlds:
\n – “*” # Use world names to restrict, or “*” for all<\/p>\n
restoration:
\n enabled: true
\n health: 4.0 # 2.0 = 1 heart
\n hunger: 3
\n saturation: 2.0<\/p>\n
effects:
\n enabled: true
\n list:
\n – type: SPEED
\n amplifier: 0 # 0 = Level I
\n duration: 300 # seconds<\/p>\n
streak:
\n enabled: true
\n bonus-duration-per-streak: 30 # extra seconds per streak level
\n max-streak: 7
\n reset-after-hours: 36<\/p>\n
random-rewards:
\n enabled: true
\n chance: 0.25 # 25% chance on each wake-up
\n rewards:
\n – type: XP
\n amount: 30
\n – type: EFFECT
\n effect: LUCK
\n amplifier: 0
\n duration: 120<\/p>\n
storm-bonus:
\n enabled: true
\n effect: LUCK
\n duration: 180<\/p>\n
display:
\n actionbar: true
\n title: true
\n sound: true
\n sound-key: ENTITY_PLAYER_LEVELUP
\n particles: true
\n particle-type: VILLAGER_HAPPY
\n“`<\/p>\n
—<\/p>\n
## Support & Custom Development<\/p>\n
Need help, found a bug, or want a custom plugin built?<\/p>\n
– **Discord Server:** discord.gg\/M48jfjrykS
\n– **Discord User:** `frostedtheguy`<\/p>\n
Custom plugin development is available \u2014 reach out on Discord for pricing and availability.<\/p>\n
—<\/p>\n
## License<\/p>\n
This project is provided as-is for use on private and public Minecraft servers. Redistribution or resale of unmodified or lightly modified versions is not permitted without permission from the author.<\/p>\n
—<\/p>\n
*CrownSleep \u2014 Make every night’s sleep count.*<\/p>\n","protected":false},"excerpt":{"rendered":"
A plugin that makes minecraft sleeping much more interesting with buffs, etc.<\/p>\n","protected":false},"featured_media":51684,"template":"","meta":{"_minecraft_slug":"crownsleep","_minecraft_project_id":"kyDoLTOi","_minecraft_author":"FrostedGuy","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":2,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"crownsleep.zip","_minecraft_size_bytes":29236,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:17:17.387646Z","_minecraft_date_created":"2026-05-08T01:12:20.754735Z","_minecraft_date_modified":"2026-05-04T05:04:25.906651Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/crownsleep","_minecraft_icon_attachment_id":51684,"_minecraft_imported_at":"2026-06-02T19:53:41+00:00","_minecraft_import_hash":"ba46505421d782e02a66d94b5d5b787a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,89,122,126,127,128,129,123],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-51683","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-game-mechanics","mod_category-magic","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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"],"yoast_head":"\n