Grundlagen
Das Framework und die Skripte, die jeder Server braucht - Charaktere, Datenbank, Inventar, HUD, Chat, Voice und mehr.
ai-core
Das Framework selbst.
- Konten und Charaktere. Spieler werden über ihr FiveM-Konto erkannt. Mehrere Charaktere pro Konto, im Panel eingestellt; das Löschen lässt sich abschalten.
- Charakterbildschirm. Die Charaktere stehen in einer echten Szene der Stadt (jeder in seinem eigenen Look); die Kamera gleitet zum gewählten. Beim Erstellen eines Charakters werden Name, Geburtsdatum, Geschlecht und Nationalität abgefragt.
- Wählen, wo man erscheint. Optional: Nach der Wahl eines Charakters erscheint über der Szene eine Liste von Orten (der letzte Standort und die Orte, die du festlegst).
- Geld. Standardmäßig Bargeld, Bank, Schwarzgeld und Krypto, weitere Konten im Panel. Jede Änderung wird mit einer Buchungszeile geschrieben, auch bei Job- und Gang-Konten.
- Jobs und Gangs. Mehrere Jobs und Gangs pro Charakter (Grenzen im Panel), jeweils ein Job im Dienst, Gehalt nur vom Job im Dienst. Prime Time ist standardmäßig an: außerhalb ihrer Stunden (Standard 18:00 bis 01:00) sinkt das Gehalt auf die Hälfte; Stunden, Kürzung und Schalter sind im Panel.
- PvP. Ob Spieler einander verletzen können, ist eine Einstellung (General, standardmäßig an); Admins schalten sie im Spiel mit
/togglepvpum. - Admin-Panel für alles (siehe Admin-Panel), Logs in die Konsole, an Discord, Fivemanage oder FiveM Stats, Update-Prüfung jedes Skripts, Skriptempfehlungen.
- Gemeinsame UI, die jedes Skript nutzt: Benachrichtigungen, der Fortschrittsbalken (eine Abbruchtaste für alle), Menüs, Eingabedialoge, Tastenhinweise im HUD, die Item-Auswahl für Admins.
- Tastenbildschirm. Der Eintrag Tasten im Radialmenü zeigt eine Tastatur mit jeder belegten Taste (mit den eigenen Belegungen des Spielers), eine Suche über die Aktionen und was die Taste unter dem Mauszeiger tut.
- Brücke. ESX-, QBCore- und Qbox-Skripte laufen unverändert auf AI Core (siehe Kompatibilität).
ai-mysql
Die Datenbank-Engine. Jedes ai-*-Skript betreibt seinen eigenen kleinen Verbindungspool; ai-mysql ersetzt außerdem oxmysql, mysql-async und ghmattimysql, sodass Skripte von Drittanbietern weiter funktionieren. Installiere oxmysql nicht daneben. Jedes Skript legt seine Tabellen beim Start selbst an und aktualisiert sie.
ai-lib
Die gemeinsame Spieler-UI, die jedes Skript nutzt: Benachrichtigungskarten, der Fortschrittsbalken mit seiner Abbruchtaste, die Hinweise rechts und die Interaktionstaste, Menüs, Eingabedialoge sowie die Minispiele Schlossknacken und Skill-Check. Sie läuft ohne ai-core, sodass andere Ressourcen sie auch allein nutzen können. Außerdem enthält sie die AI-Core-Helfer für Ressourcen, die sie nicht mitbündeln: Lua-Ressourcen fügen shared_script '@ai-lib/init.lua' hinzu und nutzen aiLib.notify, aiLib.Points, aiLib.addCommand, aiLib.progress und mehr; JavaScript-Ressourcen laden @ai-lib/dist/client.js oder server.js. Siehe die Lib.
ai-loading
Der Ladebildschirm: dein Servername, Untertitel und Slogan aus den allgemeinen Einstellungen, ein Hintergrundbild, der Ladefortschritt und Tipps, die du im Panel schreibst. Er schließt sich selbst, sobald der Charakterbildschirm bereit ist.
ai-appearance
Charaktereditor für neue Charaktere (in einem privaten Raum), Kleidungsgeschäfte und Friseure an Orten, die du festlegst, Outfits, Preise pro Geschäft. Die Porträts auf dem Charakterbildschirm kommen von hier.
ai-inventory
Ein Raster-Inventar mit Gewicht und Slots, eine separate Hotbar, Drops auf dem Boden, Lager, Kofferräume und Handschuhfächer von Fahrzeugen (der Kofferraum eines Fahrzeugs im Besitz bleibt beim Fahrzeug, egal welches Kennzeichen es trägt), Shops (mit NPCs und Job-Sperren), Werkbänke mit Rezepten, Waffen als Items, Seltenheiten mit Farben und der Charakter neben dem Inventar gezeichnet. Es beantwortet die APIs von ox_inventory und qb-inventory.
ai-hud
Gesundheit, Rüstung, Hunger, Durst und Stress, Geld, der Job, der Straßenname, ein Tacho mit Tank- und Gurtwarnung, Sprachreichweite und Funk sowie die aktuellen Tastenhinweise. Spieler stellen das Aussehen in einem Einstellungsmenü ein (Radialmenü, HUD). Bedürfnisse werden am Charakter gespeichert und auch von QB-Skripten gelesen.
ai-chat
Chat mit Kanälen (alle, in der Nähe, Job), Befehlsvorschläge nur für die Befehle, die ein Spieler nutzen darf, Farbcodes und die FiveM-chat-API für andere Skripte. /ooc und /me (eine Aktion über deinem Kopf) erreichen die Spieler um dich herum.
ai-voice
Sprachchat nach Nähe mit Reichweiten, Funkkanäle (Job-Kanäle auf den Job beschränkt), Telefonate, sowohl auf FiveM Legacy (Mumble) als auch auf FiveM for GTA V Enhanced. Ersetzt pma-voice.
ai-radialmenu
Das Radialmenü (F3): eingebaute Aktionen, Fahrzeugaktionen und die Einträge, die andere Skripte hinzufügen (Polizeimenü, Haftzeit, HUD-Einstellungen, Tastenliste...).
ai-target
Markierungen auf dem, womit du interagieren kannst (der Target-Stil). Skripte wählen nichts: Der Betreiber wählt im Panel prompt oder target, und die Orte jedes Skripts folgen. Beantwortet die ox_target-API.
ai-scoreboard
Halte Pos1 (oder drücke sie zum Öffnen und Schließen, im Panel wählbar): Spieler online, Anzahl im Dienst pro Job und, wenn du es erlaubst, Namen und IDs.
ai-weathersync
Zeit und Wetter für alle gleich: Uhrgeschwindigkeit, Startstunde, eingefrorene Zeit, Wetterzyklus und Blackout im Panel, Wetterregionen. In Innenräumen pausieren Skripte die Synchronisierung über AI Core, egal welches Wetter-Skript du nutzt.