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: 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 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:

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: discord.gg/M48jfjrykS
• 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.