Stress et besoins

Le stress, la faim et la soif vivent dans le script de HUD qui les affiche. ai-core transmet les changements au premier HUD qui tourne et tient le stress : tgiann-lumihud, tgiann-hudv2, tgiann-modern-hud, qb-hud, ps-hud, puis ai-hud. N’appelez jamais les propres événements ou exports d’un HUD (hud:server:GainStress, AddNeed d’ai-hud).

GetStressSystemCopy Anchor Link

Le nom de ressource du HUD auquel ai-core donne le stress.

Côté : Serveur · Attend : non · Lib : stress.provider()

GetStressSystem(): string | null

local system = exports['ai-core']:GetStressSystem() -- string ou nil

ParamètresCopy Anchor Link

Aucun.

RetourCopy Anchor Link

string | null : le nom de ressource du HUD. null quand aucun HUD avec stress ne tourne (les changements de stress sont alors abandonnés).

ExempleCopy Anchor Link

import { addCommand, resourceExport } from "@aicore-fivem/lib/server";

const core = resourceExport("ai-core");

addCommand("stresssystem", { help: "Shows the HUD that keeps stress", restricted: true }, () => {
  console.log(core.GetStressSystem() ?? "none: stress is dropped");
});

AddStressCopy Anchor Link

Ajoute du stress à un joueur, ou en soulage avec un montant négatif.

Côté : Serveur · Attend : non · Lib : stress.gain(source, amount) et stress.relieve(source, amount) (prennent tous deux un montant positif)

AddStress(source: number, amount: number): boolean

local ok = exports['ai-core']:AddStress(source, 5)    -- plus de stress
local ok2 = exports['ai-core']:AddStress(source, -10) -- moins de stress

ParamètresCopy Anchor Link

RetourCopy Anchor Link

boolean : true quand le changement a été transmis au HUD. false quand source ou amount est hors limites, qu’aucun HUD avec stress ne tourne, ou que le HUD a échoué. Le HUD borne le résultat à 0-100.

ExempleCopy Anchor Link

import { resourceExport } from "@aicore-fivem/lib/server";

const core = resourceExport("ai-core");

// Braquer un magasin est stressant ; fumer un joint détend.
export function robberyStarted(source: number): void {
  core.AddStress(source, 8);
}

core.RegisterUsableItem("joint", (source) => {
  core.AddStress(source, -15);
});

RefillNeedsCopy Anchor Link

Remplit complètement la faim et la soif d’un joueur via le HUD qui les tient. Utilisez-le après une réanimation ou un séjour à l’hôpital.

Côté : Serveur · Attend : non · Lib : needs.refill

RefillNeeds(source: number): boolean

local ok = exports['ai-core']:RefillNeeds(source)

ParamètresCopy Anchor Link

RetourCopy Anchor Link

boolean : true quand le remplissage a été transmis au HUD. Sans HUD qui tient les besoins, ai-core fixe lui-même les métadonnées hunger et thirst du personnage à 100 (et prévient les HUD de style QB avec hud:client:UpdateNeeds) et répond true. false quand le joueur n’a pas de personnage chargé ou que le HUD a échoué.

ExempleCopy Anchor Link

import { onClientCallback, resourceExport, near } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";

const core = resourceExport("ai-core");
const BED = { x: 317.8, y: -585.2, z: 43.3 };

// Un lit d’hôpital : réanimation, pleine santé, estomac plein.
onClientCallback("myscript:hospitalBed", { guards: [near(BED, 2)], lock: true }, (source) => {
  if (!core.RemoveMoney(source, "bank", 500, "hospital_bed")) return fail("NOT_ENOUGH_MONEY");
  if (!core.RevivePlayer(source)) core.HealPlayer(source);
  core.RefillNeeds(source);
  return { ok: true };
});