|This article is a work-in-progress.|
It may be finished in the near future, check its history to see previous edits.
This mod has not been updated since Nov 10 2010 (Minecraft Alpha 1.2.6)
A fork named "PhoenixTerrainMod" was continued by R-T-B, but abandoned May 09 2011 (Minecraft 1.7.3)
Biome Terrain Mod ( ) , created by Bucyruss of the Minecraft Forums, is a biome/terrain mod for allowing you to adjust a number of settings to get custom worlds how you want them. I'm constantly playing with the code and trying to find new things to adjust, but if you have any requests please let me know and I'll see what I can do. I'll try to keep a to-do list up to date in this post so people will know what I have planned to implement and can make suggestions based on that.
Current Version: 9.1
- 1 Where to Download
- 2 How to install the mod
- 3 Supported mod plugins
- 4 How to use the mod
- 5 Explanations of the settings from "biomesettings.txt"
- 5.1 BiomeSize:1.5
- 5.2 MoistureMin:0.0
- 5.3 MoistureMax:1.0
- 5.4 TemperatureMin:0.0
- 5.5 TemperatureMax:1.0
- 5.6 SnowThreshold:0.5 IceThreshold:0.5
- 5.7 WaterLevel:64
- 5.8 AverageHeightMax:0.0
- 5.9 AverageDepthMax:0.0
- 5.10 LandscapeFractureHorizontal:1.0 LandscapeFractureVertical:1.0
- 5.11 VolatilityPrimary:0.0 VolatilitySecondary:0.0 VolatilityPrimaryWeight:0.5 VolatilitySecondaryWeight:0.45
- 5.12 MuddySwamps:false ClaySwamps:false MuddySwampSize:2
- 5.13 WaterlessDeserts:false
- 5.14 DesertDirt:false DesertDirtFrequency:0
- 5.15 RemoveSurfaceDirtFromDesert:false
- 5.16 RemoveSurfaceStone:false
- 5.17 ReplaceWaterWithLava:false
- 5.18 ReplaceIceWithLava:false
- 5.19 LavaLevelMin:0 LavaLevelMax:10
- 5.20 DisableBedrock:false
- 5.21 FlatBedrock:false
- 5.22 GuaranteedBedrock:false
- 5.23 ChangeBedrockToObsidian:false
- 5.24 UndergroundLakes:false
- 5.25 BiomeTrees:false
- 5.26 TreeDensityGlobal:0
- 5.27 GlobalCactusDensity:0 DesertCactusDensity:10
- 5.28 UseDrakonaMarbleMod:false
- 6 Explanations and examples of the settings (default values shown) from "depositsettings.txt"
- 7 Thanks to...
- 8 Version History
Where to Download[edit | edit source]
First and Foremost, here's the mod:
How to install the mod[edit | edit source]
- Get/Use the desktop version of the game (not the browser)
- Download and open/extract the above .rar file
- Go to %appdata%\.minecraft\bin (windows) or ~/Library/Application Support/minecraft/bin (mac)
- Open your minecraft.jar file with a zip program (such as WinRar)
- Drag all of the .class files into your opened minecraft.jar file
- Be sure to delete your META-INF folder
- Close the zip program you opened minecraft.jar with
- You may copy the "biomesettings.txt" into your .minecraft folder. If not, then the program will create it when you first make a new world
Supported mod plugins[edit | edit source]
To use/install supported mod plugins, simply add the supported mods' files to your jar. Be sure to enable the setting in the biomesettings.txt file for the plugin you want to use. If we did everything right, it should work
How to use the mod[edit | edit source]
- For now you will have to manually edit the "biomesettings.txt" and/or the "depositsettings.txt" file with any text editor.
- Simply open the "biomesettings.txt" and/or the "depositsettings.txt" file and enter in the desired values (See below for an explanation of each setting).
- Every new world you create will use the "biomesettings.txt" and the "depositsettings.txt" file in your .minecraft folder as it's basis. Change the settings/values in this file before making a new world if you want the world to have those values by default.
- Once created, every world will have its own copy of the "biomesettings.txt" and the "depositsettings.txt file inside it's save folder. If you want to alter settings after a world has been created then you will need to edit the file found in that world's save folder.
Explanations of the settings from "biomesettings.txt"[edit | edit source]
Here's an explanation of each setting. Default values are shown.
BiomeSize:1.5[edit | edit source]
This value determines the size of the biomes. The larger the number, the larger the biomes. Conversely, the smaller the number, the smaller the biomes The number seems to function on a linear scale in terms of biome dimensions. Therefore, every doubling of this value will, roughly, double the average length and width of biomes.
Example of the biome size being modified to very small (BiomeSize:0.001) 
MoistureMin:0.0[edit | edit source]
This determines the minimum moisture value that the world will contain.
MoistureMax:1.0[edit | edit source]
This determines the maximum moisture value that the world will contain.
TemperatureMin:0.0[edit | edit source]
This determines the minimum temperature value that the world will contain.
TemperatureMax:1.0[edit | edit source]
This determines the maximum temperature value that the world will contain.
Example of the moisture and temperature fields being modified to force only a desert biome (MoistureMin:0.0, MoistureMax:0.0, TemperatureMin:1.0, TemperatureMax1.0
Chart showing what values of moisture and temperature will generate which biomes:
SnowThreshold:0.5 IceThreshold:0.5[edit | edit source]
These settings let you change the threshold at which snow/ice will form. Lower the values (into negatives) to make snow and ice less common (setting it to -1 should ensure that no snow/ice will form) and raise them (up to 1) make snow and ice more common.
WaterLevel:64[edit | edit source]
This alters the level at which water will be generated. Lower the value to generate lower (less) water levels and increase the value to flood worlds.
Example of the water level being increased to mostly flood a world (WaterLevel:85)
AverageHeightMax:0.0[edit | edit source]
This is a modifier field rather than a straight value field. Adjusting the value up or down (negative) from zero will either increase or decrease the average, maximum height of the world. Basically, when the world begins to increase in elevation this value will determine how much, on average, it will increase before leveling off. Setting this value negative will have the opposite effect and create a world broken by many bodies of water.
Example of increasing the value to create cliffs (AverageHeightMax:5.0)
AverageDepthMax:0.0[edit | edit source]
This is the same as AverageHeightMax except it applies to the depth of oceans mostly. Increasing this value will create deeper, larger water bodies (oceans mostly) and result in an island type world. Setting the value to negative will shallow/reduce the water in the world or cause it to disappear completely by setting the negative value large enough. A negative value, basically, inverts water bodies into land.
Example of increasing the value to create a deep, large ocean with islands(AverageDepthMax:4.0)
LandscapeFractureHorizontal:1.0 LandscapeFractureVertical:1.0[edit | edit source]
These are multipliers that control two settings that seem to act in some capacity at controlling the rate of elevation changes. Using smaller values (0 to 1) will create "calmer" landscapes while higher values (above 1) will create increasingly fragmented/fractured landscapes. There are some good balances with these that allow some neat landscapes.
Example of both values set to extreme values (both set to 100)
Example of using a "balance" of the two fracture settings combined with and increase in volatile settings and some other settings (I forget what all I changed as this was earlier when I was just playing around)
Example of using these settings along with volatility and altering max height and depth and lowering water to create "floating" ceilings that result in faux massive cave systems (Again, I don't remember the exact settings for this)
VolatilityPrimary:0.0 VolatilitySecondary:0.0 VolatilityPrimaryWeight:0.5 VolatilitySecondaryWeight:0.45[edit | edit source]
These are a bit odd/difficult to try and explain and the names may not even be right for what they are actually for, but it's the best I could come up with from observing their effects on the landscape.
There's two volatility settings with their own weighted values which let you pick how pervasive you want chaotic, volatile landscapes to be.
Increasing the value of VolatilityPrimary and VolatilitySecondary form 0 toward 1 (values over 1 automatically get reduced back to 1) will create ever more volatile landscapes.
You can set the value of either of these fields to any negative value to create increasingly flat terrain.
The two "Weight" settings let you choose how pervasive (values 0.0 to 1.0 and the sum of both should be equal to or less than 1.0) their corresponding volatility values are. So you could set the primary to high volatility, but set it's weight low and set the secondary to low volatility with a high weight to get large areas of relatively flat land with few, large, chaotic pieces of land.
This one is probably easier to just show examples of
Example of increasing just the primary volatility (VolatilityPrimary:0.8)
Example of increasing just the primary and secondary volatility (VolatilityPrimary:0.8, VolatilitySecondary:0.95)
MuddySwamps:false ClaySwamps:false MuddySwampSize:2[edit | edit source]
This idea comes from Wickity's Terrain Tweaker, but I didn't like the idea of just replacing water with mud (think that's what his code was doing at least). So I took that idea and implemented it differently so that all dirt/grass/sand at the bottom of bodies of water are changed to mud or clay depending on which you choose (mud will override clay if both are true).
The size setting affects how far mud/clay extends from the edges of water in swamp biomes.
There's a bug with the code right now that I haven't figured out that is causing "strips" of mud/clay to occur along the edges of chunks. Also, no sure if I am satisfied with the current result and may work on this some more at another time.
Example of how muddy swamps look with a size of 3
WaterlessDeserts:false[edit | edit source]
This will, simply, prevent any water from showing up in desert biomes. This applies to both desert and ice desert biomes. Thanks to Wickity for the idea and implemented it at the suggestion of a poster in this thread. Set it to "true" to keep your deserts water free.
DesertDirt:false DesertDirtFrequency:0[edit | edit source]
I implemented this because a number of people have mentioned wanting only desert biomes.
The obvious problem with this is no trees because there is no dirt. Setting DesertDirt to "true" and adding a frequency (the number, n, for DesertDirtFrequency corresponds to an average of 1 dirt square per n chunks). These two settings can be coupled with increasing the TreeDensityDesert setting to get trees in the desert biome.
Example of using desert dirt in a waterless, desert only biome setting (DesertDirt:true, DesertDirtFrequency:2)
Example of combining desert dirt settings and increasing the desert biome tree density (DesertDirt:true, DesertDirtFrequency:2, TreeDensityDesert:20
RemoveSurfaceDirtFromDesert:false[edit | edit source]
Pretty straight forward option that was implemented since someone reported seeing dirt/grass on the surface in a desert biome that was altered with volatility and height settings. This simply checks the surface blocks and any dirt or grass is converted to sand.
RemoveSurfaceStone:false[edit | edit source]
Will attempt to replace all surface stone with the nearest dirt, grass, sand, gravel, or clay type block that it finds. If it fails to find a suitable neighbor block to replicate, it will default to sand in the desert biome and grass in every other biome.
ReplaceWaterWithLava:false[edit | edit source]
Does what it says. All water becomes lava.
ReplaceIceWithLava:false[edit | edit source]
Same as above except that it replaces ice with lava instead.
LavaLevelMin:0 LavaLevelMax:10[edit | edit source]
These settings adjust the levels as which pockets of lava will form.
DisableBedrock:false[edit | edit source]
This will remove all bedrock from the map when set to true.
FlatBedrock:false[edit | edit source]
Implemented from Cadde's ore distribution mod. It simply puts all the bedrock on the bottom most layer of the map with no holes in it.
GuaranteedBedrock:false[edit | edit source]
Also implemented from Cadde's ore distribution mod. This keeps the bottom five layers of the map permeated with bedrock blocks, but makes sure that the bottom layer has no holes in it so that you don't have to worry about falling into the void.
ChangeBedrockToObsidian:false[edit | edit source]
Simple setting that just replaces all bedrock with obsidian.
UndergroundLakes:false[edit | edit source]
Enables or disables the generation of underground lakes. This replaces Cadde's original underground lakes. The new algorithm can create massive underground lakes (see settings below) with a flat water surface, varied depths, and open space over the lake.
UndergroundLakeFrequency:2 UndergroundLakeRarity:5 UndergroundLakeMinSize:40 UndergroundLakeMaxSize:60 UndergroundLakeMinAltitude:0 UndergroundLakeMaxAltitude:50
These are the options for the new underground lake algorithm. UndergroundLakeFrequency adjusts how frequent underground lakes will occur in a chunk. UndergroundLakeRarity sets the odds that an attempt to make a lake will succeed. UndergroundLakeMinSize and UndergroundLakeMaxSize set the range for the lake size to vary between. UndergroundLakeMinAltitude and UndergroundLakeMaxAltitude set the levels between which lakes will form.
BiomeTrees:false[edit | edit source]
Changing this to true will implement Wickity's biome trees. It add pine tree, shrubs, and tumbleweeds to the world. The current pine tree models are from  Chuck's Map Deleter / Pine Tree Generator] and credit goes to Wickity for the shrub/tumbleweed models. I plan on working with the models myself later to create more tree types and modify the existing ones, but I'm using these guys' models in the mean time. I also want to add in option for allowing how prevalent certain tree types are and, possibly, which biomes they appear in.
TreeDensityGlobal:0[edit | edit source]
Pretty straight forward, it modifies the tree density across all biomes (see below for individual, default biome settings for tree density).
TreeDensityRainForest:5 TreeDensitySwampland:0 TreeDensitySeasonalForest:2 TreeDensityForest:5 TreeDensitySavanna:-2 TreeDensityShrubland:-1 TreeDensityTaiga:5 TreeDensityDesert:-20 TreeDensityPlains:-20 TreeDensityTundra:-20
Again, this allows you to modify tree density, but on a biome level. You can see the biomes that are not supposed to have any trees have a relatively large negative value to ensure that no trees spawn.
GlobalCactusDensity:0 DesertCactusDensity:10[edit | edit source]
These settings adjust both the global cactus density of all biomes and the one special case of cactus density in the desert biome.
UseDrakonaMarbleMod:false[edit | edit source]
Enable this to use Drakona's Marble Mod. You must have his mod installed for this option to do anything.
Explanations and examples of the settings (default values shown) from "depositsettings.txt"[edit | edit source]
DirtDepositRarity1:100 DirtDepositFrequency1:20 DirtDepositSize1:32 DirtDepositMinAltitude1:0 DirtDepositMaxAltitude1:128 DirtDepositRarity2:0 DirtDepositFrequency2:0 DirtDepositSize2:0 DirtDepositMinAltitude2:0 DirtDepositMaxAltitude2:0 DirtDepositRarity3:0 DirtDepositFrequency3:0 DirtDepositSize3:0 DirtDepositMinAltitude3:0 DirtDepositMaxAltitude3:0 DirtDepositRarity4:0 DirtDepositFrequency4:0 DirtDepositSize4:0 DirtDepositMinAltitude4:0 DirtDepositMaxAltitude4:0
Yeah that's a lot of settings and that's just for dirt. The same settings are available for gravel, coal, iron, gold, redstone, diamond, flowers, mushrooms, reeds, pumpkins, and cacti, water sources, and lava sources.
This allows you to set the:
- rarity (0 is nonexistent, 1 is extremely rare, and 100 is common)
- frequency (the number of times this deposit type occurs per chunk)
- the size of the deposit (larger values make larger deposits)
- the level (MinAltitude) at which this deposit type start (0 to 128)
- and the highest level (MaxAltitude) to which it can be found (0 to 128).
There's four sets of these settings for gravel, coal, iron, gold, redstone, and diamond to allow you a lot of control over how you want your resources to appear on your map. This replaces the alternate ore distribution setting (Cadde's ore distribution).
The settings to get Cadde's ore distribution, assuming I didn't mess up my code and converted Cadde's settings correctly, is the following:
DirtDepositRarity1:100 DirtDepositFrequency1:20 DirtDepositSize1:24 DirtDepositMinAltitude1:0 DirtDepositMaxAltitude1:128 GravelDepositRarity1:100 GravelDepositFrequency1:10 GravelDepositSize1:16 GravelDepositMinAltitude1:0 GravelDepositMaxAltitude1:128 CoalDepositRarity1:100 CoalDepositFrequency1:4 CoalDepositSize1:4 CoalDepositMinAltitude1:48 CoalDepositMaxAltitude1:128 CoalDepositRarity2:100 CoalDepositFrequency2:4 CoalDepositSize2:16 CoalDepositMinAltitude2:48 CoalDepositMaxAltitude2:96 CoalDepositRarity3:25 CoalDepositFrequency3:1 CoalDepositSize3:32 CoalDepositMinAltitude3:0 CoalDepositMaxAltitude3:64 CoalDepositRarity4:5 CoalDepositFrequency4:1 CoalDepositSize4:64 CoalDepositMinAltitude4:0 CoalDepositMaxAltitude4:32 IronDepositRarity1:100 IronDepositFrequency1:4 IronDepositSize1:4 IronDepositMinAltitude1:64 IronDepositMaxAltitude1:80 IronDepositRarity2:100 IronDepositFrequency2:4 IronDepositSize2:8 IronDepositMinAltitude2:32 IronDepositMaxAltitude2:64 IronDepositRarity3:35 IronDepositFrequency3:1 IronDepositSize3:24 IronDepositMinAltitude3:16 IronDepositMaxAltitude3:48 IronDepositRarity4:5 IronDepositFrequency4:1 IronDepositSize4:48 IronDepositMinAltitude4:0 IronDepositMaxAltitude4:40 GoldDepositRarity1:100 GoldDepositFrequency1:2 GoldDepositSize1:8 GoldDepositMinAltitude1:0 GoldDepositMaxAltitude1:32 GoldDepositRarity2:10 GoldDepositFrequency2:1 GoldDepositSize2:24 GoldDepositMinAltitude2:0 GoldDepositMaxAltitude2:24 RedstoneDepositRarity1:100 RedstoneDepositFrequency1:6 RedstoneDepositSize1:4 RedstoneDepositMinAltitude1:0 RedstoneDepositMaxAltitude1:24 RedstoneDepositRarity2:100 RedstoneDepositFrequency2:4 RedstoneDepositSize2:12 RedstoneDepositMinAltitude2:0 RedstoneDepositMaxAltitude2:16 DiamondDepositRarity1:100 DiamondDepositFrequency1:1 DiamondDepositSize1:7 DiamondDepositMinAltitude1:0 DiamondDepositMaxAltitude1:16 DiamondDepositRarity2:2 DiamondDepositFrequency2:1 DiamondDepositSize2:20 DiamondDepositMinAltitude2:0 DiamondDepositMaxAltitude2:16
Thanks to...[edit | edit source]
- Drakona for making a plugin for his MarbleMod
- Wickity for several of the ideas in this mod and code that got me started
- Cadde for her ore mod that inspired my ore settings
- Chuck for the pine tree generator code that acted as the base for my tree generator code
- (I'm sure more will be added here in the near future. If I forgot you, please send a nasty PM saying so)
Version History[edit | edit source]
- Biome Mod v1a * Use of a field on options.txt to modify biome size
- Biome Mod v2a * Use of a biome settings file to modify biome size (unique to each world)
- Biome Mod v3a * Added ability to change moisture and temperature
- Biome Mod v3.1a * Fixed to work with update from 11/5
- Biome Mod v3.2a * Fixed snow in inappropriate biome problem
- BiomeTerrain Mod v4 * Added water level, average max height/depth, volatility parameters, tree densities, waterless deserts (thanks Wickity), and desert dirt
- BiomeTerrain Mod v5 * Added alternate ore distribution and underground lakes from Cadde's mod. Fixed volatility weights
- BiomeTerrain Mod v6 * Added flat and guaranteed bedrock from Cadde's mod and biome trees from Wickity's mod (semi-temporary until I get some time to make my own biome tree mod)
- BiomeTerrain Mod v6.1 * Updated to work with 1.2.2
- BiomeTerrain Mod v6.2 * Recompiled with JDK1.5, fixed a minor error with the desertDirt setting, and removed support for ice deserts due to a conflict in the biome class
- BiomeTerrain Mod v7 * Added grass/dirt -> sand for deserts, muddy swamps, muddy swamp size, convert bedrock to obsidian, landscape fracturing, and underground resource controls (inspired by Cadde's mod)
- BiomeTerrain Mod v8 * Added Drakona Marble Mod support, clay swamps, remove surface stone, replace all water with lava
- BiomeTerrain Mod v8.1 * Fixed biomeTrees not working and added an option to remove bedrock
- BiomeTerrain Mod v9 * Added snow and ice threshold settings, replace ice with lava, min and max lava formation levels, rewrote the underground lake code and added settings for it, global and desert cacti densities, spawning settings for flowers, mushrooms, reeds, pumpkins, cacti, and water and lava sources.
- BiomeTerrain Mod v9.1 * Fixed cactus generation, fixed clay swamps, added first revision of savanna trees.