Radialmenü

Das Radialmenü ist das Rad, das Spieler mit einer Taste öffnen, um schnelle Aktionen zu wählen (Fahrzeugtüren, Emotes, Job-Aktionen). Skripte fügen ihre Einträge bei ai-core hinzu, und ai-core übergibt sie an das Radialmenü, das der Server nutzt: ai-radialmenu oder ein unterstütztes eines Drittanbieters (tgiann-radialmenu, qb-radialmenu, codem-supreme-radialmenu, das Radialmenü von ox_lib).

ai-core verwahrt jeden Eintrag. Wenn das Radialmenü neu startet oder der Serverbesitzer zu einem anderen wechselt, fügt ai-core jeden Eintrag von selbst erneut hinzu, sodass dein Skript seine Einträge einmal beim Start hinzufügt und die Radial-Ressource nie beobachten muss. Einträge werden entfernt, wenn die Ressource, die sie hinzugefügt hat, stoppt.

AddRadialItemCopy Anchor Link

Fügt dem Radialmenü einen Eintrag hinzu oder ersetzt den Eintrag mit derselben ID. Die Funktionen des Eintrags (canShow, onPressed) laufen innerhalb deiner Ressource.

Seite: Client · Wartet: nein

AddRadialItem(item: RadialItem): void

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

ParameterCopy Anchor Link

RadialItemCopy Anchor Link

Siehe auch RadialItem.

RückgabeCopy Anchor Link

Nichts. Ein Eintrag ohne Text-id oder -label wird nicht hinzugefügt, und ai-core gibt eine Warnung mit dem Namen deiner Ressource aus.

BeispielCopy Anchor Link

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

// Einmal beim Start: ein Motorschalter im Fahrzeug-Untermenü, nur für den Fahrer.
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

Entfernt einen Eintrag über seine ID.

Seite: Client · Wartet: nein

RemoveRadialItem(id: string): void

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

ParameterCopy Anchor Link

RückgabeCopy Anchor Link

Nichts.

BeispielCopy Anchor Link

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

// Eine Fessel-Aktion nur, solange man als Polizist im Dienst ist.
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

Liest jedes canShow eines offenen Rads erneut, sodass Einträge erscheinen oder verschwinden, während der Spieler darauf schaut. Rufe es auf, nachdem sich etwas geändert hat, das ein canShow liest (der Spieler ist in ein Fahrzeug gestiegen, in den Dienst gegangen).

Seite: Client · Wartet: nein

RefreshRadial(): void

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

ParameterCopy Anchor Link

Keine.

RückgabeCopy Anchor Link

Nichts. Ohne laufendes Radialmenü bewirkt es nichts.

BeispielCopy Anchor Link

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

// Fahrzeug-Einträge hängen vom Sitz ab: aktualisieren, wenn er sich ändert.
onCache("seat", () => radial.refresh());