gctGenerator/guide.html
2020-02-16 14:20:14 +01:00

169 lines
11 KiB
HTML

<!DOCTYPE HTML>
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta name="description" content="A guide on how to install and use practice codes for Super Mario Sunshine.">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link rel="stylesheet" href="style/guide.css">
<link rel="shortcut icon" href="favicon.ico" type="image/x-icon">
<title>Guide</title>
</head>
<body>
<div id="guide_content" class="framed">
<h1>How to install and use practice codes</h1>
<p class="center">This page is a simple guide to explain the recommended way to
install practice codes on your Nintendo Wii.</p>
<br />
<div id="indexlisting">
<h3><a href="#1">1. Preparing your Wii</a></h3>
<h3><a href="#2">2. Install and use the cheatfile</a></h3>
<h3><a href="#3">3. Troubleshooting</a></h3>
<h3><a href="#4">4. Appendix: Cheat Manager (Homebrew)</a></h3>
<h3><a href="#5">5. Appendix: Using the codes with Dolphin</a></h3>
</div>
<br />
<hr />
<h2 id="1"><a href="#1">1. Preparing your Wii</a></h2>
<h3 id="1.1"><a href="#1.1">1.1 Install Homebrew</a></h3>
<p>First of all you're gonna have to install Homebrew on your Wii. Make sure your SD card is <a target="_blank"
href="https://superuser.com/questions/1179871/how-to-format-a-disk-sdcard-as-fat32-in-windows-10/1179872#1179872">formatted
to FAT32</a> and then <a target="_blank" href="https://sites.google.com/site/completesg/hacking-guide">click
this link</a> for a detailed guide on how to get Homebrew on your Wii. Ignore the "<i>So, what's next?</i>"
section.</p>
<br />
<h3 id="1.2"><a href="#1.2">1.2 Install the necessary applications</a></h3>
<p>Using <a target="_blank" href="https://github.com/FIX94/Nintendont">Nintendont</a> is the recommended way to
use practice codes. To download the most recent build you can <a target="_blank"
href="https://share.zint.ch/nintendont/latest/Nintendont.zip">click this link</a>.</p>
<p>Unpack the archive and place the Nintendont folder with all of its contents in the "<i>apps</i>" folder of your
SD card. If there is no "<i>apps</i>" folder create one in the root of your SD card.</p>
<br />
<hr />
<h2 id="2"><a href="#2">2. Install and use the cheatfile</a></h2>
<h3 id="2.1"><a href="#2.1">2.1 Generate the file</a></h3>
<p>Visit the <a target="_blank" href="index.html">main site</a> and select your game version from the dropdown
menu. Then select all the cheats you want to have enabled from the list, choose GCT as file format and hit
"Download". The name of the file you downloaded should be "GMSX01.gct" with X being E, P or J depending on the
version you selected.</p>
<br />
<p>Note: JP 1.0 and JP 1.1 both use the same ID (GMSJ01). To identify if you own JP 1.0 or 1.1 check the back
of your disc. It'll read "DOL-GMSJ-0-00" for 1.0 and "DOL-GMSJ-0-01" for 1.1:</p>
<br />
<p class="center"><img src="img/jp_diff.png" alt="JP Version difference" /></p>
<br />
<h3 id="2.2"><a href="#2.2">2.2 Copy the file onto your SD card</a></h3>
<p>Create a "<i>codes</i>" folder in the root of your SD card if there is none and copy the GCT file you just
downloaded into that folder. This is what the resulting folder structure should look like on your SD card (the
.gct
files might be different depending on the version you chose):</p>
<br />
<p class="center"><img src="img/folderstructure.png" alt="Folder Structure" /></p>
<br />
<h3 id="2.3"><a href="#2.3">2.3 Use the codes</a></h3>
<p>Open your Homebrew channel and from there launch Nintendont. Select SD and then press B on your Gamecube
controller to see the settings. In your settings, make sure that "<i>Cheats</i>" are "<i>On</i>". You can
switch it on/off by pressing A on your controller. (See image below)</p>
<p class="center"><a target="_blank" href="img/nintendont_cheats.jpg"><img src="img/nintendont_cheats.jpg"
style="width:50%;min-width:300px;margin:20px 0px" alt="Nintendont" /></a>
</p>
<p>Press B again to return to the game list and launch your game. And with that you're done already.</p>
<br />
<hr />
<h2 id="3"><a href="#3">3. Troubleshooting</a></h2>
<h3 id="3.1"><a href="#3.1">3.1 The game doesn't launch / Stuck at black screen</a></h3>
<p>This is not a practice code related issue. You have the following options if that happens to you:</p>
<ul>
<li>Restart Nintendont until the game launches (usually takes a few attempts).</li>
<li>Connect your Wii to the internet before launching Nintendont.</li>
<li>Wait around 30 seconds on the game selection screen before booting the disc.</li>
<li>Reinstalling homebrew may fix this issue permanently.</li>
</ul>
<br />
<h3 id="3.2"><a href="#3.2">3.2 Nintendont says IOS58 is missing</a></h3>
<p><a href="ios58.html">Here's a guide</a> on how to install IOS58 for use with Nintendont.</p>
<br />
<h3 id="3.3"><a href="#3.3">3.3 The game launches but the codes don't work</a></h3>
<p>This can have multiple reasons:</p>
<ul>
<li>You don't have cheats enabled: See <a href="#2.3">2.3</a> for details.</li>
<li>You're using an obsolete version of Nintendont. Make sure you use version 4.434 or newer.</li>
<li>Your cheatfile has the wrong name: Make sure the file is named "GMSE01.gct", "GMSJ01.gct" or "GMSP01.gct".
It won't work with names like "GMSE01 (1).gct". Nintendont is very picky!</li>
<li>Your cheatfile is at the wrong location: Make sure the file is in the "codes" folder of your SD Card.
Again, the folder has to be named "codes" (See sample folder structure in <a href="#2.2">section 2.2</a>).
If you have a "games"
folder, make sure there's no file with the same name in it or its subfolders.</li>
<li>Your cheatfile is too big: Using too many codes at once can cause Nintendont to disable them since the used
space in the game is limited. Make sure you don't have two incompatible codes selected when downloading the
cheatfile (for example "Level Select", "Fast Any%" and the Stage loader cannot be used
simultaneously).<br /><br /><i><b>Note: If you're using Nintendont 4.434 or newer you don't have to worry
unless your file is bigger than 8KB.</b></i></li>
<li>If you have a USB drive connected and use disc, make sure you select the device that contains the cheats
for your disc.</li>
<li>If you use an ISO your cheat file and ISO must be on the same device (both on the SD card or both on the
USB drive).</li>
</ul>
<br />
<h3 id="3.4"><a href="#3.4">3.4 The site doesn't show codes or the download button</a></h3>
<p>The main site requires Javascript to work properly. Make sure you have Javascript enabled in your browser.</p>
<br />
<br />
<hr />
<h2 id="4"><a href="#4">4. Appendix: Cheat Manager (Homebrew)</a></h2>
<br />
<p>The Cheat Manager is a homebrew application that allows you to generate GCTs on your Wii. This way you don't
have to redownload your cheatfile everytime you want a different combination. However, you're gonna have to use
a Wiimote to control the application</p>
<h3 id="4.1"><a href="#4.1">4.1 Setup</a></h3>
<p>You can download the Cheat Manager from <a target="_blank" href="http://wiibrew.org/wiki/CheatManager"
title="CheatManager - WiiBrew">WiiBrew</a>. Unzip the archive and copy the contents into the "<i>apps</i>"
folder of your SD card.</p>
<br />
<p>Using the generator on the <a target="_blank" href="index.html">main site</a>, select all the codes you want to
have available on the cheat manager and choose "<i>Cheat Manager TXT</i>" as file format instead of
"<i>GCT</i>" to download a text file formatted for use with the cheat manager. Create a "<i>txtcodes</i>"
folder in the root of your SD card if there is none and copy the generated text file into that folder. The name
of the text file doesn't matter if you use this application, since the games ID is stored in the textfile.</p>
<h3 id="4.2"><a href="#4.2">4.2 Using the Cheat Manager</a></h3>
<p>Launch the cheat manager and grab your Wiimote. Navigate to your textfile using the DPad and select it with
"<i>A</i>". On the following screen press "<i>+</i>" to activate and "<i>-</i>" to deactivate a cheat.</p>
<br />
<p>After activating your desired codes press "<i>1</i>" to generate the GCT file. The cheatmanager then creates
the GCT file in your "<i>codes</i>" folder, overwriting the old one if there's already a GCT with the same
name. If you now launch the game with cheats active the new codes will be loaded.</p>
<br />
<hr />
<h2 id="5"><a href="#5">5. Appendix: Using the codes with Dolphin</a></h2>
<h3 id="5.1"><a href="#5.1">5.1 Setup</a></h3>
<p>To use the codes with Dolphin choose "<i>Dolphin INI</i>" as file format instead of "<i>GCT</i>" to download
the codes formatted for use with Dolphin.</p>
<br />
<h4 id="5.1.1"><a href="#5.1.1">5.1.1 Configuration in Dolphin 5.0 or older</a></h4>
<p>
Right click the game in Dolphin and click on "<i>Properties</i>"
and on the bottom left corner of the property window click the "<i>Edit configuration</i>" button. Open the
text file you downloaded and copy everything following the "<i>[Gecko]</i>" tag below
the same tag in the configuration you just opened. If there is no "<i>[Gecko]</i>" tag (it should be the first
tag), create one on top of your configuration file. Save and close the configuration file.
</p>
<br />
<p class="center"><img src="img/dolphin_gecko_codes_v1.png" alt="Dolphin 5.0 preview" /></p>
<h4 id="5.1.2"><a href="#5.1.2">5.1.2 Configuration in Dolphin 5.0-11XXX or newer</a></h4>
<p>
Right click the game in Dolphin and click on "<i>Properties</i>". In the "<i>Game Config</i>" section choose
the "<i>Editor</i>" tab and paste the contents of the text file you just downloaded into the "<i>User
Config</i>" editor.
</p>
<br />
<p class="center"><img src="img/dolphin_gecko_codes_v2.png" alt="Dolphin ^5.0-11XXX preview" /></p>
<h3 id="5.2"><a href="#5.2">5.2 Using the codes</a></h3>
<p>Select the "<i>Gecko-Codes</i>" tab in the game properties and check all the codes you want to be active.
Most (but not all codes) will work with Dolphin. However, Dolphin has a code limit which is reached rather
quickly. So if your game crashes right after it starts, you probably have too many codes active simultaneously.
</p>
</div>
</body>
</html>