> For the complete documentation index, see [llms.txt](https://nightexpress.gitbook.io/sunlight/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nightexpress.gitbook.io/sunlight/modules/worlds.md).

# 🌍 Worlds

Provides basic multiworld features.

## Commands & Permissions

* [Commands](/sunlight/general/commands.md#worlds-module) link.
* [Permissions](/sunlight/general/permissions.md#worlds-module) link

## Features

* ✅ **GUI Editor**. Edit custom and default worlds with a GUI editor.
* ✅ **Unlimited Worlds**. Create as many worlds as you wish.
* ✅ **Auto-Load**. Automatically load certain world(s) on plugin load.
* ✅ **Auto-Wipe**. Automatically reset custom world(s) with certain interval.
* ✅ **Environment**. Select Environment when creating new worlds.
* ✅ **Difficulty**. Change Difficulty of any world at any time.
* ✅ **Game Rules**. Edit Game Rules of any world at any time in a GUI editor.
* ✅ **Built-in Generators**. Create Void, Plains and Flat worlds.
* ✅ **Inventory Split**. Split player's inventory and ender chest based on world groups.
* ✅ **Command Blocker**. Disable certain command(s) in certain world(s).
* ✅ **Fly Limiter**. Disable flying in certain world(s).

## Configuration

### Editor

Use **/editworld** command to open the **GUI Editor**.

### Inventory Split

To enable the feature, open **settings.yml** of the Worlds module and set `Inventory_Split` -> `Enabled` on `true`.

By default it's configured to split player's inventory and ender chest content for 2 world groups:

* **Survival**. Worlds included: `world`, `world_nether` and `world_the_end`
* **Creative**. Worlds included: `world_creative`

When player goes to the `world_creative` from any world of the **Survival** world group, their inventory will be replaced with the one stored in the **Creative** group.

The same happens when player goes from any world of the **Creative** group to the **Survival** one.

You can create as many groups as want. Just make sure that you **don't** have the same world in multiple groups.

```yaml
Inventory_Split:
  Enabled: true
  Affected_Inventories:
  - PLAYER
  - ENDER_CHEST
  World_Groups:
    survival:
    - world
    - world_nether
    - world_the_end
    creative:
    - world_creative
```

### Command Blocker

To enable the feature, open **settings.yml** of the Worlds module and set `Command_Blocker` -> `Enabled` on `true`.

By default it's configured to block **/feed** and **/heal** commands in the world called `flat`.

You can add as many worlds and commands there as you want.

```yaml
Command_Blocker:
  Enabled: true
  World_Commands:
    flat:
    - feed
    - heal
```

### Auto Wipe

You can enable **Auto-Wipe** feature for any custom world using the GUI Editor: **/editworld**

Just enable the option and set reset interval there.

You can configure world's reset notifications settings in the **settings.yml** of the **Worlds** module.

Also, you might want to configure the destination location for players before the world reset under `MovePlayersOut` section.