⛲ Brunnen

Bring your server hubs, player towns, and spawn areas to life with Brunnen! This lightweight yet visually stunning plugin allows server administrators to create, edit, and manage dynamic, animated water fountains using real Minecraft entity physics.

Instead of basic, static water blocks or performance-heavy particle spam, this plugin utilizes customized FallingBlock entities to simulate realistic water streams and sprays that will amaze your players.

---

🚀 Key Features

• 🎭 Multiple Fountain Types: Choose between different aesthetic modes. Use RANDOM for a natural, bubbling geyser effect, or SPRAY for a perfectly calculated, uniform circular water ring.
• 📐 Dynamic Sizing: Scale your fountains to perfectly fit your build! Supports SMALL, MEDIUM, and LARGE presets, which automatically scale both the amount of water blocks and the launch velocity/height.
• ⚡ Smart Proximity Optimizer: Performance comes first! The plugin continuously scans for nearby players. If no players are within a 25-block radius of a fountain, the animation automatically pauses to save server CPU cycles and network bandwidth.
• 🔒 Grief & Block-Form Protection: Built-in event listeners completely prevent the falling fountain blocks from ever solidifying or changing the world environment upon landing. Your maps stay exactly as they are.
• 💾 Flat-File Persistence: All created fountains are assigned a unique ID and saved directly inside the config.yml. They reload automatically across server restarts.
• 🛠️ Real-Time Modification: Change the origin location, adjust the size, or switch the fountain type completely on the fly using in-game commands—no file editing required!

---

🛠️ Commands & Permissions

All administrative controls are bundled into a single, easy-to-use master command:

| Command | Description |
|---------|-------------|
| /Brunnen add | Creates a default small, random fountain at your current location. |
| /Brunnen add <size> <type> | Creates a customized fountain (Sizes: small, medium, large | Types: random, spray). |
| /Brunnen set origin <id> | Relocates the specified fountain's base to your current position. |
| /Brunnen set size <id> <size> | Changes the scale of an existing fountain. |
| /Brunnen set type <id> <type> | Switches the animation pattern of an existing fountain. |
| /Brunnen remove <id> | Safely deletes a fountain and re-indexes the remaining IDs. |
| /Brunnen list | Displays a detailed list of all active fountains, their coordinates, world, size, and type. |

🔑 Permissions

• Brunnen.* — Grants full access to create, modify, list, and delete fountains.

---

📦 Configuration Preview

Fountains are tracked seamlessly via the main configuration file:

Brunnen:
  1:
    loc: "world,100.5,64.5,-200.5,0.0,0.0"
    size: "LARGE"
    type: "SPRAY"
  2:
    loc: "lobby,12.5,70.5,15.5,0.0,0.0"
    size: "SMALL"
    type: "RANDOM"