Modus

Modus (BETA)

Modus lets you configure several world generation features and player settings. All features are OFF by default. If you do not change the config files, the mod does not change the game.

Please view the gallery as it contains several reference images useful for visualization.

Config files are in the config/Modus/ folder. You can edit the config files by hand, or you can use the in-game config screen.

Vanilla Ore Generation

Modus lets you configure the generation of vanilla ores. This includes coal, iron, copper, gold, nether gold, redstone, diamond, lapis, emerald, quartz, and ancient debris.

Each ore has its own config file. Each config file is in the config/Modus/oreOptions/ folder.

For each ore, you can set these values:

• Enabled: turns Modus's generation on or off for this ore. When this is off, vanilla generation stays active.
• Vein Size Min/Max: sets the minimum and maximum size of one ore vein.
• Count Per Chunk: sets how many veins the game tries to place in each chunk.
• Rarity: sets an extra 1-in-N chance for each vein attempt.
• Min Height / Max Height: sets the height range where the ore can generate.

New values apply the next time you load the world. The Enabled switch applies the next time you load the world or restart the game.

Modded Ore Generation

Modus finds ores from other installed mods. Modus finds an ore if the ore uses the standard Minecraft ore feature. Modus cannot find an ore if the mod uses a custom ore feature.

Each found ore gets its own config file. The config files are in the config/Modus/oreOptions/modded/ folder, in a subfolder named after the mod.

Modus does not replace a modded ore's generation. Instead, Modus applies multipliers to the existing generation. For each modded ore, you can set these values:

• Enabled: turns the ore's generation on or off.
• Frequency Multiplier: sets how many veins generate, as a multiple of the mod's normal rate.
• Size Multiplier: sets the size of each vein, as a multiple of the mod's normal size. This multiplier works only for ores that use the standard Minecraft ore feature.

Mob Spawn Caps

Modus lets you set the maximum number of mobs that can spawn in each chunk. This applies to these mob categories: monsters, creatures, ambient mobs, axolotls, underground water creatures, water creatures, and water ambient mobs.

The config file is config/Modus/mobOptions/mobs.toml. A master switch turns this feature on or off.

Modus also finds spawn categories added by other mods, and lets you set a cap for those too. Those categories share the same master switch, and they go in config/Modus/mobOptions/modded.toml.

XP Gain Multiplier

Modus lets you set a multiplier for player experience gain. The multiplier applies to XP from all sources. Sources include mining, mob kills, smelting, fishing, and breeding.

The multiplier range is 0.1x to 10x. The config file is config/Modus/XP/xp.toml. A master switch turns this feature on or off.

This multiplier does not apply to XP loss.

Structure Rarity

Modus finds all structures in the game. This includes vanilla structures and structures from other mods. Each structure gets its own config file.

Vanilla structure files are in the config/Modus/structureOptions/vanilla/ folder. Modded structure files are in the config/Modus/structureOptions/modded/ folder, in a subfolder named after the mod.

For each structure, you can set these values:

• Enabled: turns the structure's generation on or off.
• Rarity: sets a multiplier for how common the structure is. A value of 1.0 is the normal rate. A value below 1.0 makes the structure rarer. A value above 1.0 makes the structure more common.

Structure Block Blacklist

Modus lets you replace specific blocks in structures. This applies to all structures, including vanilla and modded structures.

The config file is config/Modus/structureOptions/blacklist.toml. A master switch turns this feature on or off.

Each entry in the blacklist has two block IDs: the block to remove, and the block to place instead. For example, you can replace every bookshelf with an oak log.

Biome Size

Modus lets you change how big biomes generate. There are two modes, and they are mutually exclusive. You use one mode or the other, never both at once.

The config file config/Modus/biomeSize/biomeSize.toml holds the master switch, the mode, and the global size value.

• Global mode: one Global Size value changes every biome by the same amount. A value of 0 is the normal vanilla size. A positive value makes every biome bigger. A negative value makes every biome smaller. Each step is roughly a 2x change in scale. The range is -4 to 4. This affects modded biomes too, including biomes added through TerraBlender.
• Per-Biome mode: each biome has its own Size Modifier, which sizes it relative to its neighbors. A value of 0 is no change. The range is -4 to 4. Each biome gets its own file. Vanilla biome files are in config/Modus/biomeSize/vanilla/. Modded biome files are in config/Modus/biomeSize/modded/, in a subfolder named after the mod.

New values apply the next time you load the world or restart the server. Already generated chunks keep their existing biome sizes; only newly generated chunks reflect a changed value.

World Size

Modus lets you change how tall the Overworld is. The config file is config/Modus/worldSize/worldSize.toml. A master switch turns this feature on or off.

• World Height: sets the total number of blocks in the Overworld. 384 is the normal value, which gives Y -64 to Y 319. The range is 128 to 2032.

Modus does not change the floor of the world. The floor stays where your world data puts it, which is Y -64 in an unmodified game. So a world generation mod that moves the floor keeps its own floor.

The height must be a multiple of 16. Modus rounds it down if it is not.

A taller world does not only add empty air. Modus also stretches the terrain to fill the new space. The ground, the mountains, and the height each biome generates at all move up together.

The sea level moves up with the ground, so oceans and rivers hold water as normal, and they get deeper as the world gets taller. Beaches, shores, and the height each surface block changes at all move with it. The clouds move up too, so they stay above the ground.

Caves grow with the world as well. Each cave becomes taller, the winding tunnels reach up to the new ground level, and more of them generate, so the larger underground does not feel empty. At a height of 1056 a world holds about twice the cave space of a normal world, and the largest caves are about twice as tall.

This works with the terrain of other mods too. Modus reads whatever terrain data is installed and scales that, so a world generation mod keeps its own style at the new height.

Only the Overworld changes. The Nether and the End keep their normal size.

If you scale the world height, make sure your ores are configured to spawn higher up if you configured ores yourself! Modus does not move your ore height ranges, because those are your own settings. In a taller world, an ore left at a normal height range generates far below the ground.

New values apply the next time you load the world or restart the server. Use this on a new world. An already generated world keeps the size of the chunks it saved. A taller world also takes longer to generate.

In-Game Config Screen

Modus adds a config screen to the game. You can open this screen from the Mods menu.

The config screen has these sections:

• One section for the vanilla ores, grouped under a "Vanilla Ore Options" submenu.
• One section for mob spawn caps. This section also lists every found modded spawn category.
• One section for the XP multiplier.
• One section for biome size.
• One section for world size.
• One section for the structure block blacklist.
• One section for structure rarity. This section lists every found structure.
• One section for modded ore options. This section lists every found modded ore.

The structure rarity, modded ore, and biome size sections fill with data before you load a world. This happens in the background when the game starts.