User Tools

Site Tools



Mapcraft - Fantasy map designer

WorldGen - SciFi universe generator

Mapcraft Web - Web based fantasy map designer

All code for the project is released under the GPL, and is copyright Samuel Penn.

The text on this wiki is dual licensed CC-BY-SA and GPL.

You can contact the author at


User Guide

This is currently a very brief note on how to use the software, from a developer's point of view. Recently, a complete re-work of the back end has been started, to clean up the code and make it a bit more maintainable. Originally, worlds were very simple and a lot of extra stuff has been added which wasn't initially expected.

The old code still exists, but there is a new parallel package structure under which mirrors the structure.

Creating Sectors

Main class:

This defines the creation of new sectors and populating with star systems. Since a sector consists of 'hexes', each of which contains zero or one star systems, all this cares about is if a hex contains a star system or not.

Creation of each star system is completely independent, and is handled by StarSystemGenerator.

A sector can be created from:

  • Completely random die roll.
  • UWP data.
  • Bit maps which define density and possibly allegiance.

See Data Import for the last two. Support for these is currently only in the old code base.

Creating Systems

Main class:

Creates individual star systems. How this is done is being completely revamped and simplified. The plan for UWP import is to ignore most of the UWP data. Name and allegiance will be kept, as well as base information. Minimal population information will be taken (e.g., possibly star port only).

Star information will be ignored.

Creating Worlds

Main class:

Always called from StarSystemGenerator. The main work has been shifted into a class for each world type, which are all subclasses of the PlanetBuilder class.

A PlanetBuilder manages everthing about world creation, from radius and atmosphere, to resources, text descriptions and map drawing. This puts everything for a particular world type in one place making it easier to manage.

worldgen/user_guide.txt · Last modified: 2015/02/04 22:39 (external edit)