A NES emulator written in Ruby
Latest commit 38d4af5 Feb 14, 2017 @mame Update rubocop directives
Failed to load latest commit information.
bin Publish. Mar 31, 2016
doc Update benchmark result. Jun 11, 2016
examples Publish. Mar 31, 2016
lib Update rubocop directives Feb 14, 2017
tools Update rubocop directives Feb 14, 2017
.dockerignore Publish. Mar 31, 2016
.gitignore Publish. Mar 31, 2016
.rubocop.yml Update rubocop directives Feb 14, 2017
.travis.yml Retry. Jun 11, 2016
Gemfile Add development dependencies Jun 11, 2016
README.md Add a link to @eregon's blog. Nov 29, 2016
Rakefile Publish. Mar 31, 2016
optcarrot.gemspec Publish. Mar 31, 2016


Optcarrot: A NES Emulator for Ruby Benchmark

Project Goals

This project aims to provide an "enjoyable" benchmark for Ruby implementation to drive "Ruby3x3: Ruby 3 will be 3 times faster".

The specific target is a NES (Nintendo Entertainment System) emulator that works at 20 fps in Ruby 2.0. An original NES works at 60 fps. If Ruby3x3 is succeeded, we can enjoy a NES game with Ruby!

NOTE: We do not aim to create a practical NES emulator. There have been already many great emulators available. We recommend you use another emulator if you just want to play a game.

Basic usage

SDL2 is required.

$ git clone http://github.com/mame/optcarrot.git
$ cd optcarrot
$ bin/optcarrot examples/Lan_Master.nes
key button
arrow D-pad
Z A button
X B button
space Start button
return Select button

See doc/bonus.md for advanced usage.

Benchmark example

benchmark chart

See doc/benchmark.md for the measurement condition.

You may also want to read @eregon's great post for JRuby+Truffle potential performance after warm-up.

Optimized mode

It may run faster with the option --opt.

$ bin/optcarrot --opt examples/Lan_Master.nes

This option will generate an optimized (and super-dirty) Ruby code internally, and replace some bottleneck methods with them. See doc/internal.md in detail.

See also


We appreciate all the people who devoted efforts to NES analysis. If it had not been not for the NESdev Wiki, we could not create this program. We also read the source code of Nestopia, NESICIDE, and others. We used the test ROMs due to NESICIDE.