Help:Tools/botwfstools: Difference between revisions

From ZeldaMods (Breath of the Wild)
Jump to navigation Jump to search
imported>Leoetlino
imported>Leoetlino
(fusepy 3.0 is now published on pypi)
 
(One intermediate revision by the same user not shown)
Line 4: Line 4:
| authors = leoetlino
| authors = leoetlino
| source = https://github.com/leoetlino/botwfstools
| source = https://github.com/leoetlino/botwfstools
| license = GPLv3
| license = GPLv2+
| written_in = Python
| written_in = Python
| win_only =  
| win_only =  
Line 20: Line 20:
== Setup ==
== Setup ==
# Install Python 3.6+ (see [[Help:Setting up tools]] for help)
# Install Python 3.6+ (see [[Help:Setting up tools]] for help)
# Install fusepy 3.0+: install the [https://github.com/fusepy/fusepy/archive/master.zip <code>https://github.com/fusepy/fusepy/archive/master.zip</code>] package{{Install py package help|package=https://github.com/fusepy/fusepy/archive/master.zip}}
# Install the <code>fusepy</code> package{{Install py package help|package=fusepy}}
# If you're on Windows, install [http://www.secfs.net/winfsp/download/ WinFsp]
# If you're on Windows, install [http://www.secfs.net/winfsp/download/ WinFsp]
# Install the <code>botwfstools</code> package{{Install py package help|package=botwfstools}}
# Install the <code>botwfstools</code> package{{Install py package help|package=botwfstools}}

Latest revision as of 21:25, 1 December 2018

botwfstools
Author(s) leoetlino
Source code https://github.com/leoetlino/botwfstools
License GPLv2+
Written in Python
Platform support Cross-platform

botwfstools is a toolset that makes accessing and editing the game ROM easier.

Indeed, a common operation when exploring and modifying BotW's content is manipulating SARC archives (unpacking and repacking), which quickly becomes tedious and annoying. Resource system internals also cause most resource changes to require an update to the resource size table (RSTB).

botwfstools intends to address these issues with a series of tools that help the user:

  • avoid clobbering their game dump (without the need to keep space-wasting backups)
  • explore and modify content files by exposing archives as simple directories
  • edit files more easily by automatically repacking archives and editing the RSTB as needed.

Setup

  1. Install Python 3.6+ (see Help:Setting up tools for help)
  2. Install the fusepy package[CLI help]
  3. If you're on Windows, install WinFsp
  4. Install the botwfstools package[CLI help]

Usage

Usage instructions can be found in the botwfstools repository.

Known issues

  • Platform limitations: On Windows, strange errors may happen with botw-contentfs. This is unfortunately caused by Windows limitations; nothing that can be fixed by the tool author. For full functionality and better performance in general, it is recommended to use Linux.