Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/binji/pokegb
A gameboy emulator that only plays Pokemon Blue, in ~50 lines of c++.
https://github.com/binji/pokegb
emulator gameboy obfuscated pokemon
Last synced: 3 months ago
JSON representation
A gameboy emulator that only plays Pokemon Blue, in ~50 lines of c++.
- Host: GitHub
- URL: https://github.com/binji/pokegb
- Owner: binji
- License: mit
- Created: 2021-05-28T16:04:43.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-09-04T16:04:48.000Z (10 months ago)
- Last Synced: 2024-01-22T18:01:38.282Z (5 months ago)
- Topics: emulator, gameboy, obfuscated, pokemon
- Language: C++
- Homepage:
- Size: 4.02 MB
- Stars: 1,279
- Watchers: 17
- Forks: 36
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-stars - binji/pokegb - A gameboy emulator that only plays Pokemon Blue, in ~50 lines of c++. (C++)
- awesome-stars - pokegb
- awesome-stars - pokegb
README
# pokegb
A gameboy emulator that only plays Pokemon Blue, in ~50 lines of c++.
See the [technical write-up](https://binji.github.io/posts/pokegb/).
## Features
Plays Pokemon Blue (and Red).
## Screenshots
## Building
Only builds on Linux and macOS AFAIK.
```
$ make
```
On macOS, you'll need to create a save file too (just the first time):
```
$ make rom.sav
```
## Running
Get a Pokemon Blue (or Pokemon Red) ROM file. The files that are known to work have the following sha1s:
| Name | sha1 |
| - | - |
| Pokemon - Blue Version (USA, Europe) (SGB Enhanced).gb | `d7037c83e1ae5b39bde3c30787637ba1d4c48ce2` |
| Pokemon - Red Version (USA, Europe) (SGB Enhanced).gb | `ea9bcae617fdf159b045185467ae58b2e4a48b9a` |
Others might work too, but these are the ones that I've tried.
Rename the file to `rom.gb` and put it in the current directory. Then run:
```
$ ./pokegb
```
The save file is written to `rom.sav`.
Keys:
| Action | Key |
| --- | --- |
| DPAD-UP | ↑ |
| DPAD-DOWN | ↓ |
| DPAD-LEFT | ← |
| DPAD-RIGHT | → |
| B | Z |
| A | X |
| START | Enter |
| SELECT | Tab |
## Updating keys
Look for [line 24](https://github.com/binji/pokegb/blob/5444936aa7f12cb8c5c9c78e3c0c391ca4102f9b/pokegb.cc#L24) the source.
The following table shows which numbers map to which keyboard keys:
| number | default key | gameboy button |
| - | - | - |
| 27 | X | A Button |
| 29 | Z | B Button |
| 43 | Tab | Select Button |
| 40 | Return | Start Button |
| 79 | Arrow Right | DPAD Right |
| 80 | Arrow Left | DPAD Left |
| 81 | Arrow Down | DPAD Down |
| 82 | Arrow Up | DPAD Up |
Replace the numbers on this line with one from the [SDL scancode list](https://www.libsdl.org/tmp/SDL/include/SDL_scancode.h).