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)
 
(40 intermediate revisions by 22 users not shown)
Line 1: Line 1:
[[File:Blender_25.jpg|thumb|A [[Team Fortress 2]] model being edited]]
{{LanguageBar|title = Blender Source Tools}}


{{blender}} The '''Blender SMD Tools''' allow [[Blender]] 2.63+ to import and export [[Studiomdl Data]] and [[DMX model]] files.
[[File:Blender-tf2modelbeingedited.jpg|thumb|A ''[[Team Fortress 2]]'' model being edited]]
[[File:BST-sceneconfig.jpg|thumb|Scene configuration]]


* '''One-click export'''
{{blendersrctools|4|}} allows [[Blender]] to import and export [[SMD]] and [[DMX]] files.
* '''Supports SMD and DMX'''
* '''Supports most Blender features'''
* '''Export multiple objects to one SMD/DMX'''
* '''Compile a QC automatically'''
* '''Import a whole QC at once'''


== 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]'''
==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]


: ''For an in-depth guide, see [[Blender SMD Tools Help]].''
==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]]
* ''Group'' objects to export them to the same file.
* [[Flex animation|Flex animation (shape keys)]]
* Use the ''Scene Properties'' panel for export options. Files are exported to <code><output folder>\<subfolder>\<object>.smd</code>.
* [[Modeling props with Blender|Modelling Props with Blender]]
* Use the ''Armature Properties'' panel to filter and batch export actions, and to more conveniently manage or create them.
* [[Compiling a model]]
 
* [http://steamcommunity.com/sharedfiles/filedetails/?id=245723825 Steam Community Guide covering all model features in great detail]
{{tip|You can drag the new panels to a higher position if you want.}}
{{sdktools|0}}
 
[[Category:Blender]]
== Gallery ==
[[Category:Modeling]]
 
[[Category:Third Party Tools]]
<gallery>
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>
 
[[Category:Blender]] [[Category:Modeling]][[Category:Third Party Tools]]

Latest revision as of 07: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