oh-my-git

Oh My Git! is an open-source game designed to teach Git through interactive, hands-on levels. Developed by bleeptrack and blinry in 2020/2021 with funding from the Prototype Fund, the project is currently in low-maintenance mode, meaning contributions are welcome but may take time to review. ## Gameplay and Availability Players can download pre-built binaries for Linux, macOS, and Windows from itch.io. The game presents a series of levels that guide users through Git concepts and commands in a playful, puzzle-like manner. ## Custom Level Creation One of the standout features is the ability to build your own levels. The README provides a detailed guide: - Download Godot 3 (Godot 4 is not yet supported). - Clone the repository and run the game with `godot scenes/main.tscn`. - Levels are stored in the `levels` directory, organized by chapters, with each level as a file. - The level format uses sections like `[description]`, `[cli]` (optional hints), `[congrats]`, `[setup]` (Bash commands to initialize the state), and `[win]` (Bash commands to check if the level is solved). - Levels can involve multiple repositories using sections like `[setup <name>]` and `[win <name>]`, with remotes automatically configured. ## Contributing Code To contribute, open the project in the Godot editor with `godot project.godot` and run it with F5. Pull requests are welcome, but due to potential merge conflicts in Godot scene files, contributors should contact the maintainers before modifying existing `.tscn` files. Building binaries requires Godot export templates, `zip`, `wget`, and `7z`, then running `make`. ## Community and Licensing The project has a Code of Conduct for all contributions. It is licensed under the Blue Oak Model License 1.0.0, a modern alternative to MIT. The game received funding from the Prototype Fund, supported by the German Ministry for Education and Research and the Open Knowledge Foundation Germany. Sound effects are credited to various CC0 contributors.