• Blender 2.79b[www.blender.org]
  
• Blender Source Tools 2.10.2[steamreview.org]
  
• Crowbar
  
• Notepad++[notepad-plus-plus.org]
  
• GCFScape[nemstools.github.io]

You can use Blender 2.8+ if you want but this tutorial will be for 2.79b and prior. The steps in this guide should still be similar regardless.

Download the Custom KillMove Template from here[github.com] as a zip file and extract it somewhere. Now make sure the decompiled models folder is there since we'll be using them in Step 2.

Open Blender and then go to File > Import > Source Engine
Select the target's killmove model as shown below






This should show in Blender




















Now do the same for the player's killmove model except this time make sure the bone append mode is set to "Make New Armature"










And then move the player away from the target in whatever direction you want and rotate it any angle (usually facing at the target)















If you want to import a model for display then you can do that, select the player's killmove model in object mode and go to the import menu, make sure the bone append mode is set to "Append to target"










Now select whatever SMD/DMX model you want (don't import QC since it causes issues), for this tutorial we'll be using "models/humans/group01/male_07" as the player and "models/zombie/classic" as the target














Now repeat the process for the target model, unfortunately you can't move the headcrab on the default zombie model unless you make your own km model for it (I'll make a tutorial for that later)














If you don't know how to get the model SMDs then it's easy. Locate to your GarrysMod/sourceengine/hl2_misc_dir.vpk and open it with GCFScape[nemstools.github.io] I stated the model locations above so go to those directories and extract the model by selecting ALL files with it's name. Now you can decompile the MDL file with Crowbar. Go back to Blender and now you can import the SMD you decompiled.

To animate the models in Blender, go into pose mode and rotate/move the bones. If you don't know how to animate in Blender; there's many tutorials out there that show you how to.

Alternatively you can use SFM to animate and then export the animations into Blender but that won't be explained in this tutorial, there are other tutorials online that show you how.

The custom killmove template already has some animations for the models so for this tutorial we'll be using those.













Keep in mind after the target's killmove animation, it dies and after the player's animation, they regain control. The player and target animation length can be different to eachother and that's fine.

When you're done with the animation, select the player's killmove bones and go to the Scene menu as shown below



Now scroll down to the Source Engine export section (remember you need Blender Source tools if it isn't there)

Set the export path to the directory of your player killmove model and set the export format to either SMD or DMX (SMD is recommended)
















Select export and select the animation name







Now do the same for the target model (make sure to set the export path to the target killmove models directory now)

Navigate to the player and target killmove models directory and you'll see an 'anims' folder, move the animation SMD file from that folder to the already existing one that has the model name before anims and then delete the folder with just the name 'anims'.







Now we'll have to rename the model to our own to prevent conflicts with other custom killmove addons. Change uniquename to whatever name you want.







Now do the same with the target killmove model

Open the QC file of the player and target killmove model in a text editor (Notepad++ recommended)

So before we reference the animations, we'll have to rename the model in the QC as well so do Ctrl+F and replace the template name with the name you set the QC file to












And now do the same in the target killmove model QC file












Scroll down to $sequence. Copy paste an existing one and rename the animation to your one. You can edit the properties of the sequence to change how the animation plays in game. Check out this for more info.







Now it's time to compile the models, open Crowbar, go to the Compile tab and set the QC input to the player killmove model QC file. Set the Output dropdown to "Work folder" and now browse to the models directory of the addon as shown below











You can see that the template models are there, make sure to delete them since they aren't needed
The directory is "\models\weapons" for the player killmove model
Now export the the target killmove model except this time output to the "\models" folder

Open bsmod_customkillmove.lua in a text editor (Notepad++ recommended) and follow the comments, they will guide you.

Also something to note, in the distance from target, set that number to around the distance the player is from the target in Blender. You don't need to change the angle if you're making the player look at the target, the addon automatically does that. Only set a custom angle if you're not making the player look directly at the target.

To test your custom killmove in GMod, locate the "Addon" folder and inside it is a folder called "BSMod Custom KillMove Template". Extract that to your "\steamapps\common\GarrysMod\garrysmod\addons" folder

That's the end of the tutorial, if you have any problems feel free to add me so I can help.