Help:Setting up tools: Difference between revisions
imported>Leoetlino No edit summary |
imported>Leoetlino No edit summary |
||
Line 19: | Line 19: | ||
Many of the tools for these formats require [[wikipedia:Python (programming language)|Python]] 3.6+ ('''64 bit version''') to be installed. | Many of the tools for these formats require [[wikipedia:Python (programming language)|Python]] 3.6+ ('''64 bit version''') to be installed. | ||
On Linux, Python 3 is almost surely already installed. Just make sure you have a recent enough version (3.6+). Ubuntu 16.04 and Debian stretch are too old; The latest Ubuntu LTS (18.04) and rolling distros such as Arch as Debian sid have 3.6+ in their repos. | '''On Linux''', Python 3 is almost surely already installed. Just make sure you have a recent enough version (3.6+). Ubuntu 16.04 and Debian stretch are too old; The latest Ubuntu LTS (18.04) and rolling distros such as Arch as Debian sid have 3.6+ in their repos. | ||
On Windows, follow the below instructions for installing Python: | '''On Windows''', follow the below instructions for installing Python: | ||
# Uninstall any existing Python 3 version to avoid conflicts. | # Uninstall any existing Python 3 version to avoid conflicts. | ||
# Download the [https://www.python.org/ftp/python/3.7.0/python-3.7.0-amd64.exe Python 3.7 installer] (latest version as of September 2018). | # Download the [https://www.python.org/ftp/python/3.7.0/python-3.7.0-amd64.exe Python 3.7 installer] (latest version as of September 2018). |
Revision as of 19:29, 14 September 2018
Breath of the Wild uses a very flexible, custom game engine. Many aspects of the game are not hardcoded and are instead configured by a large amount of files. To edit these files, a certain number of tools are required.
A note about file formats
The most common formats that one would want to be able to decode and also modify are:
- AAMP for actor parameters, world config (climate, lighting, ...), etc.
- BFRES for cosmetic (textures, models, ...) changes
- BFEVFL for in-game events (which includes things like talking to people and also full-blown cutscenes)
- BYML for actors, map units, difficulty scaling config, etc.
- Resource system when adding new resources or making existing files larger because of how the game works internally
- SARC for archives since many resource files are packed
Installing tools
In general, there are several tools you can use for a given file format. This guide will only mention the recommended tools; a more complete list of utils can be found in the article for each file format.
Some are unfortunately Windows-only, but many — especially the newer ones — are cross platform and work on Windows, macOS and Linux (with Linux even being the best supported platform for some tools).
Common requirements
Many of the tools for these formats require Python 3.6+ (64 bit version) to be installed.
On Linux, Python 3 is almost surely already installed. Just make sure you have a recent enough version (3.6+). Ubuntu 16.04 and Debian stretch are too old; The latest Ubuntu LTS (18.04) and rolling distros such as Arch as Debian sid have 3.6+ in their repos.
On Windows, follow the below instructions for installing Python:
- Uninstall any existing Python 3 version to avoid conflicts.
- Download the Python 3.7 installer (latest version as of September 2018).
- Run the installer: do a system-wide install and tick the "add Python to environment variables / PATH" option.
- Verify that
py -3 --version
works and gives the correct version (3.6 or higher). [help]
AAMP
Two choices: aamptool or aamp.
For aamptool:
- Download the tool from GitHub (note: only built for Windows).
Warning: aamptool does not handle child parameter lists properly. This means some files will appear to have an incorrect structure. Additionally, Nintendo sometimes starts parameter structure names with numbers. aamptool converts structures into XML tags; however leading numbers in tag names are explicitly disallowed by the XML specification. As a result files with such nodes cannot be converted back to XML correctly as of September 2018.
For aamp:
- Install the
aamp
package. [CLI help]
BFRES
![]() | This section is empty. You can help by adding to it. |
BFEVFL
- Install PyQt5. (If you're on Windows, install the
PyQt5
package. [CLI help]) - Install the
eventeditor
package. [CLI help]
BYML
Two choices: ninten-file-tool (for Wii U only) or byml-v2 (Wii U and Switch, and supports all new node types)
For ninten-file-tool:
- Install the Java runtime environment (JRE).
- Download the latest release from GitHub.
For byml-v2:
- Install the
byml
package. [CLI help]
RSTB
- Install the
rstb
package. [CLI help]
SARC
Three choices: BotW Unpacker (for Wii U only) or sarc (Wii U and Switch, heavily tested on BotW archives) or SARC Tool (Wii U and Switch). We strongly advise against using other tools because they do not handle file alignment properly.
For BotW Unpacker:
- Download the latest release from GitHub.
For sarc:
- Install the
sarc
package. [CLI help]
For SARC Tool':
- Install the
sarclib
package. [CLI help] - Install the
libyaz0
package. [CLI help] - Download the latest release from GitHub.