Kompatibilität
Wie AI Core ESX-, QBCore-, Qbox- und vRP-Skripte ausführt und Ressourcen von Drittanbietern anbindet.
Fast jedes FiveM-Skript ist für ESX, QBCore, Qbox oder vRP geschrieben, deshalb ist es ein Hauptziel, sie auszuführen. AI Core liefert keine Skripte von Drittanbietern mit und bevorzugt keinen Anbieter: Du installierst deine eigenen.
Drei Ebenen
Framework-Brücke
AI Core stellt es_extended, qb-core und qbx_core bereit und beantwortet ihre Exports, Core-Objekte, Spielerobjekte, Callbacks, Events und Datei-Includes (@qb-core/shared/locale.lua, @es_extended/imports.lua, @qbx_core/modules/playerdata.lua), sodass für ESX, QBCore oder Qbox geschriebene Skripte AI Core als ihr Framework sehen und unverändert laufen. Für vRP-Skripte stellt AI Core auch vrp bereit (siehe vRP-Skripte unten). Ihre Menüs, Textaufforderungen, Fortschrittsbalken und Eingabedialoge werden mit der eigenen UI von AI Core gezeichnet.
Integrationsebenen
AI Core und die ai-*-Skripte brauchen Dinge, die andere Skripte bereitstellen. Jede Kategorie hat eine Schnittstelle, und jedes unterstützte Skript ist ein Adapter. AI Core erkennt das installierte Skript beim Start und wenn Skripte starten oder stoppen; das Admin-Panel kann die Wahl überschreiben.
| Kategorie | Beispiele |
|---|---|
| Inventar | ai-inventory, ox_inventory, qb-inventory, tgiann-inventory und mehr |
| Fahrzeugschlüssel | ai-vehiclekeys, qbx_vehiclekeys und andere |
| Dispatch (Polizeialarme) | ai-policealert und Alarm-Skripte |
| Handy | tgiann-phone, lb-phone |
| Kleidung | ai-appearance, tgiann-clothing |
| Tod | ai-death, qbx_medical, qb-ambulancejob, esx_ambulancejob, ars_ambulancejob |
| Wetter und Zeit | ai-weathersync, qb-weathersync, Renewed-Weathersync, cd_easytime |
| Gefängnis | ai-prison, qb-prison |
| Radialmenü | ai-radialmenu, qb-radialmenu, ox_lib |
Stellvertreter
Mehrere ai-*-Skripte beantworten die API des Skripts, das sie ersetzen, sodass Skripte von Drittanbietern ohne Adapter mit ihnen funktionieren: ai-mysql ersetzt oxmysql (auch mysql-async und ghmattimysql), ai-inventory ersetzt ox_inventory und qb-inventory, ai-target ox_target, ai-voice pma-voice, ai-chat chat, ai-vehicles und ai-vehiclekeys die Qbox-Fahrzeugskripte.
In der Liste der kompatiblen Skripte siehst du, womit AI Core heute zusammenarbeitet.
vRP-Skripte
AI Core stellt auch vrp bereit, sodass für das vRP-Framework geschriebene Skripte es finden und mit den Charakteren, dem Geld, den Jobs, Gangs und dem Inventar von AI Core laufen. Es gibt keine Einstellung: Jede Version unten wird gleichzeitig beantwortet, und AI Core erkennt sie an der Art, wie sie es aufrufen.
| vRP-Version | Was läuft |
|---|---|
| vRP 1.0 | Skripte, die Proxy / Tunnel mit vRP.* und vRPclient.* nutzen: Benutzer, Geld, Gruppen und Berechtigungen, Inventar und Truhen, Identität, Hunger und Durst, Menüs, Texteingaben, Benachrichtigungen, Blips und Marker. |
| vRPex, Zirix, Dunko | Dasselbe, dazu die zusätzlichen Funktionen dieser vRP-1-Forks (format, hasPermissions, tryBankPayment und weitere). |
| Der alte Aufrufstil von vRP 0.5 | Aufrufe, die ihre Argumente in einer Tabelle mit einem Callback übergeben, etwa vRP.getUserId({source}). |
| vRP 2 und vRP 3 | Erweiterungen (Extensions), die ein Skript mit vRP.loadScript lädt. Jede läuft in ihrer eigenen Sandbox in AI Core: Ihre Globals berühren nie ein anderes Skript, und alles, was sie registriert hat, wird entfernt, wenn ihre Ressource stoppt. |
Menüs, Texteingaben und Ja-/Nein-Abfragen von vRP-Skripten werden mit dem eigenen Menü und den Dialogen von AI Core gezeichnet. Fügt ein Skript dem vRP-Hauptmenü Einträge hinzu, öffnen Spieler es mit F7; die Taste änderst du im Admin-Panel unter Keybinds.
AI Core wurde auf einem laufenden Server mit sieben öffentlichen vRP-Skripten getestet: vrp_basic_mission, vrp_chests, vrp_blips, self_storages, vrp_drugfarms, vrp_worlditems und party_system.
Ein vRP-Skript installieren
Das originale vRP entfernen
AI Core ist jetzt deine vrp-Ressource, also muss das Original weg. Hat dein Server einen vrp-Ordner oder einen vRP-Datenbanktreiber (vrp_mysql, vrp_oxmysql, vrp_ghmattimysql, vRP-db-drivers), lösche den Ordner und seine ensure-Zeile in der server.cfg. Solange einer davon noch da ist, lehnt AI Core Verbindungen ab und nennt den Ordner, der gelöscht werden muss.
Das Skript hinzufügen
Lege den Ordner des Skripts in resources/[standalone]/ und füge ensure <Ordnername> in der server.cfg unter den ensure ai-*-Zeilen hinzu, wie bei jedem anderen Skript. Bearbeite das Skript nicht: Seine vrp-Abhängigkeit und sein Include @vrp/lib/utils.lua erreichen AI Core von selbst.
Starten und Berechtigungen vergeben
Starte den Server neu und probiere die Funktionen des Skripts im Spiel aus. Öffne dann das Admin-Panel (F10) und den Tab vRP scripts von AI Core: Asked permissions listet jeden Berechtigungsnamen, nach dem das Skript gefragt hat. Lege fest, wer welche bekommt, wie im nächsten Abschnitt erklärt.
Der Tab vRP scripts
vRP-Skripte fragen nicht „ist dieser Spieler Polizist?“. Sie fragen nach Berechtigungsnamen (police.service), Gruppennamen (police, vip) und Item-IDs (edible|tacos). Der Tab vRP scripts im AI-Core-Teil des Admin-Panels legt fest, was diese Namen auf deinem Server bedeuten. Jede Änderung wird sofort gespeichert, ohne Neustart. Der Tab hat fünf Karten:
Built-in rules (eingebaute Regeln)
Diese drei Schalter beantworten jeden Berechtigungsnamen, den keine Regel nennt, sodass viele Skripte schon funktionieren, bevor du eine einzige Regel anlegst:
- Job permissions go to the job: Eine Berechtigung, die mit dem Namen eines Jobs beginnt, etwa
police.service, geht an die Mitglieder dieses Jobs. Ist Only while on duty an, haben sie sie nur im Dienst. - admin. permissions go to admins: Eine Berechtigung, die mit
admin.beginnt, etwaadmin.tickets, geht an Spieler mit Adminrechten (ACEai.admin). - player. permissions go to everyone: Eine Berechtigung, die mit
player.beginnt, etwaplayer.phone, geht an jeden Spieler.
Asked permissions (abgefragte Berechtigungen)
Jeder Berechtigungsname, nach dem deine Skripte gefragt haben, mit einem Suchfeld. Drücke Add rule neben einem Namen, und eine Regel dafür erscheint oben in Permission rules. Eine neue Regel gibt die Berechtigung nur Admins, bis du auswählst, wer sie haben soll.
Permission rules (Berechtigungsregeln)
Eine Zeile pro Regel. Schreibe in Permission name die Berechtigung (police.service) oder einen Namen, der auf * endet (police.*), um jede Berechtigung abzudecken, die damit beginnt. Wähle in Who has it eines davon:
- Members of a job: Wähle den Job und den Lowest grade (dieser Rang und jeder darüber). Schalte Only on duty ein, wenn sie sie nur im Dienst haben sollen.
- Members of a gang: Wähle die Gang und den niedrigsten Rang.
- Characters in a group: Schreibe einen Gruppennamen, den Skripte vergeben (siehe Group names).
- Admins oder Everyone.
Mehrere Regeln dürfen dieselbe Berechtigung nennen: Wer auf eine davon passt, hat sie. Sobald eine Regel eine Berechtigung nennt, zählen die eingebauten Regeln für sie nicht mehr. Das Panel lehnt einen Rang ab, den der Job oder die Gang nicht hat.
Group names (Gruppennamen)
vRP-Skripte vergeben und prüfen Gruppen über ihren Namen. Der eigene Name eines Jobs oder einer Gang (police, ballas) funktioniert ohne Zeile. Für jeden anderen Namen, den ein Skript nutzt (Coronel, sheriff), fügst du eine Zeile hinzu: Schreibe ihn in Group name und wähle unter Means, was er bedeutet:
- A job grade oder A gang grade: Vergibt ein Skript diese Gruppe, bekommt der Charakter diesen Job oder diese Gang mit diesem Rang; prüft ein Skript sie, lautet die Antwort Ja für diesen Rang und jeden darüber.
- Admins: Die Prüfung antwortet Ja für Spieler mit Adminrechten. Ein Skript kann niemanden zum Admin machen: Das Vergeben dieser Gruppe wird abgelehnt.
Ein Name ohne Zeile bleibt eine eigene Gruppe, die mit dem Charakter gespeichert wird.
Item names (Item-Namen)
Verknüpfe eine Item-ID, die ein Skript nutzt (Name scripts use, etwa edible|tacos), mit einem Item deines Inventars (Inventory item, aus der Liste gewählt). Eine ID, die schon der Name eines deiner Items ist, braucht keine Zeile. Ohne Zeile bedeutet wbody|WEAPON_X das Waffen-Item und jede andere a|b-ID bedeutet b.
Beispiel: Ein Polizeiskript fragt nach police.service, aber dein Polizeijob heißt lspd. Lege eine Berechtigungsregel mit dem Namen police.service an, Members of a job, Job lspd, niedrigster Rang 0 und Only on duty an. Jetzt hat jeder Polizist im Dienst die Berechtigung.
Was mit vRP nicht funktioniert
- Creative v5. Seine API (PascalCase-Namen,
@vrp/lib/Utils.lua,@vrp/config/*.lua) ist anders und wird nicht beantwortet. - SQL auf vRPs eigenen Tabellen. AI Core hält seine eigenen Daten, deshalb findet ein Skript nichts, das
vrp_users,vrp_user_identities,vrp_user_data,vrp_srv_dataoder ähnliche Tabellen mit eigenen Abfragen liest oder schreibt. - vRP-Module, die AI Core nicht hat: Telefonverzeichnis, Häuser, Geschäfte, eigene Fahrzeuge und Garagen, Fähigkeiten (Aptitudes), Polizeiakten und Gefängnis, Shops, Item-Umwandler, Geldautomaten, Audio und Funk, Fortschrittsbalken, Bans und Whitelist sowie die Missionen von vRP 1 (Missionen von vRP 2 / 3 funktionieren). Ein Skript, das sie nutzt, verliert diesen Teil.
- Menüs haben kein Links / Rechts. Optionen, die einen Wert mit den Pfeiltasten ändern, nehmen nur eine einfache Auswahl an.
vRP:playerSpawnfeuert einmal pro geladenem Charakter, nicht nach einem Respawn: Respawns gehören zum Todesskript.vrpgilt immer als gestartet. Ein Skript, das mehrere Frameworks unterstützt und zuerst vRP prüft, nimmt seinen vRP-Code. Willst du seinen ESX- oder QBCore-Code, wähle dieses Framework in der Konfiguration des Skripts.- Eine Erweiterung von vRP 2 / 3 läuft in AI Core, deshalb erscheint ihre CPU-Zeit in
resmonunterai-core. Schlägt sie fehl, schreibt die Konsole eine Zeile mit ihrer Datei, und AI Core läuft weiter.
Ein ai-*-Skript ersetzen
Wenn du ein kostenpflichtiges Skript installierst, das ein ai-*-Skript ersetzt (zum Beispiel ein anderes Inventar), sagt dir AI Core, welchen Ordner du löschen sollst, und lässt keine Spieler beitreten, solange beide laufen, damit nie zwei Skripte um dieselbe Aufgabe kämpfen.
Ein Skript hinzufügen
Ein neues Skript zu unterstützen ist eine kleine, wiederholbare Aufgabe: die Adaptervorlage der Kategorie kopieren, ihre Aufrufe ausfüllen, eine Zeile in der Registry ergänzen. Du kannst deine KI darum bitten.