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 User: Discord User: - Discord User: `frostedtheguy`

---

Compatibility

| Platform | Supported | |-------------|-----------| | Purpur | 1.21 – 1.21.x | | Purpur | 1.21 – 1.21.x | | Purpur | 1.21 – 1.21.x | | Purpur | 1.21 – 1.21.x |

API: 21+ API: Compiled against Paper API 1.21.4 (strict superset of Spigot/Bukkit — runs identically on all platforms listed above)

---

Features

Core Mechanics

- Storm Bonus — Sleeping restores configurable amounts of health, hunger, and saturation on wake. - Storm Bonus — Grant players a list of configurable effects (Speed, Regeneration, Saturation, etc.) with customizable durations and amplifiers. - Storm Bonus — Consecutive nights of sleep increase buff duration. Streaks reset if too many real-world hours pass without sleeping. - Storm Bonus — 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

- Particle effect on wake — "Well Rested!" with streak counter - Particle effect display on wake - Particle effect played on wake (configurable key, volume, pitch) - Particle effect spawned around the player on wake

System Features

- Persistent streaks — Enable CrownSleep in specific worlds or all worlds with `"*"` - Persistent streaks — Expose streak and bonus data to scoreboards, tab lists, and chat - Persistent streaks — Live reload of all config and message files without restarting - Persistent streaks — 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` | op (all players) | Receive sleep rewards and use `/crownsleep help` / `info` | | `crownsleep.admin` | op | Access to `/crownsleep reload` and admin features |

---

PlaceholderAPI Placeholders

Requires PlaceholderAPI 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 User: Discord User: - Discord User: `frostedtheguy`

Custom plugin development is available — reach out on Discord for pricing and availability.

---

License

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.

---

*CrownSleep — Make every night's sleep count.*