> For the complete documentation index, see [llms.txt](https://old.docs.volmit.com/iris/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://old.docs.volmit.com/iris/getting-started.md).

# Getting Started

A quick start to get you generating Iris worlds in no-time!

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>Want to use other plugins?</td><td>Want to use datapacks?</td><td>Check for compatibility!</td><td><a href="/iris/plugin/compatibility.md">Compatibility</a></td><td><a href="https://3612174173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LH1Gn8DuUpLfebICk_2%2Fuploads%2FBfBCBvPFcgd8cGn61Yxn%2Fbusiness-graphics-1236300.jpg?alt=media&amp;token=932a349e-b082-4347-9d5f-a84b082a7819">business-graphics-1236300.jpg</a></td></tr><tr><td>Are commands confusing?</td><td>Want some tips?</td><td>Check the commands!</td><td><a href="/iris/plugin/command-system.md">Command System</a></td><td><a href="https://3612174173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LH1Gn8DuUpLfebICk_2%2Fuploads%2FAZ3w3GtX0UzPErRIeujC%2Fimage.png?alt=media&amp;token=9641d855-dc1e-4680-bff9-7c1ad69605c3">image.png</a></td></tr><tr><td>Found the config.yml?</td><td>Want to know what's what?</td><td>Check the configuration!</td><td><a href="/iris/plugin/configuration.md">Configuration</a></td><td><a href="https://3612174173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LH1Gn8DuUpLfebICk_2%2Fuploads%2FpENJe8UbWsGHZlU1c5QW%2Fgear-4-1566681.jpg?alt=media&amp;token=8f2f886d-56d3-4842-b951-4bcf25c553bb">gear-4-1566681.jpg</a></td></tr></tbody></table>

{% hint style="success" %}
This tutorial was made using [Purpur](https://purpurmc.org/). We strongly recommend using it. [Paper](https://papermc.io/downloads) is also supported. Spigot is supported, but lacks some key features, especially in terms of performance. Please use paper or a fork of paper for all the beautiful features!
{% endhint %}

{% hint style="warning" %}
Generally speaking, **do not update Iris**. More information in the [FAQ](/iris/plugin/faq.md#uninstalling-iris).
{% endhint %}

## Preparation

* Install Iris by putting [the latest jar file](https://www.spigotmc.org/resources/iris-world-gen-the-dimension-engine.84586/) in the `*/plugins` folder.

{% hint style="info" %}
Of course, use the latest Iris version available **for your server version**, unless you already have other Iris worlds you want to keep.
{% endhint %}

* Start the server.
* Wait. Iris will restart the server to install the pack. You may need to manually start it again.

{% hint style="info" %}
[Why does Iris restart the server?](/iris/plugin/faq.md#why-does-iris-ask-me-to-restart-after-downloading-a-pack)
{% endhint %}

* Make sure it all went right, by reading above the Iris logo in the console, and making sure the number of loaded `Custom Biomes` is at least 70. This number can vary, but less is likely a problem.

![](https://3612174173-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LH1Gn8DuUpLfebICk_2%2F-MkI8CZVmqZBBs1ZGlVF%2F-MkIBviM3OxUBDnLhgaf%2Fafbeelding.png?alt=media\&token=71183512-0fcf-42e7-92b5-d687e88469b2)

## Creating new Worlds

Simple! Run `/iris create`

## Replacing your Main World

1. Create a new world with the command above
2. Stop the server
3. Navigate to the folder of your main world (usually just the `world` folder)
4. Move the `datapacks` folder from that folder -> to the folder with the name of the world you created with `/iris create`
5. Next, open your `server.properties` file and search for `level-name=world`
6. Replace `world` with the name of your Iris world (where you just moved the `datapacks` folder to)
7. If you want to keep your current end or nether, you need to rename the `world_nether` and `world_the_end` folders to be `newname_nether` and `newname_the_end` (replacing `newname` with the name of the world you created with `/iris create`). Otherwise, a new nether and end will be generated.
8. Start the server

## Accessing the World

There are multiple options to access and manage worlds.

<table data-view="cards"><thead><tr><th></th><th></th><th data-type="content-ref"></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>MyWorlds (plugin)</td><td><a href="https://www.spigotmc.org/resources/myworlds.39594/">MyWorlds</a> is our suggested world manager plugin. It properly calls Native Minecraft Source functions we need to run our plugin. See also their <a href="https://wiki.traincarts.net/index.php/MyWorlds">documentation</a>.</td><td></td><td><a href="https://www.spigotmc.org/resources/myworlds.39594/">https://www.spigotmc.org/resources/myworlds.39594/</a></td><td><a href="https://3612174173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LH1Gn8DuUpLfebICk_2%2Fuploads%2FekfkFFG3s3hKkjMgfHCD%2F39594.jpg?alt=media&amp;token=816fd76d-1e0c-4adc-b0ac-20c38f715cf3">39594.jpg</a></td></tr><tr><td>EssentialsX</td><td><a href="https://essentialsx.net/downloads.html?branch=stable">EssentialsX</a> is another way of getting to other worlds on your server.</td><td></td><td><a href="https://essentialsx.net/downloads.html?branch=stable">https://essentialsx.net/downloads.html?branch=stable</a></td><td><a href="https://3612174173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LH1Gn8DuUpLfebICk_2%2Fuploads%2FTLAaBYamOVT8RSTQNivA%2Fdownload.png?alt=media&amp;token=cfbd4008-dd32-4154-b1ea-f3acdadf841c">download.png</a></td></tr></tbody></table>

{% hint style="danger" %}
Multiverse is **not** supported. See [Compatibility](/iris/plugin/compatibility.md).
{% endhint %}

## Support

We offer support on our [Discord](https://discord.gg/volmit). You can ask questions there if you run into an error, for example, and want to know how to fix it.\
Thank you for using Iris!

* The Volmit Software Team