Terasology - open source voxel world
Clone or download
Failed to load latest commit information.
.github Added link to How to Work on a PR Efficiently Mar 25, 2018
config Fix `@In` not properly marking variables as assigned May 22, 2018
docs Add FlexiblePathfinding, Kallisti and KComputers to the module lineup Aug 4, 2018
engine-tests Merge PR #3469 by @theobisproject - performance improvement Aug 17, 2018
engine Merge PR #3469 by @theobisproject - performance improvement Aug 17, 2018
facades Tweaks for #3327 plus add asie to credits Jun 10, 2018
fileTemplates Include javadoc stub in `System` file template Jul 3, 2018
gradle/wrapper Upgrade to Gradle 4.7 for Java 10 compatibility (version parsing issue) Jun 27, 2018
libs Move the dependency on the CrashReporter to the PC facade from the en… Jun 29, 2016
metas Missed a spot (meta/metas) Feb 19, 2018
modules Remove old useless fields from ui files Jul 13, 2018
openvr_natives Added jopenvrwrapper. Sep 11, 2016
protobuf/compiler Merge PRs #1423 by @msteiger and #1436 by @flo - library updates Dec 11, 2014
templates Engine v2 version bumps all over Feb 9, 2018
.gitattributes Remove executable file flag Oct 21, 2015
.gitignore Merge branch 'develop' into record_replay_release Jun 19, 2018
LICENSE Fill year and name placeholder in LICENSE file Jan 12, 2018
LICENSE_ARTWORK Remove some unnecessary wrapper text in the art license Jul 15, 2018
NOTICE Bump year in NOTICE. Jan 3, 2016
README.markdown added link to discord and to intellij download in readme Apr 24, 2018
build.gradle Gradle support for JNLua and its natives Aug 3, 2018
gradlew First small round of changes to Gradle/Groovy. Jun 16, 2017
gradlew.bat First small round of changes to Gradle/Groovy. Jun 16, 2017
groovyw Redirect groovyw execution to a new 'util.groovy' under 'config/groov… Feb 18, 2018
groovyw.bat Redirect groovyw execution to a new 'util.groovy' under 'config/groov… Feb 18, 2018
intellij-setup.bat Integrated various graphical tweaks. Aug 17, 2013
settings.gradle Change "meta" directory to "metas" for consistency (moduleS, libS, fa… Feb 18, 2018



Build Status Release Downloads Bounties License(code) License(art) Dependency Status IRC Channel


The Terasology project was born from a Minecraft-inspired tech demo and is becoming a stable platform for various types of gameplay settings in a voxel world.

The creators and maintainers are a diverse mix of software developers, designers, game testers, graphic artists, and musicians. We encourage others to join!

Terasology is fully open source and licensed Apache 2.0 for code and CC BY 4.0 for artwork (unless indicated otherwise - see credits for minor exceptions)

We encourage contributions from anybody and try to keep a warm and friendly community and maintain a code of conduct



Terasology requires Java 8 - download it here. Also make sure that your graphics card driver is up to date.

For easy setup (recommended) you can use our launcher - download it here

Direct download stable builds are uploaded to our release section here on GitHub while the cutting-edge develop version can be downloaded direct here from our Jenkins

For more information about playing like hot keys or server hosting see the dedicated page or check out the modules


We have gone to great lengths to make developing and modding Terasology as easy as possible. We use Gradle to automate just about everything. As long as you have a Java 8 SDK running from source is a two step process:

  • Clone the code or download a zip
  • Run gradlew game (on Unixes, including macOS, run ./gradlew everywhere you see gradlew) in the root of the project directory

That's really it! If you want the project set up in IntelliJ (our favored IDE) you run gradlew idea then load the generated project config. Then you get a bunch of run configurations and other stuff for free!

For more on developing/modding see the wiki