Blender Source Tools: Difference between revisions

Latest revision as of 06:14, 20 May 2025

A Team Fortress 2 model being edited

Scene configuration

Blender Source Tools allows Blender to import and export SMD and DMX files.

Features

Supports GoldSrc and Source
One-click export and import
SMD and DMX support
- SMD export can be optionally tailored to suit GoldSrc's limitations^[Elaborate?]
Support for most Blender features
Export multiple objects to one file
Compile QCs automatically
Import complicated models by QC

Bug:Triangles which occupy the same three vertex positions as a previous triangle have their vertices reset to around the mesh's origin (at least for SMD export).

Installation

Install the latest version of Blender (minimum 4.1, or later). Or Install Blender from Steam (AppID: 365670)
Download the Source Tools. Don't unzip.
In Blender:
1. Select Edit > Preferences
2. Move to the Add-ons tab
3. Click Install... at the top-right of the window
4. Find the downloaded zip file and select it (Double click)
5. 'Blender Source Tools' should be the only add-on shown if installed correctly. Check the box to the left and wait a moment for activation to complete.

Tip:To change the default export format to SMD, change export_format in

__init__.py.

Community

Documentation

@@ Line 1: / Line 1: @@
-[[File:Blender_25.jpg|thumb|A [[Team Fortress 2]] model open for editing in Blender.]]
+{{LanguageBar|title = Blender Source Tools}}
-{{blender}} The '''Blender SMD Tools''' allow [[Blender]] 2.5x to import and export [[Studiomdl Data]] files.
+[[File:Blender-tf2modelbeingedited.jpg|thumb|A ''[[Team Fortress 2]]'' model being edited]]
+[[File:BST-sceneconfig.jpg|thumb|Scene configuration]]
-== Installation ==
+{{blendersrctools|4|}} allows [[Blender]] to import and export [[SMD]] and [[DMX]] files.
-# '''[http://code.google.com/p/blender-smd/downloads/list Download the script]''' (0.6 released August 26th 2010)
+==Features==
-# In Blender, open ''File > User Preferences'', move to the ''Add-Ons'' tab and click ''Install Add-On'' in the bottom of the window
+* Supports {{gldsrc|4}} and {{src|4}}
-# Check the SMD Tools' box to enable them
+* One-click export and import
-# Click ''Save as Default'' to enable the tools in all Blend files
+* [[SMD]] and [[DMX]] support
+** SMD export can be optionally tailored to suit GoldSrc's limitations{{elaborate}}
+* Support for most Blender features
+* Export multiple objects to one file
+* Compile [[QC]]s automatically
+* Import complicated models by [[QC]]
+{{bug|hidetested=1|Triangles which occupy the same three vertex positions as a previous triangle have their vertices reset to around the mesh's origin (at least for SMD export).}}
-== Features ==
+==Installation==
+# [http://www.blender.org/download/ Install the latest version of Blender (minimum 4.1, or later).] Or [steam://rungameid/365670 Install Blender from Steam] (AppID: 365670)
+# [http://steamreview.org/BlenderSourceTools/ Download the Source Tools.] '''Don't''' unzip.
+# In Blender:
+## Select {{key|Edit}} > {{key|Preferences}}
+## Move to the {{key|Add-ons}} tab
+## Click {{key|Install...}} at the top-right of the window
+## Find the downloaded zip file and select it (Double click)
+## 'Blender Source Tools' should be the only add-on shown if installed correctly. Check the box to the left and wait a moment for activation to complete.
+{{tip|To change the default export format to [[SMD]], change {{code|export_format}} in {{file|__init__|py}}.}}
-* Import or export all types of SMD (except animation import, for the moment)
+==Community==
-* Rotate Y-up models/bones automatically
+* [http://steamcommunity.com/groups/BlenderSourceTools#announcements News and changelog]
-* Batch export objects from a scene with a single click, or export singly
+* [http://steamcommunity.com/groups/BlenderSourceTools/discussions Forums]
-* Compile a QC file automatically after export
-== Usage ==
+==Documentation==
+* [[Blender Source Tools Help]]
-* Use the '''Import SMD''' and '''Export SMD''' operators to import or export. Search for them from the spacebar menu, or use the File menu.
+* [[Animation in Blender|Skeletal animation]]
-* Use the '''Scene Properties panel''' for SMD export options. SMDs are exported to <code><output folder>\<subfolder>\<object>.smd</code>.
+* [[Flex animation|Flex animation (shape keys)]]
-* Use the '''Armature Properties panel''' to filter and batch export actions, and to more conveniently manage or create them.
+* [[Modeling props with Blender|Modelling Props with Blender]]
+* [[Compiling a model]]
-{{tip|You can drag the new panels to a higher position if you want.}}
+* [http://steamcommunity.com/sharedfiles/filedetails/?id=245723825 Steam Community Guide covering all model features in great detail]
+{{sdktools|0}}
-== Gallery ==
+[[Category:Blender]]
+[[Category:Modeling]]
-<gallery>
+[[Category:Third Party Tools]]
-File:Blender SMD export menu.png|Export menu
-File:Blender smd export prefs.png|Scene configuration
-File:Blender smd animation prefs.png|Animation options
-</gallery>
-== Known issues ==
-* Animation is not yet supported for import or export.
-[[Category:Blender]] [[Category:Modeling]]