CrownSleep

# CrownSleep > A lightweight survival enhancement plugin that rewards players for sleeping — buffs, health recovery, streaks, and more. --- ## Overview 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 — all without changing the vanilla feel of the game. Designed for survival SMP servers. Polished, configurable, and optimized for performance. - **Discord Server:** (https://discord.gg/M48jfjrykS) - **Discord User:** `frostedtheguy` --- ## Compatibility | Platform | Supported | |-------------|-----------| | **Bukkit** | 1.21 – 1.21.x | | **Spigot** | 1.21 – 1.21.x | | **Paper** | 1.21 – 1.21.x | | **Purpur** | 1.21 – 1.21.x | **Java:** 21+ **API:** Compiled against Paper API 1.21.4 (strict superset of Spigot/Bukkit — runs identically on all platforms listed above) --- ## Features ### Core Mechanics - **Health & Hunger Restoration** — Sleeping restores configurable amounts of health, hunger, and saturation on wake. - **Potion Effects on Wake** — Grant players a list of configurable effects (Speed, Regeneration, Saturation, etc.) with customizable durations and amplifiers. - **Sleep Streak System** — Consecutive nights of sleep increase buff duration. Streaks reset if too many real-world hours pass without sleeping. - **Random Rewards** — Configurable chance to receive bonus XP or a special potion effect on waking up. - **Storm Bonus** — Sleeping through a thunderstorm grants an additional configurable effect (e.g. Luck). ### Display & Feedback - **Actionbar messages** on wake — "Well Rested!" with streak counter - **Title + subtitle** display on wake - **Sound effect** played on wake (configurable key, volume, pitch) - **Particle effect** spawned around the player on wake ### System Features - **Per-world enable/disable** — Enable CrownSleep in specific worlds or all worlds with `"*"` - **PlaceholderAPI support** — Expose streak and bonus data to scoreboards, tab lists, and chat - **Reload command** — Live reload of all config and message files without restarting - **Full permissions support** — Separate `use` and `admin` nodes - **Persistent streaks** — Streak data saved to `streaks.yml`, survives restarts --- ## Commands All commands use `/crownsleep` or the alias `/cs`. | Command | Permission | Description | |---------|-----------|-------------| | `/crownsleep help` | `crownsleep.use` | Show the in-game help menu | | `/crownsleep info` | `crownsleep.use` | View plugin version, your streak, and PAPI status | | `/crownsleep reload` | `crownsleep.admin` | Reload `config.yml` and `messages.yml` live | --- ## Permissions | Permission | Default | Description | |-----------|---------|-------------| | `crownsleep.use` | **true** (all players) | Receive sleep rewards and use `/crownsleep help` / `info` | | `crownsleep.admin` | **op** | Access to `/crownsleep reload` and admin features | --- ## PlaceholderAPI Placeholders Requires (https://www.spigotmc.org/resources/placeholderapi.6245/) to be installed. | Placeholder | Returns | |------------|---------| | `%crownsleep_streak%` | Player's current sleep streak (integer) | | `%crownsleep_bonus_seconds%` | Extra buff seconds granted by current streak | | `%crownsleep_max_streak%` | Maximum streak level configured | --- ## Installation 1. Download `CrownSleep-1.0.0.jar` 2. Drop it into your server's `plugins/` folder 3. Restart or reload your server 4. Edit `plugins/CrownSleep/config.yml` to your liking 5. Run `/crownsleep reload` to apply changes live > **First boot** automatically generates `config.yml`, `messages.yml`, and `streaks.yml` inside `plugins/CrownSleep/`. --- ## Configuration Overview `config.yml` is fully commented. Key sections: ```yaml enabled-worlds: - "*" # Use world names to restrict, or "*" for all restoration: enabled: true health: 4.0 # 2.0 = 1 heart hunger: 3 saturation: 2.0 effects: enabled: true list: - type: SPEED amplifier: 0 # 0 = Level I duration: 300 # seconds streak: enabled: true bonus-duration-per-streak: 30 # extra seconds per streak level max-streak: 7 reset-after-hours: 36 random-rewards: enabled: true chance: 0.25 # 25% chance on each wake-up rewards: - type: XP amount: 30 - type: EFFECT effect: LUCK amplifier: 0 duration: 120 storm-bonus: enabled: true effect: LUCK duration: 180 display: actionbar: true title: true sound: true sound-key: ENTITY_PLAYER_LEVELUP particles: true particle-type: VILLAGER_HAPPY ``` --- ## Support & Custom Development Need help, found a bug, or want a custom plugin built? - **Discord Server:** (https://discord.gg/M48jfjrykS) - **Discord User:** `frostedtheguy` Custom p