Clés de véhicule

Chaque appel de clé passe par ai-core, jamais par les exports propres à un script de clés (ai-vehiclekeys compris). ai-core le transmet au système de clés actif : celui que choisit le réglage Key script du panneau, ou le premier qui tourne. Quand aucun script de clés ne tourne, chaque joueur compte comme possédant toutes les clés.

Un véhicule est donné soit comme handle d’entité serveur (le nombre que renvoie CreateVehicleServerSetter ou spawnVehicle), soit comme texte de plaque. Une plaque est d’abord nettoyée des espaces et mise en majuscules, donc " ab12cde " et "AB12CDE" sont la même clé.

Chaque clé a un motif (purpose) qui indique au système de clés pourquoi le joueur la reçoit. Certains systèmes de clés les traitent différemment (un véhicule acheté reçoit un nouvel objet clé, un véhicule de métier une clé fixée sur le contact). Voir KeyPurpose.

GiveVehicleKeysCopy Anchor Link

Donne à un joueur les clés d’un véhicule.

Côté : Serveur · Attend : non · Lib : vehicleKeys.give (et spawnVehicle({ keysTo, purpose }) les donne pour vous)

GiveVehicleKeys(source: number, vehicle: number | string, purpose?: KeyPurpose): void

exports['ai-core']:GiveVehicleKeys(source, vehicle, 'rental')

ParamètresCopy Anchor Link

RetourCopy Anchor Link

Rien. L’appel ne fait rien quand l’entité du véhicule n’existe pas, que la plaque est vide, que source n’est pas un nombre ou qu’aucun système de clés ne tourne. L’erreur d’un système de clés est enregistrée dans le log, pas levée.

ExempleCopy Anchor Link

import { onClientCallback, resourceExport, spawnVehicle } from "@aicore-fivem/lib/server";
import { fail } from "@aicore-fivem/lib/shared";

const core = resourceExport("ai-core");
const SPAWN = { x: -1023.5, y: -2694.1, z: 13.9, heading: 150 };

onClientCallback("myscript:rentScooter", { lock: true }, async (source) => {
  if (!core.RemoveMoney(source, "cash", 100, "scooter_rental")) return fail("NOT_ENOUGH_MONEY");
  const vehicle = await spawnVehicle({ model: "faggio", coords: SPAWN, asker: source });
  if (!vehicle) {
    core.AddMoney(source, "cash", 100, "scooter_rental_refund");
    return fail("SPAWN_FAILED");
  }
  core.GiveVehicleKeys(source, vehicle, "rental");
  return { ok: true };
});

RemoveVehicleKeysCopy Anchor Link

Retire à un joueur les clés d’un véhicule.

Côté : Serveur · Attend : non · Lib : vehicleKeys.remove

RemoveVehicleKeys(source: number, vehicle: number | string): void

exports['ai-core']:RemoveVehicleKeys(source, 'AB12CDE')

ParamètresCopy Anchor Link

RetourCopy Anchor Link

Rien. Mêmes cas silencieux que GiveVehicleKeys.

ExempleCopy Anchor Link

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

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

/** The rental ended: the keys go, then the scooter. */
export function endRental(source: number, vehicle: number): void {
  core.RemoveVehicleKeys(source, vehicle);
  if (DoesEntityExist(vehicle)) DeleteEntity(vehicle);
}

HasVehicleKeysCopy Anchor Link

Indique si un joueur possède les clés d’un véhicule.

Côté : Serveur · Attend : non · Lib : vehicleKeys.has

HasVehicleKeys(source: number, vehicle: number | string): boolean

local has = exports['ai-core']:HasVehicleKeys(source, vehicle)

ParamètresCopy Anchor Link

RetourCopy Anchor Link

boolean : true quand le joueur possède les clés. Aussi true quand aucun système de clés ne tourne, quand le système de clés ne sait pas répondre à cette question, ou quand il échoue, si bien qu’un script de clés absent n’enferme jamais les joueurs dehors. false quand le joueur n’a pas de clé, que l’entité du véhicule n’existe pas, que la plaque est vide ou que source n’est pas un nombre.

ExempleCopy Anchor Link

import { onClientCallback, resourceExport, vehicleNearPlayer } from "@aicore-fivem/lib/server";
import { fail, oneArg, readId } from "@aicore-fivem/lib/shared";

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

// Ouvrir le coffre d’une voiture à côté du joueur demande ses clés.
onClientCallback("myscript:openTrunk", { args: oneArg(readId) }, (source, netId) => {
  const vehicle = vehicleNearPlayer(source, netId, { metres: 4 });
  if (!vehicle) return fail("TOO_FAR");
  if (!core.HasVehicleKeys(source, vehicle)) return fail("NO_KEYS");
  return { ok: true };
});