Tutorials - Chair Throwing Gun

Introduction

In this tutorial we will create a weapon that fires chairs.

File Layout

Open your garry's mod folder.
Open the 'addons' folder.
Create a folder called 'chairlauncher'
Create a folder inside called 'lua'
Create a folder inside called 'weapons'
Create a file called 'weapon_chairgun.lua'

Your folder structure should be like this:

garrysmod/addons/chairlauncher/lua/weapons/weapon_chairgun.lua

You have created an addon called chairlauncher which contains a weapon called weapon_chairgun. Whenever you create a new weapon, most people use the weapon_ prefix, since most of the default weapons names also start with weapon_.

The Code

Add these to your weapon after you understand them.

Informational

This code is just informational. It shows up in the spawnmenu and the weapon selection menu.. so it will help people out if your weapon is complicated to use. You can also put your name in the author field so people know who made it.

SWEP.PrintName = "Chair Thrower" -- This will be shown in the spawn menu, and in the weapon selection menu SWEP.Author = "(your name)" -- These two options will be shown when you have the weapon highlighted in the weapon selection menu SWEP.Instructions = "Left mouse to fire a chair!"

Spawn Info

Defines whether players can spawn this weapon from the spawnmenu.. and whether only admins can spawn it.

SWEP.Spawnable = true SWEP.AdminOnly = true

Clip Info

Our weapon doesn't use any ammo or clips, so we just set the clip sizes to -1 and the ammo to "none".

We set primary to be automatic. This means that the player doesn't have to release the mouse button and press it again - it will continually fire.

SWEP.Primary.ClipSize = -1 SWEP.Primary.DefaultClip = -1 SWEP.Primary.Automatic = true SWEP.Primary.Ammo = "none" SWEP.Secondary.ClipSize = -1 SWEP.Secondary.DefaultClip = -1 SWEP.Secondary.Automatic = false SWEP.Secondary.Ammo = "none"

More Info

These are mostly self explanatory. The higher the weight the more likely you are to switch to it. Slot and SlotPos decide where in your weapon menu the weapon will be.

SWEP.Weight = 5 SWEP.AutoSwitchTo = false SWEP.AutoSwitchFrom = false SWEP.Slot = 1 SWEP.SlotPos = 2 SWEP.DrawAmmo = false SWEP.DrawCrosshair = true

Models

The view-model and the world-model to use.

SWEP.ViewModel = "models/weapons/v_pistol.mdl" SWEP.WorldModel = "models/weapons/w_pistol.mdl"

Precache Sounds

You can precache sounds by defining them as locals or SWEP variables using the Sound function. This prevents the sound loading when you first shoot the weapon - causing a hitch.

SWEP.ShootSound = Sound( "Metal.SawbladeStick" )

The actual chair throwing code

Commented for your learning pleasure

-- Called when the left mouse button is pressed function SWEP:PrimaryAttack() -- This weapon is 'automatic'. This function call below defines -- the rate of fire. Here we set it to shoot every 0.5 seconds. self:SetNextPrimaryFire( CurTime() + 0.5 ) -- Call 'ThrowChair' on self with this model self:ThrowChair( "models/props/cs_office/Chair_office.mdl" ) end -- Called when the rightmouse button is pressed function SWEP:SecondaryAttack() -- Though the secondary fire isn't automatic -- players shouldn't be able to fire too fast self:SetNextSecondaryFire( CurTime() + 0.1 ) self:ThrowChair( "models/props_c17/FurnitureChair001a.mdl" ) end -- A custom function we added. When you call this the player will fire a chair! function SWEP:ThrowChair( model_file ) local owner = self:GetOwner() -- Make sure the weapon is being held before trying to throw a chair if ( not owner:IsValid() ) then return end -- Play the shoot sound we precached earlier! self:EmitSound( self.ShootSound ) -- If we're the client then this is as much as we want to do. -- We play the sound above on the client due to prediction. -- ( if we didn't they would feel a ping delay during multiplayer ) if ( CLIENT ) then return end -- Create a prop_physics entity local ent = ents.Create( "prop_physics" ) -- Always make sure that created entities are actually created! if ( not ent:IsValid() ) then return end -- Set the entity's model to the passed in model ent:SetModel( model_file ) -- This is the same as owner:EyePos() + (self:GetOwner():GetAimVector() * 16) -- but the vector methods prevent duplicitous objects from being created -- which is faster and more memory efficient -- AimVector is not directly modified as it is used again later in the function local aimvec = owner:GetAimVector() local pos = aimvec * 16 -- This creates a new vector object pos:Add( owner:EyePos() ) -- This translates the local aimvector to world coordinates -- Set the position to the player's eye position plus 16 units forward. ent:SetPos( pos ) -- Set the angles to the player'e eye angles. Then spawn it. ent:SetAngles( owner:EyeAngles() ) ent:Spawn() -- Now get the physics object. Whenever we get a physics object -- we need to test to make sure its valid before using it. -- If it isn't then we'll remove the entity. local phys = ent:GetPhysicsObject() if ( not phys:IsValid() ) then ent:Remove() return end -- Now we apply the force - so the chair actually throws instead -- of just falling to the ground. You can play with this value here -- to adjust how fast we throw it. -- Now that this is the last use of the aimvector vector we created, -- we can directly modify it instead of creating another copy aimvec:Mul( 100 ) aimvec:Add( VectorRand( -10, 10 ) ) -- Add a random vector with elements [-10, 10) phys:ApplyForceCenter( aimvec ) -- Assuming we're playing in Sandbox mode we want to add this -- entity to the cleanup and undo lists. This is done like so. cleanup.Add( owner, "props", ent ) undo.Create( "Thrown_Chair" ) undo.AddEntity( ent ) undo.SetPlayer( owner ) undo.Finish() -- A lot of items can clutter the workspace. -- To fix this we add a 10 second delay to remove the chair after it was spawned. -- ent:IsValid() checks if the item still exists before removing it, eliminating errors. timer.Simple( 10, function() if ent and ent:IsValid() then ent:Remove() end end ) end

Challenges

Can you edit the new weapon to:

Use a different firing sound for left/right click
Throw a melon when you press reload? (tip: WEAPON:Reload)
Throw 3 chairs at a time