Objets Player et Entity

Les objets renvoyés par l'API et passés aux hooks. On appelle leurs méthodes avec : (par exemple ply:Name()).

Player

Côté client, seules les méthodes de lecture existent (Name, Health, Team, GetNW……) ; LocalPlayer() donne le joueur local.

concommand.Add("rapide", function(ply)
	ply:SetWalkSpeed(10)
	ply:SetRunSpeed(20)
	ply:ChatPrint("Mode rapide !")
end)

Vue, mouvement et apparence du joueur

Lecture (partagé)

Les constantes IN_ATTACK, IN_ATTACK2, IN_JUMP, IN_DUCK, IN_FORWARD, IN_BACK, IN_MOVELEFT, IN_MOVERIGHT, IN_USE, IN_RELOAD, IN_SPEED (courir), IN_WALK (marcher lentement, Alt) et IN_SCORE (Tab) désignent des actions : elles suivent les touches choisies par le joueur dans Paramètres → Touches (contrairement aux codes KEY_*, qui sont des touches physiques). Les hooks KeyPress / KeyRelease les reçoivent.

Modification serveur

-- Double saut : un deuxième appui sur Saut en l'air relance vers le haut.
local double = {}
hook.Add("KeyPress", "double_saut", function(ply, touche)
	if not SERVER or touche ~= IN_JUMP then return end
	local id = ply:UserID()
	if ply:IsOnGround() then double[id] = false return end
	if double[id] == false then
		double[id] = true
		local v = ply:GetVelocity()
		ply:SetVelocity(Vector(v.x, 6, v.z))
	end
end)

-- Couleur d'équipe et 150 points de vie.
hook.Add("PlayerSpawn", "monmode_apparence", function(ply)
	ply:SetPlayerColor(team.GetColor(ply:Team()))
	ply:SetMaxHealth(150)
	ply:SetHealth(150)
end)

Os, feu et pilotage

Les joueurs (comme les props et les PNJ) ont les méthodes d'os et de points d'attache : ply:LookupBone, GetBonePosition, GetBoneMatrix, ManipulateBoneScale…, ply:LookupAttachment("eyes"), GetAttachment. ent:SetupBones() (ou ent:InvalidateBoneCache()) recalcule tout de suite la pose des os : GetBonePosition tient alors compte d'un ManipulateBone* fait dans la même image. Côté serveur, ply:Ignite(durée, rayon) et ply:Extinguish() l'enflamment et l'éteignent ; ply:IsOnFire() des deux côtés. Voir Os, animations et effets.

ply:IsDrivingEntity(), ply:GetDrivingEntity() et ply:GetDrivingMode() (des deux côtés) disent si le joueur pilote une entité avec drive. ply:GetPData(clé, défaut), ply:SetPData(clé, valeur) et ply:RemovePData(clé) gardent des données par joueur d'une partie à l'autre.

Déplacement : CMoveData et CUserCmd

Les objets reçus par les hooks de déplacement (côté client, pour le joueur local). Unités : mètres, m/s, degrés ; boutons : bits IN_*. Un exemple complet (jetpack) est dans Déplacement du joueur.

CUserCmd (cmd)

Les commandes du tick, reçues par StartCommand(ply, cmd), CreateMove(cmd) et SetupMove(ply, mv, cmd). Les changements faits dans StartCommand et CreateMove passent dans mv.

CMoveData (mv)

L'état du déplacement, reçu par SetupMove(ply, mv, cmd), Move(ply, mv) et FinishMove(ply, mv).

Taille et gestes du joueur

Gestes disponibles : en boucle jusqu'à ce que le joueur bouge — "dance", "talk" (parler), "sit" (assis par terre), "fix" (réparer à genoux), "torch" (brandir une torche), "push" (pousser), "sit_talk" (discuter assis), "magic" (incantation) ; joués une fois puis arrêtés tout seuls — "pickup" (ramasser), "interact", "punch", "jab" (coups de poing), "cast" (lancer un sort), "swing" (coup d'épée). Les six premiers sont ceux de la roue d'emotes. Un geste s'arrête dès que le joueur se déplace, saute, passe en noclip ou meurt ; accroupi, dans l'eau ou en l'air, le joueur garde l'animation correspondante tant que dure la situation.

-- /danse pour tout le monde, et un géant pour l'équipe 2.
concommand.Add("danse", function(ply)
	for _, p in ipairs(player.GetAll()) do
		p:PlayGesture("dance")
	end
end)

hook.Add("PlayerSpawn", "monmode_taille", function(ply)
	ply:SetModelScale(ply:Team() == 2 and 1.5 or 1)
end)

Déguisement en prop et caméra

De quoi faire un mode « Prop Hunt » : les joueurs se déguisent en props, les chasseurs doivent les trouver.

-- Clic sur E en visant un prop : on se déguise en lui.
hook.Add("PlayerButtonDown", "prophunt_deguise", function(ply, touche)
	if SERVER and touche == KEY_E and ply:Team() == 1 then
		local tr = ply:GetEyeTrace()
		if IsValid(tr.Entity) and not tr.Entity:IsPlayer() then
			local mins, maxs = tr.Entity:GetModelBounds()
			local taille = maxs - mins
			if taille.y > 2.5 then ply:ChatPrint("Trop gros !") return end
			ply:SetModel(tr.Entity)
			ply:SetNameTagVisible(false)
			ply:SetThirdPerson(true)
			ply:SetHealth(math.floor(50 + taille.x * taille.y * taille.z * 100))
		end
	end
end)

-- Tirer sur un faux prop coûte de la vie au chasseur.
hook.Add("EntityTakeDamage", "prophunt_erreur", function(ent, attaquant, degats, arme)
	if IsValid(attaquant) and attaquant:Team() == 2 then
		attaquant:TakeDamage(5, attaquant, "a tiré sur le mauvais prop")
	end
end)

-- Les morts attendent la fin de la manche en regardant un survivant.
hook.Add("PlayerCanRespawn", "prophunt_manche", function(ply) return false end)
hook.Add("PlayerDeath", "prophunt_spectateur", function(ply)
	for _, autre in ipairs(player.GetAll()) do
		if autre:Alive() then ply:Spectate(autre) break end
	end
end)

Armes

Identifiants à utiliser avec ply:Give, ply:StripWeapon, ply:HasWeapon et GM:PlayerLoadout. Les armes à feu ont un chargeur et une réserve (rechargement : R ; le fusil à pompe se recharge cartouche par cartouche, donc plus il est vide, plus c'est long) ; ply:Give remplit les deux. T inspecte l'arme en main (touche modifiable dans Paramètres → Touches). Le serveur vérifie chaque tir (cadence, munitions, visée) et applique les dégâts : tête ×2, réglage serveur pvp et hook PlayerShouldTakeDamage. Les balles poussent aussi les props non figés. En véhicule, l'arme est rangée : impossible de tirer ou de recharger, et le serveur refuse ces tirs.

-- Un mode « pistolet seulement ».
function GM:PlayerLoadout(ply)
	ply:Give("pistol")
end

hook.Add("PlayerButtonDown", "monmode_arme", function(ply, touche)
	if SERVER and touche == KEY_F2 then
		ply:ChatPrint("Arme en main : " .. ply:GetActiveWeapon())
	end
end)

Prop

Les props, gadgets et entités scriptées partagent ces méthodes (on les appelle aussi entités, ent). Les méthodes de modification n'existent que côté serveur.

Une entité scriptée lit aussi les champs de sa classe pour le bac à sable : ENT.Spawnable, ENT.AdminOnly, ENT.Category, ENT.DisableDuplicator, et les fonctions ENT:SpawnFunction, ENT:PreEntityCopy, ENT:PostEntityPaste (voir Menu de spawn et dupes).

Repères, physique et apparence

Les entités ont aussi des méthodes détaillées dans Monde et physique :

• Repères (partagé) : GetForward, GetRight, GetUp, LocalToWorld, WorldToLocal, LocalToWorldAngles, WorldToLocalAngles, OBBMins, OBBMaxs, OBBCenter, BoundingRadius.
• Physique : GetVelocity, GetAngularVelocity, GetPhysicsObject ; serveur : SetVelocity, SetAngularVelocity, ApplyForceOffset, ApplyTorque, SetGravityEnabled, SetOwner.
• Collisions et apparence : GetCollisionGroup, IsSolid, GetNoDraw, GetMaterial, GetModelScale ; serveur : SetCollisionGroup, SetNotSolid, SetNoDraw, SetMaterial, SetModelScale.
• Forme et solidité : GetSolid, GetFriction, GetElasticity, GetCustomCollisionCheck ; serveur : SetSolid, PhysicsInit, PhysicsInitBox, PhysicsInitSphere, PhysicsDestroy, SetFriction, SetElasticity, SetCustomCollisionCheck (hook ShouldCollide), CollisionRulesChanged. Voir Forme et solidité.
• Attacher : GetParent ; serveur : SetParent(ent ou ply ou nil). Chocs : ENT:PhysicsCollide(data).

-- /fusee : propulse tous tes props vers le ciel.
concommand.Add("fusee", function(ply)
	for _, prop in ipairs(ents.GetAll()) do
		local proprio = prop:GetOwner()
		if proprio and proprio:UserID() == ply:UserID() then
			prop:SetFrozen(false)
			prop:ApplyForce(Vector(0, prop:GetMass() * 15, 0))
		end
	end
end)