Metin ve sayılar

Oyuncuların okudukları (para, ağırlıklar, çevrilmiş metinler), rastgele zarlar ve server’ın saatiyle uyumlu geri sayımlar için küçük yardımcılar.

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

MetinCopy Anchor Link

formatTextCopy Anchor Link

Bir metindeki {0}, {1}... yer tutucularını konuma göre değerlerle doldurur. Bir çeviri bir yer tutucuyu taşıyabilir ya da tekrarlayabilir ("{1} paid {0}"); değerlerin sıraya göre değil numaraya göre gitmesinin sebebi budur.

Taraf: Client, server ve NUI · Bekler: hayır

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

local text = aiLib.formatText(template, ...) -- değerler ayrı argümanlar olarak

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

string: değeri olan her yer tutucusu doldurulmuş metin. Değeri olmayan bir yer tutucu olduğu gibi kalır ({2}).

ÖrnekCopy 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

Başka bir script’ten gelen metni düz hale getirir: HTML etiketlerini, GTA renk ve girdi kodlarını (~r~, ~INPUT_PICKUP~) ve  ’yi kaldırır, art arda boşlukları birleştirir ve kırpar. Başka bir script’in metnini kendi arayüzünde göstermeden önce kullan.

Taraf: Client, server ve NUI · Bekler: hayır

stripGameText(text: unknown): string

local plain = aiLib.stripGameText(text)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

string: düz metin. null / undefined için "" (Lua: nil).

ÖrnekCopy 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"

SayılarCopy Anchor Link

roundCopy Anchor Link

Bir sayıyı belirli sayıda ondalık basamağa yuvarlar.

Taraf: Client, server ve NUI · Bekler: hayır

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

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

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

number: yuvarlanmış değer.

ÖrnekCopy Anchor Link

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

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

groupDigitsCopy Anchor Link

Bir sayıyı her üç basamakta bir ayırıcıyla yazar: 1234567, 1,234,567 olur. İşareti ve ondalıkları korur. Oyuncuların gördüğü her para miktarı için kullan.

Taraf: Client, server ve NUI · Bekler: hayır

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

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

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

string: gruplanmış sayı.

ÖrnekCopy 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

Gram cinsinden bir ağırlığı oyuncuların okuduğu şekilde yazar: 1 kg’ın altında gram, 1 kg’dan itibaren tek ondalıklı kilogram (100 kg’dan itibaren tam kilogram), basamaklar gruplanmış.

Taraf: Client, server ve NUI · Bekler: hayır

formatWeight(grams: number): string

Lua: karşılığı yok.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

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

ÖrnekCopy Anchor Link

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

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

RastgeleCopy Anchor Link

randomIntCopy Anchor Link

min ile max arasında (ikisi de dahil) rastgele bir tam sayı.

Taraf: Client, server ve NUI · Bekler: hayır

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

Lua: karşılığı yok; math.random(min, max) kullan.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

number: min ile max arasında bir tam sayı.

ÖrnekCopy Anchor Link

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

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

pickRandomCopy Anchor Link

Bir listeden rastgele bir öğe.

Taraf: Client, server ve NUI · Bekler: hayır

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

Lua: karşılığı yok; list[math.random(#list)] kullan.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Bir öğe ya da liste boşsa undefined.

ÖrnekCopy Anchor Link

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

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

rollChanceCopy Anchor Link

100’de percent ihtimalle true.

Taraf: Client, server ve NUI · Bekler: hayır

rollChance(percent: number): boolean

Lua: karşılığı yok; math.random() * 100 < percent kullan.

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

100’de yaklaşık percent kez true.

ÖrnekCopy 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); // 4’te 1 kırılır
}

ZamanCopy Anchor Link

ServerClockCopy Anchor Link

Client’ın kendi saatine bağlı olmayan geri sayımlar için, server’ın saati client’ta. @aicore-fivem/lib/shared’dan export edilir ve Lua karşılığı yoktur. Tam başvurusu (sync, now, toLocal, geri sayım örneği) Kamera ve zamanlama: ServerClock sayfasındadır.