Skip to content
This repository

Terasology is an open source project started by Benjamin "begla" Glatzel to research procedural terrain generation and efficient rendering techniques in Java using the LWJGL. The engine uses a block-based voxel-like approach as seen in Minecraft. After proving itself as a solid tech demo begla was joined at first by Anton "small-jeeper" Kireev a…

Octocat-spinner-32 config Go back to Terasology & MovingBlocks values again instead of Nanoware… April 12, 2014
Octocat-spinner-32 engine-tests Go back to Terasology & MovingBlocks values again instead of Nanoware… April 12, 2014
Octocat-spinner-32 engine
Octocat-spinner-32 facades Tweaks to headless Gradle config PR #1067 - activates modules in the … April 17, 2014
Octocat-spinner-32 gradle Gradle update from 1.8 to 1.10 January 30, 2014
Octocat-spinner-32 modules Make modules look for the very latest snapshot versions from Artifact… April 14, 2014
Octocat-spinner-32 protobuf Updated protobuf and netty. May 11, 2013
Octocat-spinner-32 templates Assorted fixes and tweaks after feedback December 28, 2013
Octocat-spinner-32 .gitattributes Add forced default for text type files when it comes to Git and line … December 15, 2013
Octocat-spinner-32 .gitignore Add a Gradle task to run a local headless server, with data stored in… February 06, 2014
Octocat-spinner-32 LICENSE Removed file extensions October 11, 2012
Octocat-spinner-32 NOTICE Updated NOTICE March 07, 2014
Octocat-spinner-32 README.markdown Update readme for stable build - more of a checkpoint release before … April 13, 2014
Octocat-spinner-32 build.gradle Change the protobuf compile task name so the "run" abbreviation works… April 13, 2014
Octocat-spinner-32 gradlew Gradle update from 1.8 to 1.10 January 30, 2014
Octocat-spinner-32 gradlew.bat More work on #68, can't resist. Adds the Gradle Wrapper so users can … March 09, 2012
Octocat-spinner-32 intellij-setup.bat Integrated various graphical tweaks. August 17, 2013
Octocat-spinner-32 settings.gradle Another pile of structural changes mostly related to unit testing December 25, 2013



Terasology is a game that pays ample tribute to Minecraft in initial look and origin, but stakes out its own niche by aiming for the NPC-helper and caretaker focus from such games as Dwarf Fortress and Dungeon Keeper, while striving for added depth and sophistication.

Terasology is an open source project started by Benjamin "begla" Glatzel to research procedural terrain generation and efficient rendering techniques in Java using the LWJGL. The engine uses a block-based voxel-like approach as seen in Minecraft.

The creators of Terasology are a diverse mix of software developers, game testers, graphic artists, and musicians. Get involved by checking out our Community Portal, our blog Moving Blocks!, and our Facebook Page.

Terasology is licensed under the Apache 2.0 License and available in source code form at GitHub.


Terasology requires Java 7, the newer the better - download it here. Also make sure that your graphics card driver is up to date.

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

For direct downloads you can get the latest stable version here or our cutting-edge develop version here from our Jenkins

You can use the Windows executable or one of the default launch scripts to start the game. They will setup your Java Virtual Machine to allocate up to 1024 MB of memory. Under Linux and Mac OS X the run script needs the access permission "Execute" to run properly: "chmod +x [scriptname].sh".


Note: Keys between the latest stable and latest develop build may differ.

  • [W,A,S,D] - Movement
  • [E] - Activate (Chest, TNT, etc)
  • [Q] - Throw held (block) item (hold down to charge for a longer throw!)
  • [Space] - Jump
  • [Shift] - Hold to run
  • [Left click] - Activate left click action (default = remove block)
  • [Right click] - Activate right click action (default = place block)
  • [Mouse wheel up/down] - Cycle through toolbar slots OR pick up / deposit items into stacks in an inventory one at a time
  • [1..0] - Change the active toolbar slot
  • [I] - Toggle inventory screen
  • [H] - Hide user interface
  • [HOME] - Toggle viewing distance
  • [`] - Toggle developer console (the "grave" key, above tab)
  • [Tab] - Auto-completion in the console
  • [Escape] - Show/hide the game menu screen
  • [F1] - Toggle window focus
  • [F3] - Toggle debug mode and information
  • [F5] - Show behavior tree editor
  • [F5] - Show block picker GUI element

Debug Features

Only works when the F3 debug mode is enabled (and may come and go)

  • [Arrow up/down] - Adjust the current time in small steps
  • [Arrow left/right] - Adjust the current time in larger steps
  • [R] - Debug render wire-frame
  • [F4] - Cycle advanced debug metrics
  • [F6] - Debug rendering enabled
  • [F7] - Cycle debug rendering stage
  • [F8] - Debug render chunk bounding boxes


May move slot or disappear as development continues

  • Axe / Pickaxe - Faster right-click removal of some blocks
  • Torch - Shiny! Place with left click. Try throwing these in water at night
  • Explosion tool - Big bada boom!
  • Railgun - Bigger bada boom, in a straight line!
  • Minituarizer (scissors) - Left click one block, then another, then somewhere else to "clone" your selection in a tiny accurate representation
  • Goodie chest - place it and open with 'e' for assorted goodies

More or completely alternative line-ups with certain modules / world types selected

Console Commands

Press the grave key (usually the ony immediately above tab) to show the in-game console. Block names and some other things are not capital sensitive while command names are. Copy paste is supported and up/down arrow will cycle through commands you've used before. Hitting tab with a partially typed command will auto-complete it (including abbreviated camel case like lS for listShapes). For partial commands with multiple completion candidates you can tab again to cycle through them.

  • help - Show in-game help (more thorough)
  • ghost - fly / no-clip mode (old double-jump for "god" mode)
  • hspeed - radically increase your horizontal move speed
  • hjump - jump really high. Almost like flying - but it isn't. Just jump good.
  • restoreSpeed - normalizes speed (both horizontal and vertical)
  • help "giveBlock" - Shows detailed help on the "giveBlock" command
  • giveBlock "Water" - Gives 16 water blocks
  • giveBlock "Stone" "Stair" 99 - Gives you 99 stone stair blocks
  • giveBlock "Chest" - Gives you a Chest block you can place, activate ('E'), put stuff in, break, pick up, place elsewhere, find same stuff in it!
  • giveBlock "TNT" - Gives you 16 TNT blocks you can place and activate ('E') to blow up
  • listBlocks - Lists all actively used blocks (have been loaded for the world)
  • listFreeShapeBlocks - Lists all blocks that can be requested in any known shape
  • listShapes - Lists the available shapes
  • teleport 42 42 42 - Warps the player to x = 42, y = 42, z = 42
  • fullHealth - Fully restores the player's health

Building and running from source

Run any commands in the project root directory

  • Download / clone the source from GitHub
  • To prepare for IntelliJ run: gradlew idea
  • To prepare for Eclipse run: gradlew eclipse
  • To run from the command line: gradlew run
  • For more tasks: gradlew tasks

You may also need to tweak IDE settings further for your convenience, in particular for Eclipse. See Dev Setup in our wiki for more details.

Note that by default stored data (config, saves, etc) is sent to a user profile directory like Saved Games under Windows. Add -homedir to a run configuration or command line execution to use the project dir instead (this is done automatically in some cases including IntelliJ and gradlew run)

If you want to pull down the source code for a module you can easily do so via Gradle:

  • gradlew fetchModuleSample
  • gradlew idea

This fetches the module source for the "Sample" module and the second command fetches any dependencies and updates the IntelliJ project structure so you can see it as a module. Likewise for Eclipse or any other setup you should run any one gradlew command to make sure the new module's dependencies have been fetched as well. See Codebase Structure in the wiki for more.


Content, gameplay mechanics, and mostly everything other than the engine that allows the game to run is stored in what we call "modules" which are similar to the traditional meaning of "mods" but intended to be smaller building blocks you'd normally put several of together to make one true "mod".

Modules must be enabled during world creation by selecting them using the "Modules" button. Some world generator types may be registered by a module and auto-select that and maybe other modules if you choose that world type. Modules may also enable additional console commands (listed by the "help" command when active).

Here's a list of modules bundled with the game by default (as of this writing anyway - this line-up will change now and then). It should roughly match this category in Jenkins: and you can download updated modules from there if needed.

  • AlterationEffects - module for storing some buff/debuff type effects
  • AnotherWorld - world gen module, includes features like ore placement and caves, used by WoodAndStone's world
  • BlockNetwork - a framework to support blocks that can communicate with each other in some fashion
  • CakeLie - the cake may be a lie, but these cake and candy blocks are delicious!
  • ChangingBlocks - allows blocks that change over time (like crops that grow - which will happen if you also enable Crops)
  • Cities - procedural city placer and plot organizer, also places roads to connect cities
  • CopperAndBronze - another era for throughout the ages, this time copper and bronze (comes after wood and stone)
  • Core - mandatory content needed for normal game launch
  • Crops - a series of crop-like plants with multiple growth stages
  • Fences - fences!
  • Fluid - adds support for fluid in non-world situations (such as for storage in workstations)
  • FunnyBlocks - cheese wheels and bowling pins - why not
  • Genome - genetics WOO! Complete with DNA letters and mutating plants. Part of the Wood & Stone line-up
  • GrowingFlora - organically growing (step by step) trees and such
  • Hunger - makes the player slowly gets hungry (needs actual GUI work and ways to then actually eat food though). Console hungerCheck for stats
  • Journal - allows the player to use an in-game journal for gameplay notifications and such
  • LightAndShadow - main module for the Light & Shadow gameplay
  • LightAndShadowResources - IMMA FIRIN’ MAH LASR!! Art assets for the Light & Shadow concept
  • Malicious - a series of module security tests to check that modules cannot do naughty things when running
  • MasterOfOreon - Master the Oreons, or others like them, from the throne-world of the Ancients! A menu command system
  • Maze - a maze generator. Right-click with the provided maze tool on one block then again on another and a maze will generate between the two points (in multiple layers if the area is tall enough)
  • Minerals - a large collection of mineral blocks
  • Miniion - base creature control system, used by MasterOfOreon - old module that has gone through a few redesigns
  • Minimap - a basic minimap using "slicing" (showing a single layer at a time as per a selected axis)
  • MoreLights - assorted illuminated blocks
  • MultiBlock - supports the concept of multiple blocks being part of the same structure
  • NameGenerator - can create random themed names for use by other modules, or via console using commands like generateNameList 10
  • Oreons - little sentient cookie people! Don't do much yet. Place with spawnPrefab "Oreons:OreonGuard" in the console
  • Pathfinding - framework for pathfinding used by other modules
  • PlantPack - more plants! Used by the Wood and Stone gameplay
  • Portals - allows placement of portal blocks that'll spawn Oreons giveBlock "portal"
  • Sample - miscellaneous example content showcasing module usage
  • Signalling - circuitry implementation based on BlockNetwork, similar to redstone
  • Soils - a small pack of different soil types
  • Spawning - split out from Portals to serve as general utility for anything needing stuff to spawn
  • StructuralResources - a set of structural shapes suitable for buildings and such
  • WoodAndStone - big gameplay module featuring "from scratch" crafting throughout the ages - wood here
  • Workstation - workstations offer a way to use blocks in-world for advanced purposes
  • Zones - allows you to define zones within the world, that other modules can then use for assorted reasons

Some of the modules in action:



This is an incomplete list and the team is constantly growing. See also Dev Team in the wiki but at least one of them is bound to be out of date

Apologies in advance for any omissions, contact Cervator on the forum if you believe you've been missed :-)


(Listed by primary team)

  • Architects: Benjamin 'begla' Glatzel, Immortius, Kai Kratz, Andre Herber, Panserbjoern, MarcinSc, Synopia, Xanhou, mkienenb
  • Art Team: Glasz, A'nW, basilix, Double_A, eleazzaar, metouto, Perdemot, RampageMode, SuperSnark, Wolfghard, zproc, Chrisk, Maternal
  • Design Team: Rasmus 'Cervator' Praestholm, Overdhose, Woodspeople, Mooncalf, Dei, UberWaffe, Chridal
  • General: Janred, Josh, Stuthulhu, t3hk0d3, AbraCadaver, ahoehma, Brokenshakles, DizzyDragon, esereja, NowNewStart, pencilcheck, sdab, hagish, Philius342, temsa, nitrix, R41D3NN, Aperion, ilgarma, mcourteaux, philip-wernersbach, Xeano, Jamoozy, sdab, zriezenman, NanjoW, SleekoNiko, Eliwood, nh_99, jobernolte, emenifee, socram8888, dataupload, UltimateBudgie, maym86, aldoborrero, PrivateAlpha, CruzBishop, JoeClacks, Nate-Devv
  • GUI Team: Anton "small-jeeper" Kireev, miniME89, x3ro
  • Logistics Team: AlbireoX, Mathias Kalb, Richard "rapodaca" Apodaca, Stellarfirefly, mkalb, MrBarsack, Philaxx, 3000Lane, MiJyn, neoascetic
  • World Team: bi0hax, ddr2, Nym Traveel, Skaldarnar, Tenson, Laurimann, MPratt, msteiger, Josharias

Soundtrack and Sound Effects

  • Primary soundtrack by ChrisK -
  • Sunrise, Afternoon and Sunset composed by Karina Kireev.
  • Dimlight, Resurface and Other Side composed and produced by Exile.
  • Door Open sound by Pagancow, from
  • Door Close sound by Fresco, from
  • Camera Click Noise from Snapper4298, from
  • Other sound effects created by Exile.

Additional Notes

Terasology's base graphics use the awesome Good Morning Craft! texture pack by Louis Durrant. Make sure to visit his homepage and support his work.

Something went wrong with that request. Please try again.