Логи

Каждый ресурс пишет логи через ai-core. Ваш ресурс называет канал (purchases, robberies) и пишет сообщение; ai-core решает, куда оно пойдёт. Владелец сервера включает провайдеров в админ-панели (консоль, Discord, Fivemanage, FiveM Stats), задаёт минимальный уровень и вставляет url вебхуков Discord для каждого ресурса и канала. Ресурс никогда сам не отправляет данные в вебхук или сервис логов и никогда не хранит url вебхука.

Передавайте участвующих игроков как source и target, а не пишите их имена в сообщение: ai-core добавляет имя каждого игрока, персонажа, citizen id и идентификаторы (IP только тогда, когда это разрешает панель).

LogCopy Anchor Link

Отправляет одну запись лога вашего ресурса.

Сторона: сервер · Ожидание: нет · Библиотека: aiLog(channel, message, options?) (Lua: aiLib.aiLog; оба выводят в консоль, пока ai-core не запущен)

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

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

ПараметрыCopy Anchor Link

LogOptionsCopy Anchor Link

См. LogOptions и LogLevel.

ВозвращаетCopy Anchor Link

Ничего. Запись молча отбрасывается, когда её уровень ниже минимального в панели или её канал выключен через LogChannels.

ПримерCopy 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");
  // ... создать и сохранить машину
  core.Log("purchases", "Bought a car", { source, metadata: { model: "sultan", price } });
  return { ok: true };
});

LogChannelsCopy Anchor Link

Описывает каналы вашего ресурса: их имя набора данных для Fivemanage и FiveM Stats и включён ли каждый. Вызовите один раз при старте ресурса. Каналы, которые вы так и не описали, всё равно работают со значениями по умолчанию.

Сторона: сервер · Ожидание: нет · Библиотека: aiLogChannels(channels)

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

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

ПараметрыCopy Anchor Link

LogChannelCopy Anchor Link

См. LogChannel.

ВозвращаетCopy Anchor Link

Ничего. Второй вызов заменяет всё описание вашего ресурса. Оно удаляется, когда ваш ресурс останавливается. Значение, которое не является таблицей, ничего не делает.

ПримерCopy Anchor Link

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

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

// Один раз при старте.
core.LogChannels({
  purchases: { dataset: "myscript-sales" },
  robberies: { dataset: "myscript-crime" },
  debug: { active: false },
});