The /iris command is the main entry point for Iris world management. All subcommands can be accessed via /iris <subcommand> or the aliases /ir and /irs.
World Management
Create a World
Create a new Iris world with a specific dimension pack.
/iris create <name> [dimension] [seed] [main]
name - The name of the world to create (cannot be “iris” or “benchmark”)dimension - The dimension type to use (default: default)seed - The world seed (default: 1337)main - Set as main world on restart (default: false)
Aliases: +, c
Example:
/iris create MyWorld overworld 12345
/iris create TestWorld default 1337 main=true
Remove a World
Remove an Iris world and optionally delete its files.
/iris remove <world> [delete]
world - The world to removedelete - Also delete world folder (default: true)
Aliases: del, rm, delete
Example:
/iris remove MyWorld
/iris remove TestWorld delete=false
Load a World
Load an existing Iris world that isn’t currently loaded.
Aliases: import
Example:
Unload a World
Unload an Iris world without deleting it.
/iris unloadWorld <world>
/iris unloadWorld MyWorld
Evacuate a World
Teleport all players out of a world.
Example:
List Worlds
Show all loaded worlds, separated by Iris and non-Iris worlds.
Aliases: accesslist
World Height
Display the min/max height of your current world.
Example Output:
-64 to 320
Total Height: 384
World Metrics
Get performance metrics for the current Iris world.
Aliases: measure
Teleportation
Teleport to World
Teleport yourself or another player to a world’s spawn.
/iris teleport <world> [player]
tp
Example:
/iris teleport MyWorld
/iris tp OtherWorld PlayerName
Pack Management
Download a Pack
Download dimension packs from the Iris Dimensions repository.
/iris download [pack] [branch] [overwrite]
pack - Pack name (default: overworld)branch - Git branch (default: main)overwrite - Overwrite existing pack (default: false)
Aliases: dl
Example:
/iris download overworld
/iris dl custom-pack main overwrite=true
Update World Pack
This command is UNSAFE and should only be used with backups! It can cause chunk borders and terrain mismatches.
/iris ^world <world> <pack> [confirm] [fresh-download]
world - The world to updatepack - The dimension pack to installconfirm - Confirm you’ve read the warnings (default: false)fresh-download - Download the pack again (default: false)
Aliases: update-world
Example:
/iris ^world MyWorld overworld confirm=true
Utility Commands
Version Info
Display Iris version information.
Studio Shortcut
Quick command to open a studio world for the overworld pack.
Equivalent to /studio open overworld 1337
Reload Config
Reload Iris configuration files.
Debug Mode
Toggle debug logging.
Parameters:
on - Enable/disable debug (toggles if not specified)
Example:
/iris debug on=true
/iris debug
Advanced Commands
Aura Configuration
Configure the visual aura effect.
Parameters:
h - Hue value (default: -20)s - Saturation value (default: 7)b - Brightness value (default: 8)
Bitwise Calculator
Perform bitwise calculations.
/iris bitwise <value1> <operator> <value2>
|, &, ^, >>, <<, %
Example:
/iris bitwise 5 | 3
/iris bitwise 8 << 2
Permission Nodes
iris.command.create
iris.command.remove
iris.command.teleport
iris.command.download
iris.command.worlds
iris.command.version
iris.command.reload
iris.command.metrics