MineWorlds

MineWorlds Documentation Complete Configuration & Usage Guide Version 1.0.1​ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Table of Contents · Commands & Permissions · Configuration Guide · World Settings · Time & Cooldown System · Return World Configuration (NEW) · Special Ores Configuration · VIP Features · Multi-Language Setup · Troubleshooting ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1. Commands & Permissions Commands Code (Text): /mine [overworld|nether] Description: Create and enter a mining world Permission: mineworlds.use Aliases: /mineworld, /mw Usage Examples: /mine - Opens GUI to select world type /mine overworld - Direct access to overworld mining /mine nether - Direct access to nether mining /leavemine Description: Exit mining world and return to main world Permission: mineworlds.use Aliases: /leavemining, /exitmine, /minexit Usage: /leavemine /history mine Description: View your mining world history Permission: mineworlds.history Aliases: /hist, /minehistory Usage: /history mine Note: VIP players can click worlds to revisit them Permissions Code (Text): mineworlds.use Default: true Description: Allows players to use /mine command mineworlds.vip Default: op Description: VIP features - Infinite mining time - Reduced cooldowns (5 minutes instead of 25 for nether) - World revisit capability - Up to 5 world history slots mineworlds.admin Default: op Description: Administrator access to all features mineworlds.history Default: true Description: View mining world history mineworlds.history.revisit Default: op Description: Click worlds in history GUI to revisit Note: Requires mineworlds.vip permission mineworlds.cooldown.bypass Default: op Description: Bypass all cooldown restrictions mineworlds.reload Default: op Description: Reload plugin configuration Command: /mineworlds reload ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2. Configuration Guide Basic Settings Code (Text): # Language selection language: "en_US" # Options: en_US, pt_BR, es_ES, it_IT, ru_RU, zh_CN # Debug mode - detailed console logging debug: false ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3. World Settings World Size & Dimensions Code (Text): world: # World size in blocks (radius from center) # Default: 25 (creates a 50x50 area) size: 25 # World height limits (1.17+ extended height) min-height: -64 max-height: 320 # Display name for tablist and plugins display-name: "Miner" World Border Code (Text): border: enabled: true damage: 0.2 # Damage per second outside border warning-distance: 5 # Warning distance before border effects: particles: true # Show particles at border particle-type: "CRIT" # Particle type sound: false # Play sound at border sound-type: "BLOCK_NOTE_BLOCK_BASS" pushback: enabled: true force: 1.5 # Knockback strength particles: enabled: true type: "SMOKE_LARGE" amount: 20 sound: enabled: true type: "ENTITY_VILLAGER_NO" volume: 1.0 pitch: 1.0 # Warning cooldown (seconds) - prevents chat spam warning-cooldown: 300 Biome Settings Code (Text): biomes: random: true # Random biome selection # Blacklisted biomes (never spawn here) blacklist: - "OCEAN" - "DEEP_OCEAN" - "WARM_OCEAN" - "LUKEWARM_OCEAN" - "COLD_OCEAN" - "FROZEN_OCEAN" - "RIVER" - "FROZEN_RIVER" - "MUSHROOM_FIELDS" default: "PLAINS" # Used if random is false Spawn Safety Code (Text): spawn: max-attempts: 50 # Max attempts to find safe spawn avoid-liquids: true # Avoid spawning near water/lava liquid-distance: 5 # Minimum distance from liquids Tree Generation Code (Text): trees: enabled: true trees-per-chunk: 4 # 0-10 trees per chunk spawn-chance: 0.7 # 0.0-1.0 (70% chance) min-height: 8 max-height: 15 # Tree types distribution: # Oak: 40%, Spruce: 30%, Birch: 20%, Dark Oak: 10% ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 4. Time & Cooldown System Time Limits Code (Text): time: default-limit: 900 # 15 minutes in seconds enabled: true # Action bar update rate (20 ticks = 1 second) actionbar-update-interval: 20 # Warning times in seconds warnings: - 300 # 5 minutes remaining - 60 # 1 minute remaining - 30 # 30 seconds remaining - 10 # 10 seconds remaining Overworld Cooldown Code (Text): cooldown: overworld: time: 300 # 5 minutes cooldown show-actionbar: true sound: enabled: true type: "ENTITY_VILLAGER_NO" volume: 1.0 pitch: 1.0 Nether Cooldown Code (Text): nether: enabled: true time-limit: 900 # 15 minutes cooldown: normal: 1500 # 25 minutes for normal players vip: 300 # 5 minutes for VIP players show-actionbar: true sound: enabled: true type: "ENTITY_VILLAGER_NO" volume: 1.0 pitch: 1.0 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 5. Return World Configuration NEW in Version 1.0.1 Configure which world players return to when leaving mining worlds. Perfect for servers with lobby systems, spawn worlds, or hub areas. Configuration Code (Text): teleport: # Set the world where players return when leaving mining worlds # Default: "world" (main overworld) # You can use any world name from your server return-world: "world" # Examples of common configurations: # return-world: "lobby" # Return to lobby world # return-world: "spawn" # Return to spawn world # return-world: "hub" # Return to hub world # return-world: "survival" # Return to survival world How It Works The return world is used when players leave mining worlds through: · /leavemine command · Player death in mining world · Time expiration (when time limit runs out) · Player quit/disconnect Automatic Fallback If the configured world doesn't exist: · Plugin automatically uses the default world (first world loaded) · A warning is logged in the console · Players are still teleported safely · No errors or crashes occur Use Cases Lobby Server: Code (Text): return-world: "lobby" Hub Network: Code (Text): return-world: "hub" Spawn Protection: Code (Text): return-world: "spawn" Multiple Survival Worlds: Code (Text): return-world: "survival_main" ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 6. Special Ores Configur