Skip to content

A Sega Master System and Game Gear Emulator for the Nintendo 64

License

Notifications You must be signed in to change notification settings

fhoedemakers/smsplus64

Repository files navigation

smsPlus64

A Sega Master System and Game Gear Emulator running on the Nintendo 64. Use it on real hardware with an EverDrive-64. Tested with the EverDrive-64 X7 on an NTSC Nintendo 64.

Note

This project is more of a fun thing for me to try if it works. It runs way too slow to be really usable and playable. I don't know if the emulator will ever run at full speed. Help is always welcome. Game Gear games run faster than Master System games and are much more playable. Try it yourself to find out.

Built with Libdragon

The emulator code is a port of smsPlus.

How to use on real hardware using an Everdrive 64 X7.

To try the emulator, download smsPlus64.z64 from the releases page en copy it to your flash card.

Games can be played from the flashcard's SD card. Create a folder named smsPlus64 in the root of your flashcard's SD card and copy your .sms or .gg ROMs there. You can organize your games in subfolders. The emulator shows a menu whith a list of games.

Controls

In menu

  • D-pad Up or Down: Next previous game
  • D-pad left or right: previous or next page.
  • B: Go to previous folder
  • A: Open folder or start selected game

In Game

  • D-Pad: movement
  • Start: Pause game
  • B: Button 1
  • A: Button 2
  • Z + Start: Go back to menu
  • Z + A: Toggle framerate
  • Z + B: Toggle sound (improves framerate somewhat)

Building from source

  1. Install the Libdragon SDK. For more info and instructions, see https://github.com/DragonMinded/libdragon
  2. Make sure the environment var N64_INST points to the installed SDK
  3. Get the sources and build
git clone https://github.com/fhoedemakers/smsplus64.git
cd smsplys64
chmod +x build*.sh
./build.sh

Then copy smsPlus64.z64 to your flash drive.

Using an Emulator

You can also use an Emulator. Libdragon suggests Ares. This however requires building from source. Since an Everdrive is not used, copy your .gg or .sms files to the filesystem folder of this repoistory, then run build.sh. The roms will be baked into smsPlus64.z64

The files run64.sh, cp64.sh are used to run or copy smsPlus64.z64 to the Everdrive, using an USB cable. (using usb64.exe). Since usb64.exe runs on Windows, you need to build the project using WSL (Windows Subsystem for Linux) in order to use these scripts. If you are using Linux, you have to copy the file manually to the Everdrive.