Wspólny serwer i produkcja
Panel serwera
Administracja produkcji w przeglądarce: logowanie Discordem, role, konsola, gracze i bany, allowlista, restarty, kopie, dane graczy.
Panel to strona do administracji produkcji, którą agent stawia na Twoim VPS-ie. Moderatorzy wchodzą na nią z przeglądarki, logują się Discordem i nie potrzebują studia ani planu Webexe Studio.
Włączenie
- W studiu otwórz Wspólny serwer → Produkcja.
- W części Panel serwera kliknij Włącz panel. Opcjonalnie wpisz wcześniej domenę.
- Studio rejestruje adres panelu na serwerze kont, a agent instaluje na VPS-ie Caddy i bierze certyfikat Let’s Encrypt dla adresu IP.
Panel działa pod https://<adres IP VPS-a>. Potrzebuje wolnych portów 80 i 443. Jeśli na VPS-ie działa już Twoja strona z własnym Caddy albo nginx, studio to wykryje i napisze, co dopisać do jej konfiguracji.
Własna domena jest opcją: ustaw u dostawcy domeny rekord A na adres IP VPS-a, wpisz domenę przy włączaniu panelu. Studio sprawdza, czy rekord już wskazuje na VPS.
Kto wchodzi
Ekipa studia wchodzi ze swoimi rolami (właściciel, administrator, dev). Pozostałe osoby właściciel dodaje po Discord ID w studiu albo w samym panelu, w zakładce Administracja.
Discord ID skopiujesz w Discordzie: Ustawienia → Zaawansowane → Tryb dewelopera, potem prawy klik na osobie → Kopiuj ID.
| Rola | W panelu |
|---|---|
| właściciel | wszystko, w tym dodawanie ludzi i przeniesienie z txAdmina |
| administrator | konsola, start, stop i restart produkcji, gracze, allowlista, dziennik akcji |
| moderator | podgląd konsoli; gracze: wiadomość, ostrzeżenie, wyrzucenie, ban i jego cofnięcie, notatki, ogłoszenie |
| support | gracze: wiadomość, ostrzeżenie, notatki |
| dev | podgląd konsoli |
Role z konsolą do pisania, banami, kopiami albo deployem (właściciel, administrator, moderator) logują się tylko z kontem Discord z uwierzytelnianiem dwuskładnikowym (2FA). Bez 2FA panel odmawia i mówi, co włączyć.
Usunięcie osoby z listy działa od razu: jej otwarta sesja przestaje działać przy następnym kliknięciu.
Gracze
Zakładka Gracze w panelu i część Gracze na produkcji w studiu pokazują, kto teraz gra: numer na serwerze, ping, czas gry i liczbę ostrzeżeń. Agent dokłada na produkcję resource webexe_admin, który zgłasza graczy i wykonuje akcje z panelu.
- Wiadomość trafia do czatu gracza.
- Ostrzeżenie zasłania mu ekran, dopóki go nie potwierdzi (przycisk działa po 5 sekundach).
- Wyrzucenie rozłącza go z powodem.
- Ban na stałe albo na 24 godziny, 3, 7 lub 30 dni obejmuje wszystkie identyfikatory gracza (licencja Rockstar, Discord, konto Cfx.re, Steam) i tokeny sprzętu jego komputera. Z nowego konta Rockstar na tym samym komputerze też nie wejdzie.
- Cofnij bana w karcie gracza zdejmuje go od razu.
Wszyscy gracze, którzy kiedykolwiek weszli, są w wyszukiwarce: po nazwie albo identyfikatorze (license:…, discord:…). Karta gracza ma historię ostrzeżeń i banów, notatki administracji, identyfikatory i ostatnie wejścia.
Listy banów i allowlisty webexe_admin trzyma u siebie, więc sprawdza graczy także wtedy, gdy agent się restartuje.
Allowlista
Po włączeniu Wpuszczaj tylko osoby z listy i administrację serwer wpuszcza tylko identyfikatory z listy i administrację panelu (po Discord ID). Odrzucony gracz widzi swój identyfikator, który może wysłać administracji.
Role w grze
Rola z panelu staje się w grze grupą ACE: moderator po wejściu dostaje group.moderator, support group.support i tak dalej. Resource’y, które sprawdzają IsPlayerAceAllowed, widzą administrację bez wpisów w server.cfg. Uprawnienia samych grup ustawiasz w server.cfg, np. add_ace group.moderator command.kick allow.
Przeniesienie z txAdmina
Właściciel wskazuje plik txData/<profil>/data/playersDB.json w panelu (zakładka Gracze) albo w studiu. Panel przenosi graczy z identyfikatorami, tokenami sprzętu, czasem gry i notatkami, bany i ostrzeżenia z ich cofnięciami oraz allowlistę. Bany z txAdmina mają identyfikatory zaczynające się od TX-.
Operacje
Zakładka Operacje w panelu i część Restarty planowe w studiu.
- Restarty planowe o wybranych godzinach (czas VPS-a). Gracze dostają ostrzeżenia 30, 15, 10, 5, 4, 3, 2 i 1 minutę wcześniej, a skrypty dostają zdarzenia txAdmina (
scheduledRestart,serverShuttingDown) i zapisują dane przed zamknięciem. Następny restart możesz pominąć, a dodatkowy ustawić jednorazowo. Pusty serwer może się zrestartować do 30 minut wcześniej. - Zawieszenie.
webexe_adminzgłasza się agentowi co 5 sekund. Gdy przez minutę się nie zgłosi albo serwer przez 3 minuty nie odpowiada na HTTP, agent zapisuje ostatnie linie logu dohang-<data>.log, uruchamia serwer ponownie i wysyła alert. - Ostatnie 24 godziny: gracze, tick serwera, pamięć FXServera, obciążenie i pamięć maszyny, wolne miejsce na dysku. Pomiary zostają przez 30 dni.
- Alerty: awaria, zawieszenie, nieudany deploy, nieudana kopia, mniej niż 5 GB na dysku. Trafiają do dziennika akcji i na webhook, np. kanału Discorda (Ustawienia kanału → Integracje → Webhooki). Webhook ustawia właściciel w panelu.
- Kopie bazy: co noc o 4:00 (zostaje siedem nocnych), przed migracjami, przed każdym przywróceniem i na żądanie. Kopia zawiera bazę produkcji,
panel.dbi numer działającego wydania. Przywróć zatrzymuje serwer, robi kopię obecnego stanu i przywraca wybraną. Przywraca właściciel.
Dane graczy
Właściciel serwera jest administratorem danych swoich graczy. Panel, webexe_admin i kopie działają na jego VPS-ie. Webexe Studio nie ma dostępu do tych danych; przy logowaniu do panelu potwierdza tylko Discord ID osoby z administracji.
Panel trzyma: identyfikatory, tokeny sprzętu, nazwy, czas gry, wejścia i wyjścia, ostrzeżenia, bany i notatki. Okresy przechowywania ustawia właściciel w zakładce Administracja:
| Dane | Domyślnie |
|---|---|
| wejścia i wyjścia | 90 dni |
| gracz bez wizyty i bez aktywnego bana | 12 miesięcy od ostatniej wizyty |
| dziennik akcji administracji | 12 miesięcy |
Agent sprząta raz dziennie. Gracz z aktywnym banem zostaje do końca bana.
Prośba gracza o dane: w karcie gracza Eksport danych (JSON) zapisuje wszystko, co panel o nim ma. Usuń dane gracza usuwa je; aktywny ban zostaje z samymi identyfikatorami i opisaną podstawą, żeby dalej działał. Danych w bazie gry (postacie i ekwipunek frameworka) panel nie rusza: te usuwa się w bazie produkcji.
Informacja dla graczy: w zakładce Administracja panel składa ją z okresów przechowywania, nazwy serwera i kontaktu do właściciela, po polsku i po angielsku. Wstaw ją do regulaminu serwera albo na Discorda.
Dziennik akcji
Każde logowanie, odmowa, zmiana na liście ludzi, komenda w konsoli, akcja na graczu, zmiana allowlisty, przeniesienie z txAdmina, start, stop, restart, deploy i wycofanie produkcji trafia do dziennika z autorem i źródłem (panel, studio, SSH). Widzą go właściciel i administrator: w panelu w zakładce Dziennik akcji, w studiu w części Panel serwera.
Gdy serwer kont nie działa
Logowanie Discordem idzie przez studio.webexe.pl. Jeśli ta strona nie odpowiada, właściciel wchodzi jednorazowym linkiem z SSH:
/opt/we-studio-agent/node/bin/node /opt/we-studio-agent/agent.mts panel-link
Link działa raz, przez 15 minut, i loguje jako właściciel.
Bezpieczeństwo
- Serwer kont zwraca logowanie tylko na adresy, które zarejestrowało Twoje studio. Link z innym adresem powrotu nie zadziała.
- Potwierdzenie logowania jest podpisane, ważne 60 sekund i działa raz.
- Sesja w panelu trwa 8 godzin.
- Panel przyjmuje zmiany tylko ze swojej strony, więc cudza strona nie wyśle komendy w Twoim imieniu.
Pytanie, na które tu nie ma odpowiedzi? Zadaj je na Discordzie.