-
Notifications
You must be signed in to change notification settings - Fork 15
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
37 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,38 @@ | ||
# bnkutil | ||
Tools for unpacking and repacking Wwise SoundBank files. | ||
`bnkutil` is a tool for manipulating Wwise SoundBank files (`.bnk` or `.nbnk`). It currently supports two modes: | ||
|
||
__unpack__: This takes an input SoundBank file and writes all of the embedded `.wem` files to a directory. | ||
[ww2ogg](https://github.com/hcs64/ww2ogg/releases) can then be used to convert the `.wem` files to a playable Ogg Vorbis format. | ||
|
||
__repack__: This takes an input SoundBank file, along with target `.wem` files and writes a new SoundBank with target wems replaced. Audiokinetic's [Wwise](https://www.audiokinetic.com/download/) tool can be used to convert any `.wav` of your choice into the `.wem` format for audio replacement. | ||
|
||
## Usage | ||
### Unpack | ||
|
||
To unpack a SoundBank file use the following command: | ||
|
||
```bash | ||
bnkutil.exe -unpack -bnkpath em118_vo.nbnk -output em118\ | ||
``` | ||
|
||
`-b(nkpath)` specifies the path to the `.bnk` or `.nbnk` file to unpack. | ||
|
||
`-o(utput)` specifies the new directory that will be created to unpack the `.wem` files into. | ||
|
||
### Repack | ||
|
||
To repack a SoundBank file use the following command: | ||
|
||
```bash | ||
bnkutil.exe -repack -bnkpath em118_vo.nbnk -target wems\ -output newbank.nbnk | ||
``` | ||
`-b(nkpath)` specifies the path to the `.bnk` or `.nbnk` file to use as a source for the repacking; replacement wems will replace the wems inside of this SoundBank. | ||
|
||
`-t(arget)` specifies a path to a directory that will be used to gather wem replacements. This directory will be searched for all compatible `.wem` files. Their filenames will be used as an index to the target wems to replace, starting at 1. For example, a `002.wem` file in this directory will replace the second wem in the original source SoundBank with the contents of that file. To file out what the indexes are for each `.wem` file in a SoundBank, first run the unpack command. | ||
|
||
`-o(utput)` specifies the path to the new SoundBank file to create, with replacements applied. | ||
|
||
## Limitations | ||
|
||
1. This software has not been thoroughly tested yet and isn't gaurenteed to work with all SoundBank files. Do [file a bug](https://github.com/hpxro7/bnkutil/issues/new) on this github page if you encounter a problem. | ||
2. Replacing wem files that are _larger_ than their original source wem file is currently not supported. This will be supported in the near future. |