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

Download CrownSleep-1.0.0.jar
Drop it into your server's plugins/ folder
Restart or reload your server
Edit plugins/CrownSleep/config.yml to your liking
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.