Logs

Cada recurso registra sus logs a través de ai-core. Tu recurso nombra un canal (purchases, robberies) y escribe un mensaje; ai-core decide adónde va. El dueño del servidor activa los proveedores en el panel de administración (consola, Discord, Fivemanage, FiveM Stats), fija el nivel mínimo y pega las urls de webhook de Discord por recurso y canal. Un recurso nunca publica en un webhook ni en un servicio de logs por sí mismo, y nunca guarda una url de webhook.

Pasa los jugadores implicados como source y target en lugar de escribir sus nombres en el mensaje: ai-core añade el nombre, el personaje, el citizen id y los identificadores de cada jugador (la IP solo cuando el panel lo permite).

LogCopy Anchor Link

Envía una entrada de log de tu recurso.

Lado: Servidor · Espera: no · Lib: aiLog(channel, message, options?) (Lua: aiLib.aiLog; ambos imprimen en la consola mientras ai-core no está en marcha)

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

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

ParámetrosCopy Anchor Link

LogOptionsCopy Anchor Link

Consulta LogOptions y LogLevel.

DevuelveCopy Anchor Link

Nada. La entrada se descarta sin aviso cuando su nivel está por debajo del mínimo del panel o su canal está desactivado con LogChannels.

EjemploCopy 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");
  // ... crea y guarda el coche
  core.Log("purchases", "Bought a car", { source, metadata: { model: "sultan", price } });
  return { ok: true };
});

LogChannelsCopy Anchor Link

Describe los canales de tu recurso: su nombre de dataset para Fivemanage y FiveM Stats, y si cada uno está activado. Llámalo una vez cuando se inicie tu recurso. Los canales que nunca describes siguen funcionando con los valores por defecto.

Lado: Servidor · Espera: no · Lib: aiLogChannels(channels)

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

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

ParámetrosCopy Anchor Link

LogChannelCopy Anchor Link

Consulta LogChannel.

DevuelveCopy Anchor Link

Nada. Una segunda llamada reemplaza la descripción completa de tu recurso. Se elimina cuando tu recurso se detiene. Un valor que no es una tabla no hace nada.

EjemploCopy Anchor Link

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

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

// Una vez al iniciar.
core.LogChannels({
  purchases: { dataset: "myscript-sales" },
  robberies: { dataset: "myscript-crime" },
  debug: { active: false },
});