io_import_vmf

A Valve Map Format (.vmf) and Valve Material Type (.vmt) importer for Blender.

Also includes helpful wrappers for importing HLAE .agr files and .qc models with materials using the included material importer.

Requires Blender 2.82 or newer.

Blender Source Tools must be installed for importing models!

Ships bundled with Crowbar-Command-Line for automatic model decompilation.

Installation

• Get the latest release from the releases tab.
• Go to Preferences > Addons > Install.
• Select the .zip file you downloaded.

Latest from source

• Install Python.
• Clone the repository.
• Run install.sh or install.ps1 depending on your OS.
• Follow the installation instructions above for the newly created .zip file.

Usage

The importer can automatically extract the required files from the game files. Materials and props, for example, require external game files for the import to succeed.

You need to go to the addon preferences to add game definitions which are used for loading these files. Click the + button to add a new game definition. Press the "Detect from a game directory" button and select the game directory. For CSGO that is installed in the default directory, you need to select C:\Program Files (x86)\Steam\steamapps\common\Counter-Strike Global Offensive\csgo. The addon attempts to automatically detect the game name and relevant VPK files inside the selected directory. If your game includes content inside other directories, you can use the auto-detection on them too. In case the addon fails to detect some VPK archives or you would like to add a directory without detecting the VPKs inside it, you can use the + buttons to add them manually.

Blender may appear frozen when importing complex maps. To see the import progress and any errors in realtime, you can open the Blender console.

Maps

File -> Import -> Valve Map Format (.vmf)

Source maps that ship with the game are in a compiled .bsp file format. This addon can only import them in the original .vmf format. You can use BSPSource to decompile the map files into the .vmf format supported by this addon.

You can select what to import from the file dialog. The more things you select, the slower the import progress will be, so you should select only the things you need.

Brushes, lights and overlays are fast to import, they should take less than a minute. Importing materials can take a little longer. Importing props is extremely slow, it usually takes over 30 minutes for a full-sized map.

The following features are only supported on Windows:

Materials

File -> Import -> Valve Material Type (.vmt)

By default, the materials try to mimic the original appearance as much as possible. They are however approximations and may appear different than ingame.

You can also import simpler versions of materials. You should check it if you plan to export the materials outside Blender, since exporters are usually unable to read the more complicated material setups.

There are also options to select the texture interpolation type and whether to allow backface culling in materials that don't disable it.

QC (requires Blender Source Tools)

File -> Import -> Source Engine Model (enhanced) (.qc)

AGR (requires afx-blender-scripts)

File -> Import -> HLAE afxGameRecord (enhanced) (.agr)

Credits

• Me for the addon, VMF and VMT parser and VTFLib wrapper.
• ValvePython for VPK and Valve KeyValues parser.
• Nemesis for VTFLib.
• Artfunkel for Blender Source Tools.
• ZeqMacaw and UltraTechX for Crowbar and Crowbar-Command-Line.
• Devostated for testing and bug reporting.

License

This project is licensed under the MIT license. See LICENSE for more information.