Gui

Install

Using pip

# Currently not yet released on pypi, you may want to still use Lands or WorldSynth
# or alternatively download the source
pip install worldengine

From source code

git clone or download the code
# before using worldengine: if you plan to change the code
python setup.py develop
# before using worldengine: if you want just to install worldengine
# on unix-ish system you could have to prepend sudo
python setup.py install

On Windows

If you want to install Worldengine on Windows you can read these instructions.

Executable file is also available under releases, but is currently out of date.

Note: you need also a copy of the worldengine src directory in the same folder as the exe.

Dependencies

The gui is based on QT, so you will need to install them

Output

The program produces a binary format with all the data of the generated world and a set of images. For examples seed 1 produces.

Elevation Map

Precipitation Map

Temperature Map

Biome Map

Ocean Map

Usage

worldengine [options] [world|plates|ancient_map|info]

Note that options were changed in version 0.5.3

General options

Short

Long

Description

-o DIR

--output-dir=DIR

generate files in DIR default = '.'

-n STR

--worldname=STR

set world name to STR

-b

--protocol-buffer

save world using protocol buffer format (smaller file)

-s N

--seed=N

use SEED to initialize the pseudo-random generation

-t STR

--step=STR

use STEP to specify how far to proceed in the world generation process. Valid values are: plates precipitations full

-x N

--width=N

WIDTH of the world to be generated

-y N

--height=N

HEIGHT of the world to be generated

-q N

--number-of-plates=N

number of plates

--recursion-limit=N

you need that just if you encounter an error while generating very large maps

-v

--verbose

Enable verbose messages

--bw

--black-and-white

Draw maps in black and white

Options valid only for generate

Short

Long

Description

-r FILE

--rivers=FILE

produce a map of reivers, after the option it expects the name of the file where to generate the map

--gs=FILE

--grayscale-heightmap=FILE

produce a grayscale heightmap, after the option it expects the name of the file where to generate the heightmap

Requirements

Contributors

All contributions, questions, ideas are more than welcome!
Feel free to open an issue or write in our google group.

We would like to thank you great people who helped us while working on WorldEngine and the projects from which it was derived:

Evan Sampson contributed the amazing implementation of the Holdridge life zones model and improved a lot the ancient-looking-map, biome, precipitation and temperature generators. Thanks a million!

Ryan contributed the Windows binary version and discussed Lands on Reddit bringing a lot of users. Thanks a million!

stefan-feltmann made Lands depends on pillow instead that on PIL (which is deprecated). This could also help when moving to Python 3. Thanks a million!

Russell Brinkmann helped saving the generation parameters in the generated world (so that we can use it to generate the same world again, for example), improved the command line options and added tracing information (useful for understanding the performance of the various generation steps)

License

WorldEngine is available under the MIT License. You should find the LICENSE in the root of the project.