Sprawdzanie połączeń

Każdy łączący się gracz przechodzi przez jedną bramę w ai-core. Najpierw idą własne sprawdzenia ai-core: gracz potrzebuje konta FiveM i żaden niepotrzebny skrypt nie może działać obok skryptu, który go zastępuje (gdy w panelu włączone jest Refuse players while both run). Potem idą sprawdzenia, które inne zasoby dodają przez AddConnectionCheck, w kolejności dodania. Wygrywa pierwsza odmowa.

AddConnectionCheckCopy Anchor Link

Dodaje sprawdzenie, które musi przejść każdy łączący się gracz. Używaj tego dla whitelisty, listy banów albo trybu konserwacji.

Strona: Serwer · Czeka: nie (samo sprawdzenie musi odpowiedzieć od razu) · Lib: brak

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

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

ParametryCopy Anchor Link

identifiers trzyma każdy typ identyfikatora z jego wartością bez prefiksu: identifiers.license to abc123..., nie license:abc123.... Typów, których gracz nie ma, brakuje.

ZwracaCopy Anchor Link

Nic. Bez tekstowego id albo funkcji wywołanie nic nie robi. Sprawdzenie jest usuwane, gdy twój zasób się zatrzymuje.

PrzykładCopy Anchor Link

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

const core = resourceExport("ai-core");
const allowed = new Set<string>(); // wypełniane z twojej bazy danych przy starcie

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

RegisterReplacementCopy Anchor Link

Deklaruje, że jeden skrypt sprawia, że inne są niepotrzebne (twój skrypt wykonuje to samo zadanie co one). Dopóki oba są zainstalowane, ai-core ostrzega w konsoli i podaje folder do usunięcia; dopóki oba są uruchomione, a w panelu włączone jest Refuse players while both run, nikt nie może dołączyć.

Strona: Serwer · Czeka: nie · Lib: brak

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

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

ParametryCopy Anchor Link

ZwracaCopy Anchor Link

Nic. Reguła jest usuwana, gdy wywołujący zasób się zatrzymuje. ai-core ponownie sprawdza konflikty sekundę po starcie lub zatrzymaniu dowolnego zasobu.

PrzykładCopy Anchor Link

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

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

// Nasz skrypt bankowy robi to, co te; uruchomienie obu podwoiłoby ekrany banku.
core.RegisterReplacement(["qb-banking", "okokBanking"]);

GetConflictsCopy Anchor Link

Każdy konflikt znaleziony teraz: skrypt zainstalowany obok skryptu, który go zastępuje.

Strona: Serwer · Czeka: nie · Lib: brak

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

local conflicts = exports['ai-core']:GetConflicts() -- lista tabel

ParametryCopy Anchor Link

Brak.

ZwracaCopy Anchor Link

Lista, jeden wpis na konflikt:

Pusta lista, gdy nie ma konfliktu.

PrzykładCopy 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}]`);
});