Mercator is primarily aimed at terrain for multiplayer online games and forms one of the WorldForge core libraries. It is intended to be used as a terrain library on the client, while a subset of features are useful on the server.

Mercator is designed in such a way that individual tiles can be generated on-the-fly from a very small source data set. Each tile uses a fast deterministic random number generation to ensure that identical results are produced "anytime, anywhere". This enables transmission of terrain across low bandwidth links as part of the standard data stream, or server side collision detection with the same terrain that the player sees.

The use of tiles means that there is inherently a large degree of gross control of the shape of the terrain. Finer control is implemented by allowing geometric modifications - for example, a polygonal area might be flattened, or a crater could be applied.


The latest development version of Mercator is 0.3.3. The API in the 0.3 series is not stable.
Source Code tar.gz
Source Code tar.bz2


Mercator depends on WFMath.

Height generation

Height Modifications



basic intersection/collision functions are implemented for

Current Limitations


As of August 2013 Mercator is implemented and in use in the Cyphesis server as well as the Ember and Sear clients.