1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
<p align="center"><img src="https://cloud.githubusercontent.com/assets/2197005/13260438/2f6e96ac-da3a-11e5-86cf-bbfa15083f74.gif" width="560" alt="PHP Terminal GameBoy Emulator" /></p>
[](https://travis-ci.org/gabrielrcouto/php-terminal-gameboy-emulator)
[](http://gabrielrcouto.mit-license.org/)
[](https://packagist.org/packages/gabrielrcouto/php-terminal-gameboy-emulator)
Want to play Dr Mario or Pokémon on your server terminal? That's for you!
## Table of Contents
+ [Why](#why)
+ [Requirements](#requirements)
+ [Running](#running)
+ [Controls](#controls)
+ [Tests](#tests)
+ [TO-DO](#to-do)
+ [Credits](#credits)
+ [Legal](#legal)
## Why
Some people will ask me: _"Why you did that?"_
Well, a friend asked me _"What PHP can do?"_. I thought about that awhile and
the idea came up. With PHP7's performance improvement now it's possible to
emulate some systems :smile: and, come on, that's funny! :dancers:
It's based on the [GameBoy JS Emulator](https://github.com/taisel/GameBoy-Online).
## Requirements
The following PHP versions are supported:
+ PHP 5.6
+ PHP 7
+ HHVM
You will need a good terminal! I've tested only on MacOSX and Linux. I'm sorry
about that Windows guys :disappointed:
## Installation
Using composer:
```bash
$ composer g require gabrielrcouto/php-terminal-gameboy-emulator:dev-master
```
Using PHAR:
```bash
$ wget https://raw.githubusercontent.com/gabrielrcouto/php-terminal-gameboy-emulator/master/bin/php-gameboy.phar
$ chmod +x php-gameboy.phar
$ mv php-gameboy.phar /usr/local/bin/php-gameboy
```
## Running
Your roms are loaded from the directory you are running the `php-gameboy` command.
```bash
$ php-gameboy drmario.gb
$ php-gameboy pokemon.gbc
```
If you like to run this emulator locally, simple clone the repository:
```bash
$ git clone https://github.com/gabrielrcouto/php-terminal-gameboy-emulator.git
$ cd php-terminal-gameboy-emulator
$ composer install -o
```
For running roms, pass the full path to your rom or put then in the `php-terminal-gameboy-emulator` folder:
```bash
$ bin/php-gameboy pokemon.gbc
$ bin/php-gameboy /full/path/to/your/rom/drmario.gb
```
## Controls
```bash
_n_________________
|_|_______________|_|
| ,-------------. |
| | .---------. | |
| | | | | |
| | | | | |
| | | | | |
| | | | | |
| | `---------' | |
| `---------------' |
| _ |
| _|W|_ ,-. |
||A D| ,-. "._,"|
| |S| "._," Dot |
| _ _ Comma |
| // // |
| // // \\\\\\ |
| N M \\\\\\ ,
|________...______,"
```
+ Left = A
+ Up = W
+ Down = S
+ Right = D
+ A = Comma (,)
+ B = Dot (.)
+ Select = N
+ Start = M
## Tests
You can use the following command to run the most common checks, such as `php -l`, `phpcs`:
$ ant check
## TO-DO
Converting from the JS paradigm was a lot of work, and I still need to adapt somethings like:
- [x] Code standard - PSRs, please!
- [x] Array of functions - Maybe in PHP it's not the best approach
- [x] Pixel auxiliary array - Very CPU intensive to convert RGBA every time
- [ ] Classes - Core is too big!
- [ ] Profiling and otimizing - XHProf to find the most intensive functions
- [ ] Save/Restore - I need to save my Pokémon, please!
## Credits
[@gabrielrcouto](http://www.twitter.com/gabrielrcouto)
## Legal
The purpose of this project was to study all the capabilities of PHP.
It does not have any commercial or profitable intentions.
The user is responsible to use this code and its content in the terms of the law.
The author is completely against piracy and respects all the copyrights, trademarks and patents of Nintendo.
|
