Dimension & Modpack Configuration

Note: This information is for OTG 1.16.5. For 1.12.2, see here.

The dimension & modpack configuration file is only used by Forge. If you are using PaperMC to run OTG, it is advised you set up your worlds/dimensions using a dimension management plugin such as Multiverse. Instructions for using Multiverse with OTG are here.

When using OTG with other Forge mods, be sure to check the Forge Mod Compatibility section for notes and setup instructions.

Introduction

The dimension configuration file is used to set up an OTG configuration for Forge Multiplayer servers and for modpacks (single and multiplayer). This config file defines which OTG presets are applied to worlds/dimensions, as well as seed and portal settings for OTG dimensions.

- For Forge single player, if a dimension config named "Modpack.yaml" is found in the ".minecraft/config/OpenTerrainGenerator/DimensionConfigs/" folder, the in game world creation menu is replaced by a custom screen that locks settings and uses the world/dimension settings from the Modpack.yaml, allowing users to create a new world with 1 click. This allows modpack makers to set up OTG in a predefined way, and ensures players use these settings every time they start an OTG world.

- For Forge multiplayer servers this file can be used by setting the .yaml's filename (without the .yaml extension, so "Modpack" for modpacks) as generator-settings in the server.properties. When the MP server is started, the settings and dimensions in the .yaml file will be assigned and created automatically.

- For Forge Singleplayer AND Multiplayer in 1.17, 1.18, and 1.19 and beyond GUI doesn't work yet, so modpack.yaml MUST be used.

Creating a Dimension / Modpack Config

To create the config file, go to the ".minecraft/config/OpenTerrainGenerator/DimensionConfigs/" folder and create a new text file with a .yaml file extension. You may also rename one of the examples automatically generated in the folder the first time Minecraft is started with OTG installed.

The structure of this file is as follows:

Overworld:
  (Insert Overworld settings - see below)
Nether:
  (Insert Nether settings - see below)
End:
  (Insert End settings - see below)
Dimensions:
  (Insert Dimensions settings - see below)
Settings:
  (Insert Settings settings - see below)
GameRules:
  (Insert Gamerules settings - see below)

Most lines are optional so you can customize only what you need to. See the table at the bottom of this page for a full list and explanation of all of the options.

Below are some examples of what a completed config file could look like.

Example 1

OTG "Default" overworld with "Vanilla Vistas" OTG dimension:

Overworld:
  PresetFolderName: "Default"
Dimensions:
- PresetFolderName: "VanillaVistas"

Example 2

Vanilla "flat" overworld with "Vanilla Vistas" OTG dimension.

Overworld:
  NonOTGWorldType: "flat"
Dimensions:
- PresetFolderName: "VanillaVistas"

Example 3

Biomes O' Plenty overworld with OTG nether/end/dimensions:

Overworld:
  NonOTGWorldType: "biomesoplenty"
Nether:
  PresetFolderName: "Skylands"
End:
  PresetFolderName: "SkylandsTall"
Dimensions:
- PresetFolderName: "VanillaVistas"

Note: When using Biomes o' Plenty, set use_world_type = false in BoP's client.toml config file, otherwise OTG's custom world creation screen for modpack configs won't work properly.

Example 4

Vanilla "flat" overworld with OTG nether/end and dimensions and all settings included.

Version: 1
ModpackName: "My Awesome Modpack"
Overworld:
  NonOTGWorldType: "flat"
Nether:
  PresetFolderName: "AlienJungle"
End:
  PresetFolderName: "Skylands"
Dimensions:
- PresetFolderName: "Wildlands"
  Seed: 14
  PortalColor: "beige"
  PortalMob: "minecraft:zombified_piglin"
  PortalIgnitionSource: "minecraft:flint_and_steel"
  PortalBlocks: "minecraft:redstone_block"
- PresetFolderName: "VanillaVistas"
  Seed: 14
  PortalColor: "gold"
  PortalMob: "minecraft:zombified_piglin"
  PortalIgnitionSource: "minecraft:flint_and_steel"
  PortalBlocks: "minecraft:diamond_block"  
Settings:
  GenerateStructures: true
  BonusChest: false
GameRules:
  DoFireTick: true
  MobGriefing: true
  KeepInventory: false
  DoMobSpawning: true
  DoMobLoot: true
  DoTileDrops: true
  DoEntityDrops: true
  CommandBlockOutput: true
  NaturalRegeneration: true
  DoDaylightCycle: true
  LogAdminCommands: true
  ShowDeathMessages: true
  RandomTickSpeed: 3
  SendCommandFeedback: true
  SpectatorsGenerateChunks: true
  SpawnRadius: 10
  DisableElytraMovementCheck: false
  MaxEntityCramming: 24
  DoWeatherCycle: true
  DoLimitedCrafting: false
  MaxCommandChainLength: 65536
  AnnounceAdvancements: true
  DisableRaids: false
  DoInsomnia: true
  DrowningDamage: true
  FallDamage: true
  FireDamage: true
  DoPatrolSpawning: true
  DoTraderSpawning: true
  ForgiveDeadPlayers: true
  UniversalAnger: false

Gehenna

A newer preset called Gehenna is currently available for Alpha on the OTG Discord. Gehenna modifies the nether instead of the overworld. If you wish to use Gehenna on Forge multiplayer, you will need to use modpack.yaml. The following modpack.yaml has a vanilla overworld and a Gehenna nether:

Overworld:
  NonOTGWorldType: "normal"
Nether:
  PresetFolderName: "Gehenna"

Full List Of Config Options

Parameter	Optional	Type	Description
Version	N/A	Integer	Version number of the modpack config. (Ignored at the moment - not yet implemented for 1.16.5)
ModpackName	Optional	String	Shown as the title in single player OTG world creation menu if the file is named Modpack.yaml
Overworld	Required	None	A header to tell OTG that options below it are for the Overworld
PresetFolderName	Required (unless NonOTGWorldType is used)	String	Insert this line below the Overworld header to use an OTG preset as the overworld. Input the name of the preset folder containing the OTG preset you want to use as the overworld. This must match a preset folder name in ".minecraft\config\OpenTerrainGenerator\Presets". See above for examples.
NonOTGWorldType	Required (unless PresetFolderName is used)	String	Insert this line below the overworld header to use a non-OTG world as the overworld. Input the name of the world type (same as server.properties level-type) Note: When using Biomes o' Plenty, set use_world_type = false in BoP's client.toml config file, otherwise OTG's custom world creation screen for modpack configs won't work properly. See above for examples
NonOTGGeneratorSettings	Optional	String	Used with NonOTGWorldType. Insert this line if you want to provide a JSON string with settings for NonOTGWorldType, same as server.properties generator-settings.
Nether	Optional	None	A header to tell OTG that options below it are for the Nether. If not included, OTG will use the Vanilla Nether.
PresetFolderName	Optional	String	Insert this line below the Nether header to use an OTG preset as the overworld. Input the name of the preset folder containing the OTG preset you want to use as the overworld. This must match a preset folder name in ".minecraft\config\OpenTerrainGenerator\Presets". See above for examples.
End	Optional	None	A header to tell OTG that options below it are for the End. If not included, OTG will use the Vanilla End.
PresetFolderName	Optional	String	Insert this line below the End header to use an OTG preset as the overworld. Input the name of the preset folder containing the OTG preset you want to use as the overworld. This must match a preset folder name in ".minecraft\config\OpenTerrainGenerator\Presets". See above for examples.
Dimensions	Optional	None	A header to tell OTG that options below it are for OTG dimensions. If not included, OTG will not add any OTG dimensions. If any of the below settings (other than PresetFolderName) are not included, settings from the preset's WorldConfig.ini are used instead.
- PresetFolderName	Optional	String	Insert this line below the Dimensions header to use an OTG preset as a dimension. Input the name of the preset folder containing the OTG preset you want to use as the overworld. This must match a preset folder name in ".minecraft\config\OpenTerrainGenerator\Presets". The "-" is required here as multiple dimensions can be added. See above for examples.
Seed	Optional	Integer	Can be set to -1 for a random seed. For the Overworld seed is ignored and taken from server.properties (MP) or world creation menu (SP). *In some cases, dimension seeds may be locked to overworld seed, still need to fix this.
PortalColor	Optional	String	The color of the portal. Options are: beige, black, blue, crystalblue, darkblue, darkgreen, darkred, emerald, flame, gold, green, grey, lightblue, lightgreen, orange, pink, red, white, yellow, default.
PortalMob	Optional	ID	The mob that occasionaly spawns from this portal, "minecraft:zombified_piglin" by default.
PortalIgnitionSource	Optional	ID	The ignition source for the portal, usually "minecraft:flint_and_steel".
PortalBlocks	Optional	ID	One or more blocks that can be used to build a portal. For example: "minecraft:stone, minecraft:dirt".
- PresetFolderName	Optional	String	Repeat the above to add more dimensions. See above for examples.
Settings	Optional	None	A header to tell OTG that options below it are for world settings. Used for Forge single player world creation menu if the file is named Modpack.yaml. If not included, OTG will leave these settings default.
GenerateStructures	Optional	Boolean	Set to True or False.
BonusChest	Optional	Boolean	Set to True or False.
GameRules	Optional	None	A header to tell OTG that options below it are for game rules. Used for Forge single player and multiplayer if the file is named Modpack.yaml and OTG is used for the overworld. If left empty, GameRules from the preset's WorldConfig are used, if those are empty then OTG uses the default game rules.
List of various gamerules	Optional	Various	See above examples for a list of game rules.