This page will cover all advanced options for Objects within biome or region files. To see how to create an object and use it, see Understanding Objects

This tutorial will make use of multiple examples to provide you with the best understanding of how different parameters can be used in different scenarios.

Recap of the Basics

In case you forget everything you learned, here is what was shown previously:

{
    "chance": 1,
    "density": 2,
    "place": [
        "trees/oak/generic1",
        "trees/oak/generic2",
        "trees/oak/generic3",
        "trees/oak/generic4"
    ]
}

• chance - The chance to place this object in this chunk

• density - How many to place per chunk if the chance is successful.

• place - An array of objects to place

Easy enough, right? Lets get started then!

First Example

{
    "place": [
        "structures/ruins-greek-temple"
    ],
    "chance": 0.0005,
    "mode": "VACUUM",
    "carvingSupport": "SURFACE_ONLY"
    "translate": {
        "y": -4
    },
    "rotation": {
        "enabled": true,
        "yAxis": {
            "interval": 90,
            "min": 0,
            "max": 360,
            "enabled": true
        }
    },
    "edit": [
        {
            "find": [
                {
                    "block": "gold_block"
                }
            ],
            "replace": {
                "palette": [
                    {
                        "block": "chest",
                        "weight": 1
                    },
                    {
                        "block": "dirt",
                        "weight": 5
                    }
                ]
            },
            "chance": 1
        }
    ]
}

This example places a buried greek temple underground and replaces the gold blocks in it (placeholder chest locations) with either dirt or a chest to fill with loot.

Mode

"mode" is used to define how the object is placed.

There are more options to combine with mode bellow at Other Placement Options

Carving Support

Where should this object be placed? Supports SURFACE_ONLY, CARVING_ONLY and ANYWHERE, placing on the surface, in caves or anywhere, respectively.

Translate

Translating an object's position changes where it is placed on the terrain. Making this negative (on the Y-axis) will make the object place in to the terrain and making this positive will place it above the terrain.

You can also translate the X and Z if you really want to.

"translate": {
    "x": 0,
    "y": -10,
    "z": 0,
    "yRandom": 12
}

yRandom allows you to randomize the output of the translated Y value. This value is always positive, so in the example above, the Y will range from -10 all the way to +2

Rotation

Rotation allows you to randomly rotate your object when it's placed. We recommend always allowing rotation on the Y axis with intervals of 90 degrees to let it placed in all 4 directions.

"rotation": {
    "enabled": true,
    "yAxis": {
        "interval": 90,
        "min": 0,
        "max": 360,
        "enabled": true
    }
}

Valid axis are xAxis, yAxis and zAxis. Not specifying an axis will disable it by default

• enabled - Whether to enable rotation. It can also be enabled/disabled within an individual axis as shown above

• interval - Within the minimum and maximum range of degrees, what should the angle always be a multiple of. We recommend keeping this to 90.

• min - The minimum angle to rotate

• max - The maximum angle to rotate

Edit / Replace

The edit section allows you to edit an object's blocks and replace them with others. You can even use styles to change which blocks are chosen to replace.

"edit": [
    {
        "find": [
            {
                "block": "gold_block"
            }
        ],
        "replace": {
            "palette": [
                {
                    "block": "chest",
                    "weight": 1
                },
                {
                    "block": "dirt",
                    "weight": 5
                }
            ],
            "style": {
                "style": "STATIC"
            },
            "zoom": 1
        },
        "chance": 1,
        "exact": false
    }
]

"edit": [
    {
        "chance": 0.3,
        "find": [{
            "block": "cobweb",
        }],
        "replace": {
            "palette": [{
                "block": "void_air",
            }]
        }
    },
    {
        "chance": 0.2,
        "find": [{
            "block": "bookshelf",
        }],
        "replace": {
            "palette": [{
                "block": "oak_planks",
            }]
        }
    },
    {
        "chance": 0.85,
        "find": [{
            "block": "chest",
        }],
        "replace": {
            "palette": [{
                "block": "void_air",
            }]
        }
    },
    {
        "chance": 0.3,
        "find": [{
            "block": "stone_bricks",
        }],
        "replace": {
            "palette": [
                {
                    "block": "mossy_stone_bricks",
                },
                {
                    "block": "cracked_stone_bricks",
                }
            ]
        }
    }
]

• find - A Pallete array of blocks to find to replace

• chance - The chance a block in the find will be replaced.

• exact - If this is true, the find pallete must match the block found EXACTLY (so the block data must be the same and not just the material). Defaults to false.

• replace.pallete - The Pallete array of blocks to replace with.

• replace.style - The style to replace with. If not provided, STATIC is used.

• replace.zoom - How zoomed the style should be. Defaults to 1

Loot

We can define what loot to populate this object with when the object is placed. If we don't provide anything, the containers will just be filled from the loot tables provided by the biome/region/dimension

"loot": [
    {
        "name": "global-treasure",
        "exact": false,
        "filter": [
            {
                "block": "chest"
            }
        ],
        "weight": 1
    },
    {
        "name": "global-clutter",
        "filter": [
            {
                "block": "barrel"
            }
        ]
    },
    {
        "name": "trap",
        "filter": [
            {
                "block": "dispenser"
            }
        ]
    }
]

• name - The name of the loot table to use

• exact - Whether to match the filter pallete exactly (match block data as well as material)

• filter - A pallete array of all the blocks to fill. Blocks MUST be a container of some sort (chests, barrels, dispensers, etc)

• weight - The weight of this entry. If more than one entry are put in the array that have the same filter, higher weights will mean that entry will be picked more.

Scale

Scale allows you to resize an object. It can be scaled up and scaled down and the size can even be randomized. The scaling is done on pack load and the objects are cached, so objects are not scaled when cached, but rather, placed from a cached version of the scaled object.

We suggest you play with scaling using the paste command to figure out what you think looks best.

"scale": {
    "interpolation": "TRILINEAR",
    "maximumScale": 2,
    "minimumScale": 2,
    "variations": 1
}

• interpolation - The interpolation method. Should be either TRILINEAR, TRICUBIC, TRIHERMITE or NONE. If the names seem familiar, it's because they are the same interpolation methods a lot of image editing software use but in 3D (2D is Bilinear and Bicubic).

• minimumScale - The minimum size this object will scale to.

• maximumScale - The maximum size an object will scale to.

• variantions - If the scale range is randomized (from the range decided by the min/max), how many size variations should we cache in memory. Set this to 1 if you're planning on having a single size scaled object

Trees / Saplings

The option that allows you to regrow this object with saplings!

{
    "chance": 1,
    "density": 2,
    "trees": [{
        "sizes": [{
            "depth": 1, 
            "width": 1
        }], 
        "treeTypes": ["TREE"],
        "anyTree": false,
        "anySize": false
    }],
    "rotation": {
        "yAxis": {
            "min": 0,
            "max": 360,
            "interval": 90,
            "enabled": true
        },
        "enabled": true
    },
    "place": [
        "trees/oak/antioch3",
        "trees/oak/antioch4",
        "trees/oak/antioch5",
        "trees/oak/antioch6",
        "trees/oak/antioch7",
        "trees/oak/antioch8",
        "trees/oak/antioch9",
        "trees/oak/antioch10",
        "trees/oak/antioch11",
        "trees/oak/antioch12",
        "trees/oak/antioch13"
    ]
},

As states, adding a trees parameter allows you to regrow objects (like tree objects) with saplings.

The sizes parameter dictates the formation of saplings. You can put multiple sizes in here, but generally ,you want to keep both depth and width the same. Setting these both to 1 would mean it can be grown from a 1x1 sapling. Following the same logic, setting them both to 2 would mean a user needs to put the saplings in a 2x2 formation to grow this object/tree.

The anySize parameter will bypass any sizes specified when set to true, and will allow the object to be grown from any size sapling.

The anyType follows a similar style and when set to true, will allow the sapling to be grown from any type of sapling.

Types

treeTypes specifies what type of saplings can be used to grow the tree. Or more accurately, it dictates what kind of tree it should override when that tree is grown from a sapling (of the correct specified size)

There are some types not includes on this list as while they are tree types, they cannot be grown with saplings. These include SWAMP, TALL_BIRCH, TALL_REDWOOD, JUNGLE_BUSH and COCOA_TREE

Other Placement Options

These are other options to do with the object being placed that may come in handy

Bore

"bore": true,
"boreExtendMaxY": 1,
"boreExtendMinY": 1,
"smartBore": true

• bore - Makes the object place air before it is placed

• boreExtendMinY - Extends the range of the bore

• boreExtendMaxY - The same thing but the max the range of the extend bore can be

• smartBore - Will make Iris try find "pockets" that should be air using raytracing

Water

"onwater": true,
"waterloggable": true

• onwater - Whether to place on the top of the water rather than in the water. Useful for boat objects

• waterloggable - Will make any block that can be waterlogged automatically waterlogged if placed in water

Vacuum Interpolation

"vacuumInterpolationMethod": "BILINEAR_STARCAST_3",
"vacuumInterpolationRadius": 10

• vacuumInterpolationMethod - If using vacuum, what method should the terrain use to interpolate to the flat area.

• vacuumInterpolationRadius - The radius of the interpolation

Bottom / Meld / Overstilt

"bottom": true,
"meld": true,
"overStilt": 1

• bottom - Whether to place this object from the bottom up. Shouldn't be used with rotation.

• meld - Will only place the object in places where blocks already exist. This allows you to spawn dungeons with caves carving into them, but is very performance intensive!

• overStilt - If using stilt mode, this will extend the stilt into the ground by the number of blocks specified (1 would be stilt 1 block past the ground level).

Clamp

"clamp": {
    "minimumHeight": 0,
    "maximumHeight": 255
}

clamp allows you to make sure the object only spawns within the minimum and maximum y levels.

These values are the Y level values that the object should be placed on. So if you have the minimum set to 60 and the maximum set to 65, and have an object 10 blocks high, it will still be placed on terrain 60-65 blocks high.

All Dimensional Key Value Parameters (Numerical Values)

These are the Boolean values that are toggle able in the dimension file. The ones below may not have their default values, but are just values set for the purpose of explanations.

    "version": 2,
    "biomeZoom": 0,
    "continentZoom": 0,
    "coordFractureDistance": 0,
    "coordFractureZoom": 0,
    "fluidHeight": 0,
    "dimensionAngleDeg": 0,
    "landChance": 0,
    "landZoom": 0,
    "lootTries": 0,
    "regionZoom": 0,
    "rockZoom": 0,
    "terrainZoom": 0,
    "seaZoom": 0,

Version

The Version of this dimension, Changing this will prevent you from accidentally upgrading your file and corrupting the world. The version of the configuration files in the pack.

Fluid Height

The fluid height for this dimension. The vanilla default is 63, this makes the base water level at 63

Dimensional Angle

You can rotate the input coordinates by an angle. This can make terrain appear more natural (less sharp corners and lines). This literally rotates the entire dimension by an angle. Try 12 degrees or something not on a 90 or 45 degree angle. Default Value is 0.0, Maximum allowed is 360.0, Minimum allowed is 0.0

Land Chance

The land chance. Up to 1.0 for total land or 0.0 for total sea This is the land to ocean percentage. The minimum is 0, and max is 1. Our recommendation is 0.625

Loot Tries

Try to fill a container with loot up to this many times to avoid too many empty chests. Defaulted at 5, the amount of times that a global loot table will be tried to place an item inside of a chest, increasing this will fill a chest with things, reducing it will empty. no lower than zero, no higher than 512* (you can go higher but why)

Coordinate Fracture Distance/Zoom

Coordinate Zoom: Higher = less frequent warping, Lower = more frequent and rapid warping / swirls. Coordinate Fracture Distance: Applies noise to the input coordinates. This creates the 'iris swirls' and wavy features. The distance pushes these waves further into places they shouldn't be. This is a block value multiplier.

Zooming

This zooms in the elements by a multiplier: Imagine using a crumpled ball of paper, then zooming into it. that's what this does.

****

Non-Numerical Dimensional Key Values (yeesh)

    "resourcePack": "",
    "environment": "NORMAL",
    "focus": "",
    "name": "Hello Iris",

Environment

The world Environment. This is fairly straightforward, only 3 possible options NORMAL, NETHER, and THE_END.

Focus mode (Helpful)

Keep this undefined or empty, setting this to a value will force the overworld to only generate that biome. Great for testing, Must be a valid biome. Focus mode allows you to have a specific biome be the only biome that shows up when you are making your biome. This was used in almost every step of developing the Overworld pack, and others. Below you would only see a desert

"focus": "hot-desert",

Name

The human readable name of this dimension Name of Dimension. no real explanation needed

The information below is a variant of the Biome tutorial, and we would recommend that you familiarize yourself with that first. this would then make more sense especially the complexity will become less complex.

Parameters:

• Name - What is the biome called in-game, filename refers only to what internal schema know

• Layer - What blocks makeup the biome floor, and sub-terrain (not including caves)

• Objects - This lists the 'things' that you want to place all over the place eg: trees, rocks, etc...

• Generators - The way the terrain Height-map is designed

• Derivative - This sets the Vanilla Color, Mob spawn, Weather, and some other event

Many of these here will give you a world that 'looks' like a normal world, but Iris is able to give you so much customization that you can have many types of variants that can look otherworldly.

These are some examples of other uses of the defaults:

{
    "rarity": 3,
    "name": "High Sand Cliffs",
    "derivative": "CRIMSON_FOREST",
    "layers": [
        {
            "palette": [
                {
                    "block": "red_sand"
                },
                {
                    "block": "orange_concrete_powder"
                }
            ],
            "maxHeight": 2,
            "minHeight": 1,
            "style": {
                "style": "STATIC",
                "zoom": 0.0135
            }
        }
    ],
    "generators": [
        {
            "generator": "sands-cliffs",
            "min": 112,
            "max": 220
        }
    ]
}

{
    "name": "Nether Wastes",
    "derivative": "NETHER_WASTES",
    "layers": [
        {
            "palette": [
                {
                    "block": "netherrack"
                }
            ],
            "style": {
                "style": "FLAT"
            }
        }
    ],
    "generators": [
        {
            "generator": "hell",
            "min": 141,
            "max": 186
        }
    ]
}

{
    "name": "Swamp Forest",
    "derivative": "SWAMP",
    "rarity": 4,
    "layers": [
        {
            "palette": [
                {
                    "block": "grass_block"
                }
            ]
        },
        {
            "palette": [

                {
                    "block": "dirt"
                }
            ],
            "maxHeight": 3,
            "minHeight": 2
        }
    ],
    "objects": [
        {
            "place": [
                "tree/swamp/1",
                "tree/swamp/2",
                "tree/swamp/3",
                "tree/swamp/4",
                "tree/swamp/5"
            ],
            "translate": {
                "y": 1
            },
            "chance": 1,
            "density": 3
        }
    ],
    "generators": [
        {
            "generator": "vanilla",
            "max": 4,
            "min": -1
        }
    ]
}

Recap:

Much of what you have seen above, IS used in the example projects, when it comes to what a final project biome looks like, they would look like something like this

{
    "biomeSkyScatter": [
        "SNOWY_TAIGA",
        "SNOWY_MOUNTAINS"
    ],
    "objects": [
        {
            "chance": 0.02,
            "density": 3,
            "snow": 0.35,
            "rotation": {
                "yAxis": {
                    "min": 0,
                    "max": 0,
                    "interval": 90,
                    "enabled": true
                },
                "enabled": true
            },
            "place": [
                "ice-spikes/ic-1",
                "ice-spikes/ic-2"
            ],
            "translate": {
                "x": 0,
                "y": 0,
                "z": 0
            }
        },
        {
            "chance": 0.8,
            "snow": 1,
            "rotation": {
                "yAxis": {
                    "min": 0,
                    "max": 0,
                    "interval": 90,
                    "enabled": true
                },
                "enabled": true
            },
            "place": [
                "evergreen/fantasy_evergreen_large1",
                "evergreen/fantasy_evergreen_large1"
            ],
            "translate": {
                "x": 0,
                "y": -2,
                "z": 0
            }
        },
        {
            "chance": 0.05,
            "density": 3,
            "snow": 0.35,
            "rotation": {
                "yAxis": {
                    "min": 0,
                    "max": 0,
                    "interval": 90,
                    "enabled": true
                },
                "enabled": true
            },
            "place": [
                "ice-spikes/ice-spec-1",
                "ice-spikes/ice-spec-2"
            ],
            "translate": {
                "x": 0,
                "y": 0,
                "z": 0
            }
        }
    ],
    "biomeZoom": 30,
    "derivative": "SNOWY_TAIGA_MOUNTAINS",
    "biomeStyle": {
        "style": "IRIS"
    },
    "decorators": [
        {
            "chance": 1,
            "variance": {
                "style": "IRIS",
                "zoom": 0.25
            },
            "palette": [
                {
                    "data": {
                        "layers": 1
                    },
                    "block": "snow"
                },
                {
                    "data": {
                        "layers": 2
                    },
                    "block": "snow"
                },
                {
                    "data": {
                        "layers": 3
                    },
                    "block": "snow"
                },
                {
                    "data": {
                        "layers": 4
                    },
                    "block": "snow"
                }
            ]
        }
    ],
    "children": [
        "frozen-vander"
    ],
    "name": "Frozen Pines",
    "layers": [
        {
            "minHeight": 2,
            "maxHeight": 3,
            "palette": [
                {
                    "block": "snow_block"
                }
            ]
        },
        {
            "minHeight": 2,
            "maxHeight": 4,
            "palette": [
                {
                    "block": "packed_ice"
                }
            ]
        },
        {
            "minHeight": 6,
            "maxHeight": 18,
            "style": {
                "style": "STATIC"
            },
            "palette": [
                {
                    "block": "stone"
                },
                {
                    "block": "andesite"
                },
                {
                    "block": "stone"
                }
            ]
        }
    ],
    "generators": [
        {
            "min": 3,
            "max": 16,
            "generator": "plain"
        },
        {
            "min": 13,
            "max": 48,
            "generator": "mountain"
        }
    ],
    "childShrinkFactor": 20,
    "wall": {
        "style": {
            "style": "STATIC"
        },
        "palette": [
            {
                "block": "stone"
            },
            {
                "block": "andesite"
            },
            {
                "block": "stone"
            }
        ]
    },
    "biomeScatter": [
        "SNOWY_TAIGA_MOUNTAINS",
        "TAIGA_HILLS",
        "MOUNTAINS",
        "ICE_SPIKES"
    ]
}

Post Overview

We highly recommend that you familiarize yourself, and toy around with them before diving straight into the heavy lifting- that is, advanced biome manipulation. Biomes are the some of the most important parts of this plugin. I don't think i need to explain how important that the biomes are, please familiarize yourself with Vs-code and make a custom biome using [this] to do so; once you do that feel free to dive into the harder parts in the next page. Good luck, we hope that you make a world of your dreams.

All Dimensional Boolean Parameters (Boolean Values)

These are the Boolean values that are toggle able in the dimension file. The ones below may not have their default values, but are just values set for the purpose of explanations.

    "carving": false,
    "caves": false,
    "decorate": true,
    "debugSmartBore": false,
    "placeObjects": true,
    "postProcessing": true,
    "postProcessCaves": false,
    "postProcessingSlabs": false,
    "postProcessingWalls": false,
    "preventLeafDecay": false,
    "vanillaCaves": false,
    "vanillaStructures": false,

Carving

Carve Terrain or not Carving is a 3D Noise layer that will just CUT through mountains and terrain, making some neat cliffs in mountain regions. This has a reasonable performance hit, but is on by default- well worth it in out opinion.

Caves

Generate Caves or not. Literally just a true or false as to allow iris generate IRIS caves not to be confused with Vanilla Caves

Decorate

Generate Decorations or not. Literally just a true or false as to allow iris generate predefined decorators in each biome. Example: if you have a biome decorator that says to generate flowers, toggling this in the dimension will toggle it everywhere

Debug Smart Bore

Instead of filling objects with air, fill with cobweb so you can see This is to help show you where iris thinks blocks are, and are not. It places cobwebs in the air blocks to show you where the Structure module thinks it should Cut blocks and stuff out, without overwriting the other surroundings.

Place Objects

Disable this to stop placing objects in biomes This is the 'hand that gives, or the hand that takes away' in regards to objects. It prevents the placement of all iris schematics in biomes.

Post Processing

Use Post Processing or not. Post processing is the unessential, finishing touches that iris does to make the world more pretty, at the cost of a sleight performance hit. It is fine to leave this on. If you turn it off, you may not see the Slabber , Pot-Hole-Filler, Nipple-Remover, Stacker-Fixer working, this is because you just turned them off.

Post Process Caves

Use post processing in caves or not Post processing is the unessential, finishing touches that iris does to make the world more pretty, at the cost of a sleight performance hit. It is fine to leave this on. If you turn it off, you may not see the Slabber , Pot-Hole-Filler, Nipple-Remover, Stacker-Fixer working, this is because you just turned them off. See post processing for an explanation.

Post Processing Slabs/Walls

Add Slabs or walls to the post processor instead. Post processing is the unessential, finishing touches that iris does to make the world more pretty, at the cost of a sleight performance hit. It is fine to leave this on. If you turn it off, you may not see the Slabber , Pot-Hole-Filler, Nipple-Remover, Stacker-Fixer working, this is because you just turned them off. See post processing for an explanation.

Prevent Leaf Decay

Prevent Leaf Decay Whenever iris places a schematic, or anything leaf related- especially with big trees. We use this in iris Overworld Dimension for the trees we place.

Vanilla Caves

Generate Vanilla caves and Cave things Working vanilla caves that can intersect with iris caves. this creates some gnarly looking caves and ravines.

Vanilla Structures

Generate Vanilla Structures Currently not working in the way that you might intend, this for now is default to false because it cause instability, gen failure, and other sorts of issues. We plan to just make out own villages in the future.

Iris in general is very user friendly, you just need to understand the basics. If you don't understand the basics, however, you will be in for a frustrating time in this section, and face lots of problems. We strongly suggest that you toy with the example dimension, region, and biome to familiarize yourself with VSCode, have created and built at least one dimension and know - or have at least read - most of the basics in Understanding.

These pages will feel more like Java Docs (if you know what those are).

  ______                 _   _                _    
 /  ____|               | | | |              | |   
 | |  __  ___   ___   __| | | |    _   _  ___| | __
 | | |_ |/ _ \ / _ \ / _  | | |   | | | |/ __| |/ /
 | |__| | (_) | (_) | (_| | | |___| |_| | (__|   < 
  \_____|\___/ \___/ \____| |______\____|\___|_|\_\

Support

We offer support on our Discord. Ask questions you cannot answer using the Wiki there. We ask you to look on the Wiki for a solution for your issue before going there. Thank you for using Iris!

• The Volmit Software Team

{
"biomeScatter": [],
"biomeSkyScatter": [],
"childStyle": {},
"biomeStyle": {},
"blockDrops": [],
"children": [],
"debugColor": "",
"decorators": [],
"deposits": [],
"effects": [],
"entityInitialSpawns": [],
"entitySpawnOverrides": [],
"fluidType": "",
"generators": [],
"layers": [],
"loot": {},
"objects": [],
"seaLayers": [],
"slab": {},
"structures": [],
"text": [],
"wall": {}
}

Biome Scatter

You can instead specify multiple biome derivatives to randomly scatter colors in this biome FLOOR. This sets the gradients of colors that are done by derivatives, this is great to set the ground colors to look bruised or else-wise.

Biome Sky Scatter

You can instead specify multiple biome derivatives to randomly scatter colors in this biome SKY. Since 1.13 supports 3D biomes, you can add different derivative colors for anything above the terrain. (Think swampy tree leaves with a desert looking grass surface) This is a great way for setting a 3D color dynamic in leaves or in biome-sky related changes.

Child Style

The child (if set) shape if, and when it is generated If this biome has children biomes, and the gen layer chooses one of this biomes children, How will it be shaped? The map represents the biomes/children very well, See Style to see how to use it

Biome Style

Carve Terrain or not This changes the dispersion of the biome colors if multiple derivatives are chosen. Please See Style to see how to use it, this is just a shape filter

Block Drops

Define custom block drops for this biome Drops are the items that are dropped when broken. This is a universal parameter see here to see how to use it.

Children

Have a biome generate in the midst of this biome List any biome names (file names without.json) here as children. Portions of this biome can sometimes morph into their children. Iris supports cyclic relationships such as A > B > A > B. Iris will stop checking 9 biomes down the tree.

Decorators

Decorators are used for things like tall grass, bisected flowers, and even kelp or cactus (random heights) This is the best place where you can set the flowers, and organics that are in a per biome basis.

Deposits

Creates ore & other block deposits underground This ADDS this list of deposits to the dimensional/regional parent. This is explained here, this can be set for multiple parents thus its a dimensional parameter

Effects *

Effects that play in this biome. Effects are ambient effects such as potion effects, random sounds, or even particles around each player. This has a large explanation here.

Entity Initial Spawns

Entity spawns during generation What entity spawns here during the generation of this world. This may soon have support for mythic/other mob providers in the future

Entity Spawn Overrides

If the following entity type spawns, spawn this entity. Set to unknown for any entity spawn. This is a fantastic way to prevent the spawn of a cow or any other vanilla spawned mobs. Maybe Mythic mobs in the future etc...

Generators

Generators are a form of STYLE generators:

Style/Generator is the 4-D (that's one more D than 3D) rules that draw the carve layer. Please refer to the Universal Parameters here to see the usage of generators

Layers

Loot

What Generates in conatiners here in this biome This is a global parameter, and a regional, AND a biome parameter. this is a great breakdown of loot. Beware that by default this stacks with other parent loot rolls unless otherwise specified

Objects

Modes "CENTER_HEIGHT": The default place mode. This mode picks a center point (where the center of the object will be) and takes the height. That height is used for the whole object.

"MAX_HEIGHT": Samples a lot of points where the object will cover (horizontally) and picks the highest height, that height is then used to place the object. This mode is useful for preventing any part of your object from being buried though it will float off of cliffs.

"FAST_MAX_HEIGHT": Samples only 4 points where the object will cover (horizontally) and picks the highest height, that height is then used to place the object. This mode is useful for preventing any part of your object from being buried though it will float off of cliffs.

"MIN_HEIGHT": Samples a lot of points where the object will cover (horizontally) and picks the lowest height, that height is then used to place the object. This mode is useful for preventing any part of your object from overhanging a cliff though it gets buried a lot

"FAST_MIN_HEIGHT": Samples only 4 points where the object will cover (horizontally) and picks the lowest height, that height is then used to place the object. This mode is useful for preventing any part of your object from overhanging a cliff though it gets buried a lot

"STILT": Stilting is MAX_HEIGHT but it repeats the bottom most block of your object until it hits the surface. This is expensive because it has to first sample every height value for each x,z position of your object. Avoid using this unless its structures for performance reasons.

"FAST_STILT": Just like stilting but very inaccurate. Useful for stilting a lot of objects without too much care on accuracy (you can use the over-stilt value to force stilts under ground further)

"PAINT": Samples the height of the terrain at every x,z position of your object and pushes it down to the surface. It's pretty much like a melt function over the terrain.

"VACUUM": Applies multiple terrain features into the parallax layer before this object places to distort the height, essentially vacuuming the terrain's heightmap closer to the bottom of this object. Uses MAX_HEIGHT to place

Sea Layers

Slab

Structures

Text

This is an interesting way to quite literally put text on the surface Please refer to this, for a full explanation of how to use this interesting tool. you can make a trademark per biome if you wanted. the possibilities are strangely endless.

Wall

{
    "postProcessing": false,
    "environment": "NORMAL",
    "regions": [
        "hot",
        "temperate",
        "temperate",
        "cold"
    ],
    "caves": false,
    "focus": "",
    "name": "Example",
    "fluidHeight": 63,
    "carving": false,
    "version": 1
}

Post Processing

Use Post Processing or not. Post processing is the unessential, finishing touches that iris does to make the world more pretty, at the cost of a sleight performance hit. It is fine to leave this on. If you turn it off, you may not see the Slabber , Pot-Hole-Filler, Nipple-Remover, Stacker-Fixer working, this is because you just turned them off. (More on Post Processing here)

Environment

The world Environment. This is fairly straightforward, only 3 possible options NORMAL, NETHER, and THE_END.

Regions (Essential)

Define all regions to include in this dimension. This is essential for any dimension file. The listings in here are required for you to see any kind of impact or biomes generate.

IF YOU WANT ANYTHING TO GENERATE YOU NEED TO HAVE BIOMES IN REGIONS, AND REGIONS IN THE DIMENSION FOLDER!

Caves

Generate Caves or not. Literally just a true or false as to allow iris generate IRIS caves not to be confused with Vanilla Caves

Focus mode (Helpful)

Keep this undefined or empty, setting this to a value will force the overworld to only generate that biome. Great for testing, Must be a valid biome. Focus mode allows you to have a specific biome be the only biome that shows up when you are making your biome. This was used in almost every step of developing the Overworld pack, and others. Below you would only see a desert

"focus": "hot-desert",

Name

The human readable name of this dimension Name of Dimension. no real explanation needed

Carving

Carve Terrain or not Carving is a 3D Noise layer that will just CUT through mountains and terrain, making some neat cliffs in mountain regions. This has a reasonable performance hit, but is on by default- well worth it in out opinion.

Version

The Version of this dimension, Changing this will prevent you from accidentally upgrading your file and corrupting the world. The version of the configuration files in the pack.

Post Overview

We highly recommend that you familiarize yourself, and toy around with them before diving straight into the heavy lifting- that is, dimensional manipulation. (that sounds funny) But in all seriousness the Dimensional file is likely the hardest of the files to learn, as all are relatively self explanatory in most other circumstances.

All Dimensional Array/Set/Objected Parameters

These are the values that list, compile, or involve other objects in the dimension file. The ones below may not have their default values, but are just values set for the purpose of explanations. All of these have a default value so you don't need all of these values, this is merely just to tell you what they do.

// These are the Non-Style Based Object Values
    "blockDrops": [],
    "carveLayers": [],
    "deposits": [],
    "entityInitialSpawns": [],
    "entitySpawnOverrides": [],
    "fluidPalette": {},
    "loot": {},
    "mutations": [],
    "overlayNoise": [],
    "rockPalette": {},
    "sky": {},
    "text": [],

// These are All Style Based Object Values
    "regionStyle": {},
    "caveBiomeStyle": {},
    "continentalStyle": {},
    "islandBiomeChanceStyle": {},
    "islandBiomeStyle": {},
    "lakeBiomeStyle": {},
    "landBiomeStyle": {},
    "riverBiomeStyle": {},
    "seaBiomeStyle": {},
    "shoreBiomeStyle": {},
    "skylandBiomeStyle": {},

Block Drops

Define custom block drops for this dimension Block Drops are the items that are dropped when broken, or are tossed into chests as loot. Drops are a UNIVERSAL PARAMETER, Here is the link for a TOTAL Breakdown of this [Here]

Carve Layers

Define carve layers, If you put this in the file you need to have it defined or remove it. it will cause problems. the carve layers are

Cave Layers

Define cave layers, If you put this in the file you need to have it defined or remove it. it will cause problems.

Deposits

Define biome deposit generators that add onto the existing regional and global deposit generators This is the best way to set ORES that are for the dimension: Overworld, or Nether etc. This can also be set in a REGION or in a BIOME. To see Usage go [Here]

Entity Initial Spawns

Represents an entity spawn during initial chunk generation When an entity is spawned this is run to determine any interaction with that spawn. This is usually a list of objects (entities)

Entity Spawn Overrides

This represents the Event of an event spawn When an entity is spawned this is run to determine any interaction with that spawn. This is usually to either challenge that, or change that

Fluid Palette

The palette of blocks for fluid This is the palette where you set what the fluid is going to be. This is what is generally water in the Overworld, only 1 water-level fluid can be set, you can use sub-water layers using [Fluid] subsets in other parents. To learn about how to use palettes go here. Zoom is the only really specific information that is unique, this only uses the style, and multiplies a zoom scale, default at 1.

Loot

Try to fill a container with loot up to this many times to avoid too many empty chests. Loot tables are unique to each file. The Dimensional files are global loot, Region and Biome loot all have their own files respectively. To learn about loot go here.

Mutations

Define biome mutations for this dimension Mutations are an interesting example of Subdivided Biomes. Whenever a biome is next to another biome, you will get a have a connection between the two, this is a great way to cross-fade trees when you have biomes mixing. You need to make the trees and organics that you want to show up, this is meerly just a region where things will propagate. Below is an example of a mutation file

   "mutations": [
        {
            "checks": 8,
            "objects": [
                {
                    "chance": 0.4,
                    "density": 1,
                    "rotation": {
                        "yAxis": {
                            "min": 0,
                            "max": 0,
                            "interval": 90,
                            "enabled": true
                        },
                        "enabled": true
                    },
                    "place": [
                        "dual-tree/corrupted-swamp-1",
                        "dual-tree/corrupted-swamp-2",
                    ]
                }
            ],
            "radius": 12,
            "sideB": [
                "mushroom-forest",
            ],
            "sideA": [
                "swamp-roofed-forest",
            ]
        }

Overlay Noise

Overlay additional noise on top of the interpolated terrain. For example, if you want to overlay IRIS dtyle generator over a flat terrain of the global dimension you can do that here. See Generator to see how to use generators, and the min and max values just affect the min and max block value changes.

Rock Palette

The palette of blocks for 'stone' Assuming that you are in the ground, what are the stones around you going to look like? but this involves Style, and Palette, with zoom, that zoom just being a multiplier of the zoom in or out as usual.

Sky

Literally the Sky Create an inverted dimension in the sky (like the nether) This is essentially creating an additional terrain layer directly above you. (inverted) if you want to learn how to use this, it had every single possible parameter that Overworld has. LMAO see Dimension Basics for that. you can put everything that you have in the Overworld in here and you will get a mirror of the Overworld

ALL STYLE BASED OBJECTIVE VALUES

All of these have the SAME usage, please refer here, to understand how to use style. This specific area will just tell you what they are for

• Region Style

  • Placement style of regions

• Cave Biome Style

  • Placement style of cave biomes

• Continental Style

  • Placement of land/sea

• Island Biome Chance Style

  • Placement style of biomes (fractal water looks cool)

• Island Biome Style

  • Placement style of island Biomes

• Lake Biome Style

  • Placement style of lake biomes

• Land Biome Style

  • Placement style of land/Overworld biomes

• River Biome Style

  • Placement style of river biomes

• Sea Biome Style

  • Placement style of sea biomes

• Shore Biome Style

  • Placement style of shore biomes

• Skyland Biome Style

  • Placement style of Biomes that are set above the terrain

What's Covered Here:

• Style

• Blocks

• Drops

• Deposits

• Loot

• Palette

• Slope

• Generator

• Objects (too many options!)

• Text

• Rarity

• Regions

Style/Generator Breakdown

    "......Style": {
        "exponent": 1,
        "fracture": {},
        "multiplier": 1,
        "style": "IRIS",
        "zoom": 1
    },

    "caveBiomeStyle": {
        "exponent": 1,
        "fracture": {
            "exponent": 1,
            "fracture": {},
            "multiplier": 0.2,
            "style": "IRIS",
            "zoom": 0.5
        },
        "multiplier": 1,
        "style": "IRIS",
        "zoom": 1
    },

//You can litterally fracture forever for infinite possible solutions... This is a joke page
        "caveBiomeStyle": {
        "exponent": 1,
        "fracture": {
            "exponent": 1,
            "fracture": {
                "exponent": 0
                "fracture": {
                    "exponent": 0
                    "fracture": {
                        "exponent": 0
                        "fracture": {
                            "exponent": 0
                            "fracture": {}
                            "multiplier": 0
                            "style": ""
                            "zoom": 0
                        }
                        "multiplier": 0
                        "style": ""
                        "zoom": 0
                    }
                    "multiplier": 0
                    "style": ""
                    "zoom": 0
                }
                "multiplier": 0
                "style": ""
                "zoom": 0
            },
            "multiplier": 0.2,
            "style": "IRIS",
            "zoom": 0.5
        },
        "multiplier": 1,
        "style": "IRIS",
        "zoom": 1
    },

Style/Generator Explained:

Style/Generator is the 4-D (that's one more D than 3D) rules that draw the carve layer. Static is a commonly used style, with any multiplier, or zoom- it is easy noise. IRIS, is our home-brewed Style that we use in places all over the Overworld

Blocks Breakdown

"blocks": [{
        "backup": {},
        "block": "acacia_button",
        "data": {}
        "debug": false,
        "key": ""
        "weight": 0
    }]

"blocks": [
    {
            //you can have this go infinite
            "backup": {"block": "oak_button"},
            "block": "acacia_button",
            "data": {"watterlogged": true},
            "debug": false,
            "key": "minecraft",
            "weight": 1
    }
 ]

Blocks Explained:

Style is the 4-D (that's one more D than 3D) rules that draw the carve layer. Static is a commonly used style, with any multiplier, or zoom- it is easy noise. IRIS, is our home-brewed Style that we use in places all over the Overworld

Drops Breakdown

"drops": [
        {
            "attributes": [],
            "customModel": "",
            "displayName": "",
            "dyeColor": "BLACK",
            "enchantments": [],
            "itemFlags": [],
            "leatherColor": "",
            "lore": [],
            "maxAmount": 0,
            "maxDurability": 0,
            "minAmount": 0,
            "minDurability": 0,
            "rarity": 0,
            "slotTypes": "",
            "type": "acacia_boat",
            "unbreakable": false
        }
    ]

Drops Explained:

Drops are the items that are dropped when broken, or are tossed into chests as loot. If you were linked here, that means the things here are referenced in whatever module you are looking into

Deposits Breakdown

"deposits": [
    {
        "maxHeight": 0,
        "maxPerChunk": 0,
        "maxSize": 0,
        "minHeight": 0,

        "minPerChunk": 0,
        "minSize": 0,
        "palette": [{}],
        "varience": 0,
    }
],

"deposits": [
    {
        "maxHeight": 0,
        "maxPerChunk": 1,
        "maxSize": 1,
        "minHeight": 0,
        "minPerChunk": 0,
        "minSize": 1,
        "palette": [
            {
                "backup": {"block":"lapis_ore"},
                "block": "gold_ore",
                "data": {},
                "debug": false,
                "key": "",
                "weight": 1
            }
        ],
        "varience": 3
    }
],

Deposits Explained:

Deposits are the ores, or clumps of stuff that is spawned in the ground. like Dirt patches, or Ores. This is a great way to set ores, This also supports custom blocks- Using the palette you can have whatever spawn, from custom blocks to doors can be deposits. This can be set in the Dimension, Region, and Biome.

Palette Breakdown

"palette": [
       {
                "backup": {"block":"lapis_ore"},
                "block": "gold_ore",
                "data": {},
                "debug": false,
                "key": "",
                "weight": 1
       }
  ],

"palette": [
    {
    "backup": {"block":"lapis_ore"},
    "block": "gold_ore",
    "data": {},
    "debug": false,
    "key": "",
    "weight": 1
    }
],

Palette Explained:

The palette is the set of blocks that are included in the parent function's list of parameters. you can have as many as you want as long as everything is properly labeled.

Fluid Breakdown

    "fluid": {
        "fluidHeight": 0,
        "fluidType": {},
        "inverseHeight": false
    },

// lava below 15    
    "fluid": {
        "fluidHeight": 15,
        "fluidType": {"block": "lava"},
        "inverseHeight": false
    },

Fluid Explained:

Fluid layers are a simple way to set a sort of water-layer or anything-layer in the parent. upi can put blocks here, but its built for fluids.

Slope Breakdown

 "Slope": {
   "generator": {},
   "max": 0,
   "min": 0
 }

Slope Explained:

Slope is the generator that determines the direction/form of the parent function.

Loot Breakdown

    "loot": {
        "mode": "",
        "multiplier": 0,
        "tables": []
     },

    "loot": {
        "mode": "ADD",
        "multiplier": 0,
        "tables": [global-tools]
     },

// Example Loot File
{
    "name": "Global Tools",
    "rarity": 1,
    "maxPicked": 1,
    "loot": [
        {
            "type": "WOODEN_PICKAXE",
            "maxAmount": 1,
            "rarity": 5,
            "minDurability": 0.2,
            "maxDurability": 0.8,
            "slotTypes": "STORAGE"
        },
        {
            "type": "FLINT_AND_STEEL",
            "maxAmount": 1,
            "rarity": 5,
            "minDurability": 0.2,
            "maxDurability": 0.8,
            "slotTypes": "STORAGE"
        }
        ,{
            "type": "SHEARS",
            "maxAmount": 1,
            "rarity": 7,
            "minDurability": 0.2,
            "maxDurability": 0.8,
            "slotTypes": "STORAGE"
        },
        {
            "type": "BOW",
            "maxAmount": 1,
            "rarity": 8,
            "minDurability": 0.4,
            "maxDurability": 0.8,
            "slotTypes": "STORAGE"
        }
    ]
}

Loot Explained:

Slope is the generator that determines the direction/form of the parent function.

Objects Breakdown

"objects": [{
                "boarExtendMaxY": 0,
                "boarExtendMinY": 0,
                "bore": false,
                "bottom": false,

                "carvingSupport": "",
                "chance": 0,
                "clamp": {},
                "density": 0,

                "edit": [],
                "meld": false,
                "mode": "",
                "onwater": false,

                "overStilt": 0,
                "place": [],
                "rotation": {},
                "smartBore": false,

                "snow": 0,
                "translate": {},
                "translateCenter": false,
                "underwater": false,

                "warp": {},
                "waterloggable": false,

            }]
        }

    "objects": [
        {
            "chance": 0.03,
            "density": 3,
            "rotation": {
                "yAxis": {
                    "min": 0,
                    "max": 0,
                    "interval": 90,
                    "enabled": true
                },
                "enabled": true
            },
            "place": [
                "wonderland/wonder-1",
                "wonderland/wonder-2",
                "wonderland/wonder-3"
            ],
            "translate": {
                "x": 0,
                "y": -5,
                "z": 0
            }
        },

Objects Explained:

Objects have loads of edits, and things you can do with them. (Psycho caused this) but this is one of the biggest, if not the biggest set of information and toggles that you can do.