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

# Instances

Instances represent the amount of available dungeons. Each instance has specific configuration you can modify.

## Instance creation

To create a new instance, run the command : 

`/dungeoninstance create <instance_name> <world_name>`

This command will create a new `<instance_name>.yml` file located in the `/plugins/DungeonMMO/instances/` folder.

#### Permission

The permission for instance creation is `dmmo.instance_creation`.

{% hint style="warning" %}
The world containing the dungeon instance must be created before creating an instance. You can do it using any world management plugin like [Multiverse Core](https://www.spigotmc.org/resources/multiverse-core.390/).
{% endhint %}

## Instance configuration

Here are the values you can modify :&#x20;

* **name** : the instance name
* **mob\_rooms** : the amount of mob rooms
* **special\_rooms** : the amount of special rooms
* **world** : the world name to paste the dungeon (<mark style="color:red;">**it's highly recommended to use a dedicated world for dungeon instance**</mark>)
* **time** : the time in minuts player will have to finish the dungeon before it stops
* **lifes** : amount of lifes before respawn is disabled
* **package** : the name of the package to build the dungeon with (can be **default** or a custom package you created, see [Dungeon package creation](/dungeonmmo/dungeon-creation/dungeon-package-creation.md)).
* **key\_required** : if the player need a key to enter the dungeon
* **key\_price** : the price of the key for this dungeon

## Instance loading

After creation, each instance will be loaded after every server restart. This process can take some time.

{% hint style="info" %}
Dungeons are loaded one by one in a queue to avoid server overload
{% endhint %}

{% hint style="warning" %}
It's recommended to use only one instance per server to keep the best gameplay possible, however you can create a maximum of 20 dungeon instances per server.
{% endhint %}

### Starting instance

To start an instance when you are the team owner, use the command `/dungeonlaunch <instance>` or select the instance to run on the [NPC](/dungeonmmo/dungeon-teleporter.md).