Bot na Discorda dla serwerów FiveM na ESX, QBCore, Qbox, ox_core i vRP
Autor: Termi4 min czytania
FiveBot to bot na Discorda do ticketów, moderacji i odpowiedzi AI z twojego regulaminu. Ma też zasób na FiveM, fivebot_bridge, który łączy serwer gry z tym samym panelem. Część discordowa działa bez niego. Z nim tickety, zgłoszenia i bany wiedzą, kim gracz jest w mieście.
Co działa bez serwera gry
Wszystko po stronie Discorda działa na każdym serwerze, z FiveM czy bez. W każdym planie dostajesz panele ticketów z darmowym przejmowaniem i trwałymi zapisami rozmów, anty-spam, anty-raid i anti-nuke, podania na formularzach w przeglądarce, role za reakcje i własne komendy. Od planu Starter tickety dostają też odpowiedzi AI z cytatem z twojego regulaminu, tłumaczenie w obie strony i Hollo, czyli czat na twoją stronę.
Sporo społeczności FiveM zaczyna właśnie od tego, a most instaluje, kiedy Discord jest już poukładany.
Co dodaje most
Most działa w każdym planie. To jeden zasób bez wymaganych zależności, który dokłada to, do czego potrzebna jest gra. Karta gracza wymaga planu Starter, a programista AI i NPC z AI planu Pro.
- Liczbę graczy na żywo na kanale Discorda, wysyłaną co dwie minuty.
- Bany, ostrzeżenia, kicki i zdjęte bany z txAdmina, każde z adminem, który je dał, i z powodem. Dziewięć anticheatów, w tym WaveShield, Fiveguard i ElectronAC, zgłasza swoje, każdy ban razem z tym, co serwer widział u gracza przed nim. Każde inne menu admina albo anticheat może zgłaszać przez jeden export. Jak akcje z txAdmina trafiają do FiveBota.
- Zgłoszenia z gry. Gracz wpisuje
/report 12 zastrzelił mnie przy banku, a administracja dostaje na Discordzie tę samą kartę zgłoszenia co z discordowego zgłoszenia, z obiema postaciami i odległością między nimi. Więcej o zgłoszeniach z gry. - Płatności ze sklepu. Kiedy gracz pisze, że zakup nie doszedł, FiveBot pyta most, a most pyta sklep. Tebex działa sam, Skalp podłącza się sam, a każdy inny sklep podłącza się jednym exportem. Jak ogarnąć „zapłaciłem i nic nie dostałem”.
- Błędy skryptów z konsoli serwera, zbierane w panelu z wyciętymi hasłami, tokenami, adresami IP i mailami. Dostajesz maila, kiedy błędów nagle przybywa, i krótkie podsumowanie raz dziennie. Alerty o błędach skryptów.
- Karta gracza w panelu z pieniędzmi, przedmiotami, pracą i autami, a zmiany, takie jak danie pieniędzy albo ustawienie pracy, jednym przyciskiem. Jak sprawdzić gracza.
- Zmiany w configach i skryptach na zwykłą prośbę, pokazane przed zapisaniem i cofane, jeśli skrypt padnie. Programista AI.
- Każda komenda, którą twoja administracja wpisze na serwerze gry, osobno dla każdego admina. Log komend adminów.
- NPC z AI, które stoją w twoim mieście i rozmawiają z graczami. Jak działają.
Jakie frameworki czyta
Przy starcie most szuka frameworka i czyta imię i nazwisko postaci, pracę, stopień i gang. Dzięki temu NPC wita policjanta po stopniu, a karta zgłoszenia podaje, które postacie brały udział.
| Framework | Zasób | Co czyta |
|---|---|---|
| ESX Legacy i starsze ESX | es_extended | Imię i nazwisko, praca, nazwa stopnia, a na forkach z ukrytą pracą także ona jako gang |
Forki ESX z GetPlayerFromIdClass | es_extended | Imię, nazwisko, praca, nazwa stopnia, ukryta praca |
| Qbox | qbx_core | Dane postaci, praca, stopień, gang |
| QBCore | qb-core | Dane postaci, praca, stopień, gang |
| ox_core | ox_core | Imię postaci, aktywna grupa i jej stopień |
| vRP (wersje vRPex) | vrp | Tożsamość i grupa typu job |
Bez frameworka most działa na samych identyfikatorach gracza i to też jest wspierana konfiguracja. Framework, który wystartuje po moście, zostaje wykryty w chwili startu. Żeby wymusić konkretny, ustaw fivebot_framework na esx, qbcore, qbox, ox, vrp albo none. Rdzeń o zmienionej nazwie most znajduje po jego exportach, tak samo ekwipunek i skrypt medyczny. Obsługiwane frameworki i ekwipunki.
Instalacja
- W panelu otwórz Ustawienia, Game Server Bridge, pobierz
fivebot_bridgei utwórz token serwera. Wspólny sekret pokazuje się tylko raz, więc od razu go skopiuj. - Wrzuć
fivebot_bridgedoresources/. - Dodaj poniższe linijki do
server.cfgi zrestartuj. Jeśli którejś brakuje, konsola serwera powie której.
set fivebot_api_url "https://api.fivebot.ai"
set fivebot_server_token "srv_..."
set fivebot_shared_secret "..."
ensure fivebot_bridge
Token i sekret trzymasz w server.cfg, poza folderem zasobu. Zasoby się kopiuje, pakuje i podsyła dalej, a token w folderze wędrowałby z każdą kopią.
Postacie AI są tworzone przez serwer i potrzebują OneSync, który txAdmin włącza domyślnie. Cała reszta działa bez niego. ox_lib, oxmysql i framework są opcjonalne.
Czego nie rusza
FiveM podaje identyfikator ip: razem z pozostałymi, a most odrzuca go, zanim cokolwiek zostanie zapisane albo wysłane. Nie trzyma też listy banów na twoim serwerze: bany są sprawdzane w FiveBocie wtedy, kiedy mają znaczenie.
Pliki mostu z logiką są zaciemnione. Dwa pliki zostają czytelne i możesz je edytować: config.lua z czasami i client/chat.lua, który decyduje, jak wiadomości FiveBota docierają do gracza. Aktualizacja podmienia całą resztę, więc swoje zmiany trzymaj w tych dwóch.
Ile ruchu generuje
Wejścia i wyjścia graczy idą paczkami co dwie sekundy, nigdy jednym zapytaniem na zdarzenie. Liczba graczy idzie co dwie minuty. Most sprawdza akcje z panelu co trzy do czterech i pół sekundy. Kiedy API jest nieosiągalne, każda niedziałająca ścieżka trafia do logu raz i jeszcze raz, kiedy zacznie działać, więc błędny token nie zasypuje konsoli.
Najczęstsze pytania
Czy do samego bota na Discorda potrzebuję planu Pro?
Nie. Entry i Starter obsługują tickety, moderację i ochronę serwera, a Starter także odpowiedzi AI i Hollo. Most działa w każdym planie i czyta dane postaci z ESX, QBCore, Qbox, ox_core albo vRP. NPC z AI i Bodycam zaczynają się od Pro. Aktualne ceny są na fivebot.ai/pricing.
Czy działa z txAdminem bez konfiguracji?
Tak. Most słucha zdarzeń, które txAdmin sam wysyła, więc bany, ostrzeżenia i kicki przychodzą bez żadnych zmian w txAdminie.
Mogę go używać obok innych botów?
Tak. FiveBot nie musi być jedynym botem na serwerze, więc stary bot do ticketów może zostać, dopóki porównujesz.
Czy FiveBot jest powiązany z Cfx.re?
Nie. FiveBot nie jest powiązany z Cfx.re, Rockstar Games ani Take-Two Interactive.