Verbindungsprüfungen

Jeder verbindende Spieler passiert ein Tor in ai-core. Die eigenen Prüfungen von ai-core kommen zuerst: Der Spieler braucht einen FiveM-Account, und kein unnötiges Skript darf neben dem Skript laufen, das es ersetzt (wenn die Panel-Einstellung Refuse players while both run (Spieler abweisen, solange beide laufen) aktiv ist). Dann kommen die Prüfungen, die andere Ressourcen mit AddConnectionCheck hinzufügen, in der Reihenfolge, in der sie hinzugefügt wurden. Die erste Ablehnung gewinnt.

AddConnectionCheckCopy Anchor Link

Fügt eine Prüfung hinzu, die jeder verbindende Spieler bestehen muss. Nutze es für eine Whitelist, eine Bannliste oder einen Wartungsmodus.

Seite: Server · Wartet: nein (die Prüfung selbst muss sofort antworten) · Lib: keine

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

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

ParameterCopy Anchor Link

identifiers enthält jeden Identifier-Typ mit seinem Wert ohne das Präfix: identifiers.license ist abc123..., nicht license:abc123.... Typen, die der Spieler nicht hat, fehlen.

RückgabeCopy Anchor Link

Nichts. Ohne eine Text-id oder eine Funktion tut der Aufruf nichts. Die Prüfung wird entfernt, wenn deine Ressource stoppt.

BeispielCopy Anchor Link

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

const core = resourceExport("ai-core");
const allowed = new Set<string>(); // beim Start aus deiner Datenbank gefüllt

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

RegisterReplacementCopy Anchor Link

Erklärt, dass ein Skript andere unnötig macht (dein Skript erledigt dieselbe Aufgabe wie ihres). Solange beide installiert sind, warnt ai-core in der Konsole und nennt den zu löschenden Ordner; solange beide gestartet sind und die Panel-Einstellung Refuse players while both run aktiv ist, kann niemand beitreten.

Seite: Server · Wartet: nein · Lib: keine

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

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

ParameterCopy Anchor Link

RückgabeCopy Anchor Link

Nichts. Die Regel wird entfernt, wenn die aufrufende Ressource stoppt. ai-core prüft eine Sekunde nach jedem Start oder Stopp einer Ressource erneut auf Konflikte.

BeispielCopy Anchor Link

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

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

// Unser Bank-Skript tut, was diese tun; beide laufen zu lassen würde die Bankbildschirme verdoppeln.
core.RegisterReplacement(["qb-banking", "okokBanking"]);

GetConflictsCopy Anchor Link

Jeder jetzt gefundene Konflikt: ein Skript, das neben einem Skript installiert ist, das es ersetzt.

Seite: Server · Wartet: nein · Lib: keine

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

local conflicts = exports['ai-core']:GetConflicts() -- Liste von Tabellen

ParameterCopy Anchor Link

Keine.

RückgabeCopy Anchor Link

Eine Liste, ein Eintrag pro Konflikt:

Eine leere Liste, wenn es keinen Konflikt gibt.

BeispielCopy 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}]`);
});