BubbleReset

🌍 A comprehensive and feature-rich resource world management plugin for Minecraft 1.19 - 1.21.x

BubbleReset is a complete replacement for traditional resource world plugins, designed from the ground up for modern Spigot/Paper servers. It provides automatic world resets, intuitive GUI menus, PlaceholderAPI integration, and advanced performance optimization.

---

✨ Key Features

🌐 Multi-World Support

- Overworld, Nether, and End resource worlds - Individual configuration for each dimension - Custom seeds and world types (Normal, Flat, Large Biomes, Amplified) - Configurable world borders with damage and warnings - Per-world game rule customization

⚡ Intelligent Reset System

- Post-reset commands with configurable intervals or fixed time-of-day - Post-reset commands - resets pause during server lag - Post-reset commands before resets with customizable announcements - Post-reset commands to minimize server impact - Post-reset commands - teleports players to spawn before reset - Post-reset commands - run Chunky or custom commands after resets

🎨 Interactive GUI Menu

- Customizable layout with player head icons - Customizable layout using HEX color codes - Customizable layout to any resource world - Customizable layout - change items, positions, and textures (supports Base64 head textures) - Simple permission-based access control

🔌 PlaceholderAPI Integration

Display real-time information in scoreboards, holograms, and chat: - `%rw_world%` - Time until overworld reset - `%rw_nether%` - Time until nether reset - `%rw_end%` - Time until end reset - `%rw_world_players%` - Players in resource overworld - `%rw_nether_players%` - Players in resource nether - `%rw_end_players%` - Players in resource end

🚪 Portal Override System

- Configurable per dimension to resource worlds - Configurable per dimension - override nether and/or end portals - Seamlessly integrate resource worlds into normal gameplay

📍 Smart Teleportation

- Potion effects within world borders - Potion effects - avoids lava and finds solid ground - Potion effects and delays - Potion effects (optional economy integration) - Potion effects on teleport for added flair

⚙️ Performance Optimized

- Chunky integration - pauses heavy operations during lag - Chunky integration with automatic retries - Chunky integration prevents overlapping operations - Chunky integration between world resets - Chunky integration during resets - Chunky integration for world pre-generation

🛠️ Admin Tools

- Queue management - Interactive admin panel with GUI - Queue management - reset any world on demand - Queue management without server restart - Queue management of all operations - Queue management - view and control reset queue

---

📋 Commands

| Command | Description | Permission | Aliases | |---------|-------------|------------|---------| | `/resource` | Open resource world menu | `rw.menu` | `/rw`, `/resourceworld` | | `/resource tp [world]` | Teleport to resource world | `rw.tp` | - | | `/resource menu` | Open the GUI menu | `rw.menu` | - | | `/resource reset [world]` | Manually reset a world | `rw.admin` | - | | `/resource reload` | Reload configuration | `rw.admin` | - | | `/rwadmin` | Open admin control panel | `rw.admin` | `/rwa` |

---

🔐 Permissions

- `rw.tp` - Access to teleport to resource worlds (default: op) - `rw.menu` - Access to resource world menu (default: op) - `rw.admin` - Access to admin commands and panel (default: op)

*Note: Legacy permissions (`rw.tp.nether`, `rw.tp.end`) are maintained for backwards compatibility but are no longer required.*

---

⚙️ Configuration Highlights

```yaml

Per-World Settings

world: enabled: true teleport_enabled: true world_name: resource_world world_type: NORMAL # NORMAL, FLAT, LARGE_BIOMES, AMPLIFIED environment: NORMAL # NORMAL, NETHER, THE_END world_border: enabled: true size: 4500 automated_resets: enabled: true interval: 168 # hours

Optional: run resets at a fixed server-local time instead of by interval

Format: HH:mm (example: 02:00)

time_of_day: ""

Performance Tuning

performance: tps-threshold: 18.0 # Minimum TPS to process resets reset-gap-per-world-ticks: 600 # Delay between resets

Teleport Settings

teleport_settings: cooldown: 300 # seconds delay: 3 # seconds effects: enabled: true effect: ABSORPTION ```

---

📦 Installation

1. Download (Optional) 2. Place it in your server's `plugins/` folder 3. (Optional) Install (Optional) for placeholder support 4. Start/restart your server 5. Configure worlds in `plugins/BubbleReset/config.yml` 6. Run `/resource reload` to apply changes

---

🎯 Requirements

- Dependencies: 1.19 - 1.21.x - Dependencies: Spigot, Paper, or any Paper fork - Dependencies: Java 21 or higher - Dependencies: None required (PlaceholderAPI optional)

---

🔧 Compatibility

✅ Vault - Full support ✅ Vault - Full support with enhanced features ✅ Vault - Full support ✅ Vault - Not yet tested ✅ Vault - Optional integration ✅ Vault - Optional pre-generation support ✅ Vault - Optional economy support (planned)

---

💡 Why BubbleReset?

- Clean Code - Built specifically for modern Minecraft versions - Clean Code - Intelligent systems prevent server lag - Clean Code - Customize every aspect to your needs - Clean Code - Intuitive commands and beautiful GUIs - Clean Code - Regular updates and bug fixes - Clean Code - Well-structured for easy customization

---

🐛 Bug Reports & Feature Requests

Found a bug or have a feature request? Please report it on our GitHub Issues page.

---

📄 License

This plugin is licensed under the MIT License. You are free to use, modify, and distribute this plugin.

---

📸 Screenshots

---

Download BubbleReset today and give your players a fresh, renewable resource experience!