ArduBoyEmulator and IDE in HTML5
npm install -g gulp-cli
npm install -g serve
npm install -g cordova # optional, for android build only
git clone https://github.com/felipemanga/ProjectABE.git
cd ProjectABE
npm install
mkdir build
gulp copy
gulp web-build
cd build
serve .
The emulator can be used in one of the following ways:
- Go to https://felipemanga.github.io/ProjectABE, pick a game and play.
- Download one of the offline builds here and run it.
If you want to use the online emulator, you can run a HEX/Arduboy directly by adding it to the URL like this: https://felipemanga.github.io/ProjectABE/?url=https://site/file.hex
Offline is similar, if you have the executable in your PATH: ProjectABE /path/to/file.hex
You can also drag-and-drop a hex/arduboy file into the game list to play it.
You can play by touching the buttons, if you have a touchscreen. If your device has a keyboard, use the arrow keys and Ctrl/A/Z for button A and Alt/B/S/X for button B. Joysticks/pads are also supported, if your browser supports the gamepad API.
Press F to toggle fullscreen mode.
You can start/stop recording a GIF of the game by pressing R.
To exit a game and go back to the list, click on the power button above the screen.
Some games look/play better on a vertical screen, like 1942 or Breakout-V. The emulator can be put in vertical mode by clicking on the chip in the lower-right of the Arduboy's screen.
If you want to debug the game you're currently playing, click on the USB port (bottom-center, online version only, for now).
ProjectABE includes an IDE (based on the awesome Ace editor). It allows you to write, build and debug Arduboy games in your browser, without installing anything on your computer. Since it's a work-in-progress, the edges are still rough, but it's already possible to make entire games in it (see Hello, Commander).
IDE Keyboard shortcuts:
- Ctrl-Enter: Build and run
- Ctrl-P: Jump to file
- F6: Reset
- F7: Step-In
- F8: Resume
If you have an existing project, you can drag-and-drop code (or a zip file containing code) into the editor. If your project is on github or bitbucket, the IDE can load your code from there by pointing ProjectABE to your repository like this: https://felipemanga.github.io/ProjectABE/?url=https://github.com/felipemanga/HelloCommander
You can also drag-and-drop images to have them converted into source code, ready to be used with the Arduboy2 library, with an ascii-art preview (dashes are transparent, spaces are black, and sharps white):
Simply ignore the arrays you do not need and GCC will not add them to the final build.