It can be found at
The only parameter required is a QC file. Any others must come before it.
studiomdl [options] <path\QC>
- Override the VProject game path.
- Suppresses some console output, such as spewing the searchpaths.
- Enable Xbox 360 output, overriding the
- Disable Xbox 360 output, overriding the
- Disable warnings.
- Print no more than the specified number of warnings.
- Writes extra bone info to the console.
- Equivalent to specifying
- Prints engine-ready keyframe data for each animation.
- Skip processing DX7, DX8, X360, and software VTX variants (use
.dx90.vtxonly). This speeds up compiling.
- Skip splitting quads into tris. This changes the rendering flags for the model, most likely resulting in slower performance or buggier rendering in-engine.
- Don't truncate really big collision meshes .
- Ignore all
- Throw away data from LODs above the given one (see
- Report performance info for an already-compiled model. A QC file is not needed when using this command.
- Same as
- Report performance info, per-LOD, as a comma-delimited spreadsheet. It will appear in the form:
Path to VTX, VTX file extension, LOD number (1 is the root lod), tri count, number of batches rendered, number of materials used
- Must be used with -mdlreport or -perf!
- Dumps various glview files (10 per LOD per VTX file),
- Dump hitboxes to console.
- Tag bad normals.
- Dump names of used materials to the console.
- Ignore warnings.
- Replaces all materials with the default pink check pattern
- Prints an easily parseable message indicating whether the compile was successful or a failure.
- Prints info on which bones are being retained and which bones are being collapsed.
- Disables Valve's Perforce integration. Unless you actually have Perforce set up for your game/mod (a highly unlikely scenario), you should use this.
- Compile the model, but don't actually write the results to disk.
- Auto-smooth faces equal to or below specified angle. Will override normal data for all meshes.
- Flip all triangles.
- Generates a VSI file from a QC or MDL.
- Strips down a model, removing its LOD info.
- Strips down hardware verts (VHV) of their LOD info.
- Generates a simple makefile for later compiling. It also parses the QC for any errors, and runs in
- Runs studiomdl in the context of the provided path.
- Adds the provided path as a content search path.
- "Tag reversed".
- Probably meant to test the model collision for any physics errors. Skips whatever argument is provided after it.
StudioMDL supports a range of input formats. These include SMD, DMX, and OBJ for reference meshes, SMD and DMX for skeletal animation, and VTA and DMX files for vertex and flex animation. Counter-Strike: Global Offensive also supports FBX, but with limited functionality. Flexes are not directly supported, nor are FBX sequences, however an SMD/DMX sequence can be used on an FBX model.
- Skeleton, animations, bounding/hit boxes, surface materials, LOD index…
- Vertex data optimised for software rendering, XBox 360, DirectX 7, 8 and 9 respectively.
- Remaining hardware-agnostic vertex data, including the UV map
- Collision mesh data
- Common Studiomdl errors
- Crowbar, a popular graphical interface for studiomdl which also supports model decompiling and other advanced features.
- Studiocompiler, a graphical interface for studiomdl
- GUIStudioMDL, another graphical interface
- Source Model Compiler, a web based model compiler and QC generator.
- Fixing the 5% Weight Bone Link Cull, for SFM
|Official Source SDK tools|
|Map compilers||vbsp • vvis • vrad • vmpi|
|Map tools||bspzip • glview • VBSP2 • vbspinfo|
|Model tools||Dmxconvert • Dmxedit • HLFaceposer • HLMV • Itemtest • Modelbrowser • QC_Eyes|
|Texture tools||Height2Normal • height2ssbump • makevmt • mksheet • Pfm2tgas • Shadercompile • Splitskybox • Vtex • VTF2TGA • xwad|
|Engine tools||ActBusy Script Editor • Commentary Editor • Foundry • Material Editor • Particle Editor • Source Filmmaker|
|Other||Captioncompiler • Demoinfo • Elementviewer • Motionmapper • Sfmgen • VConfig • Vfont • Vfont_decompiler • VICE • vpk|