Skip to content

v1.1.0

Latest
Compare
Choose a tag to compare
@github-actions github-actions released this 04 Oct 05:13

What's Changed

  • Added: Automatically check for invalid extab relocations by @CelestialAmber in #75
  • Added: Decode extab entries as comment in assembly output (281b0f7)
  • Added: Load objects from disc image & vfs module (f91c2a1)

Revamps support for container paths and centralizes logic into a VFS (virtual file system) module.
The new VFS architecture supports disc images and any level of nesting.

For example, the following command now works:
dtk dol info 'Interactive Multi-Game Demo Disc - July 2002 (USA).rvz:files/zz_StarFox051702_e3.tgc:files/default.dol'
This opens a TGC file inside an RVZ disc image, then reads default.dol in the FST.

Another example:
dtk rel info 'Legend of Zelda, The - The Wind Waker (USA).rvz:files/RELS.arc:mmem/f_pc_profile_lst.rel'
This opens a RARC archive inside an RVZ disc image, loads the Yaz0-compressed REL and decompresses it on the fly.

This all operates in memory with minimal overhead, with no need to extract temporary files.

Supported container formats:

  • Disc images (ISO/GCM, WIA/RVZ, WBFS, CISO, NFS, GCZ, TGC)
  • RARC/SZS and U8 (.arc)

Supported compression formats:

  • Yaz0 (SZS)
  • Yay0 (SZP)
  • NLZSS (.lz)

Projects now can utilize a new configuration key object_base:

object: orig/GZLE01/sys/main.dol
modules:
- object: orig/GZLE01/files/RELS.arc:rels/mmem/f_pc_profile_lst.rel

becomes

object_base: orig/GZLE01
object: sys/main.dol
modules:
- object: files/RELS.arc:mmem/f_pc_profile_lst.rel

When loading the objects, decomp-toolkit will automatically check the object_base directory for any disc images. (They can be named anything, but must be in the folder root.) If one is found, all objects will be fetched from the disc image itself, rather than having to extract the files manually.


Two new commands were added: vfs ls and vfs cp.
These commands are very barebones currently, but allow listing directory contents and extracting files from decomp-toolkit's vfs representation:

❯ dtk vfs ls disc.rvz:
files
sys

❯ dtk vfs ls disc.rvz:sys
boot.bin
bi2.bin
apploader.bin
fst.bin
main.dol

❯ dtk vfs cp disc.rvz:sys/main.dol .

Full Changelog: v1.0.0...v1.1.0