Радиальное меню

Радиальное меню - это колесо, которое игроки открывают клавишей, чтобы выбрать быстрое действие (двери транспорта, эмоции, рабочие действия). Скрипты добавляют свои пункты в ai-core, а ai-core передаёт их радиальному меню, которое работает на сервере: ai-radialmenu или поддерживаемое стороннее (tgiann-radialmenu, qb-radialmenu, codem-supreme-radialmenu, радиальное меню ox_lib).

ai-core хранит каждый пункт. Когда радиальное меню перезапускается или владелец сервера переключается на другое, ai-core сам снова добавляет все пункты, поэтому ваш скрипт добавляет свои пункты один раз при старте и никогда не следит за ресурсом радиального меню. Пункты удаляются, когда останавливается ресурс, который их добавил.

AddRadialItemCopy Anchor Link

Добавляет пункт в радиальное меню или заменяет пункт с тем же id. Функции пункта (canShow, onPressed) выполняются внутри вашего ресурса.

Сторона: клиент · Ожидание: нет

AddRadialItem(item: RadialItem): void

exports['ai-core']:AddRadialItem(item) -- или aiLib.radial.add(item)

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

RadialItemCopy Anchor Link

См. также RadialItem.

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

Ничего. Пункт без текстового id или label не добавляется, и ai-core выводит предупреждение с именем вашего ресурса.

ПримерCopy Anchor Link

import { cache, radial } from "@aicore-fivem/lib/client";
import { RADIAL_VEHICLE } from "@aicore-fivem/shared";
import { Locale } from "common";

// Один раз при старте: переключатель двигателя в подменю транспорта, только для водителя.
radial.add({
  id: "myscript_engine",
  label: Locale("RADIAL_ENGINE"),
  icon: "power-off",
  parent: RADIAL_VEHICLE,
  canShow: () => cache.vehicle !== false && cache.seat === -1,
  onPressed: () => {
    if (cache.vehicle === false) return;
    SetVehicleEngineOn(cache.vehicle, !GetIsVehicleEngineRunning(cache.vehicle), false, true);
  },
});

RemoveRadialItemCopy Anchor Link

Удаляет пункт по его id.

Сторона: клиент · Ожидание: нет

RemoveRadialItem(id: string): void

exports['ai-core']:RemoveRadialItem(id) -- или aiLib.radial.remove(id)

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

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

Ничего.

ПримерCopy Anchor Link

import { onPlayerData, radial } from "@aicore-fivem/lib/client";
import { Locale } from "common";

// Действие «наручники» только на дежурстве в полиции.
onPlayerData("duty", (duty) => {
  if (duty === "police")
    radial.add({ id: "myscript_cuff", label: Locale("RADIAL_CUFF"), icon: "handcuffs", onPressed: () => ExecuteCommand("cuff") });
  else radial.remove("myscript_cuff");
});

RefreshRadialCopy Anchor Link

Заново читает все canShow открытого колеса, чтобы пункты появлялись или исчезали, пока игрок на него смотрит. Вызывайте после изменения того, что читает canShow (игрок сел в транспорт, заступил на дежурство).

Сторона: клиент · Ожидание: нет

RefreshRadial(): void

exports['ai-core']:RefreshRadial() -- или aiLib.radial.refresh()

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

Нет.

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

Ничего. Без запущенного радиального меню ничего не делает.

ПримерCopy Anchor Link

import { onCache, radial } from "@aicore-fivem/lib/client";

// Пункты транспорта зависят от места: обновлять при его смене.
onCache("seat", () => radial.refresh());