QC Commands

From Valve Developer Community
Jump to: navigation, search
日本語
Note:The auto links in the mergeto template above may be messed up. Use Category:QC Commands and Talk:QC Commands respectively.

Don't use this page unless you can't find what you are looking for in Category:QC Commands.

This list is outdated and often difficult to understand!

Standard commands

Optional commands are in square brackets.

$model (name) (filename)

  • Specifies the smd file to be load. Used mainly for characters when the model needs complex parameters like eyes, flexes etc. In other cases, use $body.

$origin x y z

  • Offsets the origin of the model.

$modelname (filename)

  • Specifies the filename of the compiled model. This filename should be relative to the models/ directory in the mod.

$body (name) (filename)

  • A less complex version of $model. Should be used with props for better performance.

$cdmaterials (directory) [(directory) (directory) ...]

  • This argument may be used to provide additional directories to locate materials in. These directories should be relative to the materials/ directory and will be embedded directly in the .mdl file.

$pushd (directory)
$popd

  • These arguments allow the user to change the directory on the fly inside the .qc file. They work like the Bash-style pushd and popd commands, by pushing and popping directories onto a stack. Each pushd statement should be met with a popd statement.

$root (bone name)

  • This specifies which bone should be the root bone which all others are inherently children of. This defaults to the first bone.

$controller (number) (bone name) ([L]X|Y|Z[R]) (start angle) (end angle)

  • Use this to specify a rotating controller on one of your bones, "name" being the name of the bone and "start" and "end" being the start and end values of the rotation.

$poseparameter (name) (min) (max) ["loop" (number)] ["wrap"]

  • These are the same as "blend" parameters normally specified in sequences, except that you can now explicitly declare their range instead of letting studiomdl try to figure it out. If "loop" is specified, the engine will wrap calculate values.

$attachment (name) (bone name) (X) (Y) (Z) ["absolute"] ["rigid"] ["rotate" pitch yaw roll]

  • Attachment points are now named based instead of fixed indexed based. They also can be defined in absolute coordinates instead of being bone relative. If defined as "rigid", the bone they’re attached won’t be assumed to animate and may be optimized out, in which case they’ll reattach themselves to the first available parent bone.

The "rotate" option will change the orientation of the attachment point, in place, relative its parent joint.

$hierarchy (child bone) (parent bone)

  • This forces a specific bone hierarchy on the model, regardless of what's in the reference file. Normally, the bone hierarchy is generated based on the first occurrence of a parent child relationship. This commands allows you override it with any arbitrary hierarchy.

$collapsebones

  • Collapse all bones in the hierarchy.

$alwayscollapse (bone)

  • Collapse a specific bone.
Note:The model builder will now allow the animator to change the bone hierarchy between animations, at least in the source. The hierarchy is unified into a single fixed hierarchy for playback, but it’s often easier to change this for certain hand animation tasks. The hierarchy is defined by the first instance of the parent->child relationship.

$definebone (name) (parent) (X) (Y) (Z) (xr) (yr) (zr) (fixup XR) (fixup YR) (fixup ZR)

  • Defines a bone outside of any .smd source. This is useful when building animation only mdl’s that would otherwise optimize out all the bones since none of them are connected to any geometry or attachment points. You can get studiomdl to dump this out using the "-definebones" command line option.

$animation (name) (file) [(options)...]

  • Use this when you're creating a sequence that uses multiple source animations, but where you may need different options - such as frame numbers, alignment, etc. - on each of the different animations. When creating your sequence, refer to the animations by name instead of by filename.

$declaresequence (name)

  • Forward declares a sequence. This useful when sequence that want to add other sequences as layers that aren’t locally declared, such as when they’re actually part of an external mdl file. $declaresequence makes a empty sequence entry so that the local sequence pointers can get set, and at run time these references are overwritten with the actual sequence index.

$bonemerge (name)

  • Serves as a hint to the game code that the named bone will be used for bone merges (see Attachments) during the game. If this flag is not present, the bone can still be used but you'll get performance warnings.

$includemodel (filename)

  • Adds a .mdl file that this .mdl will include at run-time, and all new sequences and animations will be appended to the model. Animations and sequences are processed in-order, and subsequent animations/sequences that have name conflicts will be ignored, and any references to .mdl local entry by the same name will be overwritten with the reference to a first one declared.

Included .mdl’s can have different bone ordering, but they need to have the same bone hierarchy and ikchain declarations. Currently there’s no run-time checking to verify they match.

Only animations and sequences are used from included .mdls. Currently models, textures, faces, attachments, etc. are ignored.

$animblocksize (size in K)

  • If this is specified, all the animation data will be written to a .ani file, and when sequences need it the data will be demand loaded. The "size in K" is the block size the animations will be grouped into. Sizes between 4K and 64K are fine, though 16K or 32K has better memory fragmentation characteristics.

$weightlist (name) (bone name) (weight) [[(bone name) (weight)] ...]

  • This creates a named list of boneweights that can be used by animations that are intended to be blended on top of other animations. The weightlist is built assuming that the root bone has a weight of 0, and that all child bones inherit the weight of their closest specified parent bone. This means that you only have to specify weights when they change, not for each and every bone in the list.

$scale (scale)

  • Scales the model by the given scale amount. A scale of 1.0 makes the model normal sized, 0.5 is half sized, and 2.0 is double sized. Note that the $scale command must be given before any .smd file references, else it will not be applied.

$staticprop

  • Causes all bones to be collapsed in the object; this can only be used when there’s no animation associated with the object. You want to use it wherever possible though, because it will make the models render more quickly.

$realignbones

  • This forces all the bones to reorient themselves – if possible - so that their longest axis is along their X axis. This helps with building both hit boxes, quite often child bones are at some diagonal to their parent and the axis-align-bounding-box that gets connected to their parent bone is often badly shaped for models that are mostly made of long tubes, as well as making IK possible since the IK system requires that the child bones are always along the X axis of their parent.

Bones with multiple children, such as the pelvis, are not realigned and cannot be used as part of an IK system (i.e. the hip bone can’t change position in relation to the pelvis).

$surfaceprop (name)

  • Applies a particular surface property to the entire model. The surface property affects a number of parameters for the model: it’s physics properties (weight, etc), what sounds it makes when it collides, what particles it emits when you shoot it, etc. To add or change surface property types, edit the file hl2\scripts\surfaceproperties.txt. HLMV can be used to generate blocks of .QC file that sets the surface properties correctly.

$jointsurfaceprop (joint name) (name)

  • Applies a surface property to a particular joint and all of its children. HLMV can be used to generate blocks of .QC file that sets the surface properties correctly.

$contents (list of names of content types)

  • Specifies the contents to use for contents-mask tests during non-hitbox traces. This feature was specifically added to allow us to make things like fences out of props instead of brush models.

The current contents types you can use are:

  • "grate" Makes it be a grate (not solid to bullets, solid to everything else)
  • "monster" Makes it be marked as an NPC
  • "notsolid" Makes it be not solid to anything
  • "solid" Makes it be solid (usually useful only for the $jointcontents command to make a solid child of a non-solid parent)
  • "ladder" Make it be a ladder

For example,

$contents "monster" "grate"

$jointcontents (joint name) (list of names of content types)

  • This command is just like contents, but it applies the contents to the specified bone and all child bones of that bone.

$opaque

  • Causes the model to be assumed to be opaque with respect to its sorting against all other objects in the scene. Use this in cases where only a small portion of the model is translucent (hair, eyes, glasses, etc.) so if there are any sorting issues, it won’t matter.

$mostlyopaque

  • Causes the model to be rendered in two passes: The first pass renders only the opaque portions of the model, and the second pass renders only the translucent portion of the model. Good for improving translucency sorting for things like trees.

$keyvalues

  • This allows you to add an arbitrary block of keyvalues into the .mdl file. For example,
$keyvalues
      {
           "build_points"
           {
                "build_point_0"
                {
                     "valid_objects"
                     {
                          "obj_manned_plasmagun" 1
                          "obj_resourcepump" 1
                          "obj_shieldwall" 1
                     }
                }
           }
      }

$definemacro (macroname) [arg_name1] [arg_name2] […] \\

  • Defines a string substation macro. The macro definition begins on the next line, and all subsequent lines that end with \\ (two backslashes). Arguments are referenced by surrounding them with $’s (i.e. $arg_name1$ ), and can be embedded inside of other words. To use the macro, type $macroname and the next N tokens will be taken as arguments.
	$definemacro testmacro seqname filename endframe \\
	$sequence $seqname$01 $filename$ { \\
		frames 0 $endframe$ \\
		subtract $seqname$ 0 delta \\
		weightlist justbody \\
	}

Then, to use the macro, do:

	$testmacro small_flinch "npc flinch 01" 20

$lod (distance) { (lod commands here) }

  • Begins a block of commands to describe how to perform LOD on the model. The distance parameter represents that this particular set of LOD commands should be run when the camera is farther than distance away from the model. The commands allow you to replace various materials, textures, etc. The commands you can include in the LOD block are shown in the Level of Detail section.

$proceduralbones (helper bone configuration file)

  • Helper bones help controling bone orientation/position. Default helper bone configuration files are found in sourcesdk_content\hl2mp\modelsrc\humans_sdk.


$jigglebone (New with Source 2007)

  • When a bone is specified as a jigglebone, it will move based off real time physics simulations.

Level of Detail commands

replacebone (original bone) (replacement bone)

  • Causes a bone to be used in place of the original bone in the reference model. This can be useful for collapsing all of the bones in the hand together. Instead of using the ‘finger’ bone, the finger could just be tied to the ‘hand’ bone.

bonetreecollapse (bone name)

  • Causes all child bones of the specified bone to use the specified bone instead of whatever they currently are attached to. It’s a simpler way to use replacebone in the case where you want to collapse a large number of bones; hands especially can use this feature.

replacemodel (model name) (replacement model) [reverse]

  • Causes the source model to be replaced with a different model. If reverse is specified, the normals of the replacement model are reversed. If the replacement model name is ‘blank’, then the source model is not rendered at all. This is used to replace the model with lower polygon-count versions.

removemodel (model name)

  • Causes the model to not be rendered at this LOD.

replacematerial (original material name) (replacement material name)

  • Replaces all instances of a particular material on a model with a different material. This can be used to remove expensive shaders like Normal Maps or the eye shader.

removemesh (material name)

  • Removes all the triangles attached to the named material from this LOD.

nofacial

  • Causes facial animation to be deactivated for this LOD.

$model options

eyeball (name) (bone name) (X) (Y) (Z) (material name) (diameter) (angle) (iris material) (pupil scale)

  • (name) Name of eyeball, used to match eyelid rules. (bone name) Name of bone that the eye is parented to, typically the head. (X) (Y) (Z) World location of the center of the ball of the eye. (material name) Material name to use when searching for vertices to consider as the "white" of the eye (used in dynamically texture mapping the iris and cornea onto the eye). (diameter) Diameter of the ball of the eye (angle) Default yaw offset from "forward" for iris. Humans are typically 2-4 degrees walleyed. Not setting this correctly will result in your either characters appearing cross-eyed, or if you’ve compensated by misplacing the ball of the eye, them not tracking side to side. (iris material)Material to use as the iris texture. (pupil scale)World scale of the iris texture

eyelid (name) (expression file) lowerer/neutral/raiser (frame) (height) split (distance) eyeball (name)

  • (name) Base name of the eyelid flexcontroller. This is combined with the "lowerer", "neutral", and "rasier" options to build the piecewise blend positions of the eyelid. (expression file) The name of the file to find the morph targets. lowerer/neutral/raiser (frame) (height) One of the three options, the frame number in the (expression file) that it can be found, and the distance above or below the center of the pupil that polygon edge of the eyelid crosses the white of the eye. split (distance) Where to start, on the opposite side of the "0" line, for finding vertices that belong to this eyelid morph target. eyeball (name) Name of the eyeball that will drive this eyelid’s flexcontroller.
  • flex (name) [(expression file)]
  • frame (frame) position split (distance)
  • defaultflex
  • flexfile (expression file)
  • localvar (name) [(name) …]
  • mouth (flexcontroller name) (bone name)
  • spherenormals (material name) (X) (Y) (Z)

$animation options

fixuploop (pre loop frames) (post loop frames)

  • This finds the difference between the last frame and the first frame in the animation and blends the difference across the boundary. The range from some negative value (number of frames back from the last frame) to 0, and ranges from 0 to some positive number of frames after the first frame.

This is useful when building a looping animation out of a portion of a non-looping animation, or even cleaning up a animation that is supposed to loop but has a slight hitch.

alignto (goal animation)

  • This will shift the current animation so that the root position of the first (local) frame matches the root position (X and Y axis only) of the first (local) frame of another animation. This is useful when animations don't start on the origin, or when you're cutting out just a small piece of a longer source animation and you need a quick way to get it aligned to a shared origin.

align (reference animation) [X Y Z XR YR ZR] (reference frame) (to match frame)

  • This is similar to alignto, except that you can specify how the two animations are to match, and that the (to match frame) on the animation is aligned with the (reference frame) of the (reference animation). This is useful when aligning animations with vertical motion.

alignboneto (bone name) (goal animation)

  • Same as alignto, but will match the specified bone instead of the root.

startloop (local frame)

  • This resets the starting frame of a looping animation. This is useful when creating sequences that have multiple animations and the animations need to all run together in phase, but the source animations don't all quite match.

All animations default to a weightlist that assumes all bones have a weight of 1.0. QC specified weightlists

      $weightlist no_hands "Bip01" 1.0 "Bip01 L Hand" 0.0 "Bip01 R Hand" 0.0
      $weightlist head_n_arms "Bip01 Spine 2" 1.0

Only the bones with a weight > 0 will have any influence over the animation.

fudgeloop

  • Looping animations, at least ones with movement, need the first and last frames to match position (ideally) as well as have movement. The reason for this is that studiomdl needs to tell the engine exactly how far to move the model between the "last" unique keyframe and the "first" keyframe when calculating those last tween frames. Since this last little 1/30th or 1/10th of a second distance is probably not exactly the same distance as the previous keyframe nor is probably exactly the same distance as the average per-frame movement, skipping the definition of the overlap can cause a hitch or foot slide during playback if studiomdl guesses wrong.

If for some serious reason the animator can't create the last frame overlap, then this option tells studiomdl to assume the movement is the average per-frame motion seen so far in the animation, and that it needs to create the overlapping frame itself.

weightlist (weightlist name)

  • This copies a predefined list of bone weights to the current animation. You can do this any number of times per animation, which can be useful since subsequent options subtract, match, and fixuploop options only operate on bones with weights > 0. The last specified weightlist option is the one the animation system uses when doing blending. Sequences that use multiple animations need to have all their source animations use the same weightlist or the results are undefined.

subtract (animation) (frame #)

  • This subtracts the specified frame of the specified animation from all the frames of the current animation and creates an animation that is the differences between the two, effectively converting the animation to just be the changes from a reference frame of another animation.

This also creates something that can be used as a "delta" animation. The easiest way to think of these are that they’re just fancy bonecontrollers, but ones that have multiple bones and can be a time sequence animation. The resulting animations by themselves are meaningless and are only valid when played on top of other animations.

presubtract (animation)

  • This subtracts all the frames of the current animation from the first frame of the specified animation and creates an animation that is the differences between the two.

match (animation)

  • Makes the first frame of the animation match the first frame of the specified animation, and then applies the difference between the two frames to all subsequence frames. This is mainly used to correct animations that are supposed to start at a common pose but don’t for some uncontrollable reason.

walkframe (frame) [LX LY LZ LXR LYZ LZR]

  • You can set up to 16 of these per animation to specify linear piecewise movement. Matches root bone from the previous walkframe command – defaults to frame 0 – to the specified frame of each segment, extracting linear motion between each.

walkalignto (frame) (reference animation) [LX LY LZ LXR LYR LZR]

  • Like walkframe, but at extracts motion such that at (frame), the model is aligned to the specified (reference animation). This is useful when trying to extract the motion inside a animation that’s used to transition between two existing animations.

walkalign (frame) (reference animation) [LX LY LZ LXR LYR LZR] (reference frame) (to match frame)

  • Like walkalignto, but motion is calculated such that the (to match frame) matches the (reference frame) of the (reference animation). This is useful when the last frame being used to extract motion over doesn’t quite match a goal animation, but a subsequent frame does.

rotateto (angle)

  • Finds the current direction of movement (uses the first movement if there are multiple pieces), then rotates the animation so that the resulting movement is in the specified direction.

noanimation

  • Makes the animation additive, removes all the animation, zero’s out the weight list and sets a flag so that at run time the engine will skip all processing of the if it’s the only thing contributing to the sequence. This is handy for blended sequences where the "zero" position should have no effect on the model.

derivative (scale)

  • Turns the animation into the derivative of itself by simply subtracting the previous frame from each frame in the animation. The derivative can be automatically scaled to compensate for any fps issues.

lineardelta

  • Turns the animation into a delta animation, by subtracting a linear blend of the first and last frames from each frame of the animation.

splinedelta

  • Turns the animation into a delta animation, by subtracting a spline (s-curve) blend of the first and last frames from each frame of the animation.

compress (skip)

  • Turns a animation into a lower fps version of itself by only using every Nth frame. Automatically converts specified fps values into new equivalent.

numframes (frames)

  • Forces an animation to be a specified number of frames, either by clipping the animation or by duplicating the last frame until it has been padded with enough.

IK options

$ikchain (name) (end bone) [height (units)] [pad (units)][floor (units)]

  • Declares a named set of bones that are used to form an IK chain. Chains are specified by naming the bone farthest down in the chain, the next two bones are automatically found by walking the hierarchy.

Ikchains are used exclusively with ikrule and iklock animationoptions. Depending in the specific rule used, the end bone is moved into the needed position, the top most bone is assumed fixed in place, and the position of the middle bone is moved so that that the distance from the end-to-middle and middle-to-top bones remain constant. An example would be a IK chain of the ankle-knee-hip chain, where the ankle is adjusted to hit to relative to the ground, the hip is locked in place, and the knee is bend such that the leg remains its original length.

iklock (chain) (lock position) (maintain local rotation)

  • For this sequence, keep track of the position/orientation of the specific chain before the sequence is applied, then after it’s applied, do a local IK rule to move it back into position/orientation. The weights are floating point values form 0.0 to 1.0.

This is used to keep the specified IK chains from moving during this sequence, which can be useful when applying pelvis or body motion to a model but you want the hands or feet to remain in place.

Note:The value for the rotation lock is somewhat backwards from the position. To lock both of them, set it to "1 0", to let both of them freely move, set it to "0 1" (which is pointless, just don’t do the iklock in this case, but you get the idea).

ikrule (chain) touch (bone) [options...]

  • Adds an IK rule where a bone needs to be needs to be positioned relative to another part of the body. This is useful when the hand needs to touch some other part of the model, such as the face, hip, other hand, etc., and that other body part may be not in the original animated location due to additional animation layers, bone controllers, or other IK rules.

Specify a bone of "" to get the chain to move relative to the models origin instead of an animated bone.

ikrule (chain) footstep (slot #) [options...]

  • Adds an IK rule where a subsequent body part – such as a foot – needs to be moved relative to the ground.

Ikrule options

range (start) (peak) (tail) (end)

  • Sets the fade-in, hold, and fade-out frame numbers for the ikrule.

height (units)

  • Used by footstep rules, specifies how high to start the search above the desired ground height.

floor (units)

  • Used by footstep rules, specifies where the actual ground is ground height.

pad (radius)

  • Used by footstep rules, specifies how big the ground contact check should be.

contact (frame)

  • Used by footstep rules, specifies what frame use use when checking for ground position.

radius (units)

  • Used by attachment rules, specifies how out to search.

usesource

  • Use the original animation source to determine the IK goals. This is use useful if the current sequence is a composite that is different from the source animation and you want to get the movement back to its original form.

usesequence

  • Run all the sequence rules, including blendlayer and addlayer rules to determine the IK goals.

$sequence options

activity (activity_name) (weight)

  • This command binds the sequence to an activity name. An activity name is an alias for one or more sequences that the code can use.

The advantage to using activities is that the modeler can bind multiple sequences to one activity name, thus getting some variation in the animations the model plays without programmer intervention. For example, the modeler could create three idle animations and bind them all to ACT_IDLE. The programmer only has to write code saying to play ACT_IDLE, and one of the three idle sequences will be chosen.

The second parameter, activity_name, must be an activity in the programmer's activity tables (in ai_activity.cpp and activitylist.cpp).

The third parameter, weight, controls how often this sequence will be chosen versus other sequences bound to the same activity name. Sequences with higher weights will be chosen more often. For example, if you had a sequence called "idle1" with a weight of 1 and a sequence called "idle2" with a weight of 2, then "idle2" would have twice the chance of being played when the model is told to play ACT_IDLE.

If you only have one sequence for an activity, you can set the weight to -1 for a slight preformance boost.

autoplay

  • The sequence is automatically added at the end of the bone setup during playback, after all other sequences have been composited together. These sequences are usually "delta" sequences, but they don’t have to be. If the model has multiple autoplay sequences, they’re added in the order they appear in the QC file.

The easiest way to think of these are that they’re just fancy bonecontrollers, but ones that have multiple bones. Autoplay sequences are only played at a cycle/frame index of 0.

addlayer (sequence)

  • Automatically composites another sequence on top of the current sequence, before it’s composited on top of the current bone setup. The cycle index of this new sequence is the same as the current sequence.

blendlayer (sequence) (start) (peak) (tail) (end) [spline] [xfade]

  • Similar to addlayer, but the layer is only composited over the specified frames. The "spline" option coverts the linear fade in (start to peak) and fade out (tail to end) to a spline curve.

delta

  • The compliment to the "subtract" command, this tells the animation compositing system to "add" this sequence on top of the current bone setup instead of overriding each bones’ animation based on the typical cross-fade weighting scheme.

predelta

  • The compliment to the "presubtract" command, this tells the animation compositing system to add the current bone setup on top of a different frame of reference instead of overriding each bones’ animation based on the typical cross-fade weighting scheme.

snap

  • Remove all blending when transitioning to this animation. This is useful for reaction animations that are the result of sudden and violent changes in the models state such as flinching for creatures or shooting for weapons.

realtime

  • Ignore the cycle clock, play the sequence off of the real-time system clock. Useful when adding layers that need to not be cycle locked to their parent sequence.

fadein (time)

  • Override default 0.2 second blend with specified time when transitioning to this animation.

fadeout (time)

  • Override default 0.2 second blend with specified time when transitioning from this animation.

blendwidth (width)

  • Instead of just 1x1, 2x1, 3x1, 2x2, and 3x3 blends, by blending width, you can now have any size rectangular blends such as 7x1, 3x4, 2x9, etc.

blend (name) (min) (max)

  • You can have up to 8 unique parameters.

node (name)

  • Tags the sequence as belonging to a point on the sequence transition graph table. This is for animations which don’t change graph state, such as looping animations. Multiple sequences can be at the same entry in the graph table, at which point they won’t need transition animations be move between each other. Alternatively, you can have them at different points and expressly skip transitions (see $skiptransition). Sequences with no declaration are assumed at the root node and the transition graph assumes any sequence can move from the root node or to the root node without a intermediate transition.

transition (from) (to)

  • This specifies that the animation enters from one point on the node graph and exits at another point. This is used to play transitional sequences such as walk_to_stand, run_to_crouch, etc.

rtransition (name1) (name2)

  • Same as transition, but flags the sequence as able to be run in reverse order. This was used by the tentacle in HL1 but I don’t recommend it be used expect in special cases.

exitphase (phase)

  • When transitioning between looping animations, such as "stand_to_run", this tells the movement system where to start the next sequence, assuming it’s looping. It’s also assumed that you’ve made all the sequences that share the next node to be phase matched (see startloop).

$skiptransition (name1) (name2) [(name3) ...]

  • This adds a rule to the transition graph to allow direct movement between all the named nodes. This is useful for transitions between unique named nodes that that may not require any specific intermediate animation. This is how to avoid the transition graph from forcing "walk" to "run" to instead be a "walk" to "stand" to "run" transition.

keyvalues { [stuff] }

  • Add a keyvalue block (see $keyvalues) to a specific sequence.

Macro commands

$definemacro (macroname) [named parameters ...]

  • Defines a named macro that can be use as a short hand way to specify other QC commands. The macro creates a block a named block of text, that when referred to will virtually insert that text into the QC file, along with replacing the named parameters with the specified values.

Example:

      $definemacro makeidlenoise idleNoiseName fileName \\
      $sequence $idleNoiseName$ {\\
           $fileName$ \\
           subtract $idleNoiseName$ 0 \\
           iklock lfoot 1 0 iklock rfoot 1 0 \\
           delta \\
           hidden \\
           realtime \\
      }

      $makeidlenoise idleNoise03 "Idle03"
      $makeidlenoise idleNoise04 "Idle04_v32"

$collisionmodel options

$maxconvexpieces (New with Source 2007)
Manually set the maximum number of collision model pieces to allow costly collisions. This replaces -fullcollide from previous studiomdl builds.
$mass
Manually set the mass of the model.
$automass
Tell the physics system to compute a mass for the model, based on it's surfaceprops & volume.
$inertia
Inertia scale.
$damping
Linear damping scale.
$rotdamping
Rotational damping scale.
$drag
Scales the air resistance.
$concave
The vphysics collision model is not a single convex hull. If not set, it'll make a single convex hull out of whatever geometry you give it.
$masscenter
Override the center of mass, in local coordinates.
$jointskip
Rarely used. Eliminates a joint in the collision model that you don't want to use. (i.e. if you were using a render model as a ragdoll, and it has bones you don't want).
$jointmerge
Merges the vertex assignments for two joints.
$rootbone
The parent-most bone that actually has collision geometry.
$jointconstrain
The limits of the joint's movement.
$jointinertia
Like $inertia, but per-bone.
$jointdamping
Like $damping, but per-bone.
$jointrotdamping
Like $rotdamping, but per-bone.
$jointmassbias
Mass is automatically distributed by volume, this lets you bias it per-bone.
$noselfcollisions
Turns off all collisions between bones in this model, usually for performance.
$jointcollide
If any $jointcollide pairs are specified, only those joints collide with each other.
$animatedfriction
Used to animate the amount of friction on joints over time.

See also