Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
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…
Java Groovy Other

This branch is 4 commits ahead, 3801 commits behind MovingBlocks:develop

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
applet
blender_addons/io_mesh_terasology
groovy/blocks
integration/org/terasology/rendering/primitives
libs
natives
protobuf
rawMesh/blockShape
scripts
src/org/terasology
tests/org/terasology
.gitignore
LICENSE.txt
README.markdown
build.gradle

README.markdown

Terasology (previously titled Blockmania)

Terasology

Terasology is a game that pays ample tribute to Minecraft in initial look and origin, but stakes out its own niche by adopting the NPC-helper and caretaker feel 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. After proving itself as a solid tech demo begla was joined at first by Anton "small-jeeper" Kireev and Rasmus "Cervator" Praestholm and a full-fledged game concept was born.

The creators of Terasology are a diverse mix of software developers, game testers, graphic artists, and musicians. Get involved by checking out the Forum, 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.

Setup

Terasology requires the latest version of Oracle's Java Virtual Machine (JVM). Also make sure that your graphics card driver is up to date.

You can use one of the default launch scripts to start the game. The scripts will setup your JVM to allocate up to 1024 MB of heap space. Under Linux and Mac OS X the run script needs the access permission "Execute" to run properly: "chmod +x script.sh".

Controls

  • [W,A,S,D] Walking
  • [Space] Jump
  • [Shift] Hold for running
  • [Left click] Activate left click action (default = place block)
  • [Right click] Activate right click action (default = remove block)
  • [Mouse wheel up/down] Cycle through toolbar slots
  • [1,..,0] Change the active toolbar slot
  • [I] Toggle inventory screen
  • [F] Toggle viewing distance (near, moderate, far, ultra)
  • [Tab] Toggle developer console
  • [F3] Toggle debug mode and information
  • [F4] Different debug metrics
  • [2*Space] God mode
  • [K] Don't try this :-)
  • [Escape] Show/hide the game menu screen

Debug features (only works when debug mode is enabled

  • [Arrow up/down] Adjust the current time in small steps
  • [P] Activate first-person player camera
  • [O] Activate animated spawning point camera

Examples tools (may move slot or disappear)

  • Torch - shiny! Place with left click
  • Pickaxe / shovel - faster right-click removal of some blocks
  • Blueprint - left click one block, then another, then somewhere else to "clone" your selection (right-click resets)
  • Lighter - big bada boom!

Example console commands

  • cmd.giveBlock "Water" Gives 16 water blocks
  • cmd.giveBlock "Water", 42 Gives 42 water blocks
  • cmd.teleport 42, 42, 42 Warps the player to x = 42, y = 42, z = 42
  • cmd.fullHealth Fully restores the player's health
  • cmd.gotoWorld "GhostTown" Loads the world "GhostTown" if present, otherwise initializes a new world "GhostTown" with a randomized seed value
  • cmd.gotoWorld "GhostTown", "Pie!" Loads the world "GhostTown" if present, otherwise initializes a new world "GhostTown" with the seed value "Pie!"

Building and running source

  1. Install Gradle from http://gradle.org/
  2. To import into Eclipse: $ gradle eclipse
  3. To import into IntelliJ: $ gradle idea
  4. To run from the command line: $ gradle run
  5. For more tasks: $ gradle tasks

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

Credits

This is an incomplete list and the team is constantly growing. See Dev Team in the wiki for the latest updates

Contributors

  • Benjamin "begla" Glatzel
  • Anton "small-jeeper" Kireev
  • Rasmus "Cervator" Praestholm
  • Immortius
  • Richard "rapodaca" Apodaca
  • Kai Kratz
  • t3hk0d3

Soundtrack and Sound Effects

  • Sunrise, Afternoon and Sunset composed by Karina Kireev.
  • Dimlight, Resurface and Other Side composed and produced by Exile.
  • 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.