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"

```