ai-core
Framework. Gracze i postacie, ekran postaci, pieniądze, prace i gangi, uprawnienia, panel administratora oraz most ESX, QBCore, Qbox i vRP.
ai-core to samo AI Core: framework, na którym opierają się wszystkie inne skrypty. Wie, kto gra, jaką postać wybrał, ile ma pieniędzy, do jakich prac i gangów należy i kto jest administratorem. Udostępnia panel administratora dla każdego skryptu i pozwala skryptom ESX, QBCore, Qbox i vRP działać bez zmian.
Ta strona to przegląd. Sam panel administratora jest opisany na stronie Panel administratora.
Gracze i postacie
- Konta. Gracz jest identyfikowany przez swoje konto FiveM (identyfikator
fivem:). Połączenie bez niego jest odrzucane. Identyfikatory licencji i Discorda są zapisywane obok dla skryptów, które je czytają. - Kilka postaci na konto (domyślnie 3 sloty). Gracze mogą usuwać postacie, chyba że to wyłączysz.
- Ekran postaci. Postacie gracza stoją w prawdziwej scenie miasta, każda we własnych ubraniach; kamera płynnie przesuwa się do wybranej. Widać na nim nazwę twojego serwera, podtytuł i hasło.
- Tworzenie postaci wymaga imienia i nazwiska, daty urodzenia (domyślnie minimalny wiek 18 lat), płci i narodowości. Nowa postać przechodzi potem przez kreator ubrań (ai-appearance lub inny skrypt ubrań).
- Gdzie się pojawić. Nowa postać pojawia się w punkcie First spawn. Opcjonalnie po wybraniu postaci lista pokazuje ostatnią lokalizację i ustawione przez ciebie miejsca.
- Zapisywanie. Pieniądze i członkostwa są zapisywane od razu. Pozycja, pancerz i inne drobne zmiany są zapisywane co 5 minut (panel), przy wylogowaniu, przy zatrzymaniu zasobu i przy wyłączeniu przez txAdmin.
- PvP. Jeden przełącznik decyduje, czy gracze mogą się nawzajem ranić (domyślnie włączone); administratorzy przełączają go w grze komendą
/togglepvp.
Pieniądze
- Domyślnie konta Cash (500 na start), Bank (5000), Dirty money i Crypto. Konta dodajesz, zmieniasz ich nazwy lub je usuwasz w panelu (Money accounts), każde z kwotą startową i informacją, czy może zejść poniżej zera.
- Prace i gangi też mają własne konta (pieniądze organizacji).
- Każda zmiana jest zapisywana jako wiersz w księdze: kto, ile, powód.
Prace i gangi
- Kilka prac na postać (domyślnie 3, albo jedna, gdy Several jobs per character jest wyłączone) i kilka gangów (domyślnie 2) z jednym aktywnym gangiem.
- Służba. Postać jest na służbie najwyżej w jednej pracy. Wypłata przychodzi tylko z pracy, w której jest na służbie. Gracze po dołączeniu zaczynają poza służbą, chyba że włączysz Keep duty after rejoining.
- Wypłata. Co 15 minut (panel) gracze na służbie dostają pensję swojej rangi na konto bankowe, wypłacaną przez serwer albo, jeśli tak wybierzesz, z własnego konta pracy.
- Prime time. Poza godzinami szczytu (domyślnie od 18:00 do 01:00) pensje spadają o połowę. Godziny, obniżka i przełącznik są w panelu; praca może mieć własne godziny.
- Same prace i gangi (rangi, pensje, rangi szefa) to rekordy w zakładkach Jobs i Gangs w panelu.
Uprawnienia
- Administratorzy to gracze z ACE
ai.admin.permission.cfgz przepisu nadaje jegroup.admin; dodaj gracza przezadd_principal identifier.fivem:<id> group.admin. Na nowym serwerze karta powitalna pokazuje dokładną linię. - Komendy tworzone biblioteką AI Core sprawdzają uprawnienia na serwerze: wszyscy, administratorzy albo określone ACE i grupy. Zakładka Commands w panelu wymienia każdą komendę i to, kto może jej używać.
- Uprawnienia prac i gangów. ai-core odwzorowuje członkostwa jako principale ACE:
ai.job.<name>iai.job.<name>.<grade>(każdy stopień do stopnia gracza), tak samo dla gangów. Dzięki temuadd_ace ai.job.police command.mdt allowdaje komendę każdemu funkcjonariuszowi.
Panel administratora
ai-core udostępnia panel w grze (F10 lub /aiadmin) dla siebie i dla każdego skryptu ai-*. Jego własne sekcje:
| Sekcja | Co ustawiasz |
|---|---|
| General | Nazwa serwera, podtytuł, hasło i tło; sloty postaci, usuwanie, minimalny wiek; odstęp zapisu; które skrypty ekwipunku, kluczy, alertów policyjnych, ubrań, paliwa, zamków drzwi, garaży, powiadomień, rachunków, banku, MDT i medyków używa AI Core (Automatic wybiera pierwszy działający); interakcja przez podpowiedź lub target; PvP; sprawdzanie aktualizacji; odrzucanie graczy, gdy działa niepotrzebny skrypt; przewodnik konfiguracji. |
| Spawn points | Pierwszy spawn i miejsca, z których gracze mogą wybierać. |
| Character screen | Scena za ekranem postaci: kamera, czas i pogoda, miejsca, w których stoją postacie. |
| Job and gang rules | Ile prac i gangów, służba po ponownym dołączeniu, wypłata, prime time. |
| Jobs, Gangs | Każda praca i gang z rangami, pensjami i rangami szefa. |
| Money accounts | Rodzaje pieniędzy i to, z czym zaczyna nowa postać. |
| Keybinds | Klawisze każdego skryptu: domyślny klawisz dla wszystkich i to, czy HUD pokazuje go jako podpowiedź. |
| Commands | Każda komenda na serwerze z argumentami i tym, kto może jej używać. |
| Other panels | Ekrany ustawień innych skryptów, otwierane z pulpitu. |
| vRP scripts | Kto dostaje uprawnienia, grupy i przedmioty, o które proszą skrypty vRP. |
| Logs | Konsola, Discord, Fivemanage i FiveM Stats, poziomy, webhooki. |
Sprawdza też aktualizacje każdego skryptu z repozytorium na GitHubie (raz na 6 godzin na skrypt) i poleca na pulpicie darmowe skrypty warte zainstalowania.
Most (ESX, QBCore, Qbox, vRP)
ai-core robi provide dla es_extended, qb-core, qbx_core i vrp i odpowiada na ich eksporty, obiekty core i zdarzenia. Skrypty napisane dla tych frameworków widzą AI Core jako swój framework: wywołania ESX.GetPlayerFromId, QBCore.Functions.GetPlayer, exports.qbx_core:GetPlayer oraz vRP 1, 2 i 3 działają na graczach, pieniądzach i pracach AI Core.
Rysuje też zasoby UI frameworków własnymi menu i kartami AI Core: esx_context, esx_textui, esx_notify, esx_progressbar, esx_menu_default, esx_menu_dialog, esx_menu_list, qb-menu, qb-input i progressbar. Usuń te zasoby: ai-core odpowiada na ich nazwy. Zobacz Zgodność.
Warstwy: jedno miejsce dla każdego rodzaju skryptu
Przedmioty, klucze pojazdów, alerty policyjne, ubrania, śmierć i reanimacja, więzienie, paliwo, zamki drzwi, garaże, czas i pogoda, rachunki, bankowość, telefony, menu radialne, HUD i powiadomienia przechodzą przez ai-core. Skrypt prosi ai-core („daj ten przedmiot”), a ai-core wywołuje skrypt, którego używasz do tego zadania. Dlatego możesz zamienić prawie każdy skrypt ai-* na skrypt zewnętrzny i dlatego ai-core informuje cię w konsoli, gdy jednocześnie działają dwa skrypty do tego samego zadania.
Instalacja
Instaluje go przepis txAdmin AI Core. Ręcznie: włóż folder do resources/[ai]/ i dodaj ensure ai-core do server.cfg po ensure ai-mysql i przed każdym innym skryptem ai-*. Wymaga OneSync i bazy danych:
add_convar_permission ai-core read mysql_connection_stringJego tabele (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) są tworzone przy pierwszym starcie. Nie instaluj obok niego es_extended, qb-core ani qbx_core. Zostaw set resources_useSystemChat false.
Komendy
| Komenda | Argumenty | Kto | Co robi |
|---|---|---|---|
/aiadmin | brak | administratorzy | Otwiera panel administratora. |
/togglepvp | brak | administratorzy | Włącza lub wyłącza obrażenia między graczami (zapisuje ustawienie panelu). |
aicore_switch | [id] | administratorzy | Odsyła gracza (domyślnie ciebie) z powrotem do ekranu postaci. |
aicore_job | <job> <grade> [id] | administratorzy | Daje pracę na danym stopniu. |
aicore_duty | <job | off> [id] | administratorzy | Wprowadza gracza na służbę w pracy albo zdejmuje ze służby. |
aicore_money | <account> <amount> [id] | administratorzy | Dodaje do konta (ujemna kwota zabiera). |
aicore_gang | <gang> <grade> [id] | administratorzy | Daje gang na danym stopniu. |
aicore_db | [slow] | administratorzy | Statystyki bazy danych każdego zasobu w konsoli serwera; slow wymienia ostatnie wolne zapytania. |
aicore_alert | [high] | administratorzy | Wysyła testowy alert policyjny w twojej pozycji przez aktywny skrypt alertów. |
Komendy aicore_* to narzędzia testowe: odpowiadają w konsoli serwera. Znane komendy administracyjne QB / ESX (setjob, givemoney...) są w ai-admin.
Klawisze
| Domyślny klawisz | Co robi | Nazwa w ustawieniach GTA |
|---|---|---|
| F10 | Otwiera panel administratora (tylko administratorzy) | Open the admin panel |
Znane ograniczenia
- Gracze muszą mieć połączone konto FiveM (identyfikator
fivem:); gracze bez niego nie mogą dołączyć. - Skrypt, którego zamiennik działa w tym samym czasie (tgiann-inventory obok ai-inventory), nie wpuszcza nikogo, dopóki działają oba, jeśli Refuse players while both run jest włączone (domyślnie). Konsola podaje folder do usunięcia.