Biome Terrain

'''This page might not be up to date. For the latest information regarding the mod, please visit the forum thread'''

Biome Terrain Mod ( Forum thread ), 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

=Where to Download=

First and Foremost, here's the mod:

BiomeTerrain Mod v9.1 - Mediafire

(MegaUpload Mirror)

= How to install the mod =
 * 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 =
 * Drakona's Marble Mod

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 =
 * 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" = Here's an explanation of each setting. Default values are shown.

BiomeSize:1.5
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
This determines the minimum moisture value that the world will contain.

MoistureMax:1.0
This determines the maximum moisture value that the world will contain.

TemperatureMin:0.0
This determines the minimum temperature value that the world will contain.

TemperatureMax:1.0
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
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
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
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
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
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
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
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
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
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
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
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
Does what it says. All water becomes lava.

ReplaceIceWithLava:false
Same as above except that it replaces ice with lava instead.

LavaLevelMin:0 LavaLevelMax:10
These settings adjust the levels as which pockets of lava will form.

DisableBedrock:false
This will remove all bedrock from the map when set to true.

FlatBedrock:false
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
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
Simple setting that just replaces all bedrock with obsidian.

UndergroundLakes:false
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
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
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
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
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" =

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... =
 * 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 =
 * 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.

BiomeTerrain