Текст и числа

Небольшие помощники для того, что читают игроки (деньги, вес, переведённые тексты), для случайных бросков и для обратных отсчётов, совпадающих с часами сервера.

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

ТекстCopy Anchor Link

formatTextCopy Anchor Link

Подставляет в текст значения на места плейсхолдеров {0}, {1}... по позиции. Перевод может переставить или повторить плейсхолдер ("{1} paid {0}"), поэтому значения идут по номеру, а не по порядку.

Сторона: Клиент, сервер и NUI · Ждёт: нет

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

local text = aiLib.formatText(template, ...) -- значения отдельными аргументами

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

string: текст, в котором заполнен каждый плейсхолдер, для которого есть значение. Плейсхолдер без значения остаётся как есть ({2}).

ПримерCopy Anchor Link

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

formatText("You paid ${0} for {1} items", [250, 3]); // "You paid $250 for 3 items" (Вы заплатили $250 за 3 предмета)

stripGameTextCopy Anchor Link

Делает текст из другого скрипта простым: удаляет HTML-теги, цветовые коды GTA и коды ввода (~r~, ~INPUT_PICKUP~) и  , схлопывает повторяющиеся пробелы и обрезает края. Используйте перед тем, как показать текст другого скрипта в своём интерфейсе.

Сторона: Клиент, сервер и NUI · Ждёт: нет

stripGameText(text: unknown): string

local plain = aiLib.stripGameText(text)

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

string: простой текст. "" для null / undefined (Lua: nil).

ПримерCopy 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" (Нажмите, чтобы открыть магазин)

ЧислаCopy Anchor Link

roundCopy Anchor Link

Округляет число до заданного количества знаков после запятой.

Сторона: Клиент, сервер и NUI · Ждёт: нет

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

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

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

number: округлённое значение.

ПримерCopy Anchor Link

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

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

groupDigitsCopy Anchor Link

Записывает число с разделителем через каждые три цифры: 1234567 становится 1,234,567. Сохраняет знак и дробную часть. Используйте для каждой суммы денег, которую видят игроки.

Сторона: Клиент, сервер и NUI · Ждёт: нет

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

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

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

string: число, разбитое на группы.

ПримерCopy 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

Записывает вес в граммах так, как его читают игроки: меньше 1 кг в граммах, от 1 кг в килограммах с одним знаком после запятой (целые килограммы от 100 кг), цифры разбиты на группы.

Сторона: Клиент, сервер и NUI · Ждёт: нет

formatWeight(grams: number): string

Lua: аналога нет.

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

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

ПримерCopy Anchor Link

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

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

СлучайностьCopy Anchor Link

randomIntCopy Anchor Link

Случайное целое число от min до max, оба включительно.

Сторона: Клиент, сервер и NUI · Ждёт: нет

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

Lua: аналога нет; используйте math.random(min, max).

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

number: целое число от min до max.

ПримерCopy Anchor Link

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

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

pickRandomCopy Anchor Link

Один случайный элемент списка.

Сторона: Клиент, сервер и NUI · Ждёт: нет

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

Lua: аналога нет; используйте list[math.random(#list)].

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

Один элемент или undefined, если список пуст.

ПримерCopy Anchor Link

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

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

rollChanceCopy Anchor Link

true с шансом percent из 100.

Сторона: Клиент, сервер и NUI · Ждёт: нет

rollChance(percent: number): boolean

Lua: аналога нет; используйте math.random() * 100 < percent.

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

true примерно percent раз из 100.

ПримерCopy 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); // ломается в 1 случае из 4
}

ВремяCopy Anchor Link

ServerClockCopy Anchor Link

Часы сервера на клиенте, для обратных отсчётов, которые не зависят от собственных часов клиента. Экспортируется из @aicore-fivem/lib/shared и не имеет Lua-аналога. Полный справочник (sync, now, toLocal, пример обратного отсчёта) находится на странице Камера и время: ServerClock.