Menu radial

O menu radial é a roda que os jogadores abrem com uma tecla para escolher ações rápidas (portas do veículo, emotes, ações de emprego). Os scripts adicionam seus itens ao ai-core, e o ai-core os entrega ao menu radial que o servidor roda: ai-radialmenu, ou um de terceiros suportado (tgiann-radialmenu, qb-radialmenu, codem-supreme-radialmenu, o radial do ox_lib).

O ai-core guarda cada item. Quando o menu radial reinicia, ou o dono do servidor troca para outro, o ai-core adiciona cada item de novo sozinho, então seu script adiciona os itens uma vez ao iniciar e nunca precisa vigiar o recurso do radial. Os itens são removidos quando o recurso que os adicionou para.

AddRadialItemCopy Anchor Link

Adiciona um item ao menu radial, ou substitui o item com o mesmo id. As funções do item (canShow, onPressed) rodam dentro do seu recurso.

Lado: Cliente · Espera: não

AddRadialItem(item: RadialItem): void

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

ParâmetrosCopy Anchor Link

RadialItemCopy Anchor Link

Veja também RadialItem.

RetornoCopy Anchor Link

Nada. Um item sem id ou label em texto não é adicionado, e o ai-core imprime um aviso com o nome do seu recurso.

ExemploCopy Anchor Link

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

// Uma vez ao iniciar: um interruptor do motor no submenu do veículo, só para o motorista.
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

Remove um item pelo id.

Lado: Cliente · Espera: não

RemoveRadialItem(id: string): void

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

ParâmetrosCopy Anchor Link

RetornoCopy Anchor Link

Nada.

ExemploCopy Anchor Link

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

// Uma ação de algemar só enquanto em serviço como policial.
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

Lê de novo cada canShow de uma roda aberta, para que os itens apareçam ou sumam enquanto o jogador olha para ela. Chame depois que algo que um canShow lê mudou (o jogador entrou num veículo, entrou em serviço).

Lado: Cliente · Espera: não

RefreshRadial(): void

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

ParâmetrosCopy Anchor Link

Nenhum.

RetornoCopy Anchor Link

Nada. Sem um menu radial rodando, não faz nada.

ExemploCopy Anchor Link

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

// Os itens do veículo dependem do assento: atualize quando ele muda.
onCache("seat", () => radial.refresh());