Text und Zahlen

Kleine Helfer für das, was Spieler lesen (Geld, Gewichte, übersetzte Texte), Zufallswürfe und Countdowns, die zur Server-Uhr passen.

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

TextCopy Anchor Link

formatTextCopy Anchor Link

Füllt {0}, {1}...-Platzhalter in einem Text mit Werten nach Position. Eine Übersetzung kann einen Platzhalter verschieben oder wiederholen ("{1} paid {0}"), deshalb gehen die Werte nach Nummer, nicht nach Reihenfolge.

Seite: Client, Server und NUI · Wartet: nein

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

local text = aiLib.formatText(template, ...) -- Werte als einzelne Argumente

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

string: der Text mit jedem Platzhalter ausgefüllt, der einen Wert hat. Ein Platzhalter ohne Wert bleibt, wie er ist ({2}).

BeispielCopy 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

Macht Text aus einem anderen Skript schlicht: entfernt HTML-Tags, GTA-Farb- und Eingabecodes (~r~, ~INPUT_PICKUP~) und  , fasst Folgen von Leerzeichen zusammen und trimmt. Nutze es, bevor du den Text eines anderen Skripts in deiner eigenen UI anzeigst.

Seite: Client, Server und NUI · Wartet: nein

stripGameText(text: unknown): string

local plain = aiLib.stripGameText(text)

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

string: der schlichte Text. "" für null / undefined (Lua: nil).

BeispielCopy 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"

ZahlenCopy Anchor Link

roundCopy Anchor Link

Rundet eine Zahl auf eine Anzahl von Nachkommastellen.

Seite: Client, Server und NUI · Wartet: nein

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

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

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

number: der gerundete Wert.

BeispielCopy Anchor Link

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

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

groupDigitsCopy Anchor Link

Schreibt eine Zahl mit einem Trennzeichen alle drei Ziffern: 1234567 wird zu 1,234,567. Behält das Vorzeichen und die Nachkommastellen. Nutze es für jeden Geldbetrag, den Spieler sehen.

Seite: Client, Server und NUI · Wartet: nein

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

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

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

string: die gruppierte Zahl.

BeispielCopy 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

Schreibt ein Gewicht in Gramm so, wie Spieler es lesen: unter 1 kg in Gramm, ab 1 kg in Kilogramm mit einer Nachkommastelle (ab 100 kg ganze Kilogramm), Ziffern gruppiert.

Seite: Client, Server und NUI · Wartet: nein

formatWeight(grams: number): string

Lua: kein Zwilling.

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

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

BeispielCopy Anchor Link

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

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

ZufallCopy Anchor Link

randomIntCopy Anchor Link

Eine zufällige ganze Zahl von min bis max, beide eingeschlossen.

Seite: Client, Server und NUI · Wartet: nein

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

Lua: kein Zwilling; nutze math.random(min, max).

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

number: eine ganze Zahl zwischen min und max.

BeispielCopy Anchor Link

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

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

pickRandomCopy Anchor Link

Ein zufälliges Element einer Liste.

Seite: Client, Server und NUI · Wartet: nein

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

Lua: kein Zwilling; nutze list[math.random(#list)].

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

Ein Element, oder undefined, wenn die Liste leer ist.

BeispielCopy Anchor Link

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

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

rollChanceCopy Anchor Link

true mit einer Chance von percent zu 100.

Seite: Client, Server und NUI · Wartet: nein

rollChance(percent: number): boolean

Lua: kein Zwilling; nutze math.random() * 100 < percent.

ParameterCopy Anchor Link

RückgabewertCopy Anchor Link

true etwa percent-mal von 100.

BeispielCopy 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); // bricht in 1 von 4 Fällen
}

ZeitCopy Anchor Link

ServerClockCopy Anchor Link

Die Server-Uhr auf einem Client, für Countdowns, die nicht von der eigenen Uhr des Clients abhängen. Sie wird aus @aicore-fivem/lib/shared exportiert und hat keinen Lua-Zwilling. Ihre vollständige Referenz (sync, now, toLocal, Countdown-Beispiel) steht unter Kamera und Timing: ServerClock.