A continuation of Yabber, the FromSoftware file format unpacker and serializer by TKGP, bundling contributions by various community members and adding some quality-of-life features. WitchyBND continues where Yabber+ by Nordgaren left off.
WitchyBND supports FromSoftware games from Demon's Souls onwards, but is primarily tested with ELDEN RING and ARMORED CORE VI. Report any issues you may find with other games.
New additions to WitchyBND include:
- Breaks down BND folder structure to avoid excessive nesting in unpacked folders
- File globbing pattern support in the commandline
- regulation.bin support (Decrypt->unpack and repack->encrypt)
- Slightly improved Oodle DLL detection
- PARAM support (using Paramdex and DefPatch. Compact, readable output)
- FXR support
- MATBIN support (by Avocado)
- MTD support (by Avocado)
- ELDEN RING GPARAM support (by Avocado)
- Console TPF unpacking (but not repacking)
- Minor fixes like ELDEN RING envmap TPF unpack
- MQB support (by NatsuDragneelTheFireDragon)
- Support for Armored Core VI DCX archives
Planned (but TBD):
- Small UI for quality-of-life actions outside of unpacking/repacking (like duplicating AEGs, CHRs, PARTSBND...)
- Other formats from YabberAvocado (Let me know which ones are needed the most)
- Other formats from other Yabber forks (Let me know which are flying around the community)
- WitchyBND requires .NET Desktop Runtime 7.0 to function.
- The game archives need to be unpacked with UXM Selective Unpacker to access the files that Witchy can work with.
Witchy works exactly like Yabber.
- Unpack the game files using a tool like UXM Selective Unpacker. (For Armored Core VI, you may currently need a work-in-progress version from ?ServerName? Discord in #tools-and-resources)
- Find the files you'd like to extract. (Information on general modding is available in the Souls Modding Wiki or on ?ServerName? Discord.)
- Drag the files onto the WitchyBND.exe executable in the Witchy folder.
- If Witchy supports that file format, it will now be unpacked.
- To repack, simply drag the unpacked folder or file onto WitchyBND.exe again.
If you only want to remove the DCX compression from a DCX archive, use WitchyBND.DCX.exe instead.
If you find it tedious to drag files onto the EXE, run WitchyBND.Context.exe to create Windows right-click context menu entries instead; that way, you can just right-click any file and find the "WitchyBND" option in the context menu.
- TKGP - Created SoulsFormats and Yabber
- katalash - GPARAM support
- Nordgaren - Yabber+ additions, Armored Core VI additions
- DSMapStudio team - FsParam, Paramdex
- Meowmaritus, NamelessHoodie - initial FXR serialization
- Avocado - YabberAvocado additions
- NatsuDragneelTheFireDragon - MQB support
- Vawser - preliminary Armored Core VI paramdefs
- ivi - WitchyBND maintainer
- Updated AC6 Paramdex to Vawser's latest version, fixing duplicate field name issues and more.
- Fixed an issue that would incorrectly wipe correct ParamTypes from serialized PARAMs.
- Separated ParamType from Paramdef Type in the XML serialization, to ensure that "tentative" ParamTypes do not get written to params.
- Fixed an issue that prevented params with duplicate field names from correctly serializing (such as AC6 BehaviorParam_PC).
- Duplicate field names will now have the byte offset appended instead of the SortID.
- Fixed an issue where empty BNDs threw an exception when attempting to unpack them.
- Updated ACVI paramdefs to Vawser's latest version.
- Updated the AC6 PARAM reading solution for parity with the method and tentative ParamType names used by DSMapStudio.
- Updated ACVI paramdefs to Vawser's latest version.
- Applied a temporary solution to an issue that prevented some AC6 PARAMs from being read. Thanks to Vawser for the method.
- Fixed an issue with reading AC6 GIIV TPFs.
- Added support for decrypting/encrypting Armored Core VI regulation.bin. Thanks to Nordgaren for the encryption key.
- Added preliminary Paramdex support for Armored Core VI PARAM serialization. Thanks to Vawser for the preliminary paramdefs.
- Please note that this will mostly be a bunch of Unknown fields; this is more of a tool for reverse engineering than anything else.
- ACTUALLY enabled use of Oodle 28 as promised in previous updates notes, just forgot to actually merge Nordgaren's change...
- See previous notes.
- Fixed incorrect versions in README and other texts
- Added detection and usage of Oodle 28 (from Armored Core VI) to SoulsFormats and Witchy. (By Nordgaren)
- Updated Fxr3 class to the newest findings from Rainbow Stone development. (This is breaking for the serialization, so convert all the XMLs you need to FXR before updating.)
- Fixed an oversight that could cause issues with error printing to the console.
- Small fixes behind the scenes to make working with the project easier for contributors.
- Added MQB support (by NatsuDragneelTheFireDragon)
- Added preliminary support for Armored Core VI DCX.
- Improved performance when serializing PARAM files.
- Updated Paramdex.
- Updated READMEs.
- New attempt at GPARAM support, using decompiled code from a random YabberAvocado zip. Appears to do a byte-perfect roundtrip unlike all other versions. Testing needed.
- Project cleanup for less warnings.
- Moved to NuGet versioning format (1.0.4.0 instead of 1.0.4).
- Properly display assembly info data.
- Fixed regulation.bin repacking as regulation.bin.dcx.
- Fixed embarassing bug preventing binders from being repacked.
- Added more graceful handling of failed TPF repacking for console TPFs.
- Moved to clean latest version of TKGP's SoulsFormats (ER branch)
- Improved handling of Paramdex name files
- Added support for console TPFs (by TK/DSMS team)
- Added support for MTD (by Avocado)
- Fixed small issue with AssetGeometryParam def being version 4 instead of 6
- Initial release.
- Minor fix to the Context menu registry (correct names)
- Made it impossible to use multiple
..\in a file path - Updated version properly
- Added support for unpacking and repacking encrypted regulation BNDs
- Updated oodle message to instruct users to get the file from Sekiro or Elden Ring
- Fixed issue with files being written to incorrect folder, due to path traversal
- There are some fixes and upgrades that were commited by TK before I ever looked at the project, that are in this build as well
- DS2 .fltparams are now supported
- BXF4 repacking fixed
- Prompt for administrator access if necessary
- Breaking change: GPARAM format changed again; please repack any in-progress GPARAMs with the previous version, then unpack them again with this one
- Sekiro support
- Breaking change: GPARAM format has changed in a few ways; please repack any in-progress GPARAMs with the previous version, then unpack them again with this one
- Fix not being able to repack bnds with roots
- Fix LUAINFO not working on files with 2 or fewer goals
- Fix LUAGNL not working on some files
- Fix GPARAM not repacking files with Byte4 params
- Better support for weird BND/BXF formats without IDs or names
- GPARAM, LUAGNL, and LUAINFO are now supported
- Breaking change: compressed FMG is now supported; please repack any in-progress FMGs with the previous version, then unpack them again with this one
- Fix repacked FMGs getting double-spaced
- Fix decompressing DCXs that aren't named .dcx
- Add FMG support
- Fix repacking DX10 textures
- Fix bad BXF4 repacking