Coding Custom Weapons Part 2 Of 3 Client Side tutorial - Half Life Modding Kit for Half-Life

Ready to do the ever so exciting client side coding? As most of you have realized Half-Life's engine (Gold Source) is very very messed up in the coding process (not buggy just hard to code in a way) well in this tutorial we will be jumping around from I think 6 different files 1 of witch you do not actually need but can do in another file but lets not bore you any longer I know you want to get some custom weapons into your mod. To be honest this part is really not that hard, I just marked it advance because if you miss 1 thing the game will not work right. First just open up your client.dsp (NOT TO BE CONFUSED WITH CLIENT.H OR CLIENT.CPP)

Now the server side does read and operate some stuff coded on client side and vice versa but for some reason the server side or client side will not pick up the weapon file if it is on one or the other, so we are going to add it. There are 2 ways we can do this, the way I recommend is you just drag the one from your server side folder to the client.dsp window you have opened, this is better because you will always have the same file in the client and server side version which is what you need. Or you can copy and paste the file into the client side folder and drag the file into you client.dsp, I would not do the second one because it will not stay updated like the first one.

Now lets get on to the coding section, first look open up hl_events.cpp, you might not see this file on your dsp but there should be what looks like a folder labeled hl in the dsp when you click it it will drop down, I think these are all the files on server side that the client side needs. You should see void EV_SnarkFire( struct event_args_s *args ); under that add

void EV_FireColt1( struct event_args_s *args );
void EV_FireColt2( struct event_args_s *args );

This is adding in the part of the fire event for when you shoot the weapon, this allows it to trigger animations. I do not think I used the EV_FireColt2 in the code but I added it just in case I did. scroll down a little more and you should see gEngfuncs.pfnHookEvent( "events/snarkfire.sc", EV_SnarkFire ); under that add

gEngfuncs.pfnHookEvent( "events/colt.sc", EV_FireColt1 );
gEngfuncs.pfnHookEvent( "events/colt2.sc", EV_FireColt2 );

This is basically a precache for your event like we did in the server side, Now open up hl_weapons.cpp and scroll down till you see CSqueak g_Snark; under that we will add

CColt g_Colt;

This is basically linking the CColt, the name we gave the weapon in the colt.cpp to the g_Colt which is what the client side will have pieces of code linked with, it is very important you rember g_Colt we will use it later, now you want to search HUD_PrepEntity( &g_Snark , &player ); because it is a couple hundred lines down, and under that we will add

HUD_PrepEntity( &g_Colt , &player );

According to the code this is Allocate slot(s) for each weapon that we are going to be predicting, basically it is getting the HUD ready for the new weapon so the HUD knows to add it. Now search WEAPON_GLOCK and under that entry add

case WEAPON_COLT:
pWeapon = &g_Colt;
break;

This just tells the code that WEAPON_COLT is also g_Colt, Now open up ev_hldm.cpp and search for EV_SnarkFire under that line of code add this

void EV_FireColt1( struct event_args_s *args );
void EV_FireColt2( struct event_args_s *args );

This is registering the fire event we made in hl_events.cpp to the ev_hldm.cpp file, now right under that you will see #define VECTOR_CONE_20DEGREES Vector( 0.17365, 0.17365, 0.17365 ) remember we made a custom Vector in the previous tutorial now we need to add it to the client side so under that add this

#define VECTOR_CONE_COLT Vector( 0.00273, 0.00273, 0.00273 )

It does have to be the same as the one in the server side, I don't know what will happen if it is not you might have bullets shooting behind you, that would be pretty cool though :) Now search for GLOCK END and under that entry add

//======================
// Colt START
//======================
void EV_FireColt1( event_args_t *args )
{
int idx;
vec3_t origin;
vec3_t angles;
vec3_t velocity;
int empty;

vec3_t ShellVelocity;
vec3_t ShellOrigin;
int shell;
vec3_t vecSrc, vecAiming;
vec3_t up, right, forward;

idx = args->entindex;
VectorCopy( args->origin, origin );
VectorCopy( args->angles, angles );
VectorCopy( args->velocity, velocity );

empty = args->bparam1;
AngleVectors( angles, forward, right, up );

shell = gEngfuncs.pEventAPI->EV_FindModelIndex ("models/shell.mdl");// brass shell

if ( EV_IsLocal( idx ) )
{
EV_MuzzleFlash();
gEngfuncs.pEventAPI->EV_WeaponAnimation( empty ? COLT_SHOOT_EMPTY : COLT_SHOOT1, 2 );

V_PunchAxis( 0, -2.0 );
}

EV_GetDefaultShellInfo( args, origin, velocity, ShellVelocity, ShellOrigin, forward, right, up, 20, -12, 4 );

EV_EjectBrass ( ShellOrigin, ShellVelocity, angles[ YAW ], shell, TE_BOUNCE_SHELL );

gEngfuncs.pEventAPI->EV_PlaySound( idx, origin, CHAN_WEAPON, "weapons/pl_gun3.wav", gEngfuncs.pfnRandomFloat(0.92, 1.0), ATTN_NORM, 0, 98 + gEngfuncs.pfnRandomLong( 0, 3 ) );

EV_GetGunPosition( args, vecSrc, origin );

VectorCopy( forward, vecAiming );

EV_HLDM_FireBullets( idx, forward, right, up, 1, vecSrc, vecAiming, 8192, BULLET_PLAYER_9MM, 0, 0, args->fparam1, args->fparam2 );
}

void EV_FireColt2( event_args_t *args )
{
int idx;
vec3_t origin;
vec3_t angles;
vec3_t velocity;

vec3_t ShellVelocity;
vec3_t ShellOrigin;
int shell;
vec3_t vecSrc, vecAiming;
vec3_t vecSpread;
vec3_t up, right, forward;

idx = args->entindex;
VectorCopy( args->origin, origin );
VectorCopy( args->angles, angles );
VectorCopy( args->velocity, velocity );

AngleVectors( angles, forward, right, up );

shell = gEngfuncs.pEventAPI->EV_FindModelIndex ("models/shell.mdl");// brass shell

if ( EV_IsLocal( idx ) )
{
// Add muzzle flash to current weapon model
EV_MuzzleFlash();
gEngfuncs.pEventAPI->EV_WeaponAnimation( COLT_SHOOT2, 2 );

V_PunchAxis( 0, -2.0 );
}

EV_GetDefaultShellInfo( args, origin, velocity, ShellVelocity, ShellOrigin, forward, right, up, 20, -12, 4 );

EV_EjectBrass ( ShellOrigin, ShellVelocity, angles[ YAW ], shell, TE_BOUNCE_SHELL );

gEngfuncs.pEventAPI->EV_PlaySound( idx, origin, CHAN_WEAPON, "weapons/pl_gun3.wav", gEngfuncs.pfnRandomFloat(0.92, 1.0), ATTN_NORM, 0, 98 + gEngfuncs.pfnRandomLong( 0, 3 ) );

EV_GetGunPosition( args, vecSrc, origin );

VectorCopy( forward, vecAiming );

EV_HLDM_FireBullets( idx, forward, right, up, 1, vecSrc, vecAiming, 8192, BULLET_PLAYER_9MM, 0, &tracerCount[idx-1], args->fparam1, args->fparam2 );

}
//======================
// Colt END
//======================

I am not going to break this piece down since it is pointless of me, I do not understand most of it and I feel it will take up to much time to do it so lets move on, But before we do remember at the start of the tutorial when I said 1 file would not actually be needed, well ev_hldm.h is not actually needed, you could add the animations which we will be adding next to the top of this code entry, a couple of Half-Life's vanilla weapons do this like the crossbow and the gauss, I do not know why though. Now open up ev_hldm.h and lets finish up, you should see animations just add the animations the same way we had them in the colt.cpp

enum colt_e {
COLT_IDLE,
COLT_SHOOT1,
COLT_SHOOT2,
COLT_RELOAD,
COLT_RELOAD_NOSHOOT,
COLT_DRAW,
COLT_SHOOT_EMPTY,
COLT_EMPTY_IDLE
};

Oops I did forget 1 thing, we made a custom ammo remember, so we need to add it in open back up hl_weapons.cpp and search ammo_9mm under that line you want to add

player.ammo_45 = (int)from->client.vuser1[3];

Now you should be all done compile it and it should work, well after you finish the first piece of the 3rd part of this tutorial for finishing the gun (not coding). I hoped this helped you if it did not work though just message me