MineWorlds

# **⛏ MineWorlds ⛏** *Parallel Mining Worlds with Special Ores & Time Limits* ##### **Version 1.0.1** - Now with Configurable Return World! **✓ Parallel Mining Worlds** | **✓ Overworld & Nether** | **✓ Special Ore Blocks** **✓ Time Limits & Cooldowns** | **✓ VIP Features** | **✓ Multi-Language** **✓ Configurable Return World** ## **━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━** ### **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** ``` /mine [overworld|nether] - Enter a mining world Aliases: /mineworld, /mw /leavemine - Exit mining world and return to spawn Aliases: /leavemining, /exitmine, /minexit /history mine - View your mining world history Aliases: /hist, /minehistory ``` ## **━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━** ### **Permissions** ``` mineworlds.use - Access /mine command (default: true) mineworlds.vip - VIP features: infinite time, revisit worlds (default: op) mineworlds.admin - Administrator access (default: op) mineworlds.history - View mining history (default: true) mineworlds.history.revisit - Revisit previous worlds (default: op) mineworlds.cooldown.bypass - Bypass cooldowns (default: op) mineworlds.reload - Reload configuration (default: op) ``` ## **━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━** ### **⚙️ 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** * Download the latest MineWorlds-1.0.1.jar file * Place it in your server's plugins folder * Restart your server * Configure plugins/MineWorlds/config.yml to your liking * **NEW:** Set teleport.return-world to your preferred world name * Set language in config (default: en_US) * Use /mine to create your first mining world! **Configuration Example (New in 1.0.1):** ``` teleport: # Set the world where players return when leaving mining worlds # Can be: world, lobby, spawn, hub, survival, or any world name return-world: "world" ``` ## **━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━** ### **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 **⭐ If you enjoy MineWorlds, please leave a review! ⭐** ## **━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━** ### **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 ## **━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━** ##### *MineWorlds - Version 1.0.1 © 2024-2025 MineServer. All rights reserved.*