━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

About

MineWorlds is a premium Spigot plugin that creates parallel mining dimensions for your players. Each player gets their own personal mining world - eliminating grief, reducing competition, and providing a fresh mining experience every time!

Perfect for:

• Survival servers looking to protect the main world from strip mining
• Servers wanting to give players unlimited mining opportunities
• Communities that value both economy balance and player freedom
• Networks seeking a unique mining experience with special rewards

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

What's New in 1.0.1

• Configurable Return World - Choose which world players return to when leaving mining worlds
• Set any world name in config: lobby, spawn, hub, survival, etc.
• Automatic fallback to default world if configured world doesn't exist
• Smart world detection with console warnings
• Works for all exit scenarios: /leavemine, death, time expiration, quit

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✨ Features

Dual Dimension Mining

• Overworld mining worlds - Classic mining experience with all standard ores
• Nether mining worlds - Ancient debris, nether gold, quartz and more
• Custom world generation with proper biomes and vegetation
• Configurable world size with safe spawn locations
• Beautiful custom trees and terrain generation

Special Ore Blocks

• Diamond Blocks (0.5% spawn rate) - Rare and valuable
• Netherite Blocks (0.3% spawn rate) - Legendary finds
• Emerald Blocks (0.4% spawn rate) - Special rewards
• Gold Blocks (0.8% spawn rate) - Uncommon treasures
• Iron Blocks (1.0% spawn rate) - Common bonuses
• Particle effects and sounds when breaking special ores
• Fully configurable spawn rates and height ranges

⏰ Time Management

• Configurable time limits (default: 15 minutes)
• Action bar timer display
• Warning messages at 5min, 1min, 30sec, and 10sec
• Automatic teleport when time expires
• VIP infinite time support
• Cooldown system to prevent spam

Player Experience

• World border with particles and pushback
• Teleportation freeze effect for safety
• Command blocking during teleportation
• Combat tagging protection
• Death cleanup system
• Easy exit with /leavemine command

VIP Features

• Infinite mining time
• Reduced cooldowns (5 minutes instead of 25 minutes for nether)
• World revisit capability (up to 5 worlds)
• Mining history tracking
• Cooldown bypass permission

️ Protection & Restrictions

• Block specific commands in mining worlds
• Golden shovel protection (GriefPrevention compatibility)
• Portal blocking to prevent dimension escaping
• Chat blocking during teleportation
• World-specific command restrictions

⚙️ Advanced Configuration

• Configurable return world - Set any world as return destination
• Perfect for servers with lobby, hub, or spawn worlds
• Automatic fallback system
• Easy setup in config.yml

Multi-Language Support

• English (en_US)
• Portuguese Brazil (pt_BR)
• Spanish (es_ES)
• Italian (it_IT)
• Russian (ru_RU)
• Chinese Simplified (zh_CN)
• Easy to add more languages via YAML files

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permissions

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ Requirements

• Minecraft: 1.17 - 1.21+
• Server: Spigot, Paper, or any Spigot-based fork
• Java: 8 or higher
• Optional: Vault (for economy integration)
• Optional: Essentials (for compatibility)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Installation

1. Download the latest MineWorlds-1.0.1.jar file
2. Place it in your server's plugins folder
3. Restart your server
4. Configure plugins/MineWorlds/config.yml to your liking
5. NEW: Set teleport.return-world to your preferred world name
6. Set language in config (default: en_US)
7. Use /mine to create your first mining world!

Configuration Example (New in 1.0.1):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Why MineWorlds?

For Players:

• No more searching for untouched caves
• Fresh mining experience every session
• Compete for special ore blocks
• Safe mining without grief
• Personal mining dimension

For Server Owners:

• Keep your main world beautiful
• Control mining inflation with cooldowns
• Reward VIP players with special perks
• Easy configuration and setup
• Performance optimized with async generation
• Extensive customization options

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Support & Updates

Found a bug? Have a suggestion? Need help?

• Post in the discussion thread
• Report issues with detailed information
• Check the documentation for configuration help
• Updates are released regularly

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Changelog

Version 1.0.1 (Current)

• ✨ Added configurable return world setting
• Improved teleportation system with smart world detection
• ️ Added fallback system for missing worlds
• Enhanced console logging for world operations

Version 1.0.0

• Initial release with all core features

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━