Blender Source Tools: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
m (version)
m (Setting bug notice hidetested=1 param on page where the bug might not need tested in param specified)
 
(55 intermediate revisions by 27 users not shown)
Line 1: Line 1:
[[File:Blender_25.jpg|thumb|A [[Team Fortress 2]] model being editing, thanks to the Blender SMD Tools.]]
{{LanguageBar|title = Blender Source Tools}}


[[File:Blender Pyro DMX.jpg|thumb|DMX import, a world first!]]
[[File:Blender-tf2modelbeingedited.jpg|thumb|A ''[[Team Fortress 2]]'' model being edited]]
[[File:BST-sceneconfig.jpg|thumb|Scene configuration]]


[[File:Blender smd export prefs.png|thumb|Scene configuration.]]
{{blendersrctools|4|}} allows [[Blender]] to import and export [[SMD]] and [[DMX]] files.


{{blender}} The '''Blender SMD Tools''' allow [[Blender]] 2.58+ to import and export [[Studiomdl Data]] files, and to import [[DMX model]]s.
==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).}}


* '''One-click export'''
==Installation==
* '''Supports all types of SMD'''
# [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)
* '''Supports DMX import'''
# [http://steamreview.org/BlenderSourceTools/ Download the Source Tools.] '''Don't''' unzip.
* '''Supports most Blender features'''
# In Blender:
* '''Export multiple objects to one SMD'''
## Select {{key|Edit}} > {{key|Preferences}}
* '''Compile a QC automatically'''
## Move to the {{key|Add-ons}} tab
* '''Import a whole QC at once'''
## 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}}.}}


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


# '''[http://code.google.com/p/blender-smd/downloads/list Download the script]''' (1.0.2 - July 9th, 2011; [http://code.google.com/p/blender-smd/wiki/Changelog changelog])
==Documentation==
# In Blender, open ''File > User Preferences'', move to the ''Add-Ons'' tab and click ''Install Add-On'' in the bottom of the window
* [[Blender Source Tools Help]]
# Check the SMD Tools' box to enable them
* [[Animation in Blender|Skeletal animation]]
# Click ''Save as Default'' to enable the tools in all Blend files
* [[Flex animation|Flex animation (shape keys)]]
 
* [[Modeling props with Blender|Modelling Props with Blender]]
== Usage ==
* [[Compiling a model]]
 
* [http://steamcommunity.com/sharedfiles/filedetails/?id=245723825 Steam Community Guide covering all model features in great detail]
* Use the ''Import SMD'' and ''Export SMD'' operators to import or export. Search for them from the spacebar menu, or use the File menu.
{{sdktools|0}}
* ''Group'' objects to export them to the same SMD.
[[Category:Blender]]
* Use the ''Scene Properties'' panel for SMD export options. SMDs are exported to <code><output folder>\<subfolder>\<object>.smd</code>.
[[Category:Modeling]]
* Use the ''Armature Properties'' panel to filter and batch export actions, and to more conveniently manage or create them.
[[Category:Third Party Tools]]
 
{{tip|You can drag the new panels to a higher position if you want.}}
 
== Gallery ==
 
<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