Серов Станислав (yxo)   11.11.2012
Это дополненная версия статьи от 2004 года из Russian Half-Life Modelling Center.

.qc сценарий — это простой текстовый файл или несколько файлов, созданных в любом простейшем текстовом редакторе и необходимых для того, чтобы cкомпилировать трёхмерную модель для игровых движков. Обычно для моделей достаточно собрать в одну папку все smd и bmp файлы, сам компилятор studiomdl, написать сценарий компиляции — qc-файл и запустить из командной строки:
studiomdl.exe НазваниеСценария.qc
и модель готова. Хотя для компилятора существуют дополнительные настройки для командной строки и даже создан графический интерфейс для управления ими, обычно запуска в командной строке достаточно. А сейчас рассмотрим команды сценариев компиляции главным образом для движка GoldSource, но и в более современных движках используется большинство перечисленных параметров и команд создания моделей.

Короче говоря, в статье собран список общих команд для компилятора studiomdl с параметрами, описанием и примерами. Начнём с основных:

$modelname <путь>
Эта команда сообщает studiomdl, как назвать и где поместить откомпилированную модель.
Пример для модели Gordon.mdl:
$modelname "C:\Half-Life\valve\models\player\Gordon.mdl"
Пример, указывающий только название модели и потому сохраняющий в текущую папку:
$modelname "shlang.mdl"

$cd <путь>
Эта команда указывает компилятору studiomdl текущую рабочую папку. Команда работает так же, как и в DOS'e команда "cd".
пример относительного пути в ту же папку, где находится и сам .qc файл:
$cd ".\"
пример абсолютного пути:
$cd "C:\Half-Life\valve\models\source\Gordon"

$cdtexture <путь>
Эта команда сообщает компилятору studiomdl, где расположены текстуры.
Пример абсолютного пути:
$cdtexture "C:\Half-Life\valve\models\source\Gordon\textures"
Пример относительного пути из текущей папки в подпапку textures:
$cdtexture ".\textures"

$externaltextures
Эта команда сообщает studiomdl, что нужно сохранять текстуры модели как отдельный *t.mdl файл. (Здесь под звёздочкой автоматически подставляется название модели, используемое в основном файле модели *.mdl). В руководстве "Modeling and Animating for Half-Life" рассказывают, что команда $externaltextures нужна тем моделям, которые часто вызываются движком, но не отображаются на экране, для них хранение текстур отдельно от сетки приведёт к ускорению отрисовки графики.
Пример:
$externaltextures
Также разработчики задумали эту команду для удобства замены текстур в некоторых моделях заменой выделенного файла *t.mdl, не трогая объёмные данные. Короче, сейчас эта возможность используется не часто.

$cliptotextures
Эта команда сообщает studiomdl компилировать ли текстуры с моделью. Она обычно используется с моделями игрока для дезматча.
пример:
$cliptotextures

$scale #
Масштаб модели больше или меньше. По умолчанию всегда равно 1.
пример, увеличивающий её в 1,2 раза:
$scale 1.2

$origin
Это смещения начала координат модели. Этот параметр нужен для точной настройки модели, если вы к примеру модель сделали выше 0 по координате Z, то вам надо обязательно указать насколько выше вы её поместили. В противном случае модель будет неправильно показыватся на экране. Внимание: после декомпиляции модели оружия из CS движения рук съезжают нафих совсем не туда куда нужно, а с помощью этой команды можно вернуть модель рук обратно не редактируя анимации.
пример коррекции по оси Z:
$origin 0 0 36

$eyeposition
Для ботов или монстров в одиночной игре нужно, чтобы сообщить игре, где глаза монстра находятся относительно начала координат модели. К примеру, из-за ошибочно низкого положения глаз он может не увидеть что-либо из-за приземистого блока, хотя модель выглядит выше блока раза в 4, а тут можно вправить ему зрение.
пример высоты глаз на уровне 65 единиц над землёй (грубо это на высоте 1,6 метра, если считать, что 40 ед. в 1 м):
$eyeposition 0 0 65

$bbox (мин по x) (мин по y) (мин по z) (макс по x) (макс по y) (макс по z)
Задаёт параллелепипед габаритов отображения сориентированный вдоль осей X, Y и Z. Он даёт знать графическому движку о протяжённости модели. Полезно задавать для крупных моделей, которые без него могут не отрисовываться, когда выглядывают из-за казалось бы некрупных препятствий. Часто этот параллелепипед отцентрирован по длине и ширине, когда (мин по x) = –(макс по x) и (мин по y) = –(макс по y). Также задаём полную высоту в (макс по z) при том, что низ на уровне пола, поэтому задаём (мин по z) = 0. На сайте valvesoftware.com пишут, что его также называют каркасом (англ. hull, но не clipping hull, т.е. это не то же самое, что и каркас границ столкновений).
Пример габаритов дерева высотой примерно 6 метров:
$bbox -48 -48 0 48 48 240

$cbox (мин по x) (мин по y) (мин по z) (макс по x) (макс по y) (макс по z)
Задаёт параллелепипед габаритов столкновений.
NB. Надо будет проверить, в его ли габариты упираешься в игре, когда модель вставляешь в игровую карту с помощью объекта cycler?
Пример объекта размером с человека:
$cbox -16 -16 0 16 16 72

$body <имя smd файла> [reverse]
Вторая по важности команда в сценарии. Это ссылка на .smd файл главной сеточной оболочки модели; базовая модель с текстурами. Известно, что в подавляющем большинстве игр тыльные стороны граней не прорисовываются для экономии ресурсов. Команда reverse обменивает лицевые и тыльные стороны граней и используется только в случае (!), если возникают проблемы при экспортировании из редакторов типа Blender или 3D MAX, когда нормали поверхностей шиворот навыворот, а модель ошибочно получается текстурами внутрь.
Пример:
$body studio "monster" reverse

$bodygroup <имя группы> {smd группы}
Команда позволяет вашей модели иметь взаимозаменяемые части. Для модели с N заменяемых частей у многих объектов monster... в редакторах карт можно задать параметр body, в значении которого указать номер части от 0 до N–1. Этот пример показывает, как сделать монстра, который может держать дробовик, винтовку MP5 или ничего. Не включайте .smd расширение.
Пример:
$bodygroup weapons
{
studio "shotgun"
studio "mp5"
blank
}

$texturegroup <имя группы> {bmp группы}
Команда позволяет вашей модели иметь взаимозаменяемые текстуры. Этот пример показывает, как нормальные текстуры головы и тела могут быть заменены в игре кровавыми текстурами. Убедитесь, что включили .bmp расширение.
Пример предполагает, что на сеточной модели изначально есть текстуры body_normal.bmp и head_normal.bmp:
$texturegroup pain
{
{ "body_normal.bmp" "head_normal.bmp" }
{ "body_pain.bmp" "head_pain.bmp" }
}

$renamebone <старое имя кости> <новое имя кости>
Character Studio версии 2.x и старше использует другое названия для некоторых костей двуногого животного. Если вы смешиваете модели или мультипликации от более ранних версий, тогда они должны быть переименованы. Этой командой можно легко переименовать кости во время компиляции, вместо того чтобы переименовать их в каждом исходном .max файле.
пример:
$renamebone "Bip01 R Clavicle" "Bip01 R Arm"

$include <дополнительный файл сценария .qc>
Чтобы включать в компиляцию другой .qc файл.
Пример:
$include "C:\Half-Life\valve\models\player\player_shared.qc"

$attachment <#> <кость>
Задаёт определённую точку в пространстве, которая присоединяется к заданной скелетной вершине. Её задают для того, чтобы из её места воспроизводить различные эффекты, например такие, как отрисовка огня, спрайтов, искрение и т. д. Координаты задают удаление точки от скелетной вершины.
Пример:
$attachment 0 "Bip01 R Hand" 20 2 5

$controller <#> <кость> <ось вращения> <предел вращения в градусах>
Эта команда позволяет игре управлять вращением осей модели, т.е. костей. Наиболее очевидный пример — вращение головы монстра, в примере 1. Команда позволяет игре вращать голову от -60 градусов до +60 по оси X. Пример 2 показывает как сделать контроллер рта, чтобы монстр мог говорить.
пример 1:
$controller 0 "Bip01 Head" XR -60 60
пример 2:
$controller mouth "Bone03" ZR 0 45

$hbox <группа #> <кость>
Команда задаёт для костей модели hitbox'ы или по-понятному — габаритные параллелепипеды попаданий. Если звучит всё ещё сложновато, объясню подробно: в игровом движке GoldSource параллелепипеды попаданий отвечают за места получения урона моделью. Если они не заданы, то компилятор создаст их автоматически, но если вам нужно их редактировать, то легче не создавать хитбоксы заново, а сперва декомпилировать модель, исправить габариты в файле qc-сценария и снова её скомпилировать. Получившиеся хитбоксы вам покажут просмотрщики моделей типа Jed's Half-Life Model Viewer или Half-Life Model Viewer 1.25 или даже в самой игре Half-Life, Counter-Strike или др. с помощью консольной команды r_drawentities 3 (отключить её действие можно командой r_drawentities 1).
Эта пара примеров показывает создание хитбоксов для ноги, если название костей (правой) ноги в модели Bip01 R Leg1 и Bip01 R Foot.
Пример:
$hbox 7 "Bip01 R Leg1" 0.31 -3.97 -2.84 17.60 3.94 2.97
$hbox 7 "Bip01 R Foot" -0.56 -2.34 -2.19 3.81 8.00 2.66

$gamma <дробное значение # коэффициента контрастности>
Задаёт коэффициент контрастности отображения текстур модели (иначе говоря, коэффициент γ). По умолчанию этот коэффициент задаётся равным 1,8.
Пример, повышающий контрастность текстур модели до 3,2:
$gamma 3.2
А это пример влияния коэффициента контрастности на отображение модели гнома для значений 5, 3 и 1,8:

$sequencegroupsize <# в Кб>
Это отделяет файлы скелетных анимаций от сеточной модели в меньшие файлы. Нужно для того, чтобы анимации загружались в память только когда необходимо, вместо того чтобы загружать их все. Это полезно для монстров с заданным сценарием анимаций. Правда современные компьютеры редко тяготятся подобными мелочами, так что можно не пользоваться, если только Вы не оптимизируете игру для мобильников.
Пример разбивания по 64 Кб:
$sequencegroupsize 64

$sequence <имя файла> "smd" [motion extraction] [fps <#>] [blend ] [origin ] [scale <#>] [loop] [frame ] ['activity' 'multiplier'] {event <#> }
Команда задаёт компилятору файл типа .smd с движением.

И вот примеры команды $sequence:

Первый пример:
$sequence crouch_shoot_mp5 "crouch_shoot_mp5"
Очень простая команда содержащая в себе минимум, необходимый для того чтобы она работала. Crouch_shoot_mp5 — название анимации и "crouch_shoot_mp5" — файл анимации без .smd расширения.

Второй пример:
$sequence shoot "shoot" { { event 5001 1 "20" } { event 5004 1 "hks1.wav" } }
Этот пример использует такие события, чтобы показать работу спрайтов и звук стрельбы из оружия. Предполагается, что звук hks1.wav загружается игровым движком в заранее запрограммированном коде объекта (т.е. монстра, персонажа, устройства), в противном случае на картах, где используется эта модель нужно будет загружать звуковой файл через какой-нибудь объект, который позволяет загрузить произвольный звук, например, в Half-Life и CS обычно используют ambient_generic.

Не участвующие в компиляции комментарии в одну строчку, начинаются двумя косыми чертами //  и пробелом за ними. Комментарии на целый абзац должны начинаться с символов косая черта и звёздочка /*, а заканчиваться наоборот звёздочкой и косой чертой */.

Вот и всё что можно было сказать о содержании qc, далее опубликована пара примеров qc файлов с описанием каждой команды.

Пример самого простого файла:

• studiomdl [192 Кб] — компилятор MDL моделей (см. в середине той страницы), работающий из командной строки. Поддерживает дополнительные возможности моделей, реализованные в игре Day of Defeat (DoD): альфапрозрачность (точки на текстуре, окрашенные заданным цветом абсолютно прозрачны) и аддитивная прозрачность (сложение цветов текущей точки грани и того, что находится за ней).
• mdldec версии 1.2 [138 Кб] — декомпилятор MDL моделей, работающий из командной строки (см. в середине той страницы).
• GUI StodioMDL версии 2.2/Source от 2007 г. [140 Кб] — графический интерфейс из одного окна с настройками для запуска компилятора studiomdl для движков Source (в том числе Episode 1 из Half-Life 2) и GoldSource. Для Windows 2000, XP, Vista.
• GUI StodioMDL версии 1 [141 Кб] — графический однооконный интерфейс с настройками для запуска компилятора studiomdl для движка GoldSource. Для 32-х битных Windows 9x, ME, 2000, XP, Vista.
• Генератор qc сценариев версии 1.0.1 [1,35 Мб] — русскоязычный генератор qc-сценариев на основе большинства рассмотренных в статье настроек. Для Windows 9x – 7.

Спасибо человеку под псевдонимом Spider за описание команд компиляции на английском и разработчикам из компаний id Software и Valve за движок игры Half-Life и инструментарий.