Türschlösser

Tür-Aufrufe laufen über ai-core, nie über die eigenen Exports oder Events eines Türschloss-Skripts (ai-doorlock eingeschlossen). ai-core leitet jeden Aufruf an das aktive Türschloss-Skript weiter: das, das die Panel-Einstellung Door lock script (Türschloss-Skript) wählt, oder das erste, das läuft (ai-doorlock, ox_doorlock, tgiann-doorlock und die anderen aus der Kompatibilitätsliste).

Eine Tür wird über die eigene Tür-ID dieses Skripts benannt: die ID, die du in seiner Türliste siehst (ai-doorlock: die ID der Tür im Admin-Panel; ox_doorlock: ihre Datenbanknummer).

GetDoorlockSystemCopy Anchor Link

Der Ressourcenname des Türschloss-Skripts, an das ai-core weiterleitet.

Seite: Server · Wartet: nein · Lib: doors.provider()

GetDoorlockSystem(): string | null

local system = exports['ai-core']:GetDoorlockSystem() -- String oder nil

ParameterCopy Anchor Link

Keine.

RückgabeCopy Anchor Link

string | null: der Ressourcenname des Türschloss-Skripts. null, wenn keines läuft.

BeispielCopy Anchor Link

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

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

// Die Tür-IDs in deiner Config gehören zu einem Türschloss-Skript: Warne, wenn ein anderes läuft.
if (core.GetDoorlockSystem() !== "ai-doorlock")
  console.log("myscript: door ids are written for ai-doorlock");

SetDoorLockedCopy Anchor Link

Schließt eine Tür ab oder auf.

Seite: Server · Wartet: nein · Lib: doors.setLocked

SetDoorLocked(id: string, locked: boolean, by?: number): boolean

local ok = exports['ai-core']:SetDoorLocked('pacific_vault', false, source)

ParameterCopy Anchor Link

RückgabeCopy Anchor Link

boolean: true, wenn das Türschloss-Skript die Änderung angenommen hat. false, wenn kein Türschloss-Skript läuft, die Tür unbekannt ist, das Skript abgelehnt hat, id leer ist oder locked kein Boolean ist.

BeispielCopy Anchor Link

import { onClientCallback, progressFor, resourceExport, near } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";
import { Locale } from "common";

const core = resourceExport("ai-core");
const VAULT = { x: 253.9, y: 225.2, z: 101.9 };

onClientCallback("myscript:hackVault", { guards: [near(VAULT, 2)], lock: true }, async (source) => {
  if (!core.HasItem(source, "laptop")) return fail("NO_LAPTOP");
  if (!(await progressFor(source, { label: Locale("HACKING"), duration: 15000 }))) return fail("CANCELLED");
  return core.SetDoorLocked("pacific_vault", false, source) ? { ok: true } : fail("DOOR_FAILED");
});

IsDoorLockedCopy Anchor Link

Ob eine Tür abgeschlossen ist.

Seite: Server · Wartet: nein · Lib: doors.isLocked

IsDoorLocked(id: string): boolean | null

local locked = exports['ai-core']:IsDoorLocked('pacific_vault') -- true, false oder nil

ParameterCopy Anchor Link

RückgabeCopy Anchor Link

boolean | null: true abgeschlossen, false aufgeschlossen. null, wenn es unbekannt ist: Kein Türschloss-Skript läuft, die Tür existiert nicht, das Skript kann es auf dem Server nicht sagen, oder id ist leer.

BeispielCopy Anchor Link

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

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

/** Der Überfall darf nur starten, solange der Tresor noch geschlossen ist. */
export function vaultClosed(): boolean {
  return core.IsDoorLocked("pacific_vault") !== false;
}