Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/trekawek/coffee-gb
Gameboy emulator in Java 8.
https://github.com/trekawek/coffee-gb
emulator gameboy gameboy-emulator z80
Last synced: 7 days ago
JSON representation
Gameboy emulator in Java 8.
- Host: GitHub
- URL: https://github.com/trekawek/coffee-gb
- Owner: trekawek
- License: mit
- Created: 2017-01-06T12:38:41.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-03-06T21:28:23.000Z (8 months ago)
- Last Synced: 2024-10-15T05:21:03.012Z (21 days ago)
- Topics: emulator, gameboy, gameboy-emulator, z80
- Language: Java
- Size: 4.33 MB
- Stars: 1,107
- Watchers: 34
- Forks: 81
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Coffee GB
Coffee GB is a Gameboy Color emulator written in Java 8. It's meant to be a development exercise. More info can be found in the blog post [Why did I spend 1.5 months creating a Gameboy emulator?](http://blog.rekawek.eu/2017/02/09/coffee-gb/)
## Building
The emulator can be build with [Maven](https://maven.apache.org/):
mvn clean package
The coffee-gb-*-complete.jar executable file will be available in the `./target` directory.
## Usage
1. Download the [most recent release](https://github.com/trekawek/coffee-gb/releases/download/coffee-gb-1.2.0/coffee-gb-1.2.0.jar).
2. Double-click the JAR or launch it with `java -jar coffee-gb-*.jar` command.
3. Load a game.
Play with ←, ↑, ↓, →, Z, X, Enter, Backspace.
## Features
* Cycle-exact Gameboy CPU emulation. Each opcode is split into a few micro-operations (load value from memory, store it to register, etc.) and each micro-operation is run in a separate CPU cycle.
* Quite compatible (all the Blargg's tests are passed, although some game still doesn't work)
* GPU
* Joypad
* Timer
* Sound
* MBC1-5 support
* Battery saves
* Support for zipped ROMs
* ROM-based compatibility tests run from Maven
## Running Blargg's tests
The [Blargg's test ROMs](http://gbdev.gg8.se/wiki/articles/Test_ROMs) are used for testing the compatibility. Tests can be launched from Maven using appropriate profile:
mvn clean test -Ptest-blargg
mvn clean test -Ptest-blargg-individual # for running "single" tests providing more diagnostic info
They are also part of the [Travis-based CI](https://travis-ci.org/trekawek/coffee-gb).
The tests output (normally displayed on the Gameboy screen) is redirected to the stdout:
```
cpu_instrs
01:ok 02:ok 03:ok 04:ok 05:ok 06:ok 07:ok 08:ok 09:ok 10:ok 11:ok
Passed all tests
```
Coffee GB passes all the tests:
* cgb_sound
* cpu_instrs
* dmg_sound-2
* halt_bug
* instr_timing
* interrupt_time
* mem_timing-2
* oam_bug-2
## Mooneye tests
The [Mooneye GB](https://github.com/Gekkio/mooneye-gb) emulator comes with a great set of test ROMs. They can be used to test the Coffee GB as well. Use -Ptest-mooneye profile:
mvn clean test -Ptest-mooneye
## Screenshots
## Key bindings
The default key bindings can be changed with the `~/.coffeegb.properties` file. The file has following format:
```
btn_up=VK_UP
btn_down=VK_DOWN
btn_left=VK_LEFT
btn_right=VK_RIGHT
btn_a=VK_Z
btn_b=VK_X
btn_start=VK_ENTER
btn_select=VK_BACK_SPACE
```
The key list can be found in the [KeyEvent JavaDoc](https://docs.oracle.com/javase/10/docs/api/java/awt/event/KeyEvent.html#field.summary).
## Resources
* [GameBoy CPU manual](http://marc.rawer.de/Gameboy/Docs/GBCPUman.pdf)
* [The Ultimate GameBoy talk](https://www.youtube.com/watch?v=HyzD8pNlpwI)
* [Gameboy opcodes](http://pastraiser.com/cpu/gameboy/gameboy_opcodes.html)
* [Nitty Gritty Gameboy cycle timing](http://blog.kevtris.org/blogfiles/Nitty%20Gritty%20Gameboy%20VRAM%20Timing.txt)
* [Video Timing](https://github.com/jdeblese/gbcpu/wiki/Video-Timing)
* [BGB emulator](http://bgb.bircd.org/) --- good for testing / debugging, works fine with Wine
* [The Cycle-Accurate Game Boy Docs](https://github.com/AntonioND/giibiiadvance/tree/master/docs)
* [Test ROMs](http://slack.net/~ant/old/gb-tests/) - included in the [src/test/resources/roms](src/test/resources/roms)
* [Pandocs](http://bgb.bircd.org/pandocs.htm)
* [Mooneye GB](https://github.com/Gekkio/mooneye-gb) - an accurate emulator written in Rust, contains great ROM-based acceptance tests