# MultiWorlds999
## Unleash Infinite Worlds on Your Minecraft Server!
MultiWorlds999 is a powerful and intuitive Minecraft plugin designed to give server administrators unparalleled control over their server's environment. Create, manage, and customize an unlimited number of worlds, each with its own unique settings, player inventories, and seamless portal connections. Whether you're building a complex network of minigames, a diverse role-playing realm, or simply want to offer players a fresh start in a new dimension, MultiWorlds999 provides the tools you need to bring your vision to life.
## Core Features & Systems
### Dynamic World Management
Effortlessly create new worlds of various types (Normal, Nether, End) with custom seeds or let the server generate a random one. Each world can be configured with a rich set of per-world settings, ensuring a tailored experience for every dimension you introduce.
### Seamless Portal System
Design intricate travel networks with our intuitive portal system. Define portal regions using a simple selection tool, then link them to other portals for instant inter-dimensional travel or directly to the spawn point of any world. This system allows for fluid navigation across your server's diverse landscapes.
### Persistent Per-World Inventories
Say goodbye to inventory clutter and cross-world imbalances! MultiWorlds999 ensures that each player maintains a separate, persistent inventory for every world they visit. Their items, armor, and off-hand contents are automatically saved and loaded, providing a truly isolated and immersive experience in each dimension.
### Comprehensive World Settings
Gain granular control over every aspect of your worlds. Configure settings such as PvP status, mob spawning (passive and hostile), difficulty, hunger mechanics, default gamemode, and even custom respawn worlds. These settings are persistently stored in `data.yml` and applied dynamically, giving you the flexibility to craft unique environments.
### Data Persistence
All your meticulously configured worlds, portals, and player inventories are automatically saved to a `data.yml` file. This ensures that your server's unique setup remains intact across restarts, providing a reliable and stable experience for both administrators and players.
## Commands
### /mw create <name> <type> [seed]
This command is your gateway to new dimensions. Use it to generate a brand-new world on your server. Specify a unique `<name>` for your world, choose its `<type>` (options include `normal`, `nether`, or `end`), and optionally provide a `[seed]` for specific terrain generation. If no seed is given, the server will conjure a unique landscape for you.
### /mw portal create <name>
After defining a region with the `/tools` selection pickaxe, use this command to establish a new portal. Assign a distinct `<name>` to your portal. This command sets up the portal's physical presence; its destination is configured separately using the `/mw link` command.
### /mw link <portal1> <portal2_or_worldname>
This versatile command connects your portals. You can link `<portal1>` to another existing portal (`<portal2>`) for two-way travel, or you can link it directly to the spawn point of a specific `<worldname>`. This allows for flexible and dynamic travel routes across your server.
### /mw world list
Get an overview of all the worlds managed by MultiWorlds999. This command displays a comprehensive list of all created worlds, along with their aliases and key settings, giving you a quick glance at your server's multiverse.
### /mw portal list
Review all active portals on your server. This command provides a detailed list of each portal, including its unique name, the world it resides in, its precise coordinates, and information about its linked destination (either another portal or a world).
### /mw world delete <name>
Safely remove a world from your MultiWorlds999 configuration. This command unloads the specified world and removes its settings from the plugin's data. Please note that this command does not delete the actual world files from your server's disk, allowing for potential recovery if needed.
### /mw portal delete <name>
Remove an unwanted portal from your server. This command deletes the specified portal from the plugin's configuration, effectively disabling its functionality.
### /mw setstartworld
Designate the world you are currently in as the server's starting world. New players joining your server for the first time will automatically spawn in this world, providing a consistent entry point for all new adventurers.
### /mw setspawn
Set the default spawn location for the world you are currently in. Your current position will be saved as the new spawn point, ensuring players respawn or teleport to a desired location within that specific world.
### /mw spawn
Instantly teleport to the designated spawn location of the world you are currently in. This is a convenient way to quickly navigate to a world's central hub or starting point.
### /mw teleport <worldname>
Jump directly to the spawn point of any specified world. This command offers a quick and efficient way to travel between your managed worlds.
### /tools
Equip yourself with the essential portal selection tool. This command grants you a wooden pickaxe. Use right-click on a block to mark the first corner of your portal region, and left-click on another block to define the second corner. These two points will outline the area for your new portal.
## Permissions
MultiWorlds999 utilizes a robust permission system, allowing you to precisely control who can access each command and feature. All permissions default to `op` (server operators) for security.
* `multiworlds999.admin`: Grants access to all MultiWorlds999 commands and features. (Default: op)
* `multiworlds999.create`: Allows users to create new worlds using `/mw create`. (Default: op)
* `multiworlds999.portal`: Allows users to create portals using `/mw portal create`. (Default: op)
* `multiworlds999.link`: Allows users to link portals to other portals or worlds using `/mw link`. (Default: op)
* `multiworlds999.world.list`: Allows users to view the list of created worlds using `/mw world list`. (Default: op)
* `multiworlds999.portal.list`: Allows users to view the list of created portals using `/mw portal list`. (Default: op)
* `multiworlds999.world.delete`: Allows users to delete worlds using `/mw world delete`. (Default: op)
* `multiworlds999.portal.delete`: Allows users to delete portals using `/mw portal delete`. (Default: op)
* `multiworlds999.setstartworld`: Allows users to set the server's starting world using `/mw setstartworld`. (Default: op)
* `multiworlds999.setspawn`: Allows users to set the spawn point for a world using `/mw setspawn`. (Default: op)
* `multiworlds999.spawn`: Allows users to teleport to the current world's spawn using `/mw spawn`. (Default: op)
* `multiworlds999.teleport`: Allows users to teleport to other worlds using `/mw teleport`. (Default: op)
* `multiworlds999.tools`: Allows users to obtain the portal selection tool using `/tools`. (Default: op)
