Setup

How to install

• Download the addon zip file

• Open Blender

• Go to 'Edit → Preferences → Add-ons'

• Click the 'Install…​' button on the top right and navigate to the zip you downloaded, then click 'Install Add-on'

• Tick the checkbox next to 'Import-Export: Import id Tech 3 BSP' to enable the addon

• Optionally add your base path and mod paths in the addons preferences

Paths

If you haven’t configured a basepath your folder structure must look like the following to load materials and/or textures:

game/
├─ base_path/
   ├─ maps/
   │  ├─ map.bsp
   │
   ├─ models/
   │  ├─ model.md3
   │  ├─ some_folder/
   │     ├─ model.md3
   │
   ├─ pak....pk3
   ├─ assets....pk3

On importing a .map or a .bsp file the addon will guess that the parent of the "maps" folder where your file is located is also the base path. Same happens with md3 or tiki files, but it will look for a "models" folder instead.

Images loaded from a pk3 file will be saved to blenders temporary folder. After closing blender, this folder gets cleared, so make sure to pack the images or hit the "Reload Eevee Shaders" or "Reload Cycles Shaders" buttons in the side panel to unpack the images again. Warning, this will reset all your changes to the materials though.

Viewport (optional)

For working with maps I recommend following camera settings:

Sidepanel (optional)

In the addons preferences you can change the appearance of the sidepanel:

Gamepacks (optional)

You can easily import existing gamepacks for GtkRadiant for proper entity colors and sizes. Just download them from GtkRadiant Gamepack SVN

You can usually find the .def files under:

/trunk/install/*some_basename*/scripts

Use the "Import from .def" button in the addons preferences and give it a proper name.