Home

Mafia Toolkit

A Blender add-on for Mafia: The City of Lost Heaven — its models, animations, movement tracks and shadows.

Add-on version	1.0.2
Blender	5.2 or newer
Formats	.4ds models (version 29), .5ds animations, .tck movement tracks, .6ds shadows
Menu	File ▸ Import / File ▸ Export, one entry per format
Author	Richard01_CZ

🚀 Quick start

1. Installation and Setup — install it, and point the Texture Folder at the game's maps directory.
2. Importing and Exporting — open a model the game ships and look at how it is built.
3. Select an object and open Properties ▸ Object ▸ 4DS Object Properties for its Frame Types.
4. Press Check 4DS Scene in the 4DS Model sidebar tab before you export — see Checks and Messages.

📚 The pages

Getting started

• Installation and Setup — installing, the preferences, the texture folder
• Importing and Exporting — both dialogs, every option, and the report
• Command Line — the MBT CLI, for scripts and other programs

Core concepts

• Frame Types — what a frame is, which types exist, what the viewport draws
• Objects and LODs — meshes, the LOD suffix rule, instances
• Materials — the three texture boxes, color keys, animated textures

Frame types in detail

• Sectors and Portals
• Dummies and Targets
• Lights — the kinds, the falloff band, the cones, the mode switches
• Projectors — the volume, the falloff, the blends, what the material gives it
• Other Frame Types — occluders, billboards, mirrors, lens flares, cameras, emitors

Characters and animation

• Armatures and Skinning — the skeleton, influence boxes, weights
• Morph Animations — morph groups and their targets
• Animations and Movement — .5ds animations, event cues, .tck tracks
• Shadows — .6ds shadow meshes

Help

• Checks and Messages — every refusal, and what to do about it
• Troubleshooting

📖 The long documents

The wiki is the short form. In the repository:

• LS3D-4DS-User-Guide.html — the way in, in the order you meet it
• LS3D-4DS-Field-Manual.html — the full reference
• LS3D-4DS-Dummy-Names.html — every frame name the game looks for
• LS3D-4DS-User-Properties.html — the text a frame can carry
• LS3D-4DS-Flag-Usage.html — which flags the game's models really use
• LS3D-4DS-Joint-Viewer.html — a browser view of a model's joints and weights

✅ What it is tested against

Every model, animation, movement track and shadow the game ships: 3,125 models, 2,695 animations, 293 tracks and 37 shadows, round-tripped byte for byte where the format allows it.