/Bootshuze

OBJ to XML converter for Spiral Knights

Primary LanguagePythonMIT LicenseMIT

Bootshuze

OBJ to XML converter for Spiral Knights. Requires SpiralView for further model modification.

Features

The script will:

  • Convert OBJ file's indices and vertices to XML format Spiral Knights uses.
  • Recognize the primitives mode the input file uses (lines, triangles, quads).
  • Calculate bounds for the model.

The script will NOT:

  • Change any data that can be changed with SpiralSpy after creation (material, texture, etc).
  • Normalize the model size. If the model is too big, you can scale it down in SpiralSpy by creating a new Compound model and using the model you just created as one of the assets.
  • Rotate the model. Can also be fixed by creating a Compound model.
  • Create new texture UV mapping. That should be done in any 3D model editor you're using.

Getting started

  1. Download the latest release, and open either the .exe file or the .py file (the latter requires Python 3 installed).
  2. A console window should appear. When asked, provide the name of the OBJ model inside the script directory.
  3. The script should create an XML file inside the directory.
  4. With SpiralView open Model Viewer, Resource Editor (Ctrl+R), File → Import from XML... and point to the new XML you created with the script. That should provide info to the resource editor.
  5. Save the model (Ctrl+A) in any directory and open in the model viewer.

Congratulations, you've imported a model and can create new mods with new models that never existed in the game before.