Getting Started
A quick start to get you generating Iris worlds in no-time!
Video tutorial - Iris 1.8.13
We understand you want to set Iris up quickly, but it is important to take every step carefully to prevent your worlds from breaking.
Iris can create and generate any number of worlds for you. Iris does come with a bit of a manual, but we try to keep it as easy as possible for you here.
This tutorial was made using Purpur. We strongly recommend using it. Paper is also supported, but is slower than Purpur.
Any other server version you may choose to use may be unstable with Iris.
Iris updates are released frequently. Unlike most other plugins, updating Iris may cause more issues than that it resolves.
In general, you should only update the plugin or pack when you are ready to create a new world, and delete old ones.
If you are looking for a specific bug-fix, and the version that fix is on is relatively close to yours (1.8.5 to 1.8.7 for example), ask support if you can safely update. "Is it safe to update from 1.8.5 to 1.8.7? I want to update because of <this> and <that>"


  • Install Iris, by putting the latest jar file in the */plugins folder.
  • Start the server.
  • Wait. Iris will restart the server to install the pack. You may need to manually start it again.
  • 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.
If the number is lower than 70, contact support.
Next you need to either: Create a new world or Overwrite your main world

Create a new world

Make sure to have restarted the server after installation so the plugin is loaded!
  • Create a world by running: /mvc <worldName> normal -g Iris:overworld
Never create a world called Iris or iris
  • Teleport to the world by running: /mvtp <worldName>
  • Done!
Consider Pregeneration to significantly reduce lag on your new world!

Overwrite the main world

  • Stop the server
  • Delete everything from the */world folder except for the datapacks folder
  • Open the */bukkit.yml file
  • Add to the bottom of the file the following lines:
generator: Iris:overworld
Make sure to use generator: Iris:overworld and not just generator: Iris
If you named your main world differently from the default world, you must replace the second line with yourWorldName:
Make sure to have the same indentation as in the example before!
  • Start the server
  • Done!
Consider Pregeneration to significantly reduce lag on your new world!


We offer support on our Discord. 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
Last modified 20d ago