Lib: Client
@aicore8/lib/client und die Client-Seite von aiLib: was sie sind, wie du sie in TypeScript und Lua lädst, und jede Themenseite.
Die Client-Lib ist die Sammlung von Helfern, die jedes ai-*-Client-Skript nutzt, statt Natives von Hand zu schreiben: mit dem Server sprechen, der lokale Spieler, Interaktionspunkte, Zonen, Peds und Blips, die gemeinsame UI (Benachrichtigungen, Fortschrittsbalken, Menüs, Minispiele), Keybinds und die Ebenen, die über ai-core das HUD-, Death-, Kleidungs- oder Emote-Skript erreichen, das der Server betreibt.
TypeScript
Importiere aus @aicore8/lib/client in Dateien unter resource/client/. Helfer, die auf jeder Seite funktionieren (Ablehnungen, Eingabeleser, Mathematik, RecordObjects, ServerClock), kommen aus @aicore8/lib/shared.
import { Points, notify, progress, cache } from "@aicore8/lib/client";
import { RecordObjects, ServerClock } from "@aicore8/lib/shared";Jede Ressource, die aus der ai-core-Vorlage erstellt wurde, hängt bereits von dem Paket ab ("@aicore8/lib": "workspace:*" in package.json); der Build bündelt es in dist/client.js.
Lua
Lua-Ressourcen bekommen dieselben Helfer in der globalen Tabelle aiLib aus der Ressource ai-lib. Füge zwei Zeilen in deine fxmanifest.lua ein:
dependency 'ai-lib'
shared_script '@ai-lib/init.lua'Rufe dann aiLib.<name> in einer beliebigen Client-Datei auf. Jedes Modul lädt beim ersten Gebrauch und läuft innerhalb deiner Ressource, sodass die Punkte, Keybinds und Callbacks, die du erstellst, zu deiner Ressource gehören und verschwinden, wenn sie stoppt. Klassen werden mit .new() erstellt, und ihre Methoden werden mit einem Doppelpunkt aufgerufen: local points = aiLib.Points.new(), dann points:add(...).
local t = aiLib.locale()
RegisterCommand('hello', function()
aiLib.notify(t('HELLO'), 'success')
end, false)Lua-Funktionen, die mit Wartet markiert sind (triggerServerCallback, callAction, progress, menu.show, input, skillCheck, lockpick, itemPicker, fadeOut, fadeIn, player.teleport, waitForEntity, die request*-Lader, pedHeadshot), halten den Code an, bis die Antwort kommt. Sie funktionieren nur innerhalb eines Threads. Befehls-Handler und Net-Event-Handler laufen bereits in einem; überall sonst (das onPressed eines Punkts, ein Keybind, ein Menü-Callback) packst du den Aufruf in CreateThread(function() ... end).
Nicht jeder TypeScript-Helfer hat einen Lua-Zwilling. Jeder Eintrag sagt es, wenn er keinen hat. Diese fehlen in Lua: fromServer, isActionOk, replyError, onCache (Lua hat cache.onChange), readPlayerState, readWeapon, player.holdAnim, attachProp, PreviewVehicle, NuiScreen, hud.onChange, controls.isDisabled, medical, fuel, drivenVehicle, entityFromNetId, die Helfer für Fahrzeug-Props, ScriptCamera, TickLoop (nutze aiLib.every(0, fn)), AreaFollower, ServerClock, AdminWorld, RecordObjects und die Mitgliedschaftsprüfungen (hasJob, inGang, onDutyIn, allows, onMembershipChange).
Themen
Mit dem Server sprechen
triggerServerCallback, onServerEvent, onServerCallback, callAction, ein ActionResult lesen.
Der lokale Spieler
cache und onCache, player (Koordinaten, Teleport, Animationen), Überblendungen, playerPed, nearestPlayer.
Interaktionspunkte
Points: add, addModel, addVehicle, jede Option, Prompt oder Target, refresh, Punkte aus Panel-Einträgen.
Zonen
Zones: Bereiche mit Betreten- und Verlassen-Callbacks, Kugel-, Zylinder- und Polygonformen.
Peds, Blips und Props
LocalPed, Blips, createBlip, attachProp, PreviewVehicle, player.holdAnim.
Gemeinsame UI
notify, progress, menu, input, Prompts, skillCheck, lockpick, itemPicker.
Bildschirme und Steuerung
NuiScreen, hud, keyHints, controls.
Keybinds
Keybind: eine neu belegbare Taste, deren Standard das Admin-Panel ändern kann.
Ebenen über ai-core
medical, appearance, gestures, seatbelt, fuel, mdt, radial, world, inventory.
Fahrzeuge und Entities
nearestVehicle, drivenVehicle, waitForEntity, entityFromNetId, Fahrzeug-Props.
Abfragen und Laden
raycast, groundZ, locationName, vehicleLabel, waypoint, pedHeadshot, onShot, requestModel und Co.
Kamera und Timing
ScriptCamera, TickLoop, AreaFollower, ServerClock.
Mitgliedschaft und Spielerdaten
hasJob, inGang, onDutyIn, allows, onMembershipChange, getPlayerData, onPlayerData.
Mit dem Server geteilte Helfer
Der Client-Einstieg exportiert auch die /fivem-Helfer erneut, sodass du sie auch aus @aicore8/lib/client importieren kannst. Sie sind einmal auf Lib: Shared und fivem dokumentiert:
registerExport, resourceExport, optionalExport, callExport, provideExport, isResourceStarted, createLocale, loadLocaleTexts, LOCALE_CONVAR, ByResource, caller, onStop, plateOf, Reasons, every (mit den Typen EveryOptions und Job), stateBoolean, stateNumber, stateString (Typ StateParse).
Die State-Bag-Klassen EntityState, PlayerState, GlobalKey und GlobalGroup, die der Client-Einstieg exportiert, sind die schreibgeschützten Client-Versionen: get(id) und onChange(handler), kein set. Die Server-Versionen stehen unter State Bags.
Exports, die dein Skript nie aufruft
ZoneEngine (der Zonenprüfer hinter Zones), ModelScanner und readModelScanDef (der Modellscan hinter Points.addModel) werden für ai-lib exportiert, das sie für jede Ressource ausführt. Nutze stattdessen Zones und Points.
Events der Framework-Brücke
Die ESX-, QB- / Qbox- und vRP-Events, die ai-core auslöst, damit für diese Frameworks geschriebene Skripte weiter funktionieren, mit ihren genauen Argumenten, und die Framework-Events, die ai-core beantwortet.
Mit dem Server sprechen
Den Server fragen und auf seine Antwort warten, Server-Aktionen mit übersetzten Ablehnungen ausführen, auf Server-Events hören und Server-Callbacks beantworten.