aboutsummaryrefslogtreecommitdiff
path: root/content/projects/riibalanced-patcher.md
blob: 468d67d54b3c8a91a694fc8303a5ef1eae4742b0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
---
title: "Riibalanced Patcher"
description: "An ISO/WBFS Mario Kart Wii patcher for Riibalanced Version 5"
icon: "funky.png"
license: "FOSS License"
languages: "Bash"
current: true
date: 2022-06-01
enddate: "January 2, 2006"
draft: false
---
A simple shell script that takes the Riibalanced Patch Files and builds a WBFS image using WIM's Image Tools that can be used in Dolphin Netplay or just for your enjoyment. Built out of disappointment that the maintainers didn't care to make a patcher for Version 5. **This patcher only works for Version 5 of Riibalanced.**

While no active development is made on this script, I will happily make changes/review pull requests if needed.

## How to use

You need three things before starting:

1. A computer system running Linux/BSD, macOS, or Windows.
2. A Mario Kart Wii image in ISO, WBFS, WDF, WIA, CISO, WBI, or GCZ format. (Obtained legally, of course)
3. The Riibalanced Patch Archive (This can be downloaded via the Riibalanced Discord Server)

To get the script ready, you can follow my [setup guide](https://codeberg.org/brysonsteck/riibalanced-patcher/src/branch/master/SETUP.md) on the project's repo *(recommended for Windows users)* or wing it. The script will guide you on what you need to do in order for the patcher to work correctly anyways.

## Current Issues with the Patcher

* Main Menu button videos do not appear
  * This could be because there is a file referenced in the patch's Riivolution XML, but doesn't exist.
  * Running the resulting image in Dolphin on Windows has the issue above, however, running the resulting image in Dolphin on Linux and macOS(?) does not have this issue for some reason.
  * The resulting image does not work on original hardware. Maybe due to IOS issues with USB loaders?
    * For whatever reason, the game does not make it past any selection made on the Main Menu before crashing at the black loading screen.
    * The game also crashes if you try to wait for the trailer at the "Press the A button" screen, showing a white screen before crashing.