Skip to content

Adding Retro Games

Toast edited this page Mar 2, 2025 · 4 revisions


Where to find Retro Games

Retro are found at public/assets/data/retros.js Games are not provided due to legal reasons.

Adding a New Retro Game

Follow this format for adding a retro game.

{
    id: 'Id goes here',
    title: 'Name goes here',
    url: 'Link to game file goes here.',
    image: 'Game cover image link goes here.',
    cover: 'Background image/game art link goes here.',
    core: 'RetroArch core goes here.'
},
  • You can also use the example provided in public/assets/data/retros.js
  • Ids should always be lowercase with no spaces, dashes, and underscores.
  • If mame games don't work, try using the core 'fbneo'.

Format Explanation

  • The URL should lead to a zip file or a known emulator format.
  • The cover is the Background/game art that appears behind the game.
  • The cores are the emulator backend used to run the games. For example, core: 'gba' should be used when running a Game Boy Advance game.

Hosting Your Own Retro Games Server

  • Use either Node.js or Nginx to host the games server.
  • This guide assumes you're using Node.js and that you don't have a dedicated server.
  • This guide is lazily explained.

Node.js

  • Create a directory to hold your zip/game files in there.
  • Start the server
  • On your router settings, set a port fowarding rule to port 80.
  • Make the server script run everytime you turn on your computer.
  • Use a service like FreeDNS.afraid.org to give your IP address a domain name. [NOTE: It takes very long for FreeDNS to register the domain name (about an hour.)]

Clone this wiki locally