Open Source Game Clones

This is the source of http://osgameclones.com. Feel free to add new games or improve information about those already in the database by submitting a pull request or opening an issue.

Games database

All of the games and their references to the original games are stored in YAML files under games and originals. All information is inside, and you should more or less understand what's going on by reading it. Sorting is alphabetical, with the exception of ScummVM, just because it's so many games at once.

Add a clone / remake of a game

Simplest way to contribute is to fill in the template presented when you create a new issue. Even better if you edit the files in the games directory directly. Your changes will be submitted as a pull request. All games are validated against the rules in the schema/games.yaml validation file.

If you're adding a new clone/remake:

name:           string     # Name of clone/remake (required)
type:           string     # One of: remake, clone, similar, tool
originals:      array      # Name reference to original game(s) that this game remakes/clones
repo:           string     # Link to source code
url:            string     # Link to website
feed:           string     # Link to RSS/Atom feed
development:    enum       # One of: complete, very active, active, sporadic, halted
status:         enum       # One of: playable, semi-playable, unplayable
multiplayer:    enum       # Any of: Online, LAN, Split-screen, Co-op, Hotseat, Matchmaking
lang:           array      # List of programming languages used
framework:      array      # List of engines/tools used
license:        array      # List of licenses listed in games schema
content:        string     # One of: commercial, free, open, swappable*
info:           string     # Miscellaneous notes about the game
updated:        string     # Date when game was added or updated
images:         array      # Link(s) to screenshot(s)
video:
  youtube:      string     # YouTube video ID
  vimeo:        number     # Vimeo video ID

# * free means no cost, open means liberally licensed

Add a reference to the original game

All the games listed need an original game they re-implement or clone. If there is no existing game entry in originals directory you can create a new entry for it by following the following format. All originals are validated against the rules in the schema/originals.yaml validation file.

- name:         string     # Name of the original game (required)
  names:        array      # Other names for the game, or other games in the series
  platform:     enum       # Game platform, i.e. Amiga. See platform in orginals schema
  meta:
    genre:      enum       # Any of genres in originals schema
    subgenre:   enum       # Any of subgenres in originals schema
    theme:      enum       # Any of themes in originals schema

External links to article about an original game

A Wikipedia link is created for all original game names; if the article link is different, use the following syntax:

name: [Name, Name of Wikipedia article]

If the game has a non-Wikipedia link:

name: [Name, 'http://www.example.com']

Contributing

Pre-requisites

Install

Clone this repository and run inside the directory:

pipenv install

Building

Simply run the following to build the project into the _build directory.

pipenv run cyrax

License

See LICENSE

verhoevenv / osgameclones