<cat>Dev.GameModes</cat> ⤶ ⤶ # Scripted Weapons <image src="HandsExample.jpg"/>⤶ ⤶ # Scripted Weapons To make your SWEP use the viewmodel hands, add this code: ``` SWEP.UseHands = true ``` Note that your SWEP must also use a C model for its viewmodel: ``` SWEP.ViewModel = "models/weapons/c_smg1.mdl" ``` # Custom Gamemodes If you want to use the Viewmodel Hands system in your gamemode, you must put some code into your gamemode. ## Without Player Classes Serverside: ( This MUST go into a GM:PlayerSpawn function, paste it to the end ) ``` function GM:PlayerSpawn( ply ) -- Your code ply:SetupHands() -- Create the hands and call GM:PlayerSetHandsModel end -- Choose the model for hands according to their player model. function GM:PlayerSetHandsModel( ply, ent ) local simplemodel = player_manager.TranslateToPlayerModelName( ply:GetModel() ) local info = player_manager.TranslatePlayerHands( simplemodel ) if ( info ) then ent:SetModel( info.model ) ent:SetSkin( info.skin ) ent:SetBodyGroups( info.body ) end end ``` ## Using Player Classes Serverside: ( Again, must be put into GM:PlayerSpawn after you set players class ) ``` function GM:PlayerSpawn( ply ) -- Set your player class ply:SetupHands() -- Create the hands and call GM:PlayerSetHandsModel end ``` By default GM:PlayerSetHandsModel calls GetHandsModel of players current player class. ## Clientside code If you haven't overridden GM:PostDrawViewModel, this step is optional. This code makes the hands draw. It must be clientside. ``` function GM:PostDrawViewModel( vm, ply, weapon ) if ( weapon.UseHands || !weapon:IsScripted() ) then local hands = LocalPlayer():GetHands() if ( IsValid( hands ) ) then hands:DrawModel() end end end ``` # Player Class If you want a specific player class to use specific hands then add this function. ``` function PLAYER:GetHandsModel() return { model = "models/weapons/c_arms_cstrike.mdl", skin = 1, body = "0100000" } end ``` # Player Models If you're adding a player model and want to add custom hands then use this code. ``` player_manager.AddValidHands( "css_arctic", "models/weapons/c_arms_cstrike.mdl", 0, "00000000" ) ``` Where 'css_arctic' is the name you used when calling player_manager.AddValidModel — the two numbers are respectively the skin and bodygroup values. If a player model doesn't have a corresponding hands entry, it will default to the civilian hands. # Model creators Here's an example c_model that shows how things need to be set up in your QC and SMD files. This is the source files of the medkit SWEP that is packed by default with Gmod. https://github.com/robotboy655/gmod-animations/raw/master/c_medkit.7z Here are the source files for the c_arms_citizen model, if you need some reference for compiling arms: https://github.com/robotboy655/gmod-animations/raw/master/c_arms_citizen.7z Here's the citizen arms on a CAT animation rig. https://github.com/robotboy655/gmod-animations/raw/master/3DS2011_CAT_c_arms_citizen.max If you need SMD files for these arms (making your own animation rigs, etc.), here they are. https://github.com/robotboy655/gmod-animations/raw/master/c_arms_citizen.smd https://github.com/robotboy655/gmod-animations/raw/master/c_arms_combine.smd The arms mesh should never be in the weapon model itself; that defeats the entire purpose of the system! Remember to include c_arms_definebones.qci from the medkit example, as otherwise StudioMDL will optimise away the arm bones that you've included and then it won't work.