Git Adventure Game Builder

A set of tools for building a Git adventure game, to help people learn Git
Alternatives To Git Adventure Game Builder
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
14 hours ago1,151otherC++
Minetest is an open source voxel game engine with easy modding and game creation
6 months ago40November 13, 201635mitShell
Git your game on!
Git Game2,892
2 years ago21gpl-2.0
terminal game to test git skills
3 hours ago646otherC#
The main repository for the development of the evolution game Thrive.
Dev Practice1,434
5 months ago3mit
Practice your skills with these ideas.
Oh My Git1,189
4 days ago91otherGDScript
An interactive Git learning game!
Git Game V2539
3 years ago6Makefile
Second version of the terminal based game that teaches users git commands
Git Game444
7 years ago1February 27, 20188mitRuby
The git committer guessing game!
8 months ago10C#
Repository for the Endless Runner Game Sample (Trash Dash)
3 hours ago741agpl-3.0DM
The code for Aurorastation's new base, forked from Baystation12.
Alternatives To Git Adventure Game Builder
Select To Compare

Alternative Project Comparisons


A text-based adventure game helping players learn about git along the way.

This document describes how the text-based adventure system that for Git will work. It supports Git on the command line, both on Windows CMD and Windows Git Bash as well as shell under Unix based systems.

Building up a world

Each level in the game is identified by a branch. Branch names must be formatted as: <level_number>_<level_short_name>, for example: 01_look_into_the_past. The branch name is used to identify the level the user is on, display the correct puzzle information and use the correct solution checking.

Each level consists out of 5 files. The files are named, prefixed by the level name:

  • <lvl>_check.txt - Contains the puzzle solution checking code.
  • <lvl>_hint.txt - Contains a hint about how to solve the puzzle. Each level can define as many hint files as needed (<lvl>_hint2.txt, <lvl>_hint3.txt ... , <lvl>_hintN.txt).
  • <lvl>_room.txt - Contains a general description about the puzzle. This is displayed to the player when they enter the level.

Lastly, the level must also be recorded in the .game_data/levels.txt file which contains all of the level names (branch names), one per line. Ensure that this file contains a trailing blank line.

During development, all this information is stored on the master git-adventures repository and a special script may be used to generate the pristine repository. See Building the Repository.

If your level requires specific setup during repository creation, you can place additional commands into .game_data/<lvl> This script will be called with two parameters: The source folder where the git-adventure master repo is located, and the target folder where the branch is being setup. The script may assume that the target folder is already in the target branch and no changes to the git state in the target folder should be made. All new files will automatically be added to the git repo.

Scripted commands

The following 'commands' are provided as scripts in order to help the player navigate the game:

  • './look' - Tells you about your surroundings and the predicament you find yourself in. Displays the content of the <lvl>_room.txt file.
  • './hint' - Provides you with some help, perhaps an indication of how to solve the problem. Displays the content of the <lvl>_hint{n}.txt file. The command may be called multiple times, cycling through the number of hint files provided.

Some further commands we may want to potentially provide:

  • './map' - Some textual representation of the world to give the weary traveler a bit more of an idea of the long-term strategies, goals.
  • './reset' - I've messed everything up. Help me get back to the start of the current level.

Ephemeral State

The .gitignore file contains .game_data/state and this folder can be used to keep ephemeral game state such as score. Which files and what the format to be used is still undecided at this time.

Building the Repository

To test the final repo, execute the following:

./setup_clean_repo -o <target_folder>

Then clone the new pristine repository so that we can see what the user would see:

git clone <target_folder> <test_folder>

In order to play the game from the beginning:


In order to playtest a specific level, the following command can be executed to go to that specific level:

git checkout -b <lvl> origin/<lvl>

Publish the Repository

Let's say you created the game repo and you are happy with it.

./setup_clean_repo -o ../great_game

You can now publish it via:

$ ./publish_game ../great_game ${GIT_GAME}

Open Issues

  • How to ensure that local tracking branches are not automatically created
  • Branches to set visible when a level is passed.
Popular Git Projects
Popular Video Game Projects
Popular Version Control Categories

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Video Game