Skip to content

dingdio/Witcher3-Blender-Tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

120 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Witcher 3 Blender Tools

Release Blender 4.5+ REDkit License Wiki

Native import/export of The Witcher 3 game files in Blender. REDkit companion. No FBX required. Including support for reading Witcher 2 files. Get the latest Release

Witcher 3 Tools — overview

Watch the trailer on YouTube

Features

Character import

Character import

.w2ent character templates define all components needed to assemble your character in a single import. Switch appearances and equipment from the side panel without reimporting. Idle animation loads from the behaviour graph. Mounted props (swords, crossbows, shields) come in with the entity. Additional animations can be loaded from the Animation panel.

Asset Browser

Asset Browser

Type-ahead search across every file in the bundles. Texture preview, filter by type, vanilla and mod content side by side. Click to import directly into the scene.

Character Browser

Character Browser

Every journal character and bestiary creature with their in-game portrait. One click imports the full entity.

Speech Browser and lipsync

Speech Browser & lipsync

60,000+ in-game voice lines with audio preview. One click loads the matching lipsync onto a face rig. Face morphs arrive as Blender shape keys driven from a control bone — the phoneme driver system wires itself up, no manual setup. Compatible with the .re REDkit addon.

Animation export

Animation round-trip

.w2anims import lands each clip as an NLA track with root motion extracted. Edit, retarget, or author new actions in Blender. Export writes root motion back into the motion extraction block. Native .w2anims format on both ends. Also compatible with the .re REDkit addon.

Cutscene workflow

Cutscenes

.w2cutscene / .w2scene places actors, builds cameras, drops animation sequences onto NLA tracks, and loads dialogue audio alongside. The scene plays back on Blender's timeline and can be modified and exported back into REDkit.

Mesh export pipeline

Mesh pipeline

.w2mesh Game assets can be fully completed inside Blender. Export carries the full LOD hierarchy, vertex colours, textures and materials. Built-in LOD generation, collider tools (box / sphere / capsule / convex / trimesh). All embedded in a single export. .w2mi / .w2mg materials rebuild as Blender shader node graphs. Includes .xbm export.

Map and world import

Worlds & maps

.w2l layers bring mesh placements, lights, collision. .w2w imports world terrain heightmaps. Witcher 2 assets use the same workflow.


Install

  1. Download the zip from Releases.

  2. Drag and drop the zip onto Blender or in the UI go to → Edit → Preferences → Extensions → Install from Disk → enable Witcher 3 Tools.

  3. Open addon preferences and check these paths are set:

    Preference Set to
    Witcher 3 Path Root Game install folder (eg. C:\GOG Games\The Witcher 3 Wild Hunt GOTY)
    Uncook Path Extracted files depot addon will use

    Witcher 3 Path will be automatically found and set if it exists in a standard install location. Uncook Path will automatically use blender's Roaming data folder. Change it to a new empty folder if you prefer.

  4. Find Witcher 3 in the n-panel of the 3D viewport. Click on Geralt to load Geralt player entity. This will warm up the bundle and texture caches for the first time.


Format support - Witcher 3

Format Import Export
.w2mesh — Meshes Yes Yes
.w2rig — Skeletons Yes Yes
.w2anims — Animations Yes Yes
.xbm — Textures Yes Yes
.w2cutscene — Cutscenes Yes Yes
.w2ent — Characters & entities Yes
.w2scene — Scenes Yes
.w2l / .w2w — Layers & Worlds Yes
.cr2w — Lipsync & speech Yes
.w2mi / .w2mg — Materials Yes
.nxs — Cooked Collision Yes
.redcloth — Cloth physics Yes
.flyr — Foliage Yes

Format support - Witcher 2

Format Import Export
.w2mesh — Meshes Yes
.w2rig — Skeletons Yes
.w2anims — Animations Yes
.w2l — Map Layers Yes

Optional companion add-ons

Add-on Needed for Source
io_mesh_apx .redcloth / .apx cloth imports GitHub — ArdCarraigh
io_mesh_srt SpeedTree .srt foliage and trees GitHub — ArdCarraigh
blender_re_animations_plugin .re export Ships inside REDkit

Live status for all three shows up in addon preferences under External Addons.

Companion tools

Tool Role
REDkit Official mod editor — depot source and export target
WolvenKit 7 Optional JSON CLI functions — nikich340 & WolvenKit team
Radish Tools World modding pipeline via .yml — rmemr

Requirements: Blender 4.5+

Releases · Wiki · Issues

Author: dingdio · License: GPL-3.0

About

Blender addon for Witcher 3 modding.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages