HLMV create hitboxes: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
m (removed break tags)
(Redirected page to Model Viewer#Usage)
Tag: New redirect
Line 1: Line 1:
If you are starting from scratch, you can use HLMV to create a base set of hitboxes, and then modify them to fit your models needs.  This page will take you step by step through the process.  {{warning|you will need a model that compiles properly and has a least 1 bone that the geometry is skinned to.}}
#REDIRECT[[Model Viewer#Usage]]
 
== Auto Generating hitboxes ==
The first thing we'll do is get HLMV to create a set of hitboxes for us.  When it does this it will create a hitbox for every bone that has geometry skinned to it, and will fit the hitbox around that geometry.
 
#Open HLMV and load your model.  From the Render tab press <code>CTRL+H</code> or select the <code>Hit Boxes</code> checkbox to view the hitboxes {{clr}} [[Image:Hlmv_hitboxes_01.jpg]]
#Select the <code>Bones</code> tab. If you did not create hitboxes in your <code>.qc/.qci</code> file(s) then the <code>Auto-Generate Hitboxes</code> checkbox should be ON.  If you have specified some hitboxes, turning on the auto-generation will do nothing. {{clr}} [[Image:Hlmv_hitboxes_02.jpg]]
#With the auto-generated hitboxes visible, click <code>Generate QC</code> button.  This will copy the .qc commands needed to create the auto-generated hitboxes into your clipboard. {{clr}} [[Image:Hlmv_hitboxes_03.jpg]]
#Open your model's <code>.qc</code> or create a new <code>hitbox.qci</code> file with your favorite text editor. <code>CTRL+V</code> to paste the autogenerated .qc lines into the file, save it, and recompile your model.  It's a good idea to format the pasted commands into something more legible, especially if you plan on modifying the hitboxes.  It should look something like this:
<syntaxhighlight lang="cpp">
// .qc block generated by HLMV begins.
$surfaceprop "default"
$hboxset "default"
$hbox 0 "head"   -14.83  -11.24  -23.58    32.59  11.24    9.46 "head"
$hbox 0 "spine1"   -33.32  -20.38  -40.78    33.32  20.38  40.78 "spine1"
// .qc block generated by HLMV ends.
</syntaxhighlight>
 
== Creating new hitboxes and hitbox sets==
The easiest way to create new hitboxes or hitbox sets is to simply cut/copy & paste the lines in the .qc that refer to a hitbox on the bone you'd like to add the hitbox to.
 
<p>You can create a new hitbox set by adding <code>$hboxset "your_set_name_here"</code> and then cut/copy & pasting the .qc commands for an existing hitbox below.</p>
 
<p>Once you've finished adding the all the hitboxes and sets you need, save the file and recompile the model.
 
== Modifying your hitboxes with HLMV ==
Once you have all of your hitboxes and sets added, it's much faster to use HLMV to edit the scale and position of them.  You can do it directly in the .qc file, but it will require recompiling the model many times to review your changes and thus is a much more inefficient way of accomplishing the same thing.
 
#Open your model in HLMV, turn the hitboxes on, flip over to the <code>Bones</code> tab {{clr}} [[Image:Hlmv_hitboxes_04.jpg]]
#Select the set that contains the hitbox you would like to edit, and then the joint it is attached to.  You'll see the boxes describing the hitboxes' position and size fill out.  {{note|While this info represents what is defined in the .qc, it is presented differently.  The .qc script defines the 2 opposite corners of the hitbox in relation to the bones pivot.  HLMV converts that info into a more user friendly <code>size</code> and <code>origin</code>, or offset if you will, in relation to the bone's pivot.}} <br>[[Image:Hlmv_hitboxes_05.jpg]]
#Edit the <code>Origin</code> and <code>Size</code> blocks and press the <code>Update Hitbox</code> button to see your changes. <br>[[Image:Hlmv_hitboxes_06.jpg]]
#Repeat until all of the hitboxes in all of your sets are looking good.
#Click <code>Generate QC</code> to copy these new settings into your clipboard again and then replace your old hitbox info with it. Recompile your model. High-five someone.


== See also ==
== See also ==

Revision as of 04:27, 9 July 2023

Redirect to:

See also

Retrieved from "https://developer.valvesoftware.com/w/index.php?title=HLMV_create_hitboxes&oldid=327393"