ai-smallresources para desenvolvedores

Os três exports ficam no cliente, são síncronos e leem o jogador local. GetSeatbelt é tipado como AiSmallResourcesClientExports em @aicore-fivem/shared; IsHandsUp e IsPointing não são tipados (use callExport).

import { resourceExport, callExport } from "@aicore-fivem/lib/client";
const small = resourceExport("ai-smallresources");

Exports do clienteCopy Anchor Link

GetSeatbeltCopy Anchor Link

Se o jogador local está usando o cinto de segurança.

Lado: Cliente · Espera: não

GetSeatbelt(): boolean | null

local worn = exports['ai-smallresources']:GetSeatbelt() -- true, false ou nil

RetornoCopy Anchor Link

true quando afivelado, false quando não. null quando o recurso Seatbelt está desligado no painel, ou o jogador não está em um veículo com cinto.

ExemploCopy Anchor Link

import { seatbelt } from "@aicore-fivem/lib/client";

// O ícone de cinto de um HUD: lê uma vez, depois acompanha as mudanças.
let worn = seatbelt.isOn();
seatbelt.onChange((value) => {
  worn = value;
});

IsHandsUpCopy Anchor Link

Se o jogador local está com as mãos para cima (o gesto X).

Lado: Cliente · Espera: não

IsHandsUp(): boolean

local up = exports['ai-smallresources']:IsHandsUp()

RetornoCopy Anchor Link

true enquanto as mãos estão para cima, false caso contrário.

IsPointingCopy Anchor Link

Se o jogador local está apontando (o gesto B).

Lado: Cliente · Espera: não

IsPointing(): boolean

local pointing = exports['ai-smallresources']:IsPointing()

RetornoCopy Anchor Link

true enquanto aponta, false caso contrário.

EventosCopy Anchor Link

ai-smallresources:seatbeltCopy Anchor Link

Disparado no cliente local quando o cinto muda. O nome é SEATBELT_EVENT em @aicore-fivem/shared. O ai-core o repassa como seu próprio evento de cinto, que o seatbelt.onChange da lib escuta; prefira esse.

Lado: Cliente (evento local)

AddEventHandler('ai-smallresources:seatbelt', function(worn)
  print('seat belt', worn)
end)

Todos os outros eventos do ai-smallresources são internos (do cliente e do servidor dele).

State bags e metadataCopy Anchor Link

// Servidor: a placa real de um veículo, falsa ou não.
export function realPlate(vehicle: number): string {
  const real = Entity(vehicle).state.aiRealPlate as string | undefined;
  return real ?? GetVehicleNumberPlateText(vehicle);
}

Itens usáveisCopy Anchor Link

Registrados pela camada de inventário do ai-core, então funcionam com qualquer inventário que estiver rodando: binoculars, firework1-firework4, newscam, newsmic, newsboom, fakeplate, notepad, note (metadata text e description), diving_gear, diving_fill.