Blender Source Tools: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
m (Setting bug notice hidetested=1 param on page where the bug might not need tested in param specified)
 
(91 intermediate revisions by 28 users not shown)
Line 1: Line 1:
[[File:Blender_25.jpg|thumb|The [[Antlion Guard]] model 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]]


{{note|Animation is not yet supported.}}
{{blendersrctools|4|}} allows [[Blender]] to import and export [[SMD]] and [[DMX]] files.


== Installation ==
==Features==
* Supports {{gldsrc|4}} and {{src|4}}
* 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 [[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).}}


# '''[http://code.google.com/p/blender-smd/downloads/list Download the script]''' (latest release August 16th 2010)
==Installation==
# In Blender, open ''File > User Preferences'', move to the ''Add-Ons'' tab and click ''Install Add-On'' in the bottom of the window
# [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)
# Check the SMD Tools' box to enable them
# [http://steamreview.org/BlenderSourceTools/ Download the Source Tools.] '''Don't''' unzip.
# Click ''Save as Default'' to enable the tools in all Blend files
# 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}}.}}


== Usage ==
==Community==
* [http://steamcommunity.com/groups/BlenderSourceTools#announcements News and changelog]
* [http://steamcommunity.com/groups/BlenderSourceTools/discussions Forums]


See the Scene Properties panel for SMD export options. SMDs are exported to <code><output folder>\<subfolder>\<object>.smd</code>.
==Documentation==
 
* [[Blender Source Tools Help]]
== Gallery ==
* [[Animation in Blender|Skeletal animation]]
 
* [[Flex animation|Flex animation (shape keys)]]
<gallery>
* [[Modeling props with Blender|Modelling Props with Blender]]
File:Blender SMD export menu.png|Export menu
* [[Compiling a model]]
File:Blender smd export prefs.png|Configuration panel
* [http://steamcommunity.com/sharedfiles/filedetails/?id=245723825 Steam Community Guide covering all model features in great detail]
</gallery>
{{sdktools|0}}
 
[[Category:Blender]]
== Known issues ==
[[Category:Modeling]]
 
[[Category:Third Party Tools]]
* Animation is not yet supported for import or export.
 
[[Category:Blender]] [[Category:Modeling]]

Latest revision as of 06:14, 20 May 2025

English (en)Русский (ru)中文 (zh)Translate (Translate)
A Team Fortress 2 model being edited
Scene configuration

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

Features

  • Supports GoldSrc GoldSrc and Source 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
Icon-Bug.pngBug: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

  1. Install the latest version of Blender (minimum 4.1, or later). Or Install Blender from Steam (AppID: 365670)
  2. Download the Source Tools. Don't unzip.
  3. 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.pngTip:To change the default export format to SMD, change export_format in 🖿__init__.py.

Community

Documentation