Bot na Discorda dla serwerów FiveM na ESX, QBCore, Qbox, ox_core i vRP

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ł.

FrameworkZasóbCo czyta
ESX Legacy i starsze ESXes_extendedImię i nazwisko, praca, nazwa stopnia, a na forkach z ukrytą pracą także ona jako gang
Forki ESX z GetPlayerFromIdClasses_extendedImię, nazwisko, praca, nazwa stopnia, ukryta praca
Qboxqbx_coreDane postaci, praca, stopień, gang
QBCoreqb-coreDane postaci, praca, stopień, gang
ox_coreox_coreImię postaci, aktywna grupa i jej stopień
vRP (wersje vRPex)vrpToż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

  1. W panelu otwórz Ustawienia, Game Server Bridge, pobierz fivebot_bridge i utwórz token serwera. Wspólny sekret pokazuje się tylko raz, więc od razu go skopiuj.
  2. Wrzuć fivebot_bridge do resources/.
  3. Dodaj poniższe linijki do server.cfg i 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.

Czytaj dalej

Twój staff odpowiedział na to dziś czterdzieści razy.

Instalacja zajmuje około dziesięciu minut, a liczba zgłoszeń nie jest limitowana.