Teléfono y apariencia

import { phone, appearance } from "@aicore-fivem/lib/server";

phoneCopy Anchor Link

El teléfono del jugador a través de ai-core: responde el primer script de teléfono que esté en marcha (tgiann-phone, lb-phone...). Sin script de teléfono, cada llamada responde null o false. Los equivalentes en Lua en aiLib.phone tienen los mismos nombres y el mismo orden de argumentos.

phone.numberCopy Anchor Link

Lado: Servidor · Espera: no

phone.number(source: number): string | null

local number = aiLib.phone.number(source)

Devuelve el número de teléfono del jugador, o null (nil en Lua) cuando no tiene ninguno o no hay script de teléfono en marcha.

const number = phone.number(source);
if (!number) return fail("NO_PHONE_NUMBER");

phone.sourceOfCopy Anchor Link

El jugador en línea que tiene un número de teléfono.

Lado: Servidor · Espera: no

phone.sourceOf(number: string): number | null

local source = aiLib.phone.sourceOf(number)

Devuelve el id de servidor, o null (nil en Lua) cuando nadie en línea tiene ese número.

const owner = phone.sourceOf("555-0101");
if (owner !== null) notify(owner, "Your phone is ringing");

phone.hasPhoneCopy Anchor Link

Si el jugador lleva un teléfono.

Lado: Servidor · Espera: no

phone.hasPhone(source: number): boolean

local has = aiLib.phone.hasPhone(source)

Devuelve true cuando tiene uno; false si no lo tiene o no hay script de teléfono.

if (!phone.hasPhone(source)) return fail("NEED_PHONE");

phone.mailCopy Anchor Link

Envía un correo al teléfono de un jugador.

Lado: Servidor · Espera: no

phone.mail(to: number | string, mail: PhoneMail): boolean

local ok = aiLib.phone.mail(to, mail)

El tipo es PhoneMail.

Devuelve true cuando se envió, false en caso contrario.

phone.mail(source, {
  sender: "Downtown Cab Co.",
  subject: "Your shift",
  message: "Pick up the taxi at the depot.",
});

phone.messageCopy Anchor Link

Envía un mensaje de texto.

Lado: Servidor · Espera: no

phone.message(from: string, to: number | string, text: string): boolean

local ok = aiLib.phone.message(from, to, text)

Devuelve true cuando se envió, false en caso contrario.

phone.message("Dealer", source, "Meet me behind the gas station.");

phone.notifyCopy Anchor Link

Muestra una notificación dentro del teléfono.

Lado: Servidor · Espera: no

phone.notify(source: number, notification: PhoneNotification): boolean

local ok = aiLib.phone.notify(source, notification)

El tipo es PhoneNotification.

Devuelve true cuando se mostró, false en caso contrario.

phone.notify(source, { title: "Bank", message: "Salary paid: $250", app: "bank" });

appearanceCopy Anchor Link

El aspecto guardado de los personajes a través de la capa de apariencia de ai-core, sea cual sea el script de ropa que funcione (ai-appearance, tgiann-clothing).

appearance.getCopy Anchor Link

El aspecto guardado de un personaje, esté cargado o no. Úsalo para vestir un ped que representa a un personaje (un cuerpo dormido, un maniquí): pasa el resultado sin cambios a appearance.apply del cliente (Lib: cliente).

Lado: Servidor · Espera: sí (Promise en TypeScript, cede el hilo en Lua)

appearance.get(charId: number): Promise<CharacterAppearance | null>

local look = aiLib.appearance.get(charId) -- { model, data } o nil, llamar dentro de un hilo

DevuelveCopy Anchor Link

Promise<CharacterAppearance | null>: CharacterAppearance es { model, data } (el hash del modelo del ped y los datos de aspecto propios del script de ropa). null cuando el personaje no tiene ninguno, no hay script de ropa en marcha o ai-core está detenido.

EjemploCopy Anchor Link

import { appearance, online, playersNear } from "@aicore-fivem/lib/server";

async function sendLook(source: number) {
  const charId = online.charId(source);
  if (charId === undefined) return;
  const look = await appearance.get(charId);
  if (!look) return;
  // Solo los jugadores cerca de este personaje necesitan el aspecto.
  for (const other of playersNear(source, 100)) emitNet("my-sleepers:look", other, source, look);
}

appearance.providerCopy Anchor Link

Lado: Servidor · Espera: no

appearance.provider(): string | null

local name = aiLib.appearance.provider()

Devuelve el script de ropa que responde, o null (nil en Lua) cuando no hay ninguno en marcha.

console.log(`looks through ${appearance.provider() ?? "nothing"}`);