Skip to content

Latest commit

 

History

History
185 lines (160 loc) · 7.56 KB

README.md

File metadata and controls

185 lines (160 loc) · 7.56 KB
Raw

Switch-Toolbox-bugfixes

A fork of switch toolbox to fix a couple small issues. Feel free to pull request to add bugfixes, or use these fixes in your own fork

Note this only has been tested on Splatoon 3 and BOTW

Features fixed include:

  • Exporting to DAE now sets specular to 0.5 instead of 0
  • Dae files no longer have "bump" due to not being officially supported, and now have an extra "transparency" if an opacity texture is given
  • Batch exporting textures now respects "Use Texture Channel Swaps"
  • Opacity textures and Emission colours now work for Splatoon 3 and BOTW

Everything past this point is the readme of the original:

Download

https://github.com/KillzXGaming/Switch-Toolbox/releases

Keep in mind this tool is still very experimental. If something breaks from a commit, you can download manually from here. Just select a commit, go to artifacts tab and download the zip. Also be sure to report anything that breaks to issues here on github.

Discord

https://discord.gg/eyvGXWP

Support

If you'd like to support me, you can donate!

Features

This tool currently features:

  • BFRES
    • Fully supports Wii U and Switch
    • Model importing (DAE, FBX, OBJ, and CSV)
    • Material editing (Render info, texture mapping, parameters, etc.)
    • Material copying
    • Animation and model sub section can be exported / imported
    • Can delete, add, replace individual objects from an FMDL
    • Can create new sub sections and data
    • Can preview skeletal, SRT, param, texture pattern, and bone visual animations. (param animations vary)
    • Can export and import fully rigged models with bone support
    • Can convert gif files to texture pattern animations, very WIP atm

Can edit formats:

  • BFRES
  • BNTX
  • BFLYT
  • BFLAN
  • NUTEXB
  • XTX
  • GTX
  • SARC
  • BARS
  • KCL
  • BFLIM
  • GFPAK
  • BEA
  • AAMP (Switch, 3DS and Wii U)
  • BYAML/BYML (Switch, 3DS and Wii U)
  • PTCL (Switch, 3DS and Wii U)
  • TMPK
  • PAK / IGA (Crash Bandicoot / Crash Team Racing)
  • IGZ Textures (Crash Bandicoot / Crash Team Racing)
  • BFFNT (Textures only)

Can preview:

  • BCRES
    • Models, materials, and textures.
  • BFSHA
    • Can view options, samplers, attributes, and uniform blocks.
  • BNSH
    • Can extract shader vertex and fragment shaders from variations/programs.
  • SHARCFB and SHARC
    • Basic preview of some shader program data.
    • Can edit both v1 and v2 AAMP (Wii U and Switch)
  • EFC
    • Can preview effect tables and link PTCL.
  • NUT
    • Can preview NTWU, NTP3, and NTWD variants. Editing will be implemented soon.
  • MSBT
    • Very basic previewing.
  • MP3, OGG, IDSP, HPS, WAV, BFWAV, BFSTM, BCWAV, BCWAV
    • Can listen to audio and convert between certain formats. Thanks to VGAudio and CSCore
  • NARC
  • SP2 (Team Sonic Racing)
  • GFMDL
  • TEX (3DS)
  • NUSHDB (Switch Namco Shaders)
  • SDF (Snow Drop Engine)
  • NCA
  • NSP
  • IStorage
  • NXARC
  • LZARC
  • IGA .pak
  • RARC
  • GMX (TPHD Models)
  • MKAGPDX Model .bin files
  • MKAGPDX Archive .pac files
  • ME01 and SA01 archives
  • Luigi's Mansion 2: Dark Moon (archives, models, and textures)
  • TPL
  • TXE
  • BTI
  • G1T
  • CMB (OoT3D, MM3D, LM3DS)
  • CTXB (OoT3D, MM3D, LM3DS)
  • GAR (OoT3D, MM3D, LM3DS)
  • ZSI (OoT3D, MM3D)
  • BinGZ (Hyrule Warriors)
  • PAC (Sonic Forces)
  • GameCube ISOs (file system)

Tutorials

https://github.com/KillzXGaming/Switch-Toolbox/wiki

Issues or Requests

https://github.com/KillzXGaming/Switch-Toolbox/issues

Building

To build make sure you have Visual Studio installed (I use 2017, older versions may not work) and open the solution (.sln), then build the solution as release. It should compile properly on the latest.

In the event that the tool cannot compile, check references. All the libraries used are stored in Switch-Toolbox/Lib folder.

Also, while compiling, Visual Studio might throw errors about files coming from external sources (ie. the web) and will therefore fail to read and compile them. In this event, go into the project root folder and run: Get-ChildItem -Path "C:\\Full\\Path\\To\\Folder" -Recurse | Unblock-File.

Credits

  • Smash Forge Devs (SMG, Ploaj, jam1garner, smb123w64gb, etc.) for some code ported over, specifically animation stuff, ETC1 encoder and some rendering.
  • Ploaj for a base on the DAE writer.
  • Assimp devs for their massive asset library!
  • Wexos (helped figure out a few things, i.e. format list to assign each attribute)
  • JuPaHe64 for the base 3D renderer.
  • Every File Explorer devs (Gericom) for Yaz0 and bitmap font stuff.
  • exelix for BYAML, SARC and KCL library.
  • Syroot for helpful IO extensions and libraries.
  • GDKChan for SPICA library (used for BCH), PICA shaders stuff used with BCRES, structs for BCRES, and some DDS decode methods.
  • AboodXD for some foundation stuff with exelix's SARC library, Wii U (GPU7) and Switch (Tegra X1) textures swizzling, reading/converting uncompressed types for DDS, and documentation for GTX, XTX, and BNTX. Library for Yaz0 made by AboodXD and helped port it to the tool.
  • MelonSpeedruns for Switch Toolbox logo.
  • BrawlBox team for brawl libraries used for BRRES parsing.
  • Sage of Mirrors for SuperBMDLib.
  • Ambrosia for BTI and TXE support.
  • Kuriimu for some IO and file parsing help.
  • Skyth and Radfordhound for PAC documentation.
  • Ac_K for ASTC decoder c# port from Ryujinx.
  • pkNX and kwsch for Fnv hashing and useful pkmn code/structure references.
  • Dragonation for useful code on the structure for some flatbuffers in pokemon switch
  • mvit and Rei for help with gfpak hash strings and also research for formats.
  • QuickBMS for some compression code ported (LZ77 WII)

Resources

Documentation (File Formats)

Libraries

Helpful Tools

License in Switch_Toolbox\Lib\Licenses

Please note if you do not want your library used or if i'm missing credits!