About VS Terrain Diffusion
From Vintage Story ModDBGenerate terrain and climates with a model trained on real Earth topography
This mod is in early development, and is provided here for the community to play around with and explore. World breaking changes should be expected. Only use this mod with a new world.
I also recommend checking out this implementation of Terrain Diffusion by Alyis: Terra Loom
Description
Generates Vintage Story worlds with Terrain Diffusion;
a neural heightmap model trained on real Earth topography.
Recent Updates
- Many optimizations and support for OpenVINO thanks to Paul T. (v 0.8.1)
- Fixed translocators so they find a destination in a reasonable amount of time. (v 0.9.1)
- Added native, subway tunnel free, support for rivers via model conditioning. (v 0.9.1)
- Changed model inferrence to be preemptable, so moving fast or teleporting will start generating terrain near the player fairly quickly. (v 0.9.1)
- Descreased the default value for RiverBasinDepth to 0.3 to prevent river basins from flattening terrain too much. (v 0.9.2)
- Improved reliability of hardware capability detection & inference backend selection (v 0.9.3)
- Windows will now (hopefully) work with TensorRT-RTX without crashing (v 0.9.3)
- Incompatible configurations can no longer be selected in the configlib menu (v 0.9.3)
- Fixed terrain flattening near sea level. (v 0.10.0)
Known Issues
- The very large biomes can make gameplay difficult, some easy tuning knobs are needed here.
- This mod is completely untested on macOS (I dont have a system to do so), and coreml support only works in theory.
- The int8 decoder model is being auto selected on windows if a gpu inferrence device is not detected. The Int8 decoder should require explicit selection. (High priority)
- River conditioning is too strong in areas with low terrain, causing wide swaths of perfectly flat terrain.
Requirements
- ~2.3 GB of disk for the model files, downloaded once on first launch
- ~3 GB of extra VRAM while the models are resident
<table style="border-collapse: collapse; width: 100%; height: 80.8px;" border="1"> <tbody> <tr style="height: 20.2px;"> <td style="width: 33.3052%; height: 20.2px;">Platform</td> <td style="width: 33.3052%; height: 20.2px;">Device used automatically</td> <td style="width: 33.3052%; height: 20.2px;">Notes
</td> </tr> <tr style="height: 20.2px;"> <td style="width: 33.3052%; height: 20.2px;">Linux</td> <td style="width: 33.3052%; height: 20.2px;">CUDA</td> <td style="width: 33.3052%; height: 20.2px;">Needs CUDA runtime 12 or 13 and cuDNN9</td> </tr> <tr style="height: 20.2px;"> <td style="width: 33.3052%; height: 20.2px;">Windows</td> <td style="width: 33.3052%; height: 20.2px;">DirectML</td> <td style="width: 33.3052%; height: 20.2px;">Any modern GPU; no extra install</td> </tr> <tr style="height: 20.2px;"> <td style="width: 33.3052%; height: 20.2px;">macOS</td> <td style="width: 33.3052%; height: 20.2px;">CoreML</td> <td style="width: 33.3052%; height: 20.2px;">No extra install</td> </tr> <tr> <td style="width: 33.3052%;">Anything else</td> <td style="width: 33.3052%;">CPU</td> <td style="width: 33.3052%;">Works, but slow</td> </tr> </tbody> </table>
The matching ONNX Runtime native library is downloaded on first use (a few MB for CPU/DirectML,
~300 MB for CUDA). Nothing has to be installed by hand.
If you have an NVIDIA 3000 series or newer, you can try out TensorRT-RTX (Tested with Linux and Win11, Win10 may have issues atm.). It will speed things up significantly.
To enable it, set InferenceDevice to tensorrt-rtx in vsterraindiffusion.json.
Recommended Mods
- Terrain Slabs
- Farseer
- Rivers (Set "RiverSpawnChance" in rivers.json to 0.1 or even 0.05)
- Distant Vistas (If you have an extremely powerful computer, this mod is incredible)
Recommended World Settings
<table style="border-collapse: collapse; width: 100%; height: 84.8px;" border="1"> <tbody> <tr style="height: 24.2px;"> <td style="width: 49.9578%; height: 24.2px;">Landcover</td> <td style="width: 49.9578%; height: 24.2px;">40% to 60%</td> </tr> <tr style="height: 20.2px;"> <td style="width: 49.9578%; height: 20.2px;">Landcover scale</td> <td style="width: 49.9578%; height: 20.2px;">300%</td> </tr> <tr style="height: 20.2px;"> <td style="width: 49.9578%; height: 20.2px;">World Height</td> <td style="width: 49.9578%; height: 20.2px;">512 (Generally the higher, the better. You can try 768 and 1024 as well. Climates and terrain may be a bit odd atm.)</td> </tr> <tr style="height: 20.2px;"> <td style="width: 49.9578%; height: 20.2px;">Color Accurate Map</td> <td style="width: 49.9578%; height: 20.2px;">Enabled</td> </tr> </tbody> </table>
Highlights
From source dataGame versions
Supports 22 Vintage Story versions, the newest being 1.22.6.
Footprint
Rated a light load on a server.
VS Terrain Diffusion on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
- Server side
- Required on the server
- Server load
- light
- Smallest plan we suggest
- Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.
Run VS Terrain Diffusion on a Vintage Story server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogWorld generation
Changes or adds to how new terrain, biomes and structures are created.
Runs on your server
From source side supportVintage Story ModDB lists VS Terrain Diffusion as required on the server. Check its Vintage Story ModDB page to see whether players need it too.
Compatibility
- Game
- Vintage Story
- Runs on
- Serverrequired on the server
- Game versions
- 1.22.6 and 21 earlier
Verified at the source
- ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
- ✓AuthorTechmo, as published on Vintage Story ModDB
- ✓LicenseNot published by the sourceFree















