✅ BubbleReset ⚡- Modern Resource World Plugin

A comprehensive and feature-rich resource world management plugin for Minecraft 1.21.8+
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
- Automated scheduled resets with configurable intervals
- TPS- aware reset queue - resets pause during server lag
- Advance warnings before resets with customizable announcements
- Staggered resets to minimize server impact
- Safe player evacuation - teleports players to spawn before reset
- Post- reset commands - run Chunky or custom commands after resets

# Interactive GUI Menu
- ** Beautiful custom menu** with player head icons
- ** Gradient color titles** using HEX color codes
- ** One- click teleportation** to any resource world
- Customizable layout - change items, positions, and 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
- Redirect vanilla portals to resource worlds
- Configurable per dimension - override nether and/or end portals
- Seamlessly integrate resource worlds into normal gameplay

# Smart Teleportation
- Random safe locations within world borders
- Nether-aware algorithm - avoids lava and finds solid ground
- Configurable cooldowns and delays
- Cost system (optional economy integration)
- Potion effects on teleport for added flair

# ⚙️ Performance Optimized
- TPS monitoring - pauses heavy operations during lag
- Async world deletion with automatic retries
- Queue-based reset system prevents overlapping operations
- Configurable delays between world resets
- View distance reduction during resets
- Chunky integration for world pre-generation

# ️ Admin Tools
- /rwadmin - Interactive admin panel with GUI
- Manual world resets - reset any world on demand
- Config reload without server restart
- Detailed logging of all operations
- Queue management - view and control reset queue


# Permissions
- `rw.tp` - Access to teleport to resource worlds (default: true)
- `rw.menu` - Access to resource world menu (default: true)
- `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.*


# Installation

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

# Requirements

- Minecraft Version: 1.21.8 (compatible with 1.20.x - 1.21.x)
- Server Software: Spigot, Paper, or any Paper fork
- Java Version: Java 21 or higher
- Dependencies: None required (PlaceholderAPI optional)


# Compatibility

✅ Spigot - Full support
✅ Paper - Full support with enhanced features
✅ Purpur - Full support
⚠️ Folia - Not yet tested
✅ PlaceholderAPI - Optional integration
✅ Chunky - Optional pre-generation support
✅ Vault - Optional economy support (planned)

---

# Why BubbleReset?

- Modern Design - Built specifically for modern Minecraft versions
- Performance First - Intelligent systems prevent server lag
- Highly Configurable - Customize every aspect to your needs
- User Friendly - Intuitive commands and beautiful GUIs
- Active Development - Regular updates and bug fixes
- Clean Code - Well-structured for easy customization

Need a Perfect Timed Flight Plugin?, BubbleFeathers ✅


# License

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


# ❤️ Support

Credits: Inspired by the original Resource World plugin. This is a complete rewrite with modern features and optimizations.


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