Skip to content

NET-NES v1.0.0 🕹️

Latest

Choose a tag to compare

@BotRandomness BotRandomness released this 03 Jun 02:42
· 3 commits to master since this release

Download

  1. Unzip the folder
  2. Launch the executable
    • On MacOS, there might be a pop up saying "Apple could not verify", this is normal. Simply right click on the app, then open, then open again. You also go to System Settings, then security, then allow. You only need to do this once during the first time.
    • You may also need to enable execute permission on "Unix-like Oses"
    • If you want to use the terminal: Point your terminal to the application and run, Windows: NET-NES --nes <string:rom>, Unix-like Oses ./NET-NES --nes <string:rom>
  3. You are ready to go!

Controls

  • (A) = X
  • (B) = Z
  • [START] = [ENTER]
  • [SELECT] = [RSHIFT]
  • D-Pad = ArrowKeys
    Note: Pressing [SPACE] Bar toggles the top menu bar.

Usage

Simply launching the executable will show the basic GUI. Going File -> Open ROM will bring up a file launcher to select your ROM. Help -> Manual will show all the basic instructions on how to use, and what to know. More information in the Compatibility section.

Flags

NET-NES flags when using terminal. Note: these flags can be passed in any order, and in any combination.

  • --nes <string:path>: Starts up the emulator given a rom file
  • --json <string>: Runs a CPU test for a instruction given a JSON file in test/v1
  • -s <int>, --scale <int>: Scale window size by factor (2 is default)
  • -f, --fps: Enables FPS counter (off is default)
  • -rl, --raylib-log: Enables Raylib logs (off is default)
  • -d, --debug: Enables debug mode (off is default)
  • -a, --about: Shows about
  • -v, --version: Shows version number
  • -h, --help: Shows help screen

Compatibility

Most games should run fine, here is list of games I tested:

Balloon Fight - Works
Bubble Bobble - Works
Castlevania - Works
Castlevania II - Works
Contra - Works
Donkey Kong - Works
Dr. Mario - Works
DuckTales - Works
Execitebike - Works
Final Fantasy - Works
Final Fantasy II - Freeze at first Battle (Due to inaccurate Sprite0 Hit timming)
Final Fantasy III - Works
Galaga - Works
Ice Climber - Works
Kirby's Adventure - Works
The Legend of Zelda - Works
Mario Bros. - Works
Mega Man - Works
Mega Man 2 - Works
Mega Man 6 - Works
Metroid - Works
Ninja Gaiden - Freeze at Act 1 Screen (Due to inaccurate Sprite0 Hit timming), However you can get it to work if in debug mode you disable "Sprite0 Hit Check"
Ninja Gaiden II - Works
Ninja Gaiden III - Works
Pac-Man - Works
Super Mario Bros. - Works
Super Mario Bros. 2 - Works
Super Mario Bros. 3 - Works
Teenage Mutant Ninja Turtles Tournament Fighters - Works
Tetris - Works
Tetris 2 - Works