An interactive Git learning game!
Go to file
2021-02-11 11:19:22 +01:00
.github/workflows Use current tag as version on itch.io 2021-02-05 20:35:03 +01:00
cards Symbols for index-modifying cards, remove index/mv level for now 2021-01-14 11:26:21 +01:00
fonts Make all fonts pretty by activating filtering 2021-01-21 18:17:29 +01:00
images Try on another name: Oh My Git! 2021-02-05 15:00:13 +01:00
levels grey cli hints in level description 2021-02-11 11:19:22 +01:00
music Longer background music - thanks, @winniehell :) 2021-02-09 15:51:09 +01:00
nodes make all new head icons blue 2021-02-02 16:48:03 +01:00
resources Remove the fetch level for now 2021-01-14 11:30:58 +01:00
scenes grey cli hints in level description 2021-02-11 11:19:22 +01:00
scripts Performance: don't create trees and blobs, only update repos once 2021-01-13 13:30:08 +01:00
sounds Card particles and more sound effects 2020-10-22 16:19:22 +02:00
styles Sneaking survey into game before quitting 2021-01-28 11:59:26 +01:00
.gitignore Add Windows build to the CI 2020-10-20 11:11:29 +02:00
CODE_OF_CONDUCT.md Add Contributor Covenant v2.0 2020-10-12 20:00:59 +02:00
default_bus_layout.tres Add first background music, always move focus back to the command line 2021-02-04 16:11:56 +01:00
export_presets.cfg Try on another name: Oh My Git! 2021-02-05 15:00:13 +01:00
LICENSE.md Add Blue Oak Model License 1.0.0 2020-10-14 17:11:00 +02:00
Makefile Try on another name: Oh My Git! 2021-02-05 15:00:13 +01:00
project.godot Make the "save delete" function observe the new name 2021-02-05 16:21:48 +01:00
README.md Correct a level link in the README 2021-02-05 20:55:37 +01:00

Oh My Git!

Oh My Git! is an open-source game about learning Git!

The current form is an early prototype, and will change significantly until the end of February 2021.

Play the game!

You can download binaries for Linux, macOS, and Windows from itch.io!

Report bugs!

If something doesn't work or looks broken, please let us know! You can describe the issue you're having in our issue tracker.

If you have ideas for new features, we'd be excited to hear them! Also in that case, we invite you to open an issue!

Build your own level!

Wanna build your own level? Great! Here's how to do it:

  1. Download the latest version of the Godot game engine.
  2. Clone this repository.
  3. Run the game the easiest way to do so is to run godot scenes/main.tscn from the project directory.
  4. Get a bit familiar with the levels which are currently there.
  5. Take a look into the levels directory. It's split into chapters, and each level is a file.
  6. Make a copy of an existing level or start writing your own. See the documention of the format below.
  7. Write and test your level. If you're happy with it, feel free to send it to us in a pull request! <3

Level format

title = This is the level's title

[description]

This text will be shown when the level starts.

It describes the task or puzzle the player can solve.

[congrats]

This text will be shown after the player has solved the level.

Can contain additional information, or bonus exercises.

[setup]

# Bash commands that set up the initial state of the level. An initial
# `git init` is always done automatically. The default branch is called `main`.

echo You > people_who_are_awesome
git add .
git commit -m "Initial commit"

[win]

# Bash commands that check whether the level is solved. Write these as if you're
# writing the body of a Bash function. Make the function return 0 if it's
# solved, and a non-zero value otherwise. You can use `return`, and also, Bash
# functions return the exit code of the last statement, which sometimes allows
# very succinct checks.

# Check whether the file has at least two lines in the latest commit:
test "$(git show HEAD:people_who_are_awesome | wc -l)" -ge 2

A level can consist of multiple repositories. To have more than one, you can use sections like [setup <name>] and [win <name>], where <name> is the name of the remote. The default name is "yours". All repositories will add each other as remotes. Refer to the remote levels examples.

Level guidelines

At this stage, we're still exploring ourselves which kind of levels would be fun! So feel free to try new things: basic introductions with a little story? Really hard puzzles? Levels where you have to find information? Levels where you need to fix a problem? Levels with three remotes?

Contribute code!

To open the game in the Godot editor, run godot project.godot. You can then run the game using F5.

Feel free to make improvements to the code and send pull requests! There is one exception: because merge conflicts in Godot's scene files tends to be hard to resolve, before working on an existing *.tscn file, please get in touch with us.

To build your own binaries, you'll need Godot's export templates, and zip, wget, and 7z. Then, run make. On Debian/Ubuntu, the Godot binary is called godot3, you might need to adjust the paths in the Makefile.

Code of Conduct

We have a Code of Conduct in place that applies to all project contributions, including issues and pull requests.

Funded by

Logo of the German Ministry for Education and Research            Logo of the Prototype Fund            Logo of the Open Knowledge Foundation Germany

Thanks

License

Blue Oak Model License 1.0.0 a modern alternative to the MIT license. It's a a pleasant read! :)