Help:Creating mods: Difference between revisions

From ZeldaMods (Breath of the Wild)
Jump to navigation Jump to search
imported>BravelyPeculiar
(Created page)
 
(Update state of modding)
(33 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Stub|what=}}
Welcome, modders! This page contains useful information for anybody who wants to create mods. If you just want to use other people's mods, see [[Help:Using mods]].


Welcome, modders! This page is intended to be a collection of useful information for new and existing modders.
== What can currently be modded? ==


== Getting Started ==
* Textures
* Models
* Actor parameters, including enemies, weapons, and armors
* Adding new actors
* Overworld and dungeon map files
* Event flows, and as a direct consequence: cutscenes, NPC interactions, quests, minigames, etc.
* Rigid body collisions
* Text / dialogue
* UI elements (HUD, title screen, logos, etc.)
* Music and audio (cannot add new tracks, only edit/replace existing)
* Effects and shaders (limited)
 
== Getting set up ==
<br>
{{linkbox
| title = [[help:Dumping games|Dumping the game files]]
| text = To make mods, you'll need to start by dumping the unedited game files from your copy of BotW.
| faiconc = fas fa-copy
}}
{{linkbox
| title = [[help:Setting up tools|Setting up tools]]
| text = Since BotW uses a lot of Nintendo's own file formats, you'll need tools to be able to edit them.
| faiconc = fas fa-toolbox
}}
 
== Rules ==
 
=== The RSTB file ===
The file [[ResourceSizeTable.product.rsizetable]] (referred to as the RSTB file) contains a list of size limits for almost every file in the game (calculated from the non-Yaz0-compressed file sizes). If you edit a file to make its filesize bigger, you'll need to edit this file to prevent errors. For details, see [[Help:Updating the RSTB]].
 
=== File names and caching ===
The game assumes that any 2 files with the exact same filename also have the exact same contents. If you don't follow this rule when editing files, the game might load the wrong version of the file, leading to errors. The same rule applies to texture names - all unique textures should have unique names, even if they're located in different files.
 
=== File extensions for compressed resources ===
In most cases, file extensions that start with ".s" are used for [[Yaz0]]-compressed files. Ensure that any file with such extensions is compressed. Some tools (for example {{ltool|BotW Unpacker}}, {{ltool|byml-v2}} or {{ltool|sarc}}) will automatically compress files when needed.
 
Example: .bactorpack -> .sbactorpack (after compression)
 
=== Edit priority ===
If a file exists in your update dump, edit that copy of it. If it doesn't exist there, edit the one in your DLC dump. If it doesn't exist in either the update files or the DLC files, edit the one from the base game dump.

Revision as of 21:58, 8 December 2020

Welcome, modders! This page contains useful information for anybody who wants to create mods. If you just want to use other people's mods, see Help:Using mods.

What can currently be modded?

  • Textures
  • Models
  • Actor parameters, including enemies, weapons, and armors
  • Adding new actors
  • Overworld and dungeon map files
  • Event flows, and as a direct consequence: cutscenes, NPC interactions, quests, minigames, etc.
  • Rigid body collisions
  • Text / dialogue
  • UI elements (HUD, title screen, logos, etc.)
  • Music and audio (cannot add new tracks, only edit/replace existing)
  • Effects and shaders (limited)

Getting set up


Rules

The RSTB file

The file ResourceSizeTable.product.rsizetable (referred to as the RSTB file) contains a list of size limits for almost every file in the game (calculated from the non-Yaz0-compressed file sizes). If you edit a file to make its filesize bigger, you'll need to edit this file to prevent errors. For details, see Help:Updating the RSTB.

File names and caching

The game assumes that any 2 files with the exact same filename also have the exact same contents. If you don't follow this rule when editing files, the game might load the wrong version of the file, leading to errors. The same rule applies to texture names - all unique textures should have unique names, even if they're located in different files.

File extensions for compressed resources

In most cases, file extensions that start with ".s" are used for Yaz0-compressed files. Ensure that any file with such extensions is compressed. Some tools (for example BotW Unpacker, byml-v2 or sarc) will automatically compress files when needed.

Example: .bactorpack -> .sbactorpack (after compression)

Edit priority

If a file exists in your update dump, edit that copy of it. If it doesn't exist there, edit the one in your DLC dump. If it doesn't exist in either the update files or the DLC files, edit the one from the base game dump.