SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedWorld generation

Farseer

by badgerson · for Vintage Story

Draws silhouettes of the terrain outside of your view distance

230KDownloads
1.20.7Latest game version
Vintage Story ModDBSource

About Farseer

From Vintage Story ModDB

Draws silhouettes of the terrain outside of your view distance

Press Control + Shift + F in-game to bring up a settings menu where you can adjust view distance and various look-and-feel settings.

 

---

1.22.0 upgrade notice!

The new version adds support for Algernon's amazing Terrain Sampler Lib, speeding up heightmap generation times by an absurd degree.
When the mod is found, Farseer will automatically be superfast. Also saves on memory and CPU usage. It's a must have!
Be sure to download Algernon's mod: https://mods.vintagestory.at/algernonsterrainsampler

Also, like for 1.21.0, when updating you should delete existing heightmaps for worlds you want to keep playing on so heightmaps can re-generate.

---

1.21.0 upgrade notice!

If you are using Farseer and just updated to 1.21 while playing on the same world,

you're going to want to remove the files in VintagestoryData/Farseer/.

What this does is erase the far terrain heightmaps for existing saves so that the mod can generate new ones.

This is necessary because 1.21 introduces changes to terrain generation!

---

 

Farseer is a dead-simple LOD terrain system, allowing you to see the silhouette of terrain much further out than normal - by default ~4000 blocks in all directions. It does so by building two-dimensional heightmaps using the information stored in your world's chunks, and will automatically generate them for far-out chunks around players so they can see distant areas they have not yet visited.

To be clear, the mod won't show "real" chunks with trees, buildings and so on, it's just a simple heightmap rendered to look like atmospheric fog.

The initial LOD building process can be quite slow if you haven't explored much already, as the mod will have to partially generate real world chunks when they don't exist yet. The new partial chunks won't be saved, so your world file size stays the same.

Heightmaps themselves barely use any disk space or RAM and are stored in a database on the server so they can be loaded very quickly by any connecting player the next time they are needed. They are also 100% static, meaning they will not "update" when something in a chunk changes.

The mod needs to be present on the server-side in order to work, but for players on the server it's optional, they just won't see the distant terrain if they don't have the mod installed. At the moment the mod is marked as required on both sides, so that the server can auto-download it for connecting players.

Configuring

 

There's two configuration files, one for the client and one for the server. The client settings can be changed in-game with the default keybind Control + Shift + F. The server settings can only be changed manually by editing the file.

Server settings

  • HeightmapGridSize (default 128): Increasing this will make the heightmaps more detailed, but also increase file size and bandwidth use exponentially. Value should be a number to the power of two, so 32, 64, 128, 256 and so on. 512 is the highest possible value, sampling the heightmap at every single block. If you change this on an existing world, you should remove the mod's database for that world first (In VintageStoryData/Farseer directory) to reset existing regions.
  • ChunkGenerationQueueThreshold (default 64): If more than this number of chunks are currently being generated, the mod will not generate any far terrain heightmaps until it's lower again, to prevent server overload. Max possible value is 2000.
  • MaxClientViewDistance (default 4096): Limits the max view distance of players so they can't eat up all of your disk space. Increase this on the server if you want to increase view distance for players. Ignored in singleplayer and in "Open to LAN" worlds. Players can see the server-side limit in the Farseer config UI. If they set their far view distance higher than the limit, the server will make sure the limit is enforced anyway.
  • GenRealChunks (default false): If set to true, the mod will generate and save actual chunks as up until your "far view distance". When set to false, only chunks within your normal view distance are saved.
  • DisableProgressLogging (default false): If set to true, the mod will stop spamming your server log with far region generation progress reports.

Before you try

 

  • This mod is experimental and not throughly tested. You may experience issues, crashes and other weird behaviour. If you do, please share in the comments or on the mod's GitHub Issues page.
  • It uses vanilla's built-in chunk generation system to build distant heightmaps, but in a slightly unorthodox way, which has potential to cause issues with some mods (none confirmed so far).
  • As a precaution, back up your save before installing the mod.

 

Known issues:

  • The mod will probably break on very small world sizes or at the very edges of a world.
  • The transition between real chunks and far terrain is ugly and the two can sometimes overlap.
  • The extra tax on worldgen can cause some chunk generation errors, but afaik nothing that permanently messes up your save.
    • There have been a few reports of corrupted chunks crashing the server with the mod installed - I cannot say for sure what causes the chunks to be corrupted, as that could be any mod - the reason the crash only happens with Farseer enabled is likely that Farseer is trying to access these broken chunks that are not normally visited.

What's next?

Highlights

From source data

Game versions

Supports 8 Vintage Story versions, the newest being 1.20.7.

Footprint

Rated a light load on a server.

Farseer 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 Farseer 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 catalog
Listed on Vintage Story ModDB as “Worldgen”

World generation

Changes or adds to how new terrain, biomes and structures are created.

Runs on your server

From source side support

Vintage Story ModDB lists Farseer 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.20.7 and 7 earlier

Verified at the source

  • ✓Vintage Story ModDBOfficial listing, checked 2026-09-24
  • ✓Authorbadgerson, as published on Vintage Story ModDB
  • ✓LicenseNot published by the sourceFree

Farseer, answered

Generated from the mod’s own source data.

Do my players need to install Farseer?

Vintage Story ModDB lists Farseer as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Is it free?

Yes. Farseer is free to download from Vintage Story ModDB.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Farseer on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add Farseer in one click.