Mafia Toolkit 1.0.0

Mafia Toolkit 1.0.0 - a Blender add-on for Mafia's model formats.

Download mafia-toolkit-1.0.0.zip below, then in Blender: Edit > Preferences > Add-ons > Install from Disk, pick the zip, switch it on, and set the Texture Folder in its preferences to the game's maps directory.

Needs Blender 5.2 or newer.

What it does

• All four formats, in and out: .4ds models, .5ds animations, .tck movement tracks, .6ds shadows.
• 15 of the 17 frame types and all nine visual sub-types - meshes and LODs, sectors and portals, occluders, dummies, targets, lights, billboards, mirrors, lens flares, projectors, morphs, joints and skinned characters.
• Round-trips byte for byte: a model imported and exported again comes back identical, the save date aside.
• Says what is wrong before it writes - Check 4DS Scene runs every export check without writing a file, and each refusal carries a suggested fix.
• Characters: the skeleton preset, influence boxes with draggable handles, and weights painted by hand or made from the boxes.
• The MBT CLI, for driving the add-on without a window: mbt --open model.4ds --gui.

Tested against everything the game ships

What	Files	Result
Models, through Blender	3,125	round-trip identical
Models, format layer only	3,125	3,123 exact, 2 refused for their version
Animations	2,695	all exact - 52,132 tracks, 13.7M keys
Movement tracks	293	283 exact, 10 refused for their version
Shadows	37	all exact

Documentation

The User Guide is the way in; the Field Manual is the reference, with four more pages beside them. The wiki covers the same ground in shorter pages.