First of all, you will need BLENDER, VTFEDIT and Crowbar to make this work, tools are always required.


next, you will need to add a mesh, a UV SPHERE and position it where the eyes of your model are located, do this for both eyes, just shift + D to duplicate the mesh and move it to the other side.
(not necesary but you can rotate the uv sphere in the X Axis at 90 degrees so the main vértice is facing you, so it looks like an eye)



those are the position of your eyes, now what you need to do is select one of the 2 eyes, press N
and this will open a tab showing you the coordinates of the eye (do this for both eyes)
you are going to need those numbers for the QC file LATER!




you can already see how the uv spheres are working like they were qc eyes.
next select your model and enter EDIT MODE


add 2 new materials for the eyes
eyeball_r and eyeball_l (the names can be different if you want, but keep the same name for the qc file too if you change the names) one for the right eye and one for the left one



Select the EYE mesh or faces on your model, where the eyes of your model are located basically and assign a new material to both eyes (the materials you just created, one for each eye)

on some occasions you are going to need to edit the UV maps of the eyes of your model to FIT the texture of the eyeball, because it might look weird, and it won't show the complete texture for the eyeball


export the smd file on your qc folder and we go from there.
on to the next step!

Open your qc file, you are gonna need this code for the eyes to work


where it says "BONE_HEAD" insert the name of the bone that your models has for the HEAD
and all of those numbers you see there are the coordinates of your EYES

now! in blender get the coordinates i have mentioned before, where the UV spheres are located
one for EACH EYE, that's why you made 2 UV spheres, both have different coordinates
so, make sure you put the coordinates for each different eye (mostly the X and Y Axis, the Z axis will remain the same for both spheres, since that's how high the eyes are located on the model)


copy those numbers and paste them where the "-2.41602 -3.77502 64.843" is located
the first number is the X AXIS, the second Y AXIS and the last one the Z AXIS
just replace the numbers that i already left in the code.

it should look like this, in both Y axis for the right and left eye should be a negative numbers

also make sure to remove the bodygroup code for the original body or head of your model
since the other code will be using the same smd file, so make sure you don't put the the smd of your model two times!
once you put it in the $model is fine.

these are some attachments you are gonna need for your model too
again insert the names of the bones of your model, don't use the ones i put here.

Both the EYES and FORWARD attachments are REQUIRED if you are gonna make an NPC with this model.

Of course you are gonna need materials for your eyes

one for your eye, and one for your pupil
for default, the size of the pupil and eye images are for both images.
make the iris a render image, only showing the iris in the middle.



make a new VMT FILE with this code adding the names of the eyeball and iris material
(you only need 1 VMT for each eye, you don't need it for the iris)

and save it.

Import and save the texture of your eyeball_l and eyeball_r.

but before saving the IRIS texture you got to do this on the VTFEDIT
scroll down and select the option "Cramp All" and save your iris texture.


this is necessary to avoid your model having weird spider eyes
if you don't do this, this is the result.


save it where it belongs (Save it two times with different names for both iris)

Well now it comes the final part, compiling your model, if you did everything corretly there shouldn't be any problems, BUT make sure that everything has the right name, on your model, in your qc file, and VFT and VMT files.

once you compile it, open your model with HLMV (ill recommend using hlmv plus plus its way better)


move your model around and if the eyes follow you, everything is working correctly
move the flexes too, make sure everything is looking good.
(if there isn't any flexes option on the hlmv don't worry, sometimes they apear later once you reaload the model)
if the eyes don't move at all or look DARK, then the coordinates could be wrong!
but then again, if you did everything correctly it SHOULD work

and you are done!

enjoy giving your models some nice posing eyes (it works with the eye poser tool)
if there is any problems just let me know in the comments!

thanks, and have fun.