Help:Using mods: Difference between revisions

From ZeldaMods (Breath of the Wild)
Jump to navigation Jump to search
imported>BravelyPeculiar
mNo edit summary
m (updated the link for the Cemu Optimize guide, as the link provided would send you to this one anyway, also fixed a couple typos)
(21 intermediate revisions by 8 users not shown)
Line 5: Line 5:
* Switch console
* Switch console


Almost all Wii U mods should work on both the console and Cemu, but most Switch mods aren't cross-compatible. In addition, many mods are only compatible with the latest 1.5.0 version of BotW.
Almost all Wii U mods should work on both the console and Cemu, but most Switch mods aren't cross-compatible. In addition, many mods are only compatible with version 1.5.0 of BotW.


Note that any mods which edit any of the same files as each other will probably be incompatible and cause issues. Sometimes, mods that edit different files can also be unexpectedly incompatible. If you are using multiple mods and you find glitches, please figure out which mod / combination of mods is causing the issue before reporting it to the mod creator(s).
Note that any mods which edit any of the same files as each other will probably be incompatible and cause issues. Sometimes, mods that edit different files can also be unexpectedly incompatible. If you are using multiple mods and you find glitches, please figure out which mod / combination of mods is causing the issue before reporting it to the mod creator(s).
Line 14: Line 14:
Follow [https://wiiu.hacks.guide/ this guide] to set up your Wii U console to use homebrew software.
Follow [https://wiiu.hacks.guide/ this guide] to set up your Wii U console to use homebrew software.


=== Setting up SDCafiine ===
=== Setting up WUPS SDCafiine ===
SDCafiine is a Wii U homebrew program that will load modded game files from your SD card.
SDCafiine is a Wii U homebrew program that will load modded game files from your SD card. The classic version has a history of serious stability problems, as the program eventually unloads from memory, and game files begin to revert to their un-modded state. An alternative version designed for the Wii U Plugin System (WUPS) is ''much'' more stable and does not usually unload, so it is recommended.


# Download the latest stable release of SDCafiine (not a "nightly" version) from [https://github.com/Maschell/SDCafiine/releases here].
# Download the latest nightly release of the Wii U Plugin Loader from [https://github.com/Maschell/WiiUPluginLoader/releases here].
# Extract the contents of the .zip into the root of your SD card.
# Download the latest WUPS nightly of SDCafiine from [https://github.com/Maschell/SDCafiine/releases/tag/SDCafiine-WUPS-v1.4-nightly-67aa461 here].
# Extract the contents of the .zip into the root of your SD card.
# Extract the contents of the .zip into the root of your SD card.
# Create a new folder in the root of your SD Card, named <code>sdcafiine</code>.
# Create a new folder in the root of your SD Card, named <code>sdcafiine</code>.
# Within that folder, create a new folder with the name of your game's Title ID. On Wii U, the JP version of BotW uses <code>00050000101C9300</code>, the US version uses <code>00050000101C9400</code>, and the EU version uses <code>00050000101C9500</code>.
# Within that folder, create a new folder with the name of your game's Title ID. On Wii U, the JP version of BotW uses <code>00050000101C9300</code>, the US version uses <code>00050000101C9400</code>, and the EU version uses <code>00050000101C9500</code>.
# Within that folder, you can create any number of folders named after the mods you want to use. When you boot the game, a menu will appear allowing you to select one to use.
# Within that folder, you can create any number of folders named after the mods you want to use. When you boot the game, a menu will appear allowing you to select one to use.
# Inside each of those folders, create a folder named <code>content</code>. Your mod files will go in here. (Mods will often include a <code>content</code> folder already to make things clear.)
# Inside each of those folders, create a folder named <code>content</code>. Your mod files will go in here. (Mods will often include a <code>content</code> folder already to make things clear. If using BCML, this is where you will put the contents of the exported BCML pack.)


To use mods, you just need to select the SDCafiine option from the Homebrew Launcher, then boot your game immediately afterwards.
To use mods:
# Run the Wii U Plugin Loader option from the Homebrew Launcher
# Tick the SDCafiine plugin on and press '''+''' to Apply Patches.
# Back at the Wii U menu, launch BOTW.
# If you have only one mod, it will load automatically. If there are multiple mods, you will be prompted to select one to use.


== Cemu Emulator ==
== Cemu Emulator ==
=== Download Cemu Emulator ===
You can find the latest version of Cemu Emulator on the [http://cemu.info/ Official Cemu Website]


=== Setting up homebrew ===
=== Setting up homebrew ===
Line 37: Line 46:
If you dumped the game's add-on content (aoc) files, follow [http://compat.cemu.info/wiki/Tutorial:How_to_install_a_DLC this guide] to install them in Cemu.
If you dumped the game's add-on content (aoc) files, follow [http://compat.cemu.info/wiki/Tutorial:How_to_install_a_DLC this guide] to install them in Cemu.


=== Installing mods with the graphicpack menu ===
=== Setting up and Maximizing Performance ===
This method works as of Cemu 1.15.1.
Now that you have Cemu and your games files, it is recommended you use [https://cemu.cfw.guide Emiyl's Cemu Setup Guide] to maximize performance on your hardware before installing mods.
 
 
=== Installing mods using BCML ===
Mods that are packaged as a graphic pack or as a BNP can be installed using [[Help:Tools/BCML|BCML]], a mod loading tool. In addition to being simpler than manually extracting and enabling the mod, BCML is designed to resolve certain kinds of conflicts between different mods. Mods that modify many types of content, including the [[RSTB]], the same [[SARC]] files, or [[Message archives]], among many others, will not function properly together unless the changes are merged. BCML does this automatically. To install mods with BCML:
 
# Install and setup BCML using the instructions [[Help:Tools/BCML#Setup|here]] or in [https://www.youtube.com/watch?v=8gKRifYyA68 this video tutorial].
# Open BCML.
# Click the floating action button to install mods.
 
For more information on using BCML, see the [https://github.com/NiceneNerd/BCML/tree/master/docs BCML docs].
 
BCML should automatically enable installed mods in Cemu, but check to make sure by opening the Cemu graphic pack menu and making sure the "BCML" graphic pack under <code>The Legend of Zelda: Breath of the Wild/Mods/BCML</code> is enabled.
 
=== Installing mods with the graphic pack menu ===
Cemu uses "graphic packs" to install mods without overwriting any of the base files, allowing you to easily install or uninstall mods without leaving any trace.
 
Graphic packs are installed by placing the unzipped folder in <code>Cemu/graphicPacks/</code>. Note that most newer mods will come packaged as a graphic pack, or have a graphic pack option.
 
To check that the mod is a graphic pack, open the mod folder within <code>Cemu/graphicPacks/</code>. A graphic pack will have a file called <code>rules.txt</code> next to the <code>content</code> and/or <code>aoc</code> folder.


# Create a new folder inside <code>Cemu/graphicPack/</code> named after the mod you want to use.
 
If a mod is not packaged as a graphic pack you will have to package it yourself, otherwise skip to the end of this section. This method works for versions of Cemu 1.15.1+
 
# Create a new folder inside <code>Cemu/graphicPacks/</code> named after the mod you want to use.
# Inside that folder, create a folder named <code>content</code>. Your mod files will go in here. (Mods will often include a <code>content</code> folder already to make things clear.)
# Inside that folder, create a folder named <code>content</code>. Your mod files will go in here. (Mods will often include a <code>content</code> folder already to make things clear.)
# Create a file named <code>rules.txt</code> next to the <code>content</code> folder (if the downloaded mod doesn't already include one). Inside it goes:
# Create a file named <code>rules.txt</code> next to the <code>content</code> folder (if the downloaded mod doesn't already include one). Use this example as a template:


  [Definition]
  [Definition]
  titleIds = 00050000101C9300,00050000101C9400,00050000101C9500
  titleIds = 00050000101C9300,00050000101C9400,00050000101C9500
  name = Mod Name
  name = <Mod Name>
  path = "The Legend of Zelda: Breath of the Wild/Game Mods/Mod Packs/Mod Name"
  path = "The Legend of Zelda: Breath of the Wild/Mods/<Mod Name>"
  description = Mod description here.
  description = <Mod description here>
  version = 3
  version = 3
  fsPriority = 100
  fsPriority = 100
<code>version</code> must be set to 3 to work correctly. <code>fsPriority</code> determines the order in which mods are prioritized - higher numbers prioritize that mod's files over other mods. Mods without an <code>fsPriority</code> entry specified will default to 100.
<code>version</code> must be set to 3 to work correctly. <code>fsPriority</code> determines the order in which mods are prioritized - higher numbers prioritize that mod's files over other mods. Mods without an <code>fsPriority</code> entry specified will default to 100.


Once a mod has been added, simply enable it from Cemu's graphic pack menu to use it. Note that most mods should not be enabled or disabled while the game is running.
Once a mod has been added, simply enable it from Cemu's graphic pack menu to use it. You can find this menu in <code>Options > Graphic Packs</code> or by right-clicking a game and selecting <code>Edit Graphic Packs</code>.
Note that most mods should not be enabled or disabled while the game is running.


== Switch ==
== Switch ==
=== Warning ===
When you boot custom firmware (CFW) on your Switch console, the console becomes permanently "online-unsafe". Turning off Airplane Mode while unsafe has a risk of gettinf the console banned from Nintendo's online services (including eShop and game updates). This risk is reduced if you are sensible and only use mods on offline games (don't install NSPs or pirate games!)
If you never went online while in "online-unsafe" mode, then by restoring a clean NAND backup that you made ''before'' you ever booted into CFW, you can make the console "online-safe" again. You can then safely go online until the next time you boot into CFW.


=== Setting up homebrew ===
=== Setting up homebrew ===
Follow [https://guide.sdsetup.com this guide] to set up your Switch console to use homebrew software.
Follow [https://guide.sdsetup.com this guide] to set up your Switch console to use homebrew software.


This tutorial uses Atmosphere CFW. Using SXOS CFW is not recommended, as unlike Atmosphere, it costs money, uses stolen code (from Atmosphere!), and is closed source, making it impossible to check how safe it is to use.
This tutorial uses Atmosphère Custom Firmware (CFW). It is strongly recommended '''not''' to use other CFWs as they tend to be outdated, unsafe and/or use stolen code from Atmosphère.
{{warning|text=Running homebrew on your console may lead to it getting banned from Nintendo's online services (including eShop and game updates). Enabling Airplane Mode will not help, as telemetry reports are saved and sent to Nintendo the next time you connect to the internet.


=== Installing mods ===
However, this risk is very minimal as long as you are sensible and only use a safe, sane CFW (Atmosphère) and mods on offline games (don't install NSPs or pirate games!) as Atmosphère does not leave any trace on the system and disables some system telemetry.
 
# In the root of your MicroSD card, there should be a folder named <code>atmosphere</code>, <code>sxos</code>, or <code>reinx</code>, depending on which CFW you are using.
# Within that folder, there should be a folder named <code>titles</code>. Inside that, create a folder with the name of your game's Title ID. For BotW on Switch, the Title ID is <code>01007EF00011E000</code>.
# Inside that, make a folder called <code>romfs</code>. Your mod files will go in here. (Mods will often include all or part of this folder structure already, to make things easy.)


To use the mod, simply boot the console into CFW, then boot the game, and the mod will be active.
If you are paranoid, turn on Airplane Mode ''before running homebrew for the first time'', then make a full system backup, and always stay offline until you restore that clean backup.}}


=== Disabling telemetry reports ===
=== Disabling telemetry reports ===
Line 80: Line 104:
Mods that modify actors are especially dangerous as they might cause the game to use the ActorSystem emergency heap and trigger many memory-related play reports.
Mods that modify actors are especially dangerous as they might cause the game to use the ActorSystem emergency heap and trigger many memory-related play reports.


To disable problematic telemetry reports, download this [http://static.zeldamods.org/patch_switch150_no_telemetry.ips patch] and put it in <code>/atmosphere/exefs_patches/botw_no_telemetry/16A91992BBA71201E98756F3BC8F5D2F.ips</code>. This patch works for the Switch 1.5.0 [[executable]] only (build ID: 16A91992BBA71201E98756F3BC8F5D2F).
To disable problematic telemetry reports:
 
* For 1.5.0, download this [https://static.zeldamods.org/patch_switch150_no_telemetry.ips patch], put it in <code>/atmosphere/exefs_patches/botw_no_telemetry/</code> (create new folders if required) and rename the file to <code>16A91992BBA71201E98756F3BC8F5D2F.ips</code>. This patch works for the Switch 1.5.0 [[executable]] only (build ID: 16A91992BBA71201E98756F3BC8F5D2F).
 
* For 1.6.0, download this [https://static.zeldamods.org/patch_switch160_no_telemetry.ips patch], put it at <code>/atmosphere/exefs_patches/botw_no_telemetry/</code> (create new folders if required) and rename the file to <code>8E9978D50BDD20B4C8395A106C27FFDE.ips</code>. This patch works for the Switch 1.6.0 [[executable]] only (build ID: 8E9978D50BDD20B4C8395A106C27FFDE).
 
=== Installing mods ===
 
# In the root of your MicroSD card, there should be a folder named <code>atmosphere</code>.
# Within that folder, there should be a folder named <code>contents</code>. Inside that, create a folder with the name of your game's Title ID. For BotW on Switch, the Title ID is <code>01007EF00011E000</code>. (In versions of Atmosphere prior to v0.10.0, the <code>contents</code> folder was instead called <code>titles</code>.)
# Inside that, make a folder called <code>romfs</code>. Your mod files will go in here. (Mods will often include all or part of this folder structure already, to make things easy.)
 
To use the mod, simply boot the console into CFW, then boot the game, and the mod will be active.
 
Note that mods are not permanently installed on the console. To remove all installed mods, simply delete <code>/atmosphere/contents/01007EF00011E000</code>.
[[Category:Guides]]

Revision as of 13:06, 31 December 2022

Welcome, players! This article will walk you through setting up BotW to play with mods. There are three different platforms you can play on:

  • Wii U console
  • Cemu, the Wii U emulator, on your computer
  • Switch console

Almost all Wii U mods should work on both the console and Cemu, but most Switch mods aren't cross-compatible. In addition, many mods are only compatible with version 1.5.0 of BotW.

Note that any mods which edit any of the same files as each other will probably be incompatible and cause issues. Sometimes, mods that edit different files can also be unexpectedly incompatible. If you are using multiple mods and you find glitches, please figure out which mod / combination of mods is causing the issue before reporting it to the mod creator(s).

Wii U Console

Setting up homebrew

Follow this guide to set up your Wii U console to use homebrew software.

Setting up WUPS SDCafiine

SDCafiine is a Wii U homebrew program that will load modded game files from your SD card. The classic version has a history of serious stability problems, as the program eventually unloads from memory, and game files begin to revert to their un-modded state. An alternative version designed for the Wii U Plugin System (WUPS) is much more stable and does not usually unload, so it is recommended.

  1. Download the latest nightly release of the Wii U Plugin Loader from here.
  2. Extract the contents of the .zip into the root of your SD card.
  3. Download the latest WUPS nightly of SDCafiine from here.
  4. Extract the contents of the .zip into the root of your SD card.
  5. Create a new folder in the root of your SD Card, named sdcafiine.
  6. Within that folder, create a new folder with the name of your game's Title ID. On Wii U, the JP version of BotW uses 00050000101C9300, the US version uses 00050000101C9400, and the EU version uses 00050000101C9500.
  7. Within that folder, you can create any number of folders named after the mods you want to use. When you boot the game, a menu will appear allowing you to select one to use.
  8. Inside each of those folders, create a folder named content. Your mod files will go in here. (Mods will often include a content folder already to make things clear. If using BCML, this is where you will put the contents of the exported BCML pack.)

To use mods:

  1. Run the Wii U Plugin Loader option from the Homebrew Launcher
  2. Tick the SDCafiine plugin on and press + to Apply Patches.
  3. Back at the Wii U menu, launch BOTW.
  4. If you have only one mod, it will load automatically. If there are multiple mods, you will be prompted to select one to use.

Cemu Emulator

Download Cemu Emulator

You can find the latest version of Cemu Emulator on the Official Cemu Website

Setting up homebrew

Follow this guide to set up your Wii U console to use homebrew software, in order to allow you to dump the game files from your console to your PC.

Dumping the game files

To play BotW on Cemu, you'll need to dump the game files from the console to your computer. Then run the U-King.rpx file from Cemu to boot the game.

Installing the DLC

If you dumped the game's add-on content (aoc) files, follow this guide to install them in Cemu.

Setting up and Maximizing Performance

Now that you have Cemu and your games files, it is recommended you use Emiyl's Cemu Setup Guide to maximize performance on your hardware before installing mods.


Installing mods using BCML

Mods that are packaged as a graphic pack or as a BNP can be installed using BCML, a mod loading tool. In addition to being simpler than manually extracting and enabling the mod, BCML is designed to resolve certain kinds of conflicts between different mods. Mods that modify many types of content, including the Resource system, the same SARC files, or Message archives, among many others, will not function properly together unless the changes are merged. BCML does this automatically. To install mods with BCML:

  1. Install and setup BCML using the instructions here or in this video tutorial.
  2. Open BCML.
  3. Click the floating action button to install mods.

For more information on using BCML, see the BCML docs.

BCML should automatically enable installed mods in Cemu, but check to make sure by opening the Cemu graphic pack menu and making sure the "BCML" graphic pack under The Legend of Zelda: Breath of the Wild/Mods/BCML is enabled.

Installing mods with the graphic pack menu

Cemu uses "graphic packs" to install mods without overwriting any of the base files, allowing you to easily install or uninstall mods without leaving any trace.

Graphic packs are installed by placing the unzipped folder in Cemu/graphicPacks/. Note that most newer mods will come packaged as a graphic pack, or have a graphic pack option.

To check that the mod is a graphic pack, open the mod folder within Cemu/graphicPacks/. A graphic pack will have a file called rules.txt next to the content and/or aoc folder.


If a mod is not packaged as a graphic pack you will have to package it yourself, otherwise skip to the end of this section. This method works for versions of Cemu 1.15.1+

  1. Create a new folder inside Cemu/graphicPacks/ named after the mod you want to use.
  2. Inside that folder, create a folder named content. Your mod files will go in here. (Mods will often include a content folder already to make things clear.)
  3. Create a file named rules.txt next to the content folder (if the downloaded mod doesn't already include one). Use this example as a template:
[Definition]
titleIds = 00050000101C9300,00050000101C9400,00050000101C9500
name = <Mod Name>
path = "The Legend of Zelda: Breath of the Wild/Mods/<Mod Name>"
description = <Mod description here>
version = 3
fsPriority = 100

version must be set to 3 to work correctly. fsPriority determines the order in which mods are prioritized - higher numbers prioritize that mod's files over other mods. Mods without an fsPriority entry specified will default to 100.

Once a mod has been added, simply enable it from Cemu's graphic pack menu to use it. You can find this menu in Options > Graphic Packs or by right-clicking a game and selecting Edit Graphic Packs. Note that most mods should not be enabled or disabled while the game is running.

Switch

Setting up homebrew

Follow this guide to set up your Switch console to use homebrew software.

This tutorial uses Atmosphère Custom Firmware (CFW). It is strongly recommended not to use other CFWs as they tend to be outdated, unsafe and/or use stolen code from Atmosphère.

Disabling telemetry reports

The Switch version of Breath of the Wild sends many telemetry reports so when you are using mods that modify gameplay in a detectable way or add new content in any way, it is strongly recommended to disable telemetry reports because they are used by Zelda developers to understand how people play BotW and also to help them fix bugs.

Mods that modify actors are especially dangerous as they might cause the game to use the ActorSystem emergency heap and trigger many memory-related play reports.

To disable problematic telemetry reports:

  • For 1.5.0, download this patch, put it in /atmosphere/exefs_patches/botw_no_telemetry/ (create new folders if required) and rename the file to 16A91992BBA71201E98756F3BC8F5D2F.ips. This patch works for the Switch 1.5.0 executable only (build ID: 16A91992BBA71201E98756F3BC8F5D2F).
  • For 1.6.0, download this patch, put it at /atmosphere/exefs_patches/botw_no_telemetry/ (create new folders if required) and rename the file to 8E9978D50BDD20B4C8395A106C27FFDE.ips. This patch works for the Switch 1.6.0 executable only (build ID: 8E9978D50BDD20B4C8395A106C27FFDE).

Installing mods

  1. In the root of your MicroSD card, there should be a folder named atmosphere.
  2. Within that folder, there should be a folder named contents. Inside that, create a folder with the name of your game's Title ID. For BotW on Switch, the Title ID is 01007EF00011E000. (In versions of Atmosphere prior to v0.10.0, the contents folder was instead called titles.)
  3. Inside that, make a folder called romfs. Your mod files will go in here. (Mods will often include all or part of this folder structure already, to make things easy.)

To use the mod, simply boot the console into CFW, then boot the game, and the mod will be active.

Note that mods are not permanently installed on the console. To remove all installed mods, simply delete /atmosphere/contents/01007EF00011E000.