Проверки подключения

Каждый подключающийся игрок проходит через одни ворота в ai-core. Сначала идут собственные проверки ai-core: у игрока должен быть аккаунт FiveM, и рядом со скриптом, который его заменяет, не должен работать ненужный скрипт (когда в панели включено Refuse players while both run). Затем идут проверки, которые другие ресурсы добавляют через AddConnectionCheck, в порядке добавления. Побеждает первый отказ.

AddConnectionCheckCopy Anchor Link

Добавляет проверку, которую должен пройти каждый подключающийся игрок. Используйте для вайтлиста, бан-листа или режима техобслуживания.

Сторона: сервер · Ожидание: нет (сама проверка должна ответить сразу) · Библиотека: нет

AddConnectionCheck(
  id: string,
  check: (source: number, identifiers: Record<string, string>) => string | null | undefined,
): void

exports['ai-core']:AddConnectionCheck('myscript:whitelist', function(source, identifiers) end)

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

identifiers содержит каждый тип идентификатора со значением без префикса: identifiers.license - это abc123..., а не license:abc123.... Типов, которых у игрока нет, в нём нет.

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

Ничего. Без текстового id или функции вызов ничего не делает. Проверка удаляется, когда ваш ресурс останавливается.

ПримерCopy Anchor Link

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

const core = resourceExport("ai-core");
const allowed = new Set<string>(); // заполняется из вашей базы данных при старте

core.AddConnectionCheck("myscript:whitelist", (_source, identifiers) => {
  const fivem = identifiers.fivem;
  return fivem && allowed.has(fivem) ? null : Locale("CONNECT_NOT_WHITELISTED");
});

RegisterReplacementCopy Anchor Link

Объявляет, что один скрипт делает другие ненужными (ваш скрипт выполняет ту же работу, что и они). Пока установлены оба, ai-core предупреждает в консоли и называет папку, которую нужно удалить; пока оба запущены и в панели включено Refuse players while both run, никто не может зайти.

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

RegisterReplacement(remove: string | string[], keep?: string): void

exports['ai-core']:RegisterReplacement({ 'qb-banking', 'okokBanking' })

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

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

Ничего. Правило удаляется, когда вызывающий ресурс останавливается. ai-core снова проверяет конфликты через секунду после старта или остановки любого ресурса.

ПримерCopy Anchor Link

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

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

// Наш банковский скрипт делает то же, что и эти; запуск обоих удвоил бы экраны банка.
core.RegisterReplacement(["qb-banking", "okokBanking"]);

GetConflictsCopy Anchor Link

Все найденные сейчас конфликты: скрипт, установленный рядом со скриптом, который его заменяет.

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

GetConflicts(): { keep: string; remove: string; running: boolean; from: string }[]

local conflicts = exports['ai-core']:GetConflicts() -- список таблиц

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

Нет.

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

Список, по записи на каждый конфликт:

Пустой список, когда конфликтов нет.

ПримерCopy Anchor Link

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

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

addCommand("conflicts", { help: "Lists scripts to remove", restricted: true }, () => {
  for (const c of core.GetConflicts())
    console.log(`${c.keep} replaces ${c.remove}${c.running ? " (both started!)" : ""} [${c.from}]`);
});