{"id":15132717,"url":"https://github.com/movingblocks/terasology","last_synced_at":"2025-04-29T18:40:14.641Z","repository":{"id":37850243,"uuid":"1438007","full_name":"MovingBlocks/Terasology","owner":"MovingBlocks","description":"Terasology - open source voxel world","archived":false,"fork":false,"pushed_at":"2024-12-17T03:41:08.000Z","size":305766,"stargazers_count":3712,"open_issues_count":473,"forks_count":1345,"subscribers_count":184,"default_branch":"develop","last_synced_at":"2025-04-10T00:10:30.411Z","etag":null,"topics":["game","game-development","game-engine","game-engine-3d","gamedev","hacktoberfest","java","sandbox","voxel"],"latest_commit_sha":null,"homepage":"http://terasology.org","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MovingBlocks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":"docs/Supported-Development-Workflows.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2011-03-04T03:49:19.000Z","updated_at":"2025-04-09T21:01:38.000Z","dependencies_parsed_at":"2023-10-01T18:24:41.129Z","dependency_job_id":"b6e2637c-9262-45c3-a221-e14b408b0e66","html_url":"https://github.com/MovingBlocks/Terasology","commit_stats":null,"previous_names":[],"tags_count":79,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MovingBlocks%2FTerasology","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MovingBlocks%2FTerasology/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MovingBlocks%2FTerasology/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MovingBlocks%2FTerasology/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MovingBlocks","download_url":"https://codeload.github.com/MovingBlocks/Terasology/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251561392,"owners_count":21609395,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game","game-development","game-engine","game-engine-3d","gamedev","hacktoberfest","java","sandbox","voxel"],"created_at":"2024-09-26T04:22:37.853Z","updated_at":"2025-04-29T18:40:14.619Z","avatar_url":"https://github.com/MovingBlocks.png","language":"Java","funding_links":["https://www.patreon.com/Terasology"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"./docs/images/terasology-logo.png\" height=400px/\u003e\u003c/\u003e\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://github.com/MovingBlocks/Terasology/releases/latest\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/release/MovingBlocks/Terasology.svg\" alt=\"Release\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.apache.org/licenses/LICENSE-2.0\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/license(code)-Apache%202.0-blue.svg\" alt=\"License (Code)\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://creativecommons.org/licenses/by/4.0/\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/license(art)-CC%20BY%204.0-blue.svg\" alt=\"License (Art)\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://codeclimate.com/\" target=\"_blank\" alt=\"Code climate\"\u003e\n        \u003cimg src=\"https://img.shields.io/codeclimate/maintainability/MovingBlocks/Terasology\" alt=\"Code climate maintainability\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://codeclimate.com/\" target=\"_blank\" alt=\"Code climate\" \u003e\n        \u003cimg src=\"https://img.shields.io/codeclimate/tech-debt/MovingBlocks/Terasology\" alt=\"Code climate tech debt\" /\u003e\n    \u003c/a\u003e\n     \u003ca href=\"https://codeclimate.com/\" target=\"_blank\" alt=\"Code climate\"\u003e\n        \u003cimg src=\"https://img.shields.io/codeclimate/issues/MovingBlocks/Terasology\" alt=\"Code climate issues\" /\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n\u003ch3 align=\"center\"\u003e\u003cb\u003e\n    \u003ca href=\"#community\"\u003eCommunity\u003c/a\u003e | \n    \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e | \n    \u003ca href=\"#development\"\u003eDevelopment\u003c/a\u003e  | \n    \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e |\n    \u003ca href=\"https://terasology.org/Terasology/#/\"\u003eKnowledge Base\u003c/a\u003e\n\u003c/b\u003e\u003c/h3\u003e\n\nThe _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.\nThe [creators and maintainers](https://github.com/MovingBlocks/Terasology/graphs/contributors) are a diverse mix of software developers, designers, game testers, graphic artists, and musicians. We encourage others to join!\nWe encourage contributions from anybody and try to keep a warm and friendly community and maintain a [code of conduct](.github/CODE_OF_CONDUCT.md).\n\n## Community\n\nIf 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.\nWe are present in nearly the complete round-up of social networks. Follow/friend us wherever you want, chat with us and tell the world.\n\n\u0026nbsp;\n\n\u003cp align=\"center\"\u003e\n    \u003ca title=\"Discord\" href=\"https://discord.gg/terasology\"\u003e\n        \u003cimg src=\"./docs/images/discord.png\" width=\"48px\"/\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003ca title=\"Twitter\" href=\"https://twitter.com/Terasology\"\u003e\n    \u003cimg src=\"./docs/images/twitter.png\" width=\"48px\"/\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003ca title=\"Facebook\" href=\"https://www.facebook.com/Terasology\"\u003e\n        \u003cimg src=\"./docs/images/facebook.png\" width=\"48px\"/\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003ca title=\"Reddit\" href=\"https://www.reddit.com/r/Terasology\"\u003e\n        \u003cimg src=\"./docs/images/reddit.png\" width=\"48px\"/\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003ca title=\"Youtube\" href=\"https://www.youtube.com/user/blockmaniaTV\"\u003e\n        \u003cimg src=\"./docs/images/youtube.png\" width=\"48px\"/\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003ca title=\"Patreon\" href=\"https://www.patreon.com/Terasology\"\u003e\n        \u003cimg src=\"./docs/images/patreon.jpg\" width=\"48px\"/\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003ca title=\"Terasology Forum\" href=\"https://forum.terasology.org\"\u003e\n        \u003cimg src=\"./docs/images/forum.png\" width=\"48px\"/\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n## Installation\n\n\u003ctable\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e\u003c/td\u003e\n        \u003cth\u003eMinimum Requirements\u003c/th\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003eSystem (OS)\u003c/td\u003e\n        \u003ctd\u003eWindows, MacOS, Linux (64 bit)\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003eProcessor (CPU)\u003c/td\u003e\n        \u003ctd\u003edual-core CPU\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003eMemory (RAM)\u003c/td\u003e\n        \u003ctd\u003e4 GB\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003eGraphics* (GPU)\u003c/td\u003e\n        \u003ctd style=\"vertical-align:top\"\u003e\n            Intel HD Graphics (Gen 7)\u003cbr/\u003e\n            GeForce 8xxx series (or higher) or\u003cbr/\u003e\n            Radeon HD 2000 series (or higher)\u003cbr/\u003e\n            with OpenGL 3.3\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003eStorage (HDD)\u003c/td\u003e\n        \u003ctd\u003e1 GB\u003c/td\u003e\n    \u003c/tr\u003e\n\u003c/table\u003e\n\n\\* _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._\n\nInternet connectivity is required for downloading Terasology via the Launcher, afterwards playing offline is possible.\n\nFor easy game setup (recommended) you can use our launcher - [download it here](https://terasology.org/downloads/).\n\nFor more information about playing, like hot keys or server hosting, see the [dedicated page](docs/Playing.md) or check out the [modules](docs/Modules.md).\n\n\n### Alternative Installation Methods\n\nIf you already have a Java Development Kit (JDK) installed, you may use a direct download release as an alternative to using the [launcher](https://github.com/MovingBlocks/TerasologyLauncher/releases). Java version 17 is required.\n\nßDirect download stable builds are uploaded to [our release section here on GitHub](https://github.com/MovingBlocks/Terasology/releases) while the cutting-edge develop version can be downloaded direct [here from our Jenkins](https://jenkins.terasology.io/job/Terasology/job/Omega/job/develop/lastSuccessfulBuild/artifact/distros/omega/build/distributions/TerasologyOmega.zip).\n\n\n## Development\n\nDevelopment is possible on all common platforms (Windows, Linux, MacOS) as long as the JDK is properly set up.\n\n### Requirements\n\nTechnical Requirements:\n- Java SE Development Kit (JDK) 17. The CI will verify against this baseline version.\n  \u003cbr\u003eUsing newer Java versions may cause issues (see [#3976](https://github.com/MovingBlocks/Terasology/issues/3976)).\n- Git to clone the repo and commit changes.\n\nNon-Technical Requirements:\n- familiarity with Git. Have a look at https://learngitbranching.js.org/ if you're not familiar with Git yet.\n- familiarity with GitHub, _especially forks_. Have a look at [GitHub's \"Working with Forks\" Guide](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks) if you don't know how to work with forks yet.\n\n### Workspace Setup\n\nTo be able to run **Terasology** from source, you'll need to setup your workspace.\nFollow the [Contributor Quick Start Guide](https://terasology.org/Terasology/#/Contributor-Quick-Start).\nThis guide is designed for [IntelliJ IDEA](https://www.jetbrains.com/idea/) (you can use the free community edition), but alternative setups are possible.\n\n\u003e :warning: _Note, that a Terasology workspace is a **multi-repo workspace**._\n\nWhile your workspace itself is a clone of [MovingBlocks/Terasology](https://github.com/MovingBlocks/Terasology), every subdirectory in your workspace directory `./modules/` is a clone of a [Terasology module repo](https://github.com/Terasology).\n\nAccordingly, if you want to contribute to modules, you'll need to navigate into the respective subdirectory and work with Git from in there.\nAny Git commands executed in your workspace root will target [MovingBlocks/Terasology](https://github.com/MovingBlocks/Terasology).\n\nFor more information, see our wiki entry on [Understanding Terasology's Git Setup](https://terasology.org/Terasology/#/Developing-Modules?id=understanding-terasology39s-git-setup).\n\n\n### Contributing\n\nDetailed information on how to contribute can be found in [CONTRIBUTING.md](.github/CONTRIBUTING.md). Remember, that all submissions must be licensed under [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).\n\nTerasology has a rather steep learning curve in the beginning.\nTo help you with the learning process, our [Terasology Knowledge Base](https://terasology.org/Terasology/#/), formerly known as the Terasology Engine wiki, helps you find the resources you need according to the field of contribution you're interested in.\nAdditional learning resources can be found in our [tutorial modules](https://github.com/Terasology?q=Tutorial\u0026type=all\u0026language=\u0026sort=).\n\nIf you find errors or issues in any of our resources, please report them using GitHub issues and help fix them.\n\nFor 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](https://github.com/search?l=\u0026q=org%3ATerasology+label%3A%22Good+First+Issue%22+state%3Aopen\u0026state=open\u0026type=Issues).\n\nDevelopers with previous experience in rendering, physics and other less trivial aspects of game development are welcome to give the [Good First Issues in Engine](https://github.com/MovingBlocks/Terasology/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22Good+First+Issue%22) a go.\n\n## License\n\nTerasology is fully open source and licensed [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0) for code and [Creative Commons Attribution License, Version 4.0](https://creativecommons.org/licenses/by/4.0/) for artwork (unless indicated otherwise - see credits for minor exceptions).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmovingblocks%2Fterasology","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmovingblocks%2Fterasology","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmovingblocks%2Fterasology/lists"}