Terasology - open source voxel world
Java GLSL Other
Latest commit 59df7ee Mar 22, 2017 @GabrielXia GabrielXia committed with oniatus Merge PR #2767 by @GabrielXia - Optional module dependencies solution…
… for issue #2754
Failed to load latest commit information.
.github i18n fixes for confirmChangePopup Oct 27, 2016
config Update copyright year in license header for IntelliJ. Feb 19, 2017
docs Add Parygind to credits. Mar 19, 2017
engine-tests Merge PR #2827 by @vampcat - rendering work. Mar 20, 2017
engine Merge PR #2767 by @GabrielXia - Optional module dependencies solution… Mar 22, 2017
facades Slight tweak to the new CrashReporter setup. Jan 29, 2017
gradle/wrapper Update gradle and gradle plugins Dec 31, 2015
libs Move the dependency on the CrashReporter to the PC facade from the en… Jun 29, 2016
meta Assorted Gradle cleanup and utility changes Nov 8, 2014
modules Version bump to next snapshot Mar 20, 2017
openvr_natives Added jopenvrwrapper. Sep 11, 2016
protobuf/compiler Merge PRs #1423 by @msteiger and #1436 by @flo - library updates Dec 11, 2014
templates Tiny adjustments. Nov 17, 2016
.gitattributes Remove executable file flag Oct 21, 2015
.gitignore Fix NUI editor issues Jan 30, 2017
LICENSE Removed file extensions Oct 11, 2012
LICENSE_ARTWORK Additional license clarifications and full text for CC BY 4.0. Addres… Sep 27, 2016
NOTICE Bump year in NOTICE. Jan 3, 2016
README.markdown Update README.markdown Nov 26, 2016
build.gradle Utility: Include a template override.cfg that is used by default by t… Oct 22, 2016
gradlew Update to Gradle 2.10 Dec 31, 2015
gradlew.bat More work on #68, can't resist. Adds the Gradle Wrapper so users can … Mar 10, 2012
intellij-setup.bat Integrated various graphical tweaks. Aug 17, 2013
settings.gradle Fix for #1085 - modules not correctly being disabled at the end of a … Apr 28, 2014



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 Mac OS X, 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