/jamulator

(unmaintained) recompiling NES roms into native executables

Primary LanguageGo

jamulator

See the writeup for this project: Statically Recompiling NES Games into Native Executables with LLVM and Go

Note: This project is discontinued. See the above article for the explanation.

Features

  • Recompile NES games into native executables
    • Only known supported game is Super Mario Brothers 1
  • 6502 assembler / disassembler
  • Unpack & disassemble NES roms and then put them back together
  • Adds a small custom ABI which gives you putchar and exit for making test roms.

Getting Started Developing

  1. Set up your $GOPATH. Make sure the bin folder from your go path is in $PATH.

  2. Install the lexer:

    go get github.com/blynn/nex
    
  3. Install llvm-3.1 or llvm-3.2 from your package manager.

  4. Install gollvm (replace 3.2 with 3.1 if you want):

    export CGO_CFLAGS=$(llvm-config-3.2 --cflags)
    export CGO_LDFLAGS="$(llvm-config-3.2 --ldflags) -Wl,-L$(llvm-config-3.2 --libdir) -lLLVM-$(llvm-config-3.2 --version)"
    go get github.com/axw/gollvm/llvm
    
  5. Install the rest of the go dependencies:

    go install
    
  6. Install the C dependencies:

    sudo apt-get install libsdl1.2-dev libsdl-gfx1.2-dev libsdl-image1.2-dev libglew1.6-dev libxrandr-dev
    
  7. Compile, run the tests, and then try it!

    make
    make test
    ./jamulator -recompile game.nes