Serrures de portes

Les appels de portes passent par ai-core, jamais par les exports ou événements propres à un script de serrures (ai-doorlock compris). ai-core transmet chaque appel au script de serrures actif : celui que choisit le réglage Door lock script du panneau, ou le premier qui tourne (ai-doorlock, ox_doorlock, tgiann-doorlock et les autres de la liste de compatibilité).

Une porte est désignée par l’id de porte propre à ce script : l’id que vous voyez dans sa liste de portes (ai-doorlock : l’id de la porte dans le panneau d’administration ; ox_doorlock : son numéro en base de données).

GetDoorlockSystemCopy Anchor Link

Le nom de ressource du script de serrures auquel ai-core transmet.

Côté : Serveur · Attend : non · Lib : doors.provider()

GetDoorlockSystem(): string | null

local system = exports['ai-core']:GetDoorlockSystem() -- string ou nil

ParamètresCopy Anchor Link

Aucun.

RetourCopy Anchor Link

string | null : le nom de ressource du script de serrures. null quand aucun ne tourne.

ExempleCopy Anchor Link

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

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

// Les ids de portes de votre config appartiennent à un script de serrures : avertir quand un autre tourne.
if (core.GetDoorlockSystem() !== "ai-doorlock")
  console.log("myscript: door ids are written for ai-doorlock");

SetDoorLockedCopy Anchor Link

Verrouille ou déverrouille une porte.

Côté : Serveur · Attend : non · Lib : doors.setLocked

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

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

ParamètresCopy Anchor Link

RetourCopy Anchor Link

boolean : true quand le script de serrures a accepté le changement. false quand aucun script de serrures ne tourne, que la porte est inconnue, que le script a refusé, que id est vide ou que locked n’est pas un booléen.

ExempleCopy 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

Indique si une porte est verrouillée.

Côté : Serveur · Attend : non · Lib : doors.isLocked

IsDoorLocked(id: string): boolean | null

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

ParamètresCopy Anchor Link

RetourCopy Anchor Link

boolean | null : true verrouillée, false déverrouillée. null quand c’est inconnu : aucun script de serrures ne tourne, la porte n’existe pas, le script ne peut pas le dire côté serveur, ou id est vide.

ExempleCopy Anchor Link

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

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

/** The heist may start only while the vault is still closed. */
export function vaultClosed(): boolean {
  return core.IsDoorLocked("pacific_vault") !== false;
}