ai-core
Das Framework. Spieler und Charaktere, der Charakterbildschirm, Geld, Jobs und Gangs, Berechtigungen, das Admin-Panel und die Brücke zu ESX, QBCore, Qbox und vRP.
ai-core ist AI Core selbst: das Framework, auf dem jedes andere Skript aufbaut. Es weiß, wer spielt, welchen Charakter er gewählt hat, wie viel Geld er hat, zu welchen Jobs und Gangs er gehört und wer Admin ist. Es beherbergt das Admin-Panel für jedes Skript und lässt Skripte für ESX, QBCore, Qbox und vRP unverändert laufen.
Diese Seite ist eine Übersicht. Das Admin-Panel selbst wird unter Admin-Panel beschrieben.
Spieler und Charaktere
- Konten. Ein Spieler wird über sein FiveM-Konto erkannt (der Identifier
fivem:). Eine Verbindung ohne dieses Konto wird abgelehnt. License- und Discord-IDs werden daneben gespeichert, für Skripte, die sie lesen. - Mehrere Charaktere pro Konto (standardmäßig 3 Plätze). Spieler können Charaktere löschen, sofern du das nicht abschaltest.
- Charakterbildschirm. Die Charaktere des Spielers stehen in einer echten Szene der Stadt, jeder in seiner eigenen Kleidung; die Kamera gleitet zu dem gewählten. Dein Servername, Untertitel und Slogan erscheinen darauf.
- Einen Charakter erstellen fragt nach Vor- und Nachname, Geburtsdatum (standardmäßig mindestens 18 Jahre), Geschlecht und Nationalität. Ein neuer Charakter durchläuft danach den Kleidungseditor (ai-appearance oder ein anderes Kleidungsskript).
- Wo man erscheint. Ein neuer Charakter erscheint am Punkt First spawn. Optional zeigt eine Liste nach der Charakterwahl den letzten Ort und die Orte, die du festlegst.
- Speichern. Geld und Mitgliedschaften werden sofort gespeichert. Position, Rüstung und andere kleine Änderungen werden alle 5 Minuten (Panel) gespeichert, beim Ausloggen, beim Stoppen der Ressource und beim Herunterfahren durch txAdmin.
- PvP. Ein Schalter entscheidet, ob Spieler einander verletzen können (standardmäßig an); Admins schalten ihn im Spiel mit
/togglepvpum.
Geld
- Standardmäßig die Konten Cash (Bargeld, 500 zum Start), Bank (5000), Dirty money (Schwarzgeld) und Crypto. Du fügst Konten im Panel hinzu, benennst sie um oder entfernst sie (Money accounts), jedes mit einem Startbetrag und der Angabe, ob es ins Minus gehen darf.
- Jobs und Gangs haben ebenfalls eigene Konten (Firmengeld).
- Jede Änderung wird mit einer Buchungszeile geschrieben: wer, wie viel, der Grund.
Jobs und Gangs
- Mehrere Jobs pro Charakter (standardmäßig 3, oder einer, wenn Several jobs per character aus ist) und mehrere Gangs (standardmäßig 2) mit einer aktiven Gang.
- Dienst. Ein Charakter ist höchstens für einen Job im Dienst. Gehalt kommt nur vom Job im Dienst. Spieler starten nach dem Beitreten außer Dienst, es sei denn, du schaltest Keep duty after rejoining ein.
- Gehaltszahlung. Alle 15 Minuten (Panel) bekommen Spieler im Dienst das Gehalt ihres Rangs auf ihr Bankkonto, bezahlt vom Server oder, wenn du willst, vom eigenen Konto des Jobs.
- Prime Time. Außerhalb der Stoßzeiten (standardmäßig 18:00 bis 01:00) sinken die Gehälter auf die Hälfte. Die Uhrzeiten, die Kürzung und der Schalter stehen im Panel; ein Job kann eigene Uhrzeiten haben.
- Jobs und Gangs selbst (Ränge, Gehälter, Chefränge) sind Datensätze in den Panel-Tabs Jobs und Gangs.
Berechtigungen
- Admins sind Spieler mit der ACE
ai.admin. Diepermission.cfgdes Rezepts gibt sie angroup.admin; füge einen Spieler mitadd_principal identifier.fivem:<id> group.adminhinzu. Auf einem neuen Server zeigt die Willkommenskarte die genaue Zeile. - Befehle, die mit der Lib von AI Core erstellt wurden, prüfen Berechtigungen auf dem Server: alle, Admins oder bestimmte ACEs und Gruppen. Der Panel-Tab Commands listet jeden Befehl mit der Angabe, wer ihn benutzen darf.
- Job- und Gang-Berechtigungen. ai-core spiegelt Mitgliedschaften auf ACE-Principals:
ai.job.<name>undai.job.<name>.<grade>(jeder Rang bis zu dem des Spielers), dasselbe für Gangs. So gibtadd_ace ai.job.police command.mdt allowjedem Polizisten einen Befehl.
Admin-Panel
ai-core beherbergt das Panel im Spiel (F10 oder /aiadmin) für sich selbst und für jedes ai-*-Skript. Seine eigenen Bereiche:
| Bereich | Was du einstellst |
|---|---|
| General | Servername, Untertitel, Slogan und Hintergrund; Charakterplätze, Löschen, Mindestalter; das Speicherintervall; welche Inventar-, Schlüssel-, Polizeialarm-, Kleidungs-, Sprit-, Türschloss-, Garagen-, Benachrichtigungs-, Rechnungs-, Bank-, MDT- und Sanitäterskripte AI Core nutzt (Automatic wählt das erste laufende); Interaktion per Prompt oder Target; PvP; Update-Prüfungen; Spieler abweisen, solange ein unnötiges Skript läuft; die Einrichtungshilfe. |
| Spawn points | Der erste Spawn und die Orte, aus denen Spieler wählen dürfen. |
| Character screen | Die Szene hinter dem Charakterbildschirm: Kamera, Uhrzeit und Wetter, die Stellen, an denen Charaktere stehen. |
| Job and gang rules | Wie viele Jobs und Gangs, Dienst nach dem erneuten Beitreten, die Gehaltszahlung, Prime Time. |
| Jobs, Gangs | Jeder Job und jede Gang mit Rängen, Gehältern und Chefrängen. |
| Money accounts | Die Geldarten und womit ein neuer Charakter startet. |
| Keybinds | Die Tasten jedes Skripts: die Standardtaste für alle und ob das HUD sie als Hinweis anzeigt. |
| Commands | Jeder Befehl auf dem Server mit seinen Argumenten und der Angabe, wer ihn benutzen darf. |
| Other panels | Einstellungsbildschirme anderer Skripte, geöffnet vom Dashboard aus. |
| vRP scripts | Wer die Berechtigungen, Gruppen und Items bekommt, nach denen vRP-Skripte fragen. |
| Logs | Konsole, Discord, Fivemanage und FiveM Stats, Stufen, Webhooks. |
Außerdem prüft es jedes Skript mit einem GitHub-Repository auf Updates (alle 6 Stunden pro Skript) und empfiehlt auf dem Dashboard kostenlose Skripte, die sich zu installieren lohnen.
Die Brücke (ESX, QBCore, Qbox, vRP)
ai-core providet es_extended, qb-core, qbx_core und vrp und beantwortet ihre Exports, Core-Objekte und Events. Skripte, die für diese Frameworks geschrieben wurden, sehen AI Core als ihr Framework: ESX.GetPlayerFromId, QBCore.Functions.GetPlayer, exports.qbx_core:GetPlayer und Aufrufe von vRP 1, 2 und 3 funktionieren alle mit den Spielern, dem Geld und den Jobs von AI Core.
Außerdem zeichnet es die UI-Ressourcen der Frameworks mit den eigenen Menüs und Karten von AI Core: esx_context, esx_textui, esx_notify, esx_progressbar, esx_menu_default, esx_menu_dialog, esx_menu_list, qb-menu, qb-input und progressbar. Entferne diese Ressourcen: ai-core beantwortet ihre Namen. Siehe Kompatibilität.
Layer: ein Ort für jede Art von Skript
Items, Fahrzeugschlüssel, Polizeialarme, Kleidung, Tode und Wiederbelebungen, Gefängnis, Sprit, Türschlösser, Garagen, Zeit und Wetter, Rechnungen, Banken, Telefone, das Radialmenü, das HUD und Benachrichtigungen laufen alle über ai-core. Ein Skript fragt ai-core („gib dieses Item“), und ai-core ruft das Skript auf, das du für diese Aufgabe nutzt. Deshalb kannst du fast jedes ai-*-Skript gegen ein Drittanbieter-Skript tauschen, und deshalb sagt dir ai-core in der Konsole, wenn zwei Skripte für dieselbe Aufgabe gleichzeitig laufen.
Installation
Das txAdmin-Rezept von AI Core installiert es. Von Hand: Lege den Ordner in resources/[ai]/ und füge ensure ai-core in der server.cfg nach ensure ai-mysql und vor jedem anderen ai-*-Skript ein. Es braucht OneSync und die Datenbank:
add_convar_permission ai-core read mysql_connection_stringSeine Tabellen (ai_core_users, ai_core_characters, ai_core_accounts, ai_core_transactions, ai_core_character_jobs, ai_core_character_gangs, ai_core_bills, ai_core_vrp_data) werden beim ersten Start angelegt. Installiere es_extended, qb-core oder qbx_core nicht daneben. Behalte set resources_useSystemChat false.
Befehle
| Befehl | Argumente | Wer | Was er macht |
|---|---|---|---|
/aiadmin | keine | Admins | Öffnet das Admin-Panel. |
/togglepvp | keine | Admins | Schaltet Schaden zwischen Spielern an oder aus (speichert die Panel-Einstellung). |
aicore_switch | [id] | Admins | Schickt einen Spieler (Standard: dich) zurück zum Charakterbildschirm. |
aicore_job | <job> <grade> [id] | Admins | Gibt einen Job mit einem Rang. |
aicore_duty | <job | off> [id] | Admins | Setzt einen Spieler in einem Job in den Dienst oder außer Dienst. |
aicore_money | <account> <amount> [id] | Admins | Fügt einem Konto etwas hinzu (ein negativer Betrag zieht ab). |
aicore_gang | <gang> <grade> [id] | Admins | Gibt eine Gang mit einem Rang. |
aicore_db | [slow] | Admins | Datenbankstatistiken jeder Ressource in der Serverkonsole; slow listet die letzten langsamen Abfragen. |
aicore_alert | [high] | Admins | Sendet über das aktive Alarmskript einen Test-Polizeialarm an deiner Position. |
Die aicore_*-Befehle sind Testwerkzeuge: Sie antworten in der Serverkonsole. Die bekannten Admin-Befehle von QB / ESX (setjob, givemoney...) kommen mit ai-admin.
Tastenbelegungen
| Standardtaste | Was sie macht | Name in den GTA-Einstellungen |
|---|---|---|
| F10 | Öffnet das Admin-Panel (nur Admins) | Open the admin panel |
Bekannte Grenzen
- Spieler brauchen ein verknüpftes FiveM-Konto (der Identifier
fivem:); Spieler ohne eines können nicht beitreten. - Ein Skript, dessen Ersatz gleichzeitig läuft (tgiann-inventory neben ai-inventory), hält alle draußen, solange beide laufen, wenn Refuse players while both run an ist (Standard). Die Konsole nennt den Ordner, der gelöscht werden muss.