PNJ

Des personnages non joueurs qui se déplacent seuls sur la carte, voient et entendent, se battent, fuient ou se mettent à couvert. Ils ont le même mannequin que les joueurs. Le serveur calcule leur intelligence et leurs déplacements, les joueurs reçoivent leur position et leurs animations. Pour écrire toi-même leur intelligence en Lua, voir NextBot.

Dans le jeu

Les PNJ sont dans l'onglet PNJ du menu de spawn : un clic en fait apparaître un là où tu vises, tourné vers toi. Z (annuler) le retire, comme un prop, et l'outil Suppression du toolgun aussi. Le gamemode décide qui peut en faire apparaître (PlayerSpawnNPC : Sandbox autorise, Base refuse) et le serveur limite leur nombre (npc_limit, 50 par défaut, voir Serveur).

Avec Sandbox, le physgun attrape les PNJ comme les props : le PNJ reste debout, suit le faisceau, tourne avec toi et retombe quand tu le lâches (clic gauche relâché ou clic droit ; il ne se fige pas). En multijoueur, la protection des props décide qui peut attraper, toolgun (remover) et blesser les PNJ d'un autre joueur : par défaut son propriétaire et ses amis (les PNJ créés par les scripts suivent la règle « sans propriétaire »). Un gamemode peut aussi refuser avec le hook PhysgunPickup.

Toutes les armes du jeu, les armes personnalisées, les armes Lua et les explosions blessent les PNJ, avec la tête ×2 (sauf ceux d'un autre joueur que la protection des props refuse). Le réglage pvp ne les concerne pas. Tuer un PNJ donne un point (Frags) au joueur. Un PNJ mort tombe en ragdoll puis disparaît après 20 secondes.

Ce qu'ils savent faire

• Vue : champ de vision (120° par défaut) et ligne de vue (les murs et les props cachent). Une cible à moins de 8 m est remarquée même de dos ; un peu plus loin et hors du champ de vision, elle est aperçue de temps en temps.
• Ouïe : les tirs (45 m), les coups de pied-de-biche (12 m) et les explosions alertent les PNJ armés, qui vont voir ; les citoyens et les PNJ sans arme fuient.
• Combat : distance de tir selon l'arme, petits pas de côté, rafales au fusil d'assaut, rechargement, précision et dégâts réglables. Un PNJ réagit après un court délai (reaction).
• Couverture : sous un seuil de vie (cover_health), un PNJ armé cherche un endroit proche que l'ennemi ne voit pas, recharge, puis reprend le combat.
• Fuite : vers un point du navmesh à l'opposé de la menace.
• Déplacement : chemins sur le navmesh, montée des marches, saut quand quelque chose bloque, il pousse les props non figés (caisses, portes sur charnière) et garde ses distances avec les autres PNJ.

Le navmesh

Le navmesh est la carte des endroits où un PNJ peut marcher. Une map .pcmap peut l'avoir calculé dans l'éditeur (onglet Monde → Calculer le navmesh) : il est alors chargé instantanément. Sinon, il se calcule tout seul au chargement de la carte (intégrée ou .pcmap), en arrière-plan, par tuiles de 64 m, en commençant par celles qui entourent les joueurs et les points d'apparition (les PNJ proches sont prêts plus vite) : les PNJ marchent tout droit en attendant. En Lua, navmesh.IsLoaded() dit quand toute la carte est calculée. Le terrain des maps compte comme sol. Il tient compte du décor fixe, des props figés (recalculé autour d'eux deux secondes après qu'ils apparaissent, bougent ou disparaissent) et des zones interdites aux PNJ.

Dans l'éditeur de map : onglet Monde → Voir le navmesh affiche en vert le navmesh calculé, et l'entité Zone interdite aux PNJ (boîte invisible en jeu) retire une zone du navmesh. Un PNJ marche sur des pentes jusqu'à 46°, monte des marches de 45 cm et passe sous 1,8 m.

Une map .pcmap peut désactiver son navmesh (onglet Monde → Navmesh des PNJ) : rien n'est calculé et les PNJ restent sur place ; ils tournent, visent, tirent et frappent ce qui passe à portée.

Lua

La bibliothèque npc existe dans les deux réalités. Créer et modifier un PNJ, c'est sur le serveur ; les lire marche partout.

Réglages d'une classe

Tous facultatifs. Les armes sont celles du pack : "crowbar", "pistol", "shotgun", "rifle" ou "" (aucune).

Apparence en multijoueur

Le serveur décide de l'apparence d'un PNJ et tous les joueurs voient la même : nom, couleur, taille, arme, playermodel, skin et tenue. Un joueur qui rejoint la partie après l'apparition du PNJ le voit tel qu'il est à ce moment-là, changements compris. Un joueur qui n'a pas le playermodel le télécharge depuis le Workshop s'il y est publié ; en attendant, il voit le mannequin. Une classe déclarée seulement côté serveur (npc.Register dans un fichier serveur) s'affiche aussi correctement chez les joueurs, mais n'apparaît pas dans leur onglet PNJ : déclare-la dans un fichier partagé.

Méthodes d'un PNJ

Hooks

Quand un PNJ blesse un joueur, PlayerShouldTakeDamage et PlayerHurt sont appelés avec un attaquant nil ; la cause du message est « a été tué par nom du PNJ ».

-- lua/autorun/zombies.lua (partagé) : une classe de PNJ.
npc.Register("zombie", {
	name = "Zombie", category = "Monstres", faction = "hostile",
	health = 60, weapon = "crowbar", color = Color(90, 140, 70),
	walk_speed = 1.0, run_speed = 3.2, damage = 0.8, sight = 25, cover_health = 0,
})

if SERVER then
	-- Une vague de zombies toutes les 30 secondes autour du point "spawn_zombies".
	timer.Create("vagues", 30, 0, function()
		local centre = map.GetPoint("spawn_zombies")
		if not centre then return end
		for i = 1, 4 do
			local z = npc.Create("zombie", centre + Vector(math.random(-6, 6), 0.2, math.random(-6, 6)))
			if IsValid(z) then z:SetSchedule("wander") end
		end
	end)

	-- Les gardes du menu de spawn en uniforme : un playermodel de l'addon, skin 1, deuxième option du premier bodygroup.
	hook.Add("PlayerSpawnedNPC", "uniforme_gardes", function(ply, pnj)
		if pnj:GetClass() == "ally_pistol" then
			pnj:SetPlayerModel("addon:mon_addon/playermodels/garde.json", 1)
			pnj:SetBodygroup(0, 1)
		end
	end)

	-- Points pour chaque zombie abattu.
	hook.Add("OnNPCKilled", "points_zombies", function(pnj, attaquant)
		if pnj:GetClass() == "zombie" and IsValid(attaquant) and attaquant:IsPlayer() then
			attaquant:ChatPrint("Zombie abattu !")
		end
	end)
end

NextBot : une IA en Lua

Un NextBot est un PNJ dont l'intelligence est le code de sa classe, comme les NextBots de Garry's Mod. Il a le corps des PNJ (mannequin ou playermodel, collisions, dégâts, ragdoll, réseau), mais le jeu ne lui donne aucun comportement : c'est ton code qui le fait marcher, viser, attendre…

Déclarer et créer

C'est une entité scriptée (entities/<classe>.lua d'un gamemode ou lua/entities/<classe>.lua d'un addon) avec ENT.Base = "base_nextbot" (ou ENT.Type = "nextbot"). ENT.Model peut être un playermodel ("addon:<clé>/playermodels/<fichier>.json") ; sinon c'est le mannequin.

Côté serveur, ents.Create(classe) crée le corps (immobile, en attente) ; règle SetPos, SetAngles et éventuellement SetModel(playermodel), puis Spawn() appelle ENT:Initialize() et démarre ENT:RunBehaviour(). Il a toutes les méthodes d'un PNJ (GetPos, SetHealth, TakeDamage, Remove…), plus :

• GetClass() renvoie sa classe, IsNextBot() et IsNPC() renvoient true ; npc.GetAll() le liste.
• Il compte dans la limite npc_limit : au-delà, ents.Create renvoie nil (message dans la console).
• Il n'a pas de propriétaire et ne lance ni NPCSpawned ni PlayerSpawnedNPC.
• Il part avec 50 points de vie (et le t-shirt bleu du citoyen sur le mannequin) : règle sa vie dans Initialize avec self:SetMaxHealth(n) puis self:SetHealth(n).

RunBehaviour, une coroutine

ENT:RunBehaviour() tourne dans une coroutine : écris-la comme une boucle sans fin. coroutine.yield() rend la main au jeu jusqu'à l'image physique suivante ; coroutine.wait(s) attend s secondes. Une erreur dans la coroutine est affichée avec sa pile d'appels et arrête le comportement. À chaque image physique du serveur, le jeu appelle aussi ENT:BehaveUpdate(intervalle) (qui fait avancer la coroutine : ne la remplace que si tu sais ce que tu fais), ENT:BodyUpdate() et ENT:Think() (pas de NextThink pour un NextBot : elle est appelée à chaque image).

Évènements

Se déplacer : self.loco

self.loco (serveur) commande le corps. Unités : mètres, m/s, degrés.

Chemins : Path

Path("Follow") crée un chemin à suivre soi-même (c'est ce que fait MoveToPos). Côté serveur.

Le navmesh en Lua

La bibliothèque navmesh lit le navmesh de la carte. Le navmesh de PhysiCore est fait de polygones, pas des carrés de Source : une « aire » est ici un point du navmesh, avec les méthodes de Garry's Mod qui ont un sens pour un point.

-- entities/garde_lua.lua : patrouille autour de son point d'apparition, poursuit les joueurs proches.
ENT.Base = "base_nextbot"
ENT.PrintName = "Garde (Lua)"

if SERVER then
	function ENT:Initialize()
		self:SetMaxHealth(80)
		self:SetHealth(80)
		self.origine = self:GetPos()
		self.loco:SetDesiredSpeed(2)
		self.loco:SetMaxYawRate(180)
	end

	function ENT:CibleProche()
		for _, ply in ipairs(player.GetAll()) do
			if ply:Alive() and self:GetRangeTo(ply:GetPos()) < 15 then return ply end
		end
	end

	function ENT:RunBehaviour()
		while true do
			local cible = self:CibleProche()
			if cible then
				-- Poursuite : 5 m/s, chemin recalculé quand la cible bouge.
				self.loco:SetDesiredSpeed(5)
				local chemin = Path("Follow")
				chemin:SetGoalTolerance(1.5)
				while IsValid(cible) and cible:Alive() and self:GetRangeTo(cible:GetPos()) < 20 do
					chemin:Chase(self, cible)
					coroutine.yield()
				end
				self.loco:SetDesiredSpeed(2)
			else
				-- Patrouille : un point au hasard à moins de 10 m de l'origine.
				local aire = navmesh.GetNearestNavArea(self.origine + Vector(math.random(-10, 10), 0, math.random(-10, 10)))
				if aire then self:MoveToPos(aire:GetCenter(), { tolerance = 1, maxage = 10 }) end
				coroutine.wait(2)
			end
		end
	end

	function ENT:OnInjured(dmg)
		local attaquant = dmg:GetAttacker()
		if IsValid(attaquant) and attaquant:IsPlayer() then attaquant:ChatPrint("Le garde t'a repéré !") end
	end
end

-- Ailleurs, côté serveur, quand le navmesh est prêt :
-- if navmesh.IsLoaded() then
-- 	local bot = ents.Create("garde_lua")
-- 	if IsValid(bot) then bot:SetPos(Vector(0, 0.2, 5)) bot:Spawn() end
-- end

Limites

• Le navmesh est fait de polygones : pas d'attributs (accroupi, saut, eau…), pas de vrais carrés ni d'échelles ; GetAllNavAreas ne couvre que les environs des joueurs.
• Un NextBot ne fait que ce que son code demande : il ne voit pas, n'entend pas et n'a pas d'arme par lui-même (Disposition, GetEnemy… des PNJ du jeu ne lui servent pas).
• Tant que le navmesh n'est pas prêt autour de lui, MoveToPos renvoie "failed" : attends navmesh.IsLoaded() ou réessaie.