Back to mods
Temperature Height Tweak project artwork

Vintage Story Mod DB · Vintage Story mod

Temperature Height Tweak

A pet peeve of mine has long been walking up a 60-block tall hill and seeing ambient temperature drop by 10°C. In the vanilla game temperature decreases linearly with elevation by about 0.16°C for each block above sea level. While this makes for nice

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Temperature Height Tweak release should I use?

Updated 3 months ago
Latest stable file 0.4.0
Game version 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3
Loader Built-in Vintage Story mod system

Temperature Height Tweak 0.4.0 targets 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3. It must be installed on the client. Installation on the dedicated server is optional. No extra mods listed for this file.

Where it goes

Is Temperature Height Tweak required on the client, server, or both?

It must be installed on the client. Installation on the dedicated server is optional.

Client Required
Dedicated server Optional
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This release supports both sides, but the source does not require it on the server.

What else does Temperature Height Tweak 0.4.0 need?

0.4.0. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Temperature Height Tweak without breaking your instance.

Built for Temperature Height Tweak 0.4.0. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 0.4.0. It targets 1.22.0-pre.1, 1.22.0-pre.2, 1.22.0-pre.3; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    It must be installed on the client. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 0.4.0. It opens that exact file at the source.

About this project

What does Temperature Height Tweak add?

A pet peeve of mine has long been walking up a 60-block tall hill and seeing ambient temperature drop by 10°C.

In the vanilla game temperature decreases linearly with elevation by about 0.16°C for each block above sea level. While this makes for nice snow-capped mountains, I feel it's not particularly realistic for hills, ridges and highlands to get so cold so quickly. Realism, of course, is impossible to achieve to begin with in a toybox world of very limited height (not to even get into how local terrain affects temperature, e.g. canyons being cooler than the mesas surrounding them), so here's a compromise solution.

What this does

This mod changes the function by which temperature decreases with elevation to follow a sigmoid curve rather than being linear. The temperature decreases very gently at first, then starts decreasing steeply at about 100 blocks above sea level until it intersects the vanilla temperature drop at about 170 blocks above sea level. From there the curve levels back out, but this won't be relevant for most worlds due to world height limitations.

To illustrate:

Blocks above sea level Vanilla temperature Modded temperature
0 20°C 20°C
50 12.2°C 18.6°C
100 4.3°C 13.3°C
150 -3.5°C 0°C
170 -6.7°C -6.7°C
200 -11.4°C -14.7°C

Below sea level this mod uses the standard linear function.

Or see this calculator or the mod screenshot: https://www.desmos.com/calculator/tlizehxfmy (in this calculator, the variable U controls the ambient base temperature)

New world recommended

While this mod can be dropped into an existing world, certain terrain features such as snow and glaciers on mountaintops will not update to reflect the changes in existing chunks.

The numbers in this mod are tuned for a world height of 320. It will work with other world heights, but shorter worlds will be warmer at peak elevation while taller worlds will be colder. This same limitation applies to the vanilla system though.

Configuration (changing the curve)

To configure the mod, run the game with it once and then edit TemperatureHeightTweak.json (or create it with the following content):

{
  "a": 188.0,
  "b": 0.03,
  "c": 155.0
}

These values correspond to the variables in the equation y = a / (1 + exp(-b(x - c))) - a / (1 + exp(bc))

image

Use this calculator (or any other graphing calculator) to adjust the variables until the curve has an acceptable shape. On the calculator the X-axis corresponds to height above sea level (in blocks) and the Y-axis to median temperature (before local climate is taken into account). The default curve is tuned for a world height of 320. Keep in mind that sea level varies by world height — have a look at this wiki page or check the sea level for your world height in-game to figure this out for your world height as you adjust the curve.

Adjusting the variables without using a graphing calculator is an exercise in madness, so don't try it.

Please do share good values you've found in the comments. Here are ones for 448 height shared by FinkThinker:

{
    "a": 188.0,
    "b": 0.027,
    "c": 170.0
}

Mod compatibility

This should work with pretty much any mod, including worldgen mods. This will only conflict with other mods that pretty much do the exact same thing, as there is no reason to patch the functions this mod patches except to change temperature elevation scaling.

Project description from Vintage Story Mod DB.

Pick your setup

Temperature Height Tweak releases for each Vintage Story version.

Choose the version and loader you play, then open the matching release.

20 available setups

Showing the newest 12 of 20 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Temperature Height Tweak versions and loaders

4 of 4 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.