Game Play Color

A JavaScript Game Boy and Game Boy Color emulator for iOS, based on the GameBoy-Online emulator core.

If you just want to play Game Play, you can find it online at https://gameplaycolor.com.

[!IMPORTANT]

Game Play Color is no longer under active development—now that emulators are permitted on the App Store, there are many more fully featured alternatives, including the fabulous Delta.

Dependencies

Check out the project, update the submodules, install the brew-based dependencies, and install the additional Python dependencies:

git clone git@github.com:gameplaycolor/gameplaycolor.git
cd gameplaycolor
git submodule update --init --recursive
scripts/install-dependencies.sh

It may be necessary to install pipenv as follows:

pip3 install pipenv

Builds

Game Play is built using a custom Python build script which inlines and minifies HTML, CSS and JavaScript, and binds in the settings for a given deployment.

For example, building the release version of Game Play as hosted on gameplaycolor.com can be done by running the following command from the root of the repository:

scripts/gameplay build settings/release.json

The build will be created in the build directory, and a corresponding *.tar.gz will be created in archives, tagged with the git sha and settings name (e.g., build-168bd9d0d8d309a1efb1983bd61ec34ff22951b5-release.tar.gz).

Development

The gameplay build script includes a lightweight server for local development:

scripts/gameplay serve

This does not automatically build the project, so it's necessary to build the project using the instructions above whenever you make a change.

Releases

The main branch is automatically deployed using continuous integration at https://app.gameplaycolor.com. You can find an auto-gemerated changelog at https://gameplaycolor.com/changelog/.

Thanks

Many thanks to:

Grant Galitz for the GameBoy-Online emulator and core.
Pedro Ladaria for writing the JSGB core which served as inspiration for the first version of Game Play.
David McLeod for graphical inspiration on Dribbble and for letting me know about MicrogrammaD-MediExte.
Paul Ledger for suggesting the name 'Game Play'.
Pavlos Vinieratos for help and suggestions testing early builds.

Legal

Downloading copied ROMs is illegal: only use images you have created from ROMs you own yourself.
Game Play and Jason Morley are in no way affiliated with Nintendo Co., Ltd..

License

Game Play and its dependencies are licensed under the MIT license. See LICENSE for more details.

Third Party Sources

Game Play includes the following third party sources:

Gameplaycolor

Install / Use

README