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.

minecraft1.19+ codefactor badge

✨ 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 or fixed time-of-day
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 (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

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

📋 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: 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.

⚙️ Configuration Highlights

# 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

Download bubblereset-1.1.2.jar
Place it in your server's plugins/ folder
(Optional) Install PlaceholderAPI for placeholder support
Start/restart your server
Configure worlds in plugins/BubbleReset/config.yml
Run /resource reload to apply changes

🎯 Requirements

Minecraft Version: 1.19 - 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

🐛 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!