This article's documentation is for the "GoldSrc" engine. Click here for more information.
This article's documentation is for anything that uses the Source engine. Click here for more information.

QC: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(jb3 is weird. there isn't any good reason to use backslashes instead of forward slashes, though)
(strangely common to have a mix)
Line 10: Line 10:
Comments can be ends of lines starting with <code>//</code>, or blocks contained between <code>/*</code> and <code>*/</code>. Source additionally supports end of line comments starting with <code>#</code> or <code>;</code>.  
Comments can be ends of lines starting with <code>//</code>, or blocks contained between <code>/*</code> and <code>*/</code>. Source additionally supports end of line comments starting with <code>#</code> or <code>;</code>.  


Paths usually can contain either forward or backslashes, except for {{jbep3}}, which requires forward slashes due to adding support for {{w|escape sequence|escape sequences}} in QC files (due to shared code between [[VBSP]] and StudioMDL).
Paths usually can contain a combination of either forward or backslashes, except for {{jbep3}}, which requires forward slashes due to adding support for {{w|escape sequence|escape sequences}} in QC files (due to shared code between [[VBSP]] and StudioMDL).


{{note|Although the "QC" file extension is derived from the [[QuakeC]] programming language used by {{quake|4.1}}, the syntax of StudioMDL QC files is significantly modified from the {{w|C (programming language)|C}}-like syntax used by QuakeC.}}
{{note|Although the "QC" file extension is derived from the [[QuakeC]] programming language used by {{quake|4.1}}, the syntax of StudioMDL QC files is significantly modified from the {{w|C (programming language)|C}}-like syntax used by QuakeC.}}

Revision as of 17:15, 3 April 2025

English (en)日本語 (ja)Русский (ru)Translate (Translate)

For a list of QC commands, see Category:QC Commands.
To learn how to compile a model, see Compiling a model.

A QC file is a script which controls the process of "compiling" SMDs into a binary model that can be loaded into a game. A QC configures the model's location and name, while SMD files are used to provide geometry, collision meshes and animations, how the model reacts when shot, and so on.

Comments can be ends of lines starting with //, or blocks contained between /* and */. Source additionally supports end of line comments starting with # or ;.

Paths usually can contain a combination of either forward or backslashes, except for Jabroni Brawl: Episode 3, which requires forward slashes due to adding support for Wikipedia icon escape sequences in QC files (due to shared code between VBSP and StudioMDL).

Note.pngNote:Although the "QC" file extension is derived from the QuakeC programming language used by Quake Quake, the syntax of StudioMDL QC files is significantly modified from the Wikipedia icon C-like syntax used by QuakeC.
Tip.pngTip:Shared QC files intended for use with $include are typically given the extension qci, and outdated or deprecated QC files are typically given the extension qcx. This prevents them from attempting to be compiled when batch-compiling an entire folder.

Simple example

Here is a very simple QC file for a solid model without any animation or special properties (click on each command for details):

$modelname	"props_sdk/myfirstmodel.mdl"
$body mybody	"myfirstmodel-ref"

$surfaceprop	combine_metal
$cdmaterials	"models/props_sdk"

$sequence idle	"myfirstmodel-ref" // no animation wanted, so re-using the reference mesh

$collisionmodel	"myfirstmodel-phys" { $concave }
Note.pngNote:The .smd file extension should usually be omitted from mesh and animation file names. Including it will cause GoldSrc StudioMDL to fail to load the file.

Source StudioMDL automatically looks for files in this order when no extension is present:

Source 2013 VRM, SMD, SMA (SMD), PHYS (SMD), VTA, OBJ, DMX, XML (DMX)
CS:GO engine branch FBX, VRM, DMX, MPP (DMX), SMD, SMA (SMD), PHYS (SMD), VTA, OBJ, XML (DMX), FBX

File format

[Todo]

Files

[Todo]

See also


Stub

This article or section is a stub. You can help by expanding it.