[Release][WIP] Sonic Riders native port (Switch + PC), static recompilation, needs testers

  • Thread starter Thread starter teclilla
  • Start date Start date
  • Views Views 2,406
  • Replies Replies 19
  • Likes Likes 3

teclilla

Member
Newcomer
Joined
Aug 11, 2018
Messages
11
Reaction score
9
Trophies
0
Age
29
XP
166
Country
United States
​


Sonic Riders Native Port v0.7.0
Windows PC, Linux / Steam Deck, jailbroken Switch, Android and now iPhone / iPad

Hey everyone! It's been a few releases since my last post (v0.4.2), and this one is huge.

Quick refresher: I'm still not a programmer and I still have literally zero coding experience. Everything is being built by prompting Claude Code, and I'm just getting better and better at bug testing and stress testing everything. LITERALLY EVERYTHING I TEST EVERYTHING EXTENSIVELY FOR HOURS ON END. (Beats coding from scratch at least lol)

What is this?
A native port of Sonic Riders (GameCube, USA). Not an emulator: the game's code gets converted to C on your own machine and built into a real Windows, Linux, Switch, Android or iPhone/iPad app. Same idea as the Zelda and Mario recomps.

You need your own copy of the game. The download has zero game files. The installer builds everything from your own Sonic Riders (USA) disc image. Please don't ask me for ISOs.

What's new
  • iPhone and iPad: built on your Mac (Apple silicon + Xcode) with a free Apple account, installed directly or as an .ipa for Sideloadly / AltStore. 60fps races on iPhone 17 Pro and recent iPads, touch controls or a controller. (Free accounts renew every 7 days, saves are kept)
  • PC frame rates above 60: 120, 144, 180, 240 or Unlimited. The game still runs at normal speed, the PC just draws extra in-between frames. Honestly, it's about as close to eye candy as you can get without an HD remake
  • Windows launcher with button remapping: pick your disc, press INSTALL AND PLAY, done
  • PC graphics options: resolution up to 4x, MSAA, AMD FSR sharpening/upscaling, bloom, colour presets, smoother character lighting
  • Ultrawide without stretching (16:9, 21:9, 32:9, Steam Deck) and a FOV slider
  • Linux / Steam Deck is now a regular download (it works on the Deck!)
  • Switch races are fast again (~60fps overclocked) and the setup can make a HOME-screen icon

  • Save a bug report from F1 > About (PC, Linux, Steam Deck); the last five logs are kept
  • PC: controllers keep working when the window isn't focused; laptops use the fast graphics chip; the F1 menu works with the mouse
  • Android: recovers from graphics driver resets, runs on the fast CPU cores, no more "crashed" report after swiping it away
  • Chaos Emerald option is now off by default

What's next
  • Custom music folder: your own MP3/OGG/WAV/FLAC tracks replacing the soundtrack (Discussion #17)
  • Online play, right-stick camera / look back, and a boost camera effect (Discussion #16)

Performance
PC: 60fps on my RTX 3060 even at 4x + 8x MSAA, 120 holds at 3x. Switch: ~60fps overclocked, 30 at stock. Android: 60 on a Galaxy S23 Ultra. iPhone/iPad: 60 on recent models.

Known issues
Android screen recording isn't supported, speed blur is a bit weaker than GameCube, the story cutscene monitor looks garbled, no lens flare.

  • Windows / Switch / Android: a 64-bit Windows 10 or 11 PC (it does the building)
  • Linux / Steam Deck: the Linux machine builds it itself (SteamOS has everything it needs)
  • iPhone / iPad: a Mac with Apple silicon and Xcode, plus a free Apple account
  • Your own Sonic Riders USA disc image: GXEE8P, a full 1.4GB .iso (convert .rvz to ISO in Dolphin first)
  • About 4GB free and internet the first time
  • Switch: custom firmware with the Homebrew Menu
  • Android: 64-bit phone on Android 11+, a USB cable, USB debugging on
Extract the zip and run the installer (on Windows the launcher does it for you). First build takes 10 to 30 minutes. Full guide on GitHub.

Help wanted
Testers: Steam Deck, iPhone/iPad, other Android phones, laptops, 120/144Hz monitors. A bug report with your log (or the zip from F1 > About) goes straight back into Claude.
Devs: graphics, GameCube internals, C or recomp folks: there are help wanted issues on GitHub, Switch stock-clock performance is the big one.

Links
Download | Install guide | Report a bug | Ideas | Changelog

Built on the approach and PowerPC-to-C translator from SwitchWakerHD and ZeldaWWHDRecomp. FSR uses AMD FidelityFX Super Resolution 1 (MIT). Not affiliated with SEGA, Nintendo or Apple.
 
Last edited by teclilla,
Ah nice! Well then this will be geared more towards Switch players. If you don’t mind, could you link the already made one so I can check it out?
I think he means the one officially released in 2006, which might not even work in W10 or 11. Same as Heroes having a very old official pc port too.
 
they do work via windows compatibility xp sp2 and dxvk
Heroes has some sort of patch to downright work on W10. Dunno if Riders 2006 PC has that too
Post automatically merged:

I also tested the most recent build (0.3.1 I believe). While the github page says that the races run at a stable 30fps on stock clocks, I can't get them to run consistently at 30fps even with overclock. Is this because my console is an Erista/V1?

EDIT: On second boot, I can manage to get stable 30fps widescreen with a 1428/576/1600 overclock on most tracks, with 1581/729/1633 needed for the city. Very moderate overclock
 
Last edited by DarkKRPG,
  • Like
Reactions: teclilla
Heroes has some sort of patch to downright work on W10. Dunno if Riders 2006 PC has that too
Post automatically merged:

I also tested the most recent build (0.3.1 I believe). While the github page says that the races run at a stable 30fps on stock clocks, I can't get them to run consistently at 30fps even with overclock. Is this because my console is an Erista/V1?

EDIT: On second boot, I can manage to get stable 30fps widescreen with a 1428/576/1600 overclock on most tracks, with 1581/729/1633 needed for the city. Very moderate overclock
Hello!! Thanks a lot for testing, and for posting your clocks! This is the first performance report from a V1, so it's really useful.

Ok, to my knowledge, it shouldn't be because of your Switch being a V1. At stock clocks a V1 and a Mariko run at exactly the same speeds (CPU 1020 MHz; GPU 384 MHz in handheld, which the port selects, or 768 MHz docked). Mariko's advantage is overclock headroom, which matters for a steady 60, not for 30.

What I think you ran into is that 0.3.1 had a bug. After a few races the game leaves a rarely used colour setting switched on, and from then on the port stopped using its precompiled fast shaders for the rest of the session. The GPU then did several times more work per frame (around 20 fps at stock) until you restarted.

This fits what you saw with it being worse on the first boot and better after a reboot and the GPU clock being what got you back to 30. It's fixed in 0.3.2 (just released). Fast shaders now stay on for a whole session on my OLED at stock clocks.

I’m going to acquire a V1 for testing purposes and to make sure my own hardware testing covers both versions of the consoles.

Also, the "steady 30" on the GitHub page is with Frame rate set to "30 fps (full speed)". The default is Auto, which aims for 60 and skips frames when the console can't keep up, so the fps counter moves around by design. The README should say that more clearly, that's on me.

If you're up for another test:
1. Update to 0.3.2: download the new Switch zip and run its installer with the same iso you used the first time (saves are kept). You can check the version in-game under Minus (press and hold) —> About.
2. Turn your overclock off.
3. Hold Minus > Performance > Frame rate: 30 fps (full speed). Keep widescreen if you like, with resolution at 1x.
4. Play a few races in one session, including metal city.

If it still dips below 30, please send me sonicriders.log and sonicriders.prev.log from switch/sonicriders/ on your SD card plus the track in which it dipped.

Also, were you playing handheld or docked? (Docked already runs the GPU at 768 MHz stock, higher than your 576.)

Thanks again, seriously this is tremendously helpful.
 
  • Like
Reactions: DarkKRPG
Hello!! Thanks a lot for testing, and for posting your clocks! This is the first performance report from a V1, so it's really useful.

Ok, to my knowledge, it shouldn't be because of your Switch being a V1. At stock clocks a V1 and a Mariko run at exactly the same speeds (CPU 1020 MHz; GPU 384 MHz in handheld, which the port selects, or 768 MHz docked). Mariko's advantage is overclock headroom, which matters for a steady 60, not for 30.

What I think you ran into is that 0.3.1 had a bug. After a few races the game leaves a rarely used colour setting switched on, and from then on the port stopped using its precompiled fast shaders for the rest of the session. The GPU then did several times more work per frame (around 20 fps at stock) until you restarted.

This fits what you saw with it being worse on the first boot and better after a reboot and the GPU clock being what got you back to 30. It's fixed in 0.3.2 (just released). Fast shaders now stay on for a whole session on my OLED at stock clocks.

I’m going to acquire a V1 for testing purposes and to make sure my own hardware testing covers both versions of the consoles.

Also, the "steady 30" on the GitHub page is with Frame rate set to "30 fps (full speed)". The default is Auto, which aims for 60 and skips frames when the console can't keep up, so the fps counter moves around by design. The README should say that more clearly, that's on me.

If you're up for another test:
1. Update to 0.3.2: download the new Switch zip and run its installer with the same iso you used the first time (saves are kept). You can check the version in-game under Minus (press and hold) —> About.
2. Turn your overclock off.
3. Hold Minus > Performance > Frame rate: 30 fps (full speed). Keep widescreen if you like, with resolution at 1x.
4. Play a few races in one session, including metal city.

If it still dips below 30, please send me sonicriders.log and sonicriders.prev.log from switch/sonicriders/ on your SD card plus the track in which it dipped.

Also, were you playing handheld or docked? (Docked already runs the GPU at 768 MHz stock, higher than your 576.)

Thanks again, seriously this is tremendously helpful.
I see, thanks for the explanation! I played exclusively on handheld. I'll try out 0.3.2 as well.
 
Hello, I'm having issue while installing it. Here is the setup log.
Thanks for attaching your log! :D The setup tripped over the special letters in your Windows user name (the İ and ç). I've just released v0.3.4, which fixes this:

1. Download the new Switch zip from the releases page.
2. Extract it to a simple folder like C:\SonicRiders (not your Downloads folder).
3. Double-click Install Sonic Riders (Switch).bat again.

It will re-download its tools into C:\SonicRidersTools the first time. If it still fails, please send the new setup.log.
 
  • Love
Reactions: sonicinium
Thanks for attaching your log! :D The setup tripped over the special letters in your Windows user name (the İ and ç). I've just released v0.3.4, which fixes this:

1. Download the new Switch zip from the releases page.
2. Extract it to a simple folder like C:\SonicRiders (not your Downloads folder).
3. Double-click Install Sonic Riders (Switch).bat again.

It will re-download its tools into C:\SonicRidersTools the first time. If it still fails, please send the new setup.log.
Thanks for directing me lol. I had to create a new user without the special characters but no worries, it worked. Actually, it's working much better than the emulation. My FPS counter in status monitor does not work but it's really really smooth (switch oled, handheld mode without overclocking)
 
Thanks for directing me lol. I had to create a new user without the special characters but no worries, it worked. Actually, it's working much better than the emulation. My FPS counter in status monitor does not work but it's really really smooth (switch oled, handheld mode without overclocking)
If you hold (-) minus button for a few seconds, the menu will appear. Look through it and you can toggle the FPS counter to show!
 

Attachments

  • Screenshot 2026-10-31 144607.png
    Screenshot 2026-10-31 144607.png
    681.5 KB · Views: 3
Any support for Steam Deck/Linux? It’s hell trying to run the .bat file on it. Then when you’re finally able to, a black window with the prompt “press any key to continue” only for it to close and never re open after pressing a key.
 
Any support for Steam Deck/Linux? It’s hell trying to run the .bat file on it. Then when you’re finally able to, a black window with the prompt “press any key to continue” only for it to close and never re open after pressing a key.
While I don't have a steam deck, I'll see what i can get the LLM to do for me in that area and i'll get back to you.
Post automatically merged:

Any support for Steam Deck/Linux? It’s hell trying to run the .bat file on it. Then when you’re finally able to, a black window with the prompt “press any key to continue” only for it to close and never re open after pressing a key.
Thanks for trying! The .bat is the Windows installer, so it can't work on the Deck. There's now a native Linux / Steam Deck test version: https://github.com/teclilla18/sonic-riders-recomp/releases/tag/v0.5.0-linux-test

On the Deck, in Desktop Mode:
1. Extract the zip to a folder you'll keep (e.g. ~/Games/SonicRiders).
2. Double-click "Install Sonic Riders (Linux).sh" (choose Execute), pick your Sonic Riders (USA) .iso and wait 10-30 minutes. Nothing gets installed into SteamOS and no sudo is needed; it downloads its own compiler.
3. Steam > Games > Add a Non-Steam Game > tick "Sonic Riders" > Add. It then starts from Game Mode with the Deck's controls (hold View for the settings menu).

You'd be the first to try it on a real Deck, so I'd love to hear how it goes: does it build, does it start in Game Mode, and how do races run? If anything fails, please post setup.log (or sonicriders.log from the game folder) on GitHub issues.
 
Last edited by teclilla,
  • Like
Reactions: RonnieD
While I don't have a steam deck, I'll see what i can get the LLM to do for me in that area and i'll get back to you.
Post automatically merged:


Thanks for trying! The .bat is the Windows installer, so it can't work on the Deck. There's now a native Linux / Steam Deck test version: https://github.com/teclilla18/sonic-riders-recomp/releases/tag/v0.5.0-linux-test

On the Deck, in Desktop Mode:
1. Extract the zip to a folder you'll keep (e.g. ~/Games/SonicRiders).
2. Double-click "Install Sonic Riders (Linux).sh" (choose Execute), pick your Sonic Riders (USA) .iso and wait 10-30 minutes. Nothing gets installed into SteamOS and no sudo is needed; it downloads its own compiler.
3. Steam > Games > Add a Non-Steam Game > tick "Sonic Riders" > Add. It then starts from Game Mode with the Deck's controls (hold View for the settings menu).

You'd be the first to try it on a real Deck, so I'd love to hear how it goes: does it build, does it start in Game Mode, and how do races run? If anything fails, please post setup.log (or sonicriders.log from the game folder) on GitHub issues.
Thank you for making this a reality!!!! It works on steam deck just minor issues like the Full Screen Borderless(Can put up with 4:3 borders for now) and 16:9 Stretch option not working. The chaos board cheat doesn’t work as well(not that it matters I plan on unlocking naturally)
I’ve been wanting to play it this way since I got the steam deck last year. Dream come true.
 
Thank you for making this a reality!!!! It works on steam deck just minor issues like the Full Screen Borderless(Can put up with 4:3 borders for now) and 16:9 Stretch option not working. The chaos board cheat doesn’t work as well(not that it matters I plan on unlocking naturally)
I’ve been wanting to play it this way since I got the steam deck last year. Dream come true.
Awesome! THanks for being so quick about it! Chaos board cheat unlocks it in the shop for zero coins! I'll work on fixes now.
Post automatically merged:

Thank you for making this a reality!!!! It works on steam deck just minor issues like the Full Screen Borderless(Can put up with 4:3 borders for now) and 16:9 Stretch option not working. The chaos board cheat doesn’t work as well(not that it matters I plan on unlocking naturally)
I’ve been wanting to play it this way since I got the steam deck last year. Dream come true.
Thanks again for testing the Linux build!

Quick notes: the old "16:9 Stretch" option was replaced in this build.
Use Fit window (fills the Deck's 16:10 screen, HUD at the edges in races) or 16:9 widescreen.
I found some widescreen bugs in menus and cutscenes, so I'm fixing those first.

The next build also opens fullscreen at the Deck's resolution in Game Mode, so the 4:3 bars should go away.

The Chaos Emerald option puts the board in the Shop for 0 rings (buy it there, then pick it for Sonic). In the next build it will be off by default, since many people want to earn it.

There will also be a "Save a bug report" button (F1 → About) that makes one zip to attach if anything goes wrong. I'll post here when it's up.
 
Last edited by teclilla,

Site & Scene News

New Hot Discussed User Submitted