Block/World Configs

The format of all data-driven JSON configs for blocks and the world

Temperature Units

Most world-related configs support using different units depending on the user's preference.There are 3 supported units of temperature for use with biome and dimension settings:

• F : Fahrenheit

• C : Celsius

• MC : Minecraft Units. These are used in biome generation, and typically range from 0 (freezing) to 2 (the Nether). With default settings, perfectly habitable is about 1.

Internally, these are all converted to MC units, since these are the units that are used by Minecraft and other mods for their biomes

Block Temperature

/block/block_temp/

You might be familiar with BlockTemps from previous sections. They can also be defined in JSON format, which has a couple advantages over traditional configs. The main reason they can be defined this way, though, is because of the modularity of JSON rather than defining them in the monolithic TOML files.

Format

{
  // A negatable list of required mods
  "required_mods": [
    // none
  ],
  // A negatable list or single block requirement
  "block": {
    "blocks": [
      "#minecraft:all_signs"
    ],
    "nbt": {
      "front_text": {
        "has_glowing_text": true
      } 
    }
  },
  // The temperature of the block
  "temperature": 5,
  // The maximum temperature change that this BlockTemp can cause
  // Multiple instances of this block can only heat/cool up to this amount
  "max_effect": 20,
  // Temperature units to use. All temperature fields must be specified in these units
  "units": "f",
  // (default=true) Makes the block's effect fade with increasing distance
  "fade": true,
  // The radius of the block's area-of-effect
  "range": 7,
  // (optional) This block cannot heat the local area to above this value
  "max_temp": 100,
  // (optional) This block cannot cool the local area to below this value
  "min_temp": 30,
  // (optional) Location requirement that must pass in order to emit temperature
  "location": {},
  // (optional) Entity requirement that the nearby entity must pass to be affected
  "entity": {},
  // (optional) Multiple instances of this block will apply temperature logarithmically 
  // (diminishing returns)
  "logarithmic": false,
}

Biome Temperature

/world/biome_temp/

The temperatures of biomes can be customized through JSON data, which is useful for 3rd-party developers who wish to support their custom biomes, or for pack developers who want a custom feel.

Format

Luckily, the format for biome temperatures is simpler than most settings:

{
  "required_mods": [
    "terralith"
  ],
  "biomes": [
    "minecraft:plains",
    "#minecraft:is_ocean"
  ],
  "temperature": 70,
  // Alternatively, temperatures for noon and midnight (high and low) can be defined:
  "min_temp": 50,
  "max_temp": 90,
  // The units being used for temperature. This example is in Fahrenheit
  // Defaults to MC
  "units": "F",
  // Applies an offset to the biome's base temperature, 
  // rather than setting the biome's temperature outright
  "is_offset": false
}

Dimension Temperature

/world/dimension_temp/

Dimension temperature configs apply to an entire dimension, overriding all biome temperatures. if is_offset is true, the dimension's temperature will be offset instead (in addition to biome temperatures).

Format

{
  "required_mods": [
    "origins"
  ],
  "dimensions": [
    "minecraft:the_nether",
    "#cold_sweat:soulspring_lamp_valid"
  ],
  // The dimension's temperature at midnight. "is_offset" makes this an offset
  "min_temp": -10,
  // The dimension's temperature at noon. "is_offset" makes this an offset
  "max_temp": 20,
  // Alternative to min/max_temp. Sets both of them to the same value
  "temperature": 50,
  // The units being used for temperature. This example is in Fahrenheit
  // Defaults to MC
  "units": "F",
  // Applies an offset to the dimension's base temperature
  // If false, all biome temperatures are overridden to the specified value
  "is_offset": true
}

Structure Temperature

/world/structure_temp/

The temperature within the bounds of a naturally-generated structure can be modified, similar to dimensions and biomes.

Format

{
  "required_mods": [
    "idas"
  ],
  "structures": [
    "minecraft:igloo",
    "#minecraft:village"
  ],
  "temperature": 30,
  "units": "F",
  "offset": true
}

Temperature Regions

/world/temp_region/

Cold Sweat uses a system of "temperature regions" to determine the temperature of the world at any y-level. These regions are highly configurable:

Format

Each config can be made up of many "regions", which define the world's temperature at specific altitudes. First, we will go into detail about to makeup of a region bound:

// The bound, either "top" or "bottom"
"top": {
  // "depth" will be relative to this point
  // (constant, world_top, world_bottom, ground_level)
  "anchor": "ground_level",
  // 21 blocks below ground level
  "depth": -21,
  // The temperature at the top of this region will be 75 degrees Fahrenheit
  "temperature": 75,
  "units": "f"
}

The "temperature" field also has a few optional properties:

"top": {
  "temperature": {
    // Either "midpoint" or "static"
    // "midpoint" is the average of the world's min/max habitable temperature
    // "static" is normal
    // optional, defaults to "static"
    "type": "midpoint",
    // The temperature of the bound
    // if set to "midpoint", this field is useless and can be omitted
    "value": 10,
    // Ranges from 0 to 1
    // at 1, the temperature is fixed to the given value 
    // at 0, passes through the biome's temperature
    // values in-between will partially apply the temperature
    "strength": 0.5 
  }
}

It can also just be an integer, which defaults to "static" with a strength of 1:

"top": {
  "temperature": 10
}

Now, let's put this together into a complete region:

{
  // The type of gradient between the bottom and top bounds
  // (constant, linear, exponential, logarithmic)
  "type": "linear",
  // The upper bound of this region
  "top": {
    "anchor": "ground_level",
    "depth": -1,
    "temperature": {
      "strength": 0
    }
  },
  // The lower bound of this region
  "bottom": {
    "anchor": "ground_level",
    "depth": -20,
    "temperature": 75,
    "units": "f"
  }
}

Finally, we can look at the full formatting for a temperature region file:

// This is the default depth region layout, with some tweaks to show off more features
{
  "dimensions":
  [
    // Only apply this depth region set in overworld-like dimensions
    "#forge:overworld_like"
  ],
  "regions": [
    // From ground level to the world height is normal
    {
      "type": "constant",
      "top": {
        "anchor": "world_top",
        "depth": 0,
        "temperature": {
          "strength": 0
        }
      },
      "bottom": {
        "anchor": "ground_level",
        "depth": 0,
        "temperature": {
          "strength": 0
        }
      }
    },
    // At 20 blocks below, the temperature evens out a bit
    {
      "type": "linear",
      "top": {
        "anchor": "ground_level",
        "depth": -1,
        "temperature": {
          "strength": 0
        }
      },
      "bottom": {
        "anchor": "ground_level",
        "depth": -20,
        "temperature": {
          "type": "midpoint",
          "strength": 0.5
        }
      }
    },
    // At the bottom of the world, it gets hotter
    {
      "type": "exponential",
      "top": {
        "anchor": "ground_level",
        "depth": -21,
        "temperature": {
          "type": "midpoint",
          "strength": 0.5
        }
      },
      "bottom": {
        "anchor": "world_bottom",
        "depth": 0,
        "temperature": {
          "value": 110,
          "strength": 1
        },
        "units": "f"
      }
    }
  ]
}