# 🌙 DreamWeaver

_Fall asleep together and drift into a shared, procedurally generated dream dimension._

## ✨ Overview
DreamWeaver transforms sleeping into an adventure. When enough players doze off in beds within the same chunk, they're whisked away to a surreal floating-island dream world spun up just for them. The dreamscape is built from purpur, end stone, amethyst, glowstone, and more — with rare loot chests hidden among the islands. Dreamers wake at sunrise (or when they leave their bed), optionally carrying their finds back to reality. A personal dream journal tracks every nap.

## 📦 Installation
1. Drop the `.jar` into your server's `/plugins` folder.
2. Restart the server (built for Minecraft **1.21**, `api-version: 1.21`).
3. The dream world is created automatically on enable. Tune `config.yml` to taste.

## ⌨️ Commands

| Command | Description | Aliases | Permission |
|---------|-------------|---------|------------|
| `/dream` | Manage your dream state. `/dream status` shows whether you're dreaming and your dream count, `/dream journal` lists recent dream entries, `/dream invite <player>` invites someone to share a dream. | `dw` | — |

## ⚙️ Configuration
- **`dream-world-name`** — name of the generated dream dimension (an End-environment flat world).
- **`min-players-per-chunk`** — how many players must sleep in the same chunk to trigger a dream.
- **`dream-duration-ticks`** — how long a dream lasts before players wake at sunrise.
- **`carry-items-back`** — if `true`, items collected in the dream are kept on waking; if `false`, your inventory is restored to its pre-dream state.
- **`floating-islands`** — number of islands generated per dream area.
- **`rare-loot-chance`** — probability each island spawns a rare loot chest.
- **`bed-check-delay-ticks`** — delay after entering a bed before the shared-sleep check runs.

## 📖 Full documentation
👉 https://spaleforce.com/wiki/dreamweaver

---
🤖 *This plugin was created with **Spaleforce AI**. Create your own Minecraft plugins for free at* 🚀 **https://spaleforce.com**