{"id":13794767,"url":"https://github.com/DigitalExtinction/Game","last_synced_at":"2025-05-12T21:32:29.287Z","repository":{"id":61228622,"uuid":"474391338","full_name":"DigitalExtinction/Game","owner":"DigitalExtinction","description":"A 3D RTS game implemented in Rust.","archived":false,"fork":false,"pushed_at":"2024-09-03T22:25:28.000Z","size":2525,"stargazers_count":315,"open_issues_count":153,"forks_count":25,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-11-11T16:03:44.457Z","etag":null,"topics":["3d","3d-game","bevy","bevy-engine","game","game-development","gamedev","games","linux-gaming","real-time-strategy","rts","rts-game","rust"],"latest_commit_sha":null,"homepage":"https://de-game.org","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DigitalExtinction.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"Indy2222"}},"created_at":"2022-03-26T15:42:00.000Z","updated_at":"2024-11-10T11:44:10.000Z","dependencies_parsed_at":"2024-07-23T09:26:21.119Z","dependency_job_id":null,"html_url":"https://github.com/DigitalExtinction/Game","commit_stats":{"total_commits":508,"total_committers":4,"mean_commits":127.0,"dds":"0.017716535433070835","last_synced_commit":"9f10f9286ab5f98467b9bb82a21eb2e8c93f6061"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalExtinction%2FGame","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalExtinction%2FGame/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalExtinction%2FGame/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitalExtinction%2FGame/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DigitalExtinction","download_url":"https://codeload.github.com/DigitalExtinction/Game/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224855037,"owners_count":17380956,"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":["3d","3d-game","bevy","bevy-engine","game","game-development","gamedev","games","linux-gaming","real-time-strategy","rts","rts-game","rust"],"created_at":"2024-08-03T23:00:47.560Z","updated_at":"2024-11-18T09:31:09.835Z","avatar_url":"https://github.com/DigitalExtinction.png","language":"Rust","funding_links":["https://github.com/sponsors/Indy2222"],"categories":["Open Source Projects","Prototypes"],"sub_categories":[],"readme":"# Digital Extinction\n\n[![AGPLv3](https://img.shields.io/badge/license-AGPLv3-088F8F.svg)](https://github.com/DigitalExtinction/Game#license)\n[![CI](https://github.com/DigitalExtinction/Game/actions/workflows/test.yml/badge.svg)](https://github.com/DigitalExtinction/Game/actions/workflows/test.yml)\n[![Sponsors](https://img.shields.io/github/sponsors/Indy2222)](https://github.com/sponsors/Indy2222)\n\nDigital Extinction ([de-game.org](https://de-game.org/),\n[Documentation](https://docs.de-game.org/),\n[GitHub](https://github.com/DigitalExtinction/Game),\n[Discord](https://discord.gg/vHMFuCWGSX)) is a 3D real-time strategy (RTS)\ngame. It is set in the near future when humans and AI fight over their\nexistence.\n\nIt is [open source \u0026 free software](#license). Forever! It runs on Linux,\nWindows and potentially other platforms.\n\nThe game is completely written in [Rust](https://www.rust-lang.org/) with\n[Bevy](https://bevyengine.org/) used as the engine.\n\n[![Gameplay video](video.png)](https://youtu.be/aRk65kyIEes)\n\n# Status\n\nThe game is still in [the early phases](#roadmap) of its development. If you\nare looking for a mature game, come back in a few months.\n\nFeedback, bug reports, and other [contributions](#contributing) are welcome.\n\n# How to Play?\n\nGame controls \u0026 gameplay tutorial is at\n[docs.de-game.org/tutorial/](https://docs.de-game.org/tutorial/).\n\n## Downloading Nightly Builds\n\nBuild from `main` branch is automatically published every night as a ZIP\narchive. The archive contains:\n\n* all necessary game assets,\n* main game binary (`de` or `de.exe`),\n* DE Lobby binary (`de-lobby` or `de-lobby.exe`),\n* and DE Connector binary (`de-connector` or `de-connector.exe`).\n\nFollow these steps to start the game on your computer:\n\n1. Download nightly ZIP file for your OS and CPU:\n\n   * [Linux (`x86_64-unknown-linux-gnu`)](https://download.de-game.org/x86_64-unknown-linux-gnu/nightly.zip)\n   * [Windows (`x86_64-pc-windows-gnu`)](https://download.de-game.org/x86_64-pc-windows-gnu/nightly.zip)\n   * [macOS with M series (`aarch64-apple-darwin`)](https://download.de-game.org/aarch64-apple-darwin/nightly.zip)\n   * [macOS with Intel (`x86_64-apple-darwin`)](https://download.de-game.org/x86_64-apple-darwin/nightly.zip)\n\n2. Extract the ZIP file.\n\n3. Execute binary file called `de` or `de.exe`.\n\n## Building from Source\n\nWhat you need:\n\n* installed and configured Git\n* [Git LFS](https://git-lfs.github.com/)\n* [Rust](https://www.rust-lang.org/tools/install)\n\nClone, build \u0026 run recipe (will work in the majority of the cases):\n\n* `git clone git@github.com:DigitalExtinction/Game.git DigitalExtinction`\n* `cd DigitalExtinction`\n* make sure that Git LFS files in [assets/](assets/) are pulled\n* `cargo run --release`\n\n# Build Profiles\n\n## Testing Profile\n\nOn top of the standard Cargo build profiles, there is a `testing` profile\noptimized for manual testing. In this profile, extra checks and debug info are\nincluded in the build. LTO is disabled and the optimization level is fine-tuned\nfor fast compilation times while keeping performance reasonable.\n\n## LTO Profile\n\nProfile `lto` shares configuration with `release` profile but enables LTO.\n\n# Cargo Build Features\n\nThe following are the Cargo [build\nfeatures](https://doc.rust-lang.org/cargo/reference/features.html) supported by\nthe game. These features enable special functionality that can be useful during\ndevelopment, testing, and experimentation.\n\n## godmode\n\n`godmode` makes it possible to control all game entities (i.e. enemy units and\nbuildings).\n\n# Where to Get Help?\n\n* Consult [CONTRIBUTING.md](/CONTRIBUTING.md) or [the online documentation at\n  docs.de-game.org](https://docs.de-game.org/).\n* Open a question in [the Q\u0026A category of this repository's\n  discussions](https://github.com/DigitalExtinction/Game/discussions/categories/q-a).\n* Reach out to the [community](#community).\n\n# Community\n\nSee [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md).\n\n* [Digital Extinction Updates](https://mgn.cz/categories/de-updates/)\n\n* [Discord server](https://discord.gg/vHMFuCWGSX)\n\n* [Subreddit /r/DigitalExtinction/](https://www.reddit.com/r/DigitalExtinction/)\n\n# Goals\n\nMany of the goals are intentionally vague and aspirational. They serve as a\ngeneral direction for future development. All changes and decisions shall go\nhand in hand with the spirit of the following goals.\n\n* Develop a forever free (as in free speech) and open source RTS game. A game\n  without the restraints of commercial development – no marketing-motivated\n  features, no dopamine traps, no in-game purchases…\n\n* Design an original game, not yet another clone of an existing (and often a\n  very old) game. The game is a combination of tried and true concepts and\n  mechanics from the RTS genre with new and innovative ideas.\n\n* Create a true **strategy** game, where dexterity or APS do not play the\n  primary role.\n\n* Focus on exponential in-game technological and economical progress. Players\n  who consistently outperform their competitors for extended times prevail.\n  Short-term boosts and performance fluctuations do have a proportionately\n  small impact on the game results.\n\n* Produce a modern game, unchained from obsoleted constraints and utilizing\n  current technology. Truly utilize the power of modern multi-core CPUs and\n  other capable hardware with the help of advances in software development,\n  like fearless concurrency of Rust programming language, or ECS-based Bevy\n  engine.\n\n  Seize this technological opportunity to create an RTS of grand scale, with\n  hundreds of buildings and thousands of fully simulated units on the game map.\n\n* Develop the game indefinitely and incrementally. To regularly ship a new\n  version (rolling release) and to forever improve the game based on new\n  experiences and new ideas.\n\n* Show that non-trivial games could be created in Rust and by extension Bevy\n  engine.\n\n# Game Design\n\nSee [game design documentation](https://docs.de-game.org/design/).\n\n# Contributing\n\nContributions to the project in any form are welcomed. Check out our\n[Contributor's Guide](/CONTRIBUTING.md).\n\nMSRV: the Minimum Supported Rust Version (MSRV) is “the latest stable release”\nof Rust.\n\n# Roadmap\n\nBellow is a high-level roadmap. Also, see [Issue\n#246](https://github.com/DigitalExtinction/Game/issues/246) with a detailed\npath toward version 1.0.\n\n1. [Proof of Concept\n   (PoC)](https://github.com/DigitalExtinction/Game/milestone/1)\n1. Prioritize in development cycles, each organized in a GitHub milestone named\n   Run N. For example [Run\n   2](https://github.com/DigitalExtinction/Game/milestone/4).\n1. Release (first) [version\n   1.0](https://github.com/DigitalExtinction/Game/milestone/2)\n1. [Indefinitely improve the game](/CONTRIBUTING.md#development-process)\n\n## Proof of Concept\n\nThis is an embarrassingly bare bones game. It is complete in the sense that you\ncan start the game, play against someone and win or loose.\n\nAt this stage, the game is too bare bones to be enjoyable. The UI/UX misses\nsome very important features (like seeing what units are selected, ability to\nsee health / energy of units, and so on).\n\nThe goal of this milestone is to lay down the foundations, setup basic\ninfrastructure (GitHub Actions, issues labels, …) and achieve an important\npsychological milestone.\n\n## 1.0\n\nThis is the first published version of the game. In theory, this should be the\nearliest possible version, minimizing development time and effort, which is\nthreshold enjoyable for an actual player.\n\nAs opposed to PoC, this version has all the basic UI to make the UX acceptable.\nThe game mechanics are somewhat expanded so it is no longer thoroughly “dummy”.\n\n# License\n\n## Source Code\n\nDigital Extinction is free and open source. All code in this repository is\nlicensed under GNU AGPLv3 ([LICENSE](LICENSE) or\n[https://www.gnu.org/licenses/agpl-3.0.en.html](https://www.gnu.org/licenses/agpl-3.0.en.html)).\n\nUnless you explicitly state otherwise, any source code contribution\nintentionally submitted for inclusion in the work by you, shall be licensed as\nabove, without any additional terms or conditions.\n\n## Assets\n\nAll game assets are located in [/assets](/assets) directory of this repository.\nAssets placed in a directory with a file named `LICENSE` are licensed under the\nlicense stated in the file.\n\nAll other artwork in this repository, including 3D models, textures,\nanimations, UI bitmaps, sounds and music are licensed under\n[Attribution-ShareAlike 4.0 International (CC BY-SA\n4.0)](https://creativecommons.org/licenses/by-sa/4.0/legalcode)\n\n# Sponsors\n\n[@JustinDaleGray](https://github.com/JustinDaleGray)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDigitalExtinction%2FGame","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDigitalExtinction%2FGame","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDigitalExtinction%2FGame/lists"}