From Custom Mario Kart
Jump to navigation Jump to search
Author: Aaron "AerialX", tueidj, Tempus, megazig
Version: v1.06
Date of latest version: 2013-12-18
Download: GitHub (Riivolution Archive)
Source code: GitHub


Riivolution is an on-the-fly game patcher created by AerialX, tueidj, Tempus, and megazig for use with retail discs. It allows users to place content on their SD or USB devices, as well as on a RiiFS server, which will be read by the game during regular play. It is used by several custom track distributions in order to run modified tracks without a patched ISO. Riivolution is supported on console and Dolphin since version 5.0-15407. For older versions of Dolphin, you will need to patch your ISO.


Riivolution uses XML files to load custom content from an external filesystem. To use this, have your XML point to a folder with all the custom content inside and place the XML in the "riivolution" folder. The format of these XML files is described here, and templates are available here.

Riivolution game patching tutorial
How to run Riivolution mods on Dolphin (For builds prior to 5.0-15407)


Does Riivolution work with my backups or USB loaders?

No. And that's not a bug.

Does Riivolution work with my PAL/NTSC/JAP Wii/game?


Does Riivolution work on my Wii U?

It does now! In vWii mode (it does not work with Wii U games) Riivolution can be run or installed through Smash Stack, other game exploits, or the Homebrew Channel if it's already installed.

What IOS does it need installed?

Riivolution requires an updated IOS37; if you're on System Menu 4.2 or 4.3 you don't need to do anything. If it's not installed or the proper version it will be installed the first time Riivolution is run.

Alternatively, you can also use NUSD or DOP-IOS to install it - with all patches disabled.

Does Riivolution work with Game X?

I probably haven't played it, but yes, it should; try it. If it doesn't work, report it - some games known to reload IOS will require specific patches to work.

Games that have specifically been tested include Fatal Frame 4, Super Smash Bros. Brawl, New Super Mario Bros. Wii, Rock Band, among others.

What does the "Install" button do?

It will install a Riivolution channel onto your System Menu for easy access. This can always be uninstalled.

Can I use Ocarina / Gecko codes with it?

Normally, Riivolution just supports direct memory patches. However, Riivolution supports a patching method that can be used with the Gecko OS code handler.

Read more about that here.

Uhh, how do I use this?

As a user, you need to either download patch packages made by someone else or make your own.

A basic template and packages for common games can be found at the patch templates section. For a more detailed explanation about Riivolution's patch XML files, check out the instructions.

Network support? Awesome, how do I use it?

Read more about all of Riivolution's network features.

Version History

Version Date of release Information
v1.0 2010-03-20 First release
v1.01 2010-03-22
  • Memory patch improvements.
  • Mounted disk improvements.
  • Added network support.
v1.02 2010-03-28
  • Added disc file support.
  • More memory patch improvements.
  • Added network hostname lookups.
  • Network stability improvements.
  • Games will now connect to the network alongside RiiFS.
  • Added foreign character support in XMLs (Latin-1).
v1.03 2010-06-28
  • Added System Menu 4.3 compatibility.
  • Added Wii slot light filesystem indicator.
  • Stability fixes for all filesystems.
  • Files now close after a few seconds to allow them to be replaced over RiiFS.
  • Supported NetBEUI hostname lookups.
  • Improved channel install.
    • It no longer requires SD/USB.
  • RiiFS improvements.
    • Native C++ Server.
    • Connects automatically on a LAN without needing SD/USB.
v1.04 2010-09-22
  • This update provides behind-the-scenes fixes that will not affect features but will improve the overall system performance.
  • Added System Menu 4.3v2 compatibility (September 8th, 2010 update).
  • Added new savefile redirection feature.
v1.05 2013-06-10
  • The Wii U (Virtual Wii Menu) is now supported.
  • Added new Wii Remote Plus remotes are now properly supported.
v1.06 2013-12-18 Fixed Wii Remote disconnection issues (Smash Bros. Brawl strap screen crash).

Known Bugs

In a distribution via Riivolution, the game can freeze when a player completes a lap. This occurs for some Wii users.