Logs

Chaque ressource écrit ses logs via ai-core. Votre ressource nomme un canal (purchases, robberies) et écrit un message ; ai-core décide où il va. Le propriétaire du serveur active les fournisseurs dans le panneau d’administration (console, Discord, Fivemanage, FiveM Stats), fixe le niveau minimum, et colle les urls de webhook Discord par ressource et par canal. Une ressource ne poste jamais elle-même vers un webhook ou un service de logs, et ne détient jamais d’url de webhook.

Passez les joueurs concernés comme source et target au lieu d’écrire leurs noms dans le message : ai-core ajoute le nom, le personnage, le citizen id et les identifiants de chaque joueur (l’IP seulement quand le panneau l’autorise).

LogCopy Anchor Link

Envoie une entrée de log de votre ressource.

Côté : Serveur · Attend : non · Lib : aiLog(channel, message, options?) (Lua : aiLib.aiLog ; tous deux écrivent plutôt dans la console tant qu’ai-core ne tourne pas)

Log(channel: string, message: string, options?: LogOptions): void

exports['ai-core']:Log('purchases', 'Bought a car', { source = source, metadata = { price = 25000 } })

ParamètresCopy Anchor Link

LogOptionsCopy Anchor Link

Voir LogOptions et LogLevel.

RetourCopy Anchor Link

Rien. L’entrée est abandonnée sans un mot quand son niveau est sous le minimum du panneau ou que son canal est désactivé avec LogChannels.

ExempleCopy Anchor Link

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

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

onClientCallback("myscript:buyCar", { lock: true }, (source) => {
  const price = 25_000;
  if (!core.RemoveMoney(source, "bank", price, "car_purchase")) return fail("NOT_ENOUGH_MONEY");
  // ... créer et ranger la voiture
  core.Log("purchases", "Bought a car", { source, metadata: { model: "sultan", price } });
  return { ok: true };
});

LogChannelsCopy Anchor Link

Décrit les canaux de votre ressource : leur nom de dataset pour Fivemanage et FiveM Stats, et si chacun est activé. Appelez-le une fois au démarrage de votre ressource. Les canaux que vous ne décrivez jamais fonctionnent quand même avec les valeurs par défaut.

Côté : Serveur · Attend : non · Lib : aiLogChannels(channels)

LogChannels(channels: Record<string, LogChannel>): void

exports['ai-core']:LogChannels({ purchases = { dataset = 'myscript-sales' }, debug = { active = false } })

ParamètresCopy Anchor Link

LogChannelCopy Anchor Link

Voir LogChannel.

RetourCopy Anchor Link

Rien. Un second appel remplace toute la description de votre ressource. Elle est abandonnée quand votre ressource s’arrête. Une valeur qui n’est pas une table ne fait rien.

ExempleCopy Anchor Link

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

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

// Une fois au démarrage.
core.LogChannels({
  purchases: { dataset: "myscript-sales" },
  robberies: { dataset: "myscript-crime" },
  debug: { active: false },
});