Cave Generator Mod for Minecraft 1.12.2

Cave Generator is a modification of Mojang’s tunnel generation algorithm, used for creating cave-like openings in the overworld.

It supports injecting overrides for almost any variable used in the process, and even adds a few options for creating different shapes. Additionally, users can apply decorations to flood caves with water, replace surfaces with grass, cover them with gravel, place stalagmites and stalactites, and more.

Each cave preset has a percent selection chance, a height range, biome restrictions, and other parameters to help make them stand out and prompt exploration. Multiple presets can be combined to generate simultaneously, and individual tunnels from one preset can even spawn entirely different shapes by calling on other presets.

Cave Generator Mod

Because preset creation can initially be somewhat tedious, Cave Generator Mod 1.12.2 includes a total of 5 example presets.

How to use:

  • By default, only the vanilla preset is enabled. It can be found under /config/cavegenerator/presets/, which is the cave preset directory. Open it up and take a look at the different categories to get a better idea of what can be done.
  • To enable or disable presets, simply change “chance” from 0.0 to 100.0 or any value in between.
  • There is no need to restart the game for this to take effect; presets can be reloaded while in-game using the command “/reloadcaves.”


  • This mod was very carefully designed so as to not break seeds as much as possible until certain settings are modified.
  • As it is currently in beta, be aware that this may change.


  • Presets
    • Selection chance
      • Multiple presets can be combined, each with unique probabilities.
    • Height restrictions
    • Distance / length
    • Probability of spawning as a cave system
    • Specific vertical noise reduction, as implemented in vanilla
    • Extensions
      • Can be placed at the beginning, end, or randomly in the middle of each cave.
      • Can be vanilla-style branches, matching branches, tunnels from another preset, rooms, or nothing at all.
        • May eventually support structures.
      • Examples
        • Certain cave types lead into massive pits that go straight into lava
    • Biomes
      • A biome whitelist. There is no blacklist, as of yet.
      • Biomes cab be entered by registry name, ID number, or Biome Dictionary Type.
    • Block fillers
      • A blockstate to replace stone with
      • A selection chance
        • Multiple block fillers can be setup per-preset.
      • A list of blocks that should be matched–optional
      • A list of directions that blocks should be matched–optional
      • A preference
        • Whether to replace the original position, or the position where the block was matched
      • Example uses
        • Flood caves with water or lava
        • Add stalagmites and stalactites
        • Cover the floor with patches of gravel
        • Simulate cave-ins using gravel and multiple cave presets
    • Room settings
      • These are the spherical chambers that get placed at certain locations underground, often at intersections between several caves.
      • Change their overall scale, or squish or stretch them vertically.
        • There may be more options or other room styles in the future.
    • slopeXZ and slopeY
      • The horizontal and vertical angle of each tunnel
      • Change the starting value, or specify the randomness factor of the starting value.
    • twistXZ and twistY
      • How the horizontal and vertical angle of each tunnel will change as the tunnel expands outward.
      • Supports linear and quadratic scaling.
      • Change the starting value, or specify the randomness factor (how much the value should change randomly per each block outward).
    • scale and scaleY
      • The overall size and the vertical size ratio
      • Can be adjusted linearly or quadratically
      • Includes a randomness factor – needs work
      • Starting values can be specified (i.e. caves can be scaled overal, or squished or stretched to look like ravines)
      • scale includes a starting value randomness factor (from vanilla–scaleY will be added).
    • Lava rules
      • Only supports a maximum height limit, for now.
  • An entirely new, noise-based cave generator
    • Can be used in addition to or instead of the vanilla tunnel-like caves.
    • Supports height restrictions.
      • Flat ceilings and floors are avoided using additional, 2D noise, resulting in more chasm-like openings.
    • Support for biome restrictions is coming.
      • Biomes can be limited, but expect flat walls between borders.
      • There are experimental features in place to shrink cave sizes near borders, but detection is not yet as good as it should be. They are currently disabled.
    • Settings
      • enable / disable
      • min/maxHeight
      • “spacing”
        • The simultaneous distance and overall size of caverns.
      • scale / scaleY
      • “octaves”
        • The number of generation passes. Creates noisier caves at the cost of performance.
  • Commands
    • /reloadcaves
      • Used to unload and reload all presets in the preset folder. There’s no need to reload the game. See the game log for more information on which presets have been enabled (chance > 0).


Cave Generator Mod Screenshots 1Cave Generator Mod Screenshots 2Cave Generator Mod Screenshots 3Cave Generator Mod Screenshots 4Cave Generator Mod Screenshots 5Cave Generator Mod Screenshots 6Cave Generator Mod Screenshots 7Cave Generator Mod Screenshots 8Cave Generator Mod Screenshots 9Cave Generator Mod Screenshots 10Cave Generator Mod Screenshots 11


Minecraft Forge

How to install:

  1. Make sure you have already installed Minecraft Forge.
  2. Locate the minecraft application folder.
    • On windows open Run from the start menu, type %appdata% and click Run.
    • On mac open finder, hold down ALT and click Go then Library in the top menu bar. Open the folder Application Support and look for Minecraft.
  3. Place the mod you have just downloaded (.jar file) into the Mods folder.
  4. When you launch Minecraft and click the mods button you should now see the mod is installed.

Cave Generator Mod Download Links:

File Name Status Game Version Date
cavegenerator-0.3.jar Beta 1.12.2 Jul 26, 2018

Author: PersonTheCat

Related Posts