AI Core

Zgodność

Jak AI Core uruchamia skrypty ESX, QBCore, Qbox i vRP i łączy się z zasobami zewnętrznymi.

Prawie każdy skrypt FiveM jest napisany dla ESX, QBCore, Qbox lub vRP, więc ich uruchamianie to główny cel. AI Core nie dołącza żadnych skryptów zewnętrznych i nie faworyzuje żadnego dostawcy: instalujesz własne.

Trzy warstwy

Most frameworków

AI Core udostępnia es_extended, qb-core i qbx_core i odpowiada na ich eksporty, obiekty core, obiekty graczy, callbacki, zdarzenia i dołączane pliki (@qb-core/shared/locale.lua, @es_extended/imports.lua, @qbx_core/modules/playerdata.lua), więc skrypty napisane dla ESX, QBCore lub Qbox widzą AI Core jako swój framework i działają bez zmian. Dla skryptów vRP AI Core udostępnia też vrp (zobacz Skrypty vRP niżej). Ich menu, podpowiedzi tekstowe, paski postępu i okna wprowadzania są rysowane własnym UI AI Core.

Warstwy integracji

AI Core i skrypty ai-* potrzebują rzeczy, które dostarczają inne skrypty. Każda kategoria ma jeden interfejs, a każdy obsługiwany skrypt to jeden adapter. AI Core wykrywa zainstalowany skrypt przy starcie oraz gdy skrypty się uruchamiają lub zatrzymują; panel administratora może nadpisać ten wybór.

KategoriaPrzykłady
Ekwipunekai-inventory, ox_inventory, qb-inventory, tgiann-inventory i inne
Klucze pojazdówai-vehiclekeys, qbx_vehiclekeys i inne
Dispatch (alerty policyjne)ai-policealert i skrypty alertów
Telefontgiann-phone, lb-phone
Ubraniaai-appearance, tgiann-clothing
Śmierćai-death, qbx_medical, qb-ambulancejob, esx_ambulancejob, ars_ambulancejob
Pogoda i czasai-weathersync, qb-weathersync, Renewed-Weathersync, cd_easytime
Więzienieai-prison, qb-prison
Menu radialneai-radialmenu, qb-radialmenu, ox_lib

Zamienniki

Kilka skryptów ai-* odpowiada na API skryptu, który zastępuje, więc skrypty zewnętrzne działają z nimi bez adaptera: ai-mysql zastępuje oxmysql (także mysql-async i ghmattimysql), ai-inventory zastępuje ox_inventory i qb-inventory, ai-target ox_target, ai-voice pma-voice, ai-chat chat, a ai-vehicles i ai-vehiclekeys skrypty pojazdów Qbox.

Na liście zgodnych skryptów zobaczysz, z czym AI Core integruje się dziś.

Skrypty vRP

AI Core udostępnia też vrp, więc skrypty napisane dla frameworka vRP go znajdują i działają na postaciach, pieniądzach, pracach, gangach i ekwipunku AI Core. Nie ma żadnego ustawienia: wszystkie wersje poniżej są obsługiwane jednocześnie, a AI Core rozpoznaje je po sposobie, w jaki go wywołują.

Wersja vRPCo działa
vRP 1.0Skrypty, które używają Proxy / Tunnel z vRP.* i vRPclient.*: użytkownicy, pieniądze, grupy i uprawnienia, ekwipunek i skrzynie, tożsamość, głód i pragnienie, menu, podpowiedzi tekstowe, powiadomienia, blipy i znaczniki.
vRPex, Zirix, DunkoTo samo, plus dodatkowe funkcje tych forków vRP 1 (format, hasPermissions, tryBankPayment i inne).
Stary styl wywołań vRP 0.5Wywołania, które przekazują argumenty w tabeli z callbackiem, np. vRP.getUserId({source}).
vRP 2 i vRP 3Rozszerzenia (extensions), które skrypt ładuje przez vRP.loadScript. Każde działa we własnym sandboksie wewnątrz AI Core: jego zmienne globalne nigdy nie dotykają innego skryptu, a wszystko, co zarejestrowało, jest usuwane, gdy jego zasób się zatrzyma.

Menu, podpowiedzi tekstowe i pytania tak / nie skryptów vRP są rysowane własnym menu i oknami AI Core. Gdy skrypt dodaje pozycje do głównego menu vRP, gracze otwierają je klawiszem F7; klawisz zmienisz w Keybinds w panelu admina.

AI Core przetestowano na działającym serwerze z siedmioma publicznymi skryptami vRP: vrp_basic_mission, vrp_chests, vrp_blips, self_storages, vrp_drugfarms, vrp_worlditems i party_system.

Instalacja skryptu vRP

Usuń oryginalne vRP

AI Core jest teraz twoim zasobem vrp, więc oryginał musi zniknąć. Jeśli twój serwer ma folder vrp albo sterownik bazy danych vRP (vrp_mysql, vrp_oxmysql, vrp_ghmattimysql, vRP-db-drivers), usuń folder i jego linię ensure w server.cfg. Dopóki któryś z nich tam jest, AI Core odrzuca połączenia i podaje folder do usunięcia.

Dodaj skrypt

Wrzuć folder skryptu do resources/[standalone]/ i dodaj ensure <nazwa folderu> do server.cfg pod liniami ensure ai-*, jak przy każdym innym skrypcie. Nie edytuj skryptu: jego zależność vrp i dołączany plik @vrp/lib/utils.lua same trafiają do AI Core.

Uruchom go i rozdaj jego uprawnienia

Zrestartuj serwer i wypróbuj funkcje skryptu w grze. Potem otwórz panel admina (F10) i zakładkę vRP scripts AI Core: Asked permissions pokazuje każdą nazwę uprawnienia, o którą pytał skrypt. Zdecyduj, kto dostaje każde z nich, jak wyjaśnia następna sekcja.

Zakładka vRP scripts

Skrypty vRP nie pytają „czy ten gracz jest policjantem?”. Pytają o nazwy uprawnień (police.service), nazwy grup (police, vip) i identyfikatory przedmiotów (edible|tacos). Zakładka vRP scripts w części AI Core panelu admina decyduje, co te nazwy znaczą na twoim serwerze. Każda zmiana zapisuje się od razu, bez restartu. Zakładka ma pięć kart:

Built-in rules (wbudowane reguły)

Te trzy przełączniki odpowiadają na każdą nazwę uprawnienia, której nie wymienia żadna reguła, więc wiele skryptów działa, zanim dodasz choć jedną regułę:

  • Job permissions go to the job: uprawnienie zaczynające się od nazwy pracy, np. police.service, trafia do członków tej pracy. Z włączonym Only while on duty mają je tylko na służbie.
  • admin. permissions go to admins: uprawnienie zaczynające się od admin., np. admin.tickets, trafia do graczy z prawami admina (ACE ai.admin).
  • player. permissions go to everyone: uprawnienie zaczynające się od player., np. player.phone, trafia do każdego gracza.

Asked permissions (zapytane uprawnienia)

Każda nazwa uprawnienia, o którą pytały twoje skrypty, z polem wyszukiwania. Naciśnij Add rule obok nazwy, a reguła dla niej pojawi się na górze Permission rules. Nowa reguła daje uprawnienie tylko adminom, dopóki nie wybierzesz, kto ma je mieć.

Permission rules (reguły uprawnień)

Jeden wiersz na regułę. W Permission name wpisz uprawnienie (police.service) albo nazwę kończącą się na * (police.*), by objąć każde uprawnienie, które tak się zaczyna. W Who has it wybierz jedno:

  • Members of a job: wybierz pracę i Lowest grade (ten stopień i każdy wyższy). Włącz Only on duty, jeśli mają je mieć tylko na służbie.
  • Members of a gang: wybierz gang i najniższy stopień.
  • Characters in a group: wpisz nazwę grupy, którą nadają skrypty (zobacz Group names).
  • Admins albo Everyone.

Kilka reguł może wymieniać to samo uprawnienie: ma je każdy, kto pasuje do którejkolwiek. Gdy tylko reguła wymienia uprawnienie, wbudowane reguły przestają się dla niego liczyć. Panel odrzuca stopień, którego praca albo gang nie mają.

Group names (nazwy grup)

Skrypty vRP nadają i sprawdzają grupy po nazwie. Własna nazwa pracy albo gangu (police, ballas) działa bez wiersza. Dla każdej innej nazwy, której używa skrypt (Coronel, sheriff), dodaj wiersz: wpisz ją w Group name i wybierz w Means, co znaczy:

  • A job grade albo A gang grade: gdy skrypt nadaje tę grupę, postać dostaje tę pracę albo ten gang na tym stopniu; gdy skrypt ją sprawdza, odpowiedź brzmi tak dla tego stopnia i każdego wyższego.
  • Admins: sprawdzenie odpowiada tak dla graczy z prawami admina. Skrypt nigdy nie zrobi nikogo adminem: nadanie tej grupy jest odrzucane.

Nazwa bez wiersza pozostaje osobną grupą, zapisaną razem z postacią.

Item names (nazwy przedmiotów)

Połącz identyfikator przedmiotu, którego używa skrypt (Name scripts use, np. edible|tacos), z przedmiotem twojego ekwipunku (Inventory item, wybranym z listy). Identyfikator, który już jest nazwą jednego z twoich przedmiotów, nie potrzebuje wiersza. Bez wiersza wbody|WEAPON_X oznacza przedmiot broni, a każdy inny identyfikator a|b oznacza b.

Przykład: skrypt policji pyta o police.service, ale twoja praca policji nazywa się lspd. Dodaj regułę uprawnienia z nazwą police.service, Members of a job, pracą lspd, najniższym stopniem 0 i włączonym Only on duty. Teraz każdy policjant na służbie ma to uprawnienie.

Co nie działa z vRP

  • Creative v5. Jego API (nazwy w PascalCase, @vrp/lib/Utils.lua, @vrp/config/*.lua) jest inne i nie jest obsługiwane.
  • SQL na własnych tabelach vRP. AI Core trzyma własne dane, więc skrypt, który własnymi zapytaniami czyta albo zapisuje vrp_users, vrp_user_identities, vrp_user_data, vrp_srv_data czy podobne tabele, nic nie znajdzie.
  • Moduły vRP, których AI Core nie ma: książka telefoniczna, domy, firmy, własne pojazdy i garaże, umiejętności (aptitudes), kartoteki policyjne i więzienie, sklepy, przetwórnie przedmiotów, bankomaty, audio i radio, paski postępu, bany i whitelista oraz misje vRP 1 (misje vRP 2 / 3 działają). Skrypt, który ich używa, traci tę część.
  • Menu nie mają lewo / prawo. Opcje zmieniające wartość strzałkami przyjmują tylko zwykły wybór.
  • vRP:playerSpawn odpala się raz na wczytanie postaci, nie po odrodzeniu: odrodzenia należą do skryptu śmierci.
  • vrp zawsze wygląda na uruchomiony. Skrypt, który obsługuje kilka frameworków i najpierw sprawdza vRP, używa swojego kodu vRP. Jeśli chcesz jego kodu ESX albo QBCore, wybierz ten framework w konfiguracji samego skryptu.
  • Rozszerzenie vRP 2 / 3 działa wewnątrz AI Core, więc jego czas CPU widać pod ai-core w resmon. Gdy się wywali, konsola wypisuje jedną linię z jego plikiem, a AI Core działa dalej.

Zastępowanie skryptu ai-*

Jeśli zainstalujesz płatny skrypt, który zastępuje jeden ze skryptów ai-* (na przykład inny ekwipunek), AI Core powie ci, który folder usunąć, i nie wpuszcza graczy, dopóki działają oba, więc dwa skrypty nigdy nie walczą o to samo zadanie.

Dodawanie skryptu

Obsługa nowego skryptu to jedno małe, powtarzalne zadanie: skopiuj szablon adaptera danej kategorii, uzupełnij jego wywołania, dodaj jedną linię do rejestru. Możesz poprosić o to swoje AI.

Na tej stronie