⚠️ Note: This is not for the faint of heart. It requires a bit of knowledge on how Blender works and a lot of time and patience since a lot of models will not be centered correctly by default or would require manually editing the textures, thus requiring plenty of tweaking to get them ready for the process.

TurntableStripGenerator

Blender addon for generating pseudo-3D images from models for Deadlock wiki usage.

Requirements

• Deadlock
• Source 2 Viewer and CLI version
• Blender
• addon.py (from this repository)

Installation steps

1. Install Deadlock
2. (Optional) Add Source 2 Viewer CLI to PATH

Linux (bash/zsh)

Suppose CLI is in /home/user/Source2Viewer-CLI

echo 'export PATH="$PATH:/home/user/Source2Viewer-CLI"' >> ~/.bashrc
source ~/.bashrc

Test

Source2Viewer-CLI --help

Windows (PowerShell)

Suppose CLI is in C:\Tools\Source2Viewer-CLI

[Environment]::SetEnvironmentVariable("Path", $Env:Path + ";C:\Tools\Source2Viewer-CLI", "User")

Close and reopen PowerShell, then test

Source2Viewer-CLI.exe --help

3. Download addon.py to an easily accessible folder.
4. Install Blender
   • In Blender go Edit > Preferences > Add-ons > Add-ons Settings (Button with down arrow) > Install from Disk > Select addon.py

Usage

1. Extract model from Deadlock, Source 2 Viewer can be used to find exact model and pose (animation)

Linux

Source2Viewer-CLI -i "/path/to/steam/steamapps/common/Deadlock/game/pak01_dir.vpk" \
-o "/path/to/output/folder" -d \
-f "models/<category>/<model_name>.vmdl_c" \
--gltf_export_format glb \
--gltf_export_animations \
--gltf_animation_list "<animation_name>" \
--gltf_export_materials \
--gltf_textures_adapt

Windows

Source2Viewer-CLI.exe -i "C:\path\to\steam\steamapps\common\Deadlock\game\pak01_dir.vpk" `
-o "C:\path\to\output\folder" -d `
-f "models\<category>\<model_name>.vmdl_c" `
--gltf_export_format glb `
--gltf_export_animations `
--gltf_animation_list "<animation_name>" `
--gltf_export_materials `
--gltf_textures_adapt

2. In Blender, press N to open the Sidebar and select the Turntable tab:

   • Press Clean Scene (Trash icon).
   • Press Folder, select <model_name>.glb, then click Import GLB.
     • After import, delete the objects glTF_not_exported and Icosphere.
   • A large number of incorrectly exported bones will appear. (If there are no cloth bones in object list) Click on any of them, switch Object Mode → Pose Mode, select all bones, and press H to hide them, then switch back to Object Mode.
     • If there are cloth bones may God help you scale down all bones.
       • Transform Pivot Point > Individual Origins > S > Move your mouse to scale bones.
         • Properly tweaking cloth bones can be VERY difficult to do. If you're struggling I'd suggest picking pose with less rotation/movement.
   • Click Setup Scene in the Turntable tab, then press F12 to preview the render.
     • Adjust camera settings in the tab if needed.
   • When everything looks correct, specify Output Folder and Model Name, then click RENDER TURNTABLE STRIP.

3. Before uploading model strip image to the wiki compress it.