Open Terrain Generator Wiki
Advertisement

OTG can be installed as a PaperMC plugin or as a Forge mod using the same OTG .jar file. Fabric is not yet supported, but is planned after OTG 1.16.x 1.0.0.

As a PaperMC plugin, OTG is not required client-side. For Forge servers, the client-side mod is required, but we intend to lift this requirement before 1.0.0. When OTG is run server-side without a client, features like foliage/grass/sky/fog colors don't work fully (plain colors instead of gradient colors), and features like dimension portals for Forge are disabled.

Installation instructions for each platform are included below, please be aware that without installing a world preset, OTG will use its default preset, which is made to look like a vanilla overworld. The Default preset is unpacked when Minecraft loads to "/config/OpenTerrainGenerator/Presets/Default/" for Forge or "/plugins/OpenTerrainGenerator/Presets/Default/" for PaperMC, its configuration files can be edited with any text editor.

Forge Installation[]

Forge Single Player[]

  1. Go to files.minecraftforge.net to download & install the latest recommended Forge release corresponding to the version of Minecraft you want to use.
  2. Run Minecraft once to create the /mods folder (usually found at C:\Users\[USERNAME]\AppData\Roaming\.minecraft\mods\ ).
  3. Download the OpenTerrainGenerator.jar and put it in the .minecraft/mods folder.
  4. Install a world preset (for 1.12.2 presets, unpack and copy the preset folder from the .jar)

Note: If you experience long world loading times, increase memory allocation. OTG usually requires 2gb+ memory to be assigned to Minecraft (depending on world preset).

Forge Server[]

  1. Go to files.minecraftforge.net to download & install the latest recommended Forge release corresponding to the version of Minecraft you want to use.
  2. Download the OpenTerrainGenerator.jar and put it in the server's mods folder.
  3. Install a world preset (for 1.12.2 presets, unpack and copy the preset folder from the .jar)
  4. Configure server.properties
  5. (Optional) Include a DimensionConfig.yaml file to define custom OTG Overworld/Nether/End and add OTG dimensions.

Note: If you have already generated any chunks with vanilla or other world settings, delete the level.dat and region files of your main world to get one with the correct level type.

server.properties[]

- Set level-type: otg and generator-settings: presetname. "presetname" should match either the folder name of one of your installed presets ("/config/OpenTerrainGenerator/Presets/" for Forge), or the name of a .yaml file in the ".../OpenTerrainGenerator/DimensionConfigs/" folder.

Dimension configs / Modpack configuration (SP&MP)[]

Dimension configs can be used for Forge MP servers to assign custom OTG Overworld/Nether/End/dimensions, or to define a non-OTG overworld with OTG Nether/End/dimensions. For Forge SP, if a dimension config called "Modpack.yaml" is found, the world creation menu is replaced by a custom screen that locks settings and allows users to create a new world with 1 click, using the settings from Modpack.yaml.

To create a dimension config file, add a .yaml file to ".../OpenTerrainGenerator/DimensionConfigs/" (create DimensionConfigs folder if necessary). For Forge MP, the .yaml file is used by setting its filename (without .yaml) as server.properties generator-settings. When the MP server is started, the dimensions in the .yaml file should be created automatically.

The .yaml file should look as follows:

#TODO: Provide instructions for modpack devs.
---
Version: 1
ModpackName: "My Awesome Modpack"
Overworld:
  NonOTGWorldType: "flat"
  NonOTGGeneratorSettings:
  PresetFolderName:
  Seed: 10
Nether:
  PresetFolderName: "AlienJungle"
  Seed: 11
End:
  PresetFolderName: "NewBB"
  Seed: 12
Dimensions:
- PresetFolderName: "Wildlands"
  Seed: 14
  PortalColor: "beige"
  PortalMob: "minecraft:zombified_piglin"
  PortalIgnitionSource: "minecraft:flint_and_steel"
  PortalBlocks: "REDSTONE_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
  • Overworld: Can be set to OTG or non-OTG. To use an OTG preset, use PresetFolderName. To use a non-OTG overworld, use NonOTGWorldType and NonOTGGeneratorSettings.
  • Nether: Optional, if PresetFolderName has a value, the OTG preset is used for the Nether.
  • End: Optional, if PresetFolderName has a value, the OTG preset is used for the End.
  • Dimensions: Optional, List. Add as many dimensions as you like, each entry starting with a dash (-).
  • Settings: Optional, used for Forge SP world creation menu if the file is named Modpack.yaml.
  • GameRules: Optional, used for Forge MP, and for Forge SP if the file is named Modpack.yaml. If missing, default game rules are used.
  • ModpackName: Optional, Shown as the title in OTG world creation menu's for Forge SP if the file is named Modpack.yaml.
  • Version: Ignored at the moment.
  • Seed: 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.

Dimensions only:

  • PortalBlock: One or more blocks that can be used to build a portal. For example: "minecraft:stone, minecraft:dirt".
  • PortalMob: The mob that occasionaly spawns from this portal, "minecraft:zombified_piglin" by default.
  • PortalColor: 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.
  • PortalIgnitionSource: The ignition source for the portal, usually "minecraft:flint_and_steel".

If left empty, portal settings from the preset's WorldConfig are used.

Mod Compatibility (Forge)[]

  • OTG uses MC biome categories and Forge Biome Dictionary tags for its biomes. Modded mobs, resources and structures should spawn in OTG worlds, provided they are configured correctly.
  • Mods that add carvers (caves, ravines) like Yung's Better Caves also work, OTG's carvers should be automatically disabled when using them.
  • Terrain/Biome generation mods like TerraForged, Biomes o' Plenty, Oh the Biomes You'll Go etc can be used with OTG. However, modded biomes will only spawn in OTG worlds if the OTG preset includes mod compatibility configs for the biomes. This can be done via template biomes using biome category and biome dictionary tags (see WorldConfig BiomeGroups/TemplateBiomes and BiomeConfig TemplateForBiome). Other mods are not able to spawn OTG biomes properly, this is something we'll look at for the future. Note that it is also possible to make a non-OTG (modded or vanilla) overworld with OTG Nether/End and dimensions.
  • When using Quark, set "Improved Sleeping" = false in quark-common.toml, or you won't be able to sleep in OTG dimensions.
  • When using Biomes o' Plenty, set use_world_type = false in client.toml or OTG's custom world creation screen for modpack configs won't work properly.
  • When using 1.12.2 presets with OTG 1.16.5, some mods don't work due to missing biome categories or biome dictionary tags in OTG biomes, configured via the BiomeConfig (.bc) files. Ice and Fire requires the "overworld" tag for example, which is not configured for 1.12.2 OTG presets. Presets are being updated and will be released on CurseForge a.s.a.p, users can also manually add categories/tags to BiomeConfig (.bc) files (BiomeCategory:, BiomeDictTags:).

Mod recommendations (Forge)[]

  • ChunkPregenerator integrates seamlessly with OTG world creation UI and provides pre-generation/preview features for all dimensions.

PaperMC Installation[]

Tutorial for setting up a PaperMC server are here.

  1. Set up the server in the normal way.
  2. Download and put the Open Terrain Generator .jar into the server's plugins folder.
  3. Install a world preset (for 1.12.2 presets, unpack and copy the preset folder from the .jar)
  4. Specify OTG as generator:
    • With MultiVerse: specify OTG as generator like so: "-g OpenTerrainGenerator:Wildlands"
    • Without, add the following to your Bukkit.yml file:
      worlds:
          world_name:
              generator: OpenTerrainGenerator:Wildlands
      


Although players do not require an OTG client for PaperMC servers, using a Forge OTG client enables features like complex foliage/grass/sky/fog colors.

PaperMC console command permissions

The following console commands can be be used with the permissions.yml file in your PaperMC server folder:

*TODO: Needs to be updated for 1.16.5.

Commands
cmd.tp cmd.list
cmd.biome cmd.map
cmd.check cmd.spawn
cmd.help cmd.reload

For a description of each of them see Console Commands.

Other Tips[]

  • Servers and clients running OTG will require more memory than vanilla Minecraft. It is recommended to increase Minecraft's allocated memory to 2gb+
  • 1.12.2 presets can be used with OTG 1.16.5, however presets will need to be updated to make use of all the new features.
  • Check the new Default preset for updated config settings and comments, these will tell you about all the 1.16.5 features.
  • Set SettingsMode: WriteAll in WorldConfig.ini to make OTG write all the latest settings and comments. This may break some legacy presets, so be sure to back up your preset files if you are a preset creator.
Advertisement