Ключи от транспорта

Каждый вызов ключей идёт через ai-core, а не через собственные экспорты скрипта ключей (включая ai-vehiclekeys). ai-core передаёт его активной системе ключей: той, что выбрана в настройке панели Key script, или первой запущенной. Когда ни один скрипт ключей не работает, каждый игрок считается владельцем всех ключей.

Транспорт задаётся либо серверным хэндлом сущности (число, которое возвращает CreateVehicleServerSetter или spawnVehicle), либо текстом номера. Номер сначала обрезается по краям и переводится в верхний регистр, поэтому " ab12cde " и "AB12CDE" - один и тот же ключ.

У каждого ключа есть назначение, которое сообщает системе ключей, зачем игрок его получает. Некоторые системы ключей обрабатывают их по-разному (купленный транспорт получает новый предмет-ключ, рабочий транспорт - ключ, закреплённый в замке зажигания). См. KeyPurpose.

GiveVehicleKeysCopy Anchor Link

Выдаёт игроку ключи от транспорта.

Сторона: сервер · Ожидание: нет · Библиотека: vehicleKeys.give (а spawnVehicle({ keysTo, purpose }) выдаёт их за вас)

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

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

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

Ничего. Вызов ничего не делает, когда сущность транспорта не существует, номер пуст, source не число или ни одна система ключей не работает. Ошибка системы ключей записывается в лог, а не бросается.

ПримерCopy 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

Забирает у игрока ключи от транспорта.

Сторона: сервер · Ожидание: нет · Библиотека: vehicleKeys.remove

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

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

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

Ничего. Те же молчаливые случаи, что и у GiveVehicleKeys.

ПримерCopy 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

Есть ли у игрока ключи от транспорта.

Сторона: сервер · Ожидание: нет · Библиотека: vehicleKeys.has

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

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

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

boolean: true, когда у игрока есть ключи. Также true, когда ни одна система ключей не работает, когда система ключей не может ответить на этот вопрос или когда она даёт сбой, поэтому отсутствующий скрипт ключей никогда не блокирует игроков. false, когда у игрока нет ключа, сущность транспорта не существует, номер пуст или source не число.

ПримерCopy 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");

// Чтобы открыть багажник машины рядом с игроком, нужны её ключи.
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 };
});