Skip to content

Latest commit

 

History

History
36 lines (19 loc) · 1.9 KB

readme.md

File metadata and controls

36 lines (19 loc) · 1.9 KB

CSB Loader

Turns Paper Mario: The Origami King's CSB file collision meshes into Wavefront obj files to visualize them.

Usage

To use this, you need a full dump of Paper Mario: The Origami King's RomFS, as well as a tool to decompress the ZSTD files (recommended is Origami Wand). To decompress the files in Origami Wand, navigate to the menu bar and click Zstd > Decompress File. Select the files you want to load with CSB Loader to decompress them.

With these files, use csbloader like this, to obtain the obj files:

csbloader extract <path to CSB file> <path to Wavefront obj output file>

These files can be treated like usual model files, e.g., be opened in Blender. Once they are edited, you can turn them back into csb files like this:

csbloader build <path to obj mesh file> <path to output CSB file>

For more information, run csbloader --help.

Installation

Make sure you have the latest node.js LTS Version, NPM and TypeScript installed.

Open the Command Prompt, Git Bash or a Shell in a convenient location (not PowerShell), clone the repository with git clone https://github.com/Darxoon/csbloader and enter the new directory.

Type npm install && tsc && npm link to build the program and have access to the csbloader command at all times in any location in the command line.

Updating from a previous version

If you have csbloader installed already and want to update, you can follow these instructions.

To update, open a Command Prompt, Git Bash or Shell in the csbloader directory and run this: git pull && npm install && tsc. Now you have the latest version installed.

Contact

For any discussions or help regarding modding Paper Mario: The Origami King or this program, join the Paper Mario: The Origami King Refolded server (https://discord.gg/y7qfTKyhZy) or the Paper Mario Modding server (https://discord.gg/Pj4u7wB).