| title | Iris |
|---|---|
| description | Iris world generation engine for Paper and Folia |
| published | true |
| date | 2026-08-27 00:00:00 UTC |
| tags | iris |
| editor | markdown |
| dateCreated | 2026-08-09 00:00:00 UTC |
Iris replaces vanilla world generation. You write dimensions, regions, biomes, objects, and jigsaw structures as JSON data packs. Iris assembles them when it generates a chunk.
| Command | /iris (ir, irs) |
| Load | STARTUP — before any world loads |
| Folia | Supported |
| Permissions | iris.all, iris.treefeller |
| Direct Bukkit integrations | WorldEdit, Multiverse-Core, PlaceholderAPI, CraftEngine, Nexo, ItemsAdder, ExecutableItems, MMOItems, EcoItems, MythicMobs, MythicCrucible, KGenerators |
| Ecosystem prerequisites | SCore loads for ExecutableItems, MythicLib for MMOItems, and eco for EcoItems; none is a direct Iris provider |
| Iris-aware Volmit plugins | React consumes Iris metrics; Wormholes uses Iris biome, terrain, and fluid probes for random teleport destinations |
Iris declares
loadbefore: Multiverse-Core. If you run Multiverse, Iris must start first. If Multiverse starts first, it claims Iris worlds with the vanilla generator. Multiverse cannot create, delete, regenerate, or clone Iris worlds — those commands are refused. Read Multiverse before running any of them. {.is-warning}
| Node | Default | Covers |
|---|---|---|
iris.all |
op |
The full /iris tree — worlds, studio, pregen, packs, developer tools |
iris.treefeller |
op |
Lets survival players fell Iris-managed trees with an axe |
iris.all is coarse. There is no per-subcommand node. Anyone who holds it can create,
unload, evacuate, and delete worlds. Grant it to administrators only. Use
iris.treefeller for the one player-facing feature.
- Overview
- Installation & Platforms
- Getting Started
- Configuration
- Commands & Permissions {.links-list}
- Concepts & Pack Layout
- Worlds & Lifecycle
- Pregeneration
- Localization
- PlaceholderAPI
- Studio & VSCode Schemas {.links-list}
- Dimensions
- Regions
- Biomes
- Generators, Noise & Expressions
- Caves & Carving
- Image Map Concepts
- Supported Image Inputs
- Grayscale Heightmaps
- RGB Heightmaps
- Color Maps & Masks
- Image Map Studio Workflow
- Image Map Configuration & Coordinates
- Biome Catalog
- Surfaces, Decorators & Deposits
- Trees, Fungi, Coral, Crystals, Formations, Ruins
- Structures Overview
- Objects
- Object Placement
- Jigsaw Structures
- Native Structures & Datapacks
- Loot, Entities, Spawners, Markers
- Vanilla Passthrough
- Pack Mods & Snippets
- Pack Management {.links-list}
- Example - Minimal Dimension
- Example - Configuring Overworld
- Integrations
- Client HUD & Protocol
- Platform Differences
- Operator Runbooks
- Determinism & Goldenhash
- Performance Tuning
- Multiverse {.links-list}