Repository files navigation

TheTerasology 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.Thecreators 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 acode of conduct.

If you want to get in contact with theTerasology community and the wholeMovingBlocks 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.

*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 thededicated page or check out themodules.

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

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

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

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 athttps://learngitbranching.js.org/ if you're not familiar with Git yet.
• familiarity with GitHub,especially forks. Have a look atGitHub's "Working with Forks" Guide if you don't know how to work with forks yet.

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

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

While your workspace itself is a clone ofMovingBlocks/Terasology, every subdirectory in your workspace directory./modules/ is a clone of aTerasology 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 targetMovingBlocks/Terasology.

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

Detailed information on how to contribute can be found inCONTRIBUTING.md. Remember, that all submissions must be licensed underApache License, Version 2.0.

Terasology has a rather steep learning curve in the beginning.To help you with the learning process, ourTerasology 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 ourtutorial 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 withGood First Issues in Module Land.

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

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