movingblocks / terasology

Terasology - open source voxel world

Community | Installation | Development | License | Knowledge Base

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! We encourage contributions from anybody and try to keep a warm and friendly community and maintain a code of conduct.

Community

If you want to get in contact with the Terasology community and the whole MovingBlocks team, you can easily connect with us, share your ideas, report and solve problems. We are present in nearly the complete round-up of social networks. Follow/friend us wherever you want, chat with us and tell the world.

 

                             

Installation

	Minimum Requirements
System (OS)	Windows, MacOS, Linux (64 bit)
Processor (CPU)	dual-core CPU
Memory (RAM)	4 GB
Graphics* (GPU)	Intel HD Graphics (Gen 7) GeForce 8xxx series (or higher) or Radeon HD 2000 series (or higher) with OpenGL 3.3
Storage (HDD)	1 GB

* Please note, that if you have both integrated (chip) and dedicated (card) graphics, you should make sure that you're actually using your dedicated graphics when running Terasology.

Internet connectivity is required for downloading Terasology via the Launcher, afterwards playing offline is possible.

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

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

Alternative Installation Methods

If you already have a Java Development Kit (JDK) installed, you may use a direct download release as an alternative to using the launcher. Java version 17 is required.

ß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.

Development

Development is possible on all common platforms (Windows, Linux, MacOS) as long as the JDK is properly set up.

Requirements

Technical Requirements:

• Java SE Development Kit (JDK) 17. The CI will verify against this baseline version.
  Using newer Java versions may cause issues (see #3976).
• Git to clone the repo and commit changes.

Non-Technical Requirements:

• familiarity with Git. Have a look at https://learngitbranching.js.org/ if you're not familiar with Git yet.
• familiarity with GitHub, especially forks. Have a look at GitHub's "Working with Forks" Guide if you don't know how to work with forks yet.

Workspace Setup

To be able to run Terasology from source, you'll need to setup your workspace. Follow the Contributor Quick Start Guide. This guide is designed for IntelliJ IDEA (you can use the free community edition), but alternative setups are possible.

⚠️ Note, that a Terasology workspace is a multi-repo workspace.

While your workspace itself is a clone of MovingBlocks/Terasology, every subdirectory in your workspace directory ./modules/ is a clone of a Terasology module repo.

Accordingly, if you want to contribute to modules, you'll need to navigate into the respective subdirectory and work with Git from in there. Any Git commands executed in your workspace root will target MovingBlocks/Terasology.

For more information, see our wiki entry on Understanding Terasology's Git Setup.

Contributing

Detailed information on how to contribute can be found in CONTRIBUTING.md. Remember, that all submissions must be licensed under Apache License, Version 2.0.

Terasology has a rather steep learning curve in the beginning. To help you with the learning process, our Terasology Knowledge Base, formerly known as the Terasology Engine wiki, helps you find the resources you need according to the field of contribution you're interested in. Additional learning resources can be found in our tutorial modules.

If you find errors or issues in any of our resources, please report them using GitHub issues and help fix them.

For developers that have not worked with complex software systems or dealt with the intricacies of Java yet, we recommend to start with Good First Issues in Module Land.

Developers with previous experience in rendering, physics and other less trivial aspects of game development are welcome to give the Good First Issues in Engine a go.

License

Terasology is fully open source and licensed Apache License, Version 2.0 for code and Creative Commons Attribution License, Version 4.0 for artwork (unless indicated otherwise - see credits for minor exceptions).

terasology's Issues

Replace "float" with "double"

Optimize collision detection

Increase playability of the terrain

Fix that player's can spawn inside caves

Fix random slowdown

Add village/building generator(s)

Rewrite chunk file format

Optimize and extend particle system

Overhaul rendering architecture

Add a player model

Fix ice on top of water in the snow biome

Add main menu

Find a direction for the actual game

Chunks are very rarely not updated correctly

Optimze chunk file format

Add underwater shader

Fix choppy collision detection

BlueprintPrototyp Error

success = _parent.getGroovyManager().runGroovyShell(_consoleInput.toString()); // Line 102

Cannot resolve method getGroovyManager()

and

Blockmania.getInstance().initOpenGLParams(); // Line 108

Cannot resolve method initOpenGLParams();

Compose ambient music

Fix light updates when blocks are removed/created

Allow chunk generation in the area "x < 0" and "z < 0"

Add ambient music to the game

Add propagation of water and lava

Size and position of the chunk AABBs is not correct

Flying up and down gets much too fast

Add a sky animation (rising/setting sun and moon)

Add properties to blocks

Add swimming

Fix block flickering

GLSL chunk_vert.glsl shader broken

Just downloaded the latest build and tried running (it does), but that shader seems to have some issues and the entire landscape is just rendered in plain white...

Dec 2, 2011 4:34:55 PM com.github.begla.blockmania.rendering.manager.ShaderManager createShader
INFO: Loading shader chunk (chunk_vert.glsl, type = 35633)
Dec 2, 2011 4:34:55 PM com.github.begla.blockmania.rendering.manager.ShaderManager printLogInfo
INFO: ERROR: 0:11: 'array of 4-component vector of float' : constructor not supported for type
ERROR: 0:17: 'array of 4-component vector of float' : no matching overloaded function found
ERROR: 0:11: 'const' : non-matching types for const initializer
ERROR: 0:31: 'x' : field selection requires structure or vector on left hand side
ERROR: 0:31: 'y' : field selection requires structure or vector on left hand side
ERROR: 0:31: 'z' : field selection requires structure or vector on left hand side
ERROR: 0:31: 'w' : field selection requires structure or vector on left hand side
ERROR: 0:32: 'w' : field selection requires structure or vector on left hand side

System: OSX 10.6.8, MacBook Pro, i7, NVIDIA GeForce GT 330M

I remember there're some issues with const arrays and NVidia drivers, but don't have any details at hand...

Add water/lava animation

Make transition into water smoother

Add more complex trees

Add more different block types

Block light is sometimes not handled correctly

Implement 'unspreading' of light

Create an animation for harvesting blocks

The game slows down randomly

Extend the skybox

Rivers should overlap beaches

Add basic support for music and sound effects

Add an inventory

Add underground cave system

Add stars at night

Add network code

Put lava and water into separate VBOs

Update the terrain generator to produce more interesting terrain

Improve the game loop to be more failsafe

Billboards on water trick the tessellation

Lighting updates are sometimes off