WoS BlenderToolkit

This toolkit is a Blender addon/plugin for the video game Spider-Man: Web of Shadows

This addon is designed on Blender 4. 5. 0 mainly, then compatibility has been tested and confirmed for Blender 5. 0. 0

and it could very possibly work on other untested versions of Blender, especially 4. 1+

Don't forget to check it out on GitHub as well !

# Features:

- Import/Export the game's model format (.wrap.mesh) to/from Blender (drag-and-drop supported for import)

- Import/Export the game's skeleton format (.wrap.skel) to Blender (drag-and-drop supported for import)

- Convert the game's texture format (.wrap.tex) to DDS/PNG and vice versa (drag-and-drop feature)

• []PNG/TEX Conversion requires installing ImageMagick[/]

  []Also installing Wand python library in your Blender's python environment, e.g.:

  "E:\Blender 5. 0\5. 0\python\bin\python.exe" -m pip install Wand[/]

Use latest version of kirbystealer's WebOfShadowsTools or Devryx's 

Toolkit

to extract said files

- The addon presents an extra feature which you can find in the side-panel. Press N to open Blender's side-panel, then go to the WOS Tools tab, there you can find the Rename Vertex Groups Utility.

- Use this utility to rename a model's vertex groups from the "bone_{index}" naming to the real bone names imported with the skeleton (Armature needs to be in same collection or the utility will raise an error)

- The addon also presents some options on importing/exporting model format, which are:

- Flip UV V-Axis

- Reverse Triangle Winding Order

- Convert to Triangle List

- Supported pixel formats: DXT1, DXT3, DXT5, D3DFMT_A8R8G8B8, D3DFMT_X8R8G8B8, D3DFMT_L8

# Tutorials:

Porting Batman to Web of Shadows Part I

Porting Batman to Web of Shadows Part II

# Notes:

- Safe max vertex groups count for each submesh is 48, otherwise the mesh deformation might look off

- For custom model ports, rename your materials to the name of any material file the original model uses, full name could work but preferred to only take the hash part, like: `0x9E8F3E7F`

- It is advised to use Data Transfer modifier to transfer weights from original models to modded ones, use Replace as Mix Mode and a Mapping of Nearest Vertex

- Each submesh needs a vertex color attribute of some value, use Face Corner and Byte Color when creating the attribute, then make it White if you want fully opaque vertex color

- If you don't set a vertex color, the model will look complete black in-game

- All submeshes under a single collection need to be parented to the armature so that weights can be exported correctly

- To convert to the game's texture files you need a DDS file to drag and drop into Blender's 3D Viewport

- If you don't have your image file ready in the DDS format, then you can use this SimpleTextureConverter tool to convert back-and-forth between a lot of image formats including DDS

- It is advised to turn off the Convert to Triangle List option on import for models that have been exported using this toolkit, so as not to double convert an already-ready Triangle List

- Blender doesn't use Triangle Strips, which is the Primitive Type used in almost all the game's original models for face polygons, so they need to be converted to normal Triangle List for Blender to consume.

- However, the default export setting in this addon is to use Triangle List, which luckily the game can accept to consume if a certain field in the data is tweaked to a value of 4.

- Apply scale to the model before exporting, toolkit handles applying the rest of tranforms

📦 Recommended Model Import Settings

- ✔ Flip UV V-Axis

• ✔ Reverse Triangle Winding Order
•