Podstawy
Framework i skrypty, których potrzebuje każdy serwer - postacie, baza danych, ekwipunek, HUD, czat, głos i więcej.
ai-core
Sam framework.
- Konta i postacie. Gracze są rozpoznawani po koncie FiveM. Kilka postaci na konto, ustawiane w panelu; usuwanie można wyłączyć.
- Ekran postaci. Postacie stoją w prawdziwej scenie miasta (każda we własnym wyglądzie); kamera płynnie przesuwa się do wybranej. Tworzenie postaci pyta o imię i nazwisko, datę urodzenia, płeć i narodowość.
- Wybór miejsca pojawienia się. Opcjonalnie: po wybraniu postaci nad sceną pojawia się lista miejsc (ostatnia pozycja i miejsca, które ustawisz).
- Pieniądze. Domyślnie gotówka, bank, brudne pieniądze i krypto, więcej kont w panelu. Każda zmiana jest zapisywana z wierszem w księdze; konta prac i gangów także.
- Prace i gangi. Kilka prac i gangów na postać (limity w panelu), jedna praca na służbie naraz, wypłata tylko z pracy na służbie. Godziny szczytu są domyślnie włączone: poza nimi (domyślnie od 18:00 do 01:00) wypłata spada o połowę; godziny, obniżka i przełącznik są w panelu.
- PvP. To, czy gracze mogą się nawzajem ranić, to jedno ustawienie (General, domyślnie włączone); administratorzy przełączają je w grze komendą
/togglepvp. - Panel administratora do wszystkiego (zobacz Panel administratora), logi do konsoli, na Discorda, do Fivemanage lub FiveM Stats, sprawdzanie aktualizacji każdego skryptu, polecane skrypty.
- Wspólne UI, którego używa każdy skrypt: powiadomienia, pasek postępu (jeden klawisz anulowania dla wszystkich), menu, okna wprowadzania, podpowiedzi klawiszy na HUD, wybierak przedmiotów dla administratorów.
- Ekran klawiszy. Pozycja Klawisze w menu radialnym pokazuje klawiaturę z każdym używanym klawiszem (z własnymi przypisaniami gracza), wyszukiwanie po akcjach i to, co robi klawisz pod kursorem.
- Most. Skrypty ESX, QBCore i Qbox działają na AI Core bez zmian (zobacz Zgodność).
ai-mysql
Silnik bazy danych. Każdy skrypt ai-* ma własną małą pulę połączeń; ai-mysql zastępuje też oxmysql, mysql-async i ghmattimysql, więc skrypty zewnętrzne dalej działają. Nie instaluj obok niego oxmysql. Każdy skrypt sam tworzy i aktualizuje swoje tabele przy starcie.
ai-lib
Wspólne UI gracza, którego używa każdy skrypt: karty powiadomień, pasek postępu z klawiszem anulowania, podpowiedzi po prawej i klawisz interakcji, menu, okna wprowadzania oraz minigry otwierania zamka wytrychem i testu umiejętności. Działa bez ai-core, więc inne zasoby mogą używać go samodzielnie. Zawiera też funkcje pomocnicze AI Core dla zasobów, które ich nie dołączają: zasoby Lua dodają shared_script '@ai-lib/init.lua' i używają aiLib.notify, aiLib.Points, aiLib.addCommand, aiLib.progress i innych; zasoby JavaScript wczytują @ai-lib/dist/client.js lub server.js. Zobacz lib.
ai-loading
Ekran ładowania: nazwa serwera, podtytuł i hasło z ustawień ogólnych, obraz tła, postęp ładowania i wskazówki, które piszesz w panelu. Zamyka się sam, gdy ekran postaci jest gotowy.
ai-appearance
Kreator postaci dla nowych postaci (w prywatnym pokoju), sklepy z ubraniami i fryzjerzy w miejscach, które ustawisz, stroje, ceny dla każdego sklepu. To z niego pochodzą portrety na ekranie postaci.
ai-inventory
Ekwipunek z siatką, wagą i slotami, osobny pasek skrótów, przedmioty upuszczone na ziemię, schowki, bagażniki i schowki na rękawiczki (bagażnik posiadanego pojazdu zostaje z pojazdem, niezależnie od tablicy, jaką ma), sklepy (z NPC i ograniczeniem do prac), stoły do wytwarzania z przepisami, broń jako przedmioty, rzadkości z kolorami i postać narysowana obok ekwipunku. Odpowiada na API ox_inventory i qb-inventory.
ai-hud
Zdrowie, pancerz, głód, pragnienie i stres, pieniądze, praca, nazwa ulicy, prędkościomierz z paliwem i ostrzeżeniem o pasach, zasięg głosu i radio oraz bieżące podpowiedzi klawiszy. Gracze ustawiają jego wygląd w menu ustawień (menu radialne, HUD). Potrzeby są zapisywane na postaci i czytają je także skrypty QB.
ai-chat
Czat z kanałami (wszyscy, w pobliżu, praca), podpowiedzi tylko tych komend, których gracz może używać, kody kolorów i API chat FiveM dla innych skryptów. /ooc i /me (czynność nad głową) docierają do graczy w pobliżu.
ai-voice
Głos zbliżeniowy z zasięgami, kanały radiowe (kanały prac zablokowane dla danej pracy), rozmowy telefoniczne, zarówno na FiveM Legacy (Mumble), jak i na FiveM for GTA V Enhanced. Zastępuje pma-voice.
ai-radialmenu
Menu radialne (F3): wbudowane akcje, akcje pojazdu i pozycje dodawane przez inne skrypty (menu policji, czas wyroku, ustawienia HUD, lista klawiszy...).
ai-target
Znaczniki na tym, z czym możesz wejść w interakcję (styl target). Skrypty niczego nie wybierają: właściciel wybiera w panelu prompt lub target, a miejsca każdego skryptu się dostosowują. Odpowiada na API ox_target.
ai-scoreboard
Przytrzymaj Home (albo naciśnij, by otworzyć i zamknąć, do wyboru w panelu): gracze online, liczba osób na służbie w każdej pracy oraz, jeśli na to pozwolisz, nazwy i id.
ai-weathersync
Czas i pogoda takie same dla wszystkich: szybkość zegara, godzina startowa, zatrzymany czas, cykl pogody i blackout w panelu, regiony pogodowe. We wnętrzach skrypty wstrzymują synchronizację przez AI Core, niezależnie od używanego skryptu pogody.