Binary Animation Sequence converter for LoZ:BotW
Project description
Breath of the Wild Binary Animation Sequence Convert
Converts Binary Animation Sequence (.bas) files from machine code to human-readable format and replaces TypeIndex values with names (or vice versa). For LoZ:BotW
Note: Only one of the TypeIndex enums has official names. These names are listed on https://zeldamods.org/wiki/Bas. The other TypeIndex enums have been given unofficial names, also listed on that page. (NOTE: unofficial name conversion has not been implemented yet)
Dependencies
- A dumped copy of Legend of Zelda: Breath of the Wild (for Wii U or Switch)
- Python 3.7+ (64-bit, added to system PATH)
The following pip
packages, which will be automatically installed:
- oead
Setup
- Download and install Python 3.7+, 64-bit. You must choose the "Add to System PATH" option during installation.
- Open a command line and run
pip install bas_convert
How to Use
bas_convert [file] [output] [-n] [-d]
-
file
- The name of the file to convert. You can select multiple files by using wildcards. (e.g.*.yml
will select all.yml
files in the directory) -
output
- The type to output as. Acceptsyml
,yaml
,bas
, andaamp
.yml
andyaml
are YAML, human-readable.bas
andaamp
are AAMP, machine-readable. -
-n
- Outputs the file with TypeIndex conversions to names. -
-d
- Outputs the file with TypeIndex conversions to digits (numbers). -
All permutations of conversion have been supported, for use with tools such as
hyrule_builder
which will convert to YAML for you.
Contributing
- Issues: https://github.com/GingerAvalanche/bas_convert/issues
- Source: https://github.com/GingerAvalanche/bas_convert
This software is in early, but usable, beta. There are many TypeIndex types that are not yet converted, or even mapped out. Any support is appreciated.
License
This software is licensed under the terms of the GNU Affero General Public License, version 3+. The source is publicly available on Github.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for bas_convert-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 707abf63675cf7abf9b97932e56120df0183a77bb736cedb7489e2cccc3d298a |
|
MD5 | 39c23e8fa8eaca93ff03f69f34296e27 |
|
BLAKE2b-256 | b46e3c83b9ba950944cb56b0e7d8b7d6658562d18603995ec73d49e9b4e8b023 |