Texto y números

Pequeñas utilidades para lo que leen los jugadores (dinero, pesos, textos traducidos), tiradas aleatorias y cuentas atrás que coinciden con el reloj del servidor.

import { formatText, round, groupDigits, formatWeight, stripGameText, randomInt, pickRandom, rollChance, ServerClock } from "@aicore-fivem/lib/shared";

TextoCopy Anchor Link

formatTextCopy Anchor Link

Rellena los marcadores {0}, {1}... de un texto con valores por posición. Una traducción puede mover o repetir un marcador ("{1} paid {0}"), por eso los valores van por número, no por orden.

Lado: Cliente, servidor y NUI · Espera: no

formatText(template: string, args: ReadonlyArray<string | number>): string

local text = aiLib.formatText(template, ...) -- valores como argumentos separados

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

string: el texto con cada marcador que tiene valor rellenado. Un marcador sin valor se queda como está ({2}).

EjemploCopy Anchor Link

import { formatText } from "@aicore-fivem/lib/shared";

formatText("You paid ${0} for {1} items", [250, 3]); // "You paid $250 for 3 items"

stripGameTextCopy Anchor Link

Convierte en texto plano el texto de otro script: quita las etiquetas HTML, los códigos de color y de entrada de GTA (~r~, ~INPUT_PICKUP~) y  , junta los espacios repetidos y recorta. Úsalo antes de mostrar el texto de otro script en tu propia interfaz.

Lado: Cliente, servidor y NUI · Espera: no

stripGameText(text: unknown): string

local plain = aiLib.stripGameText(text)

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

string: el texto plano. "" para null / undefined (Lua: nil).

EjemploCopy Anchor Link

import { stripGameText } from "@aicore-fivem/lib/shared";

stripGameText("Press ~INPUT_CONTEXT~ to <b>open</b>  the ~g~shop~s~"); // "Press to open the shop"

NúmerosCopy Anchor Link

roundCopy Anchor Link

Redondea un número a una cantidad de decimales.

Lado: Cliente, servidor y NUI · Espera: no

round(value: number, decimals?: number): number

local rounded = aiLib.numbers.round(value, decimals)

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

number: el valor redondeado.

EjemploCopy Anchor Link

import { round } from "@aicore-fivem/lib/shared";

round(12.345, 1); // 12.3
round(12.5);      // 13

groupDigitsCopy Anchor Link

Escribe un número con un separador cada tres dígitos: 1234567 pasa a ser 1,234,567. Conserva el signo y los decimales. Úsalo para cada cantidad de dinero que ven los jugadores.

Lado: Cliente, servidor y NUI · Espera: no

groupDigits(value: number | string, separator?: string): string

local text = aiLib.numbers.groupDigits(value, separator)

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

string: el número agrupado.

EjemploCopy Anchor Link

import { groupDigits } from "@aicore-fivem/lib/shared";

groupDigits(1234567);        // "1,234,567"
groupDigits(-9876.5);        // "-9,876.5"
groupDigits(1500000, ".");   // "1.500.000"

formatWeightCopy Anchor Link

Escribe un peso en gramos como lo leen los jugadores: por debajo de 1 kg en gramos, desde 1 kg en kilogramos con un decimal (kilogramos enteros desde 100 kg), con los dígitos agrupados.

Lado: Cliente, servidor y NUI · Espera: no

formatWeight(grams: number): string

Lua: sin equivalente.

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

string: "750 g", "1.5 kg", "1,250 kg".

EjemploCopy Anchor Link

import { formatWeight } from "@aicore-fivem/lib/shared";

formatWeight(750);      // "750 g"
formatWeight(1500);     // "1.5 kg"
formatWeight(1250000);  // "1,250 kg"

AleatorioCopy Anchor Link

randomIntCopy Anchor Link

Un número entero aleatorio de min a max, ambos incluidos.

Lado: Cliente, servidor y NUI · Espera: no

randomInt(min: number, max: number): number

Lua: sin equivalente; usa math.random(min, max).

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

number: un número entero entre min y max.

EjemploCopy Anchor Link

import { randomInt } from "@aicore-fivem/lib/shared";

const payout = randomInt(150, 300); // 150, 151, ... o 300

pickRandomCopy Anchor Link

Un elemento aleatorio de una lista.

Lado: Cliente, servidor y NUI · Espera: no

pickRandom<T>(list: readonly T[]): T | undefined

Lua: sin equivalente; usa list[math.random(#list)].

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

Un elemento, o undefined cuando la lista está vacía.

EjemploCopy Anchor Link

import { pickRandom } from "@aicore-fivem/lib/shared";

const loot = pickRandom(["goldbar", "rolex", "diamond"]) ?? "goldbar";

rollChanceCopy Anchor Link

true con una probabilidad de percent sobre 100.

Lado: Cliente, servidor y NUI · Espera: no

rollChance(percent: number): boolean

Lua: sin equivalente; usa math.random() * 100 < percent.

ParámetrosCopy Anchor Link

DevuelveCopy Anchor Link

true aproximadamente percent veces de cada 100.

EjemploCopy Anchor Link

import { inventory } from "@aicore-fivem/lib/server";
import { rollChance } from "@aicore-fivem/lib/shared";

function useLockpick(source: number, slot: number): void {
  if (rollChance(25)) inventory.removeItem(source, "lockpick", 1, undefined, slot); // se rompe 1 de cada 4 veces
}

TiempoCopy Anchor Link

ServerClockCopy Anchor Link

El reloj del servidor en un cliente, para cuentas atrás que no dependen del propio reloj del cliente. Se exporta desde @aicore-fivem/lib/shared y no tiene equivalente en Lua. Su referencia completa (sync, now, toLocal, ejemplo de cuenta atrás) está en Cámara y temporización: ServerClock.