qAdminPanel
qAdminPanel to panel administracyjny dla Counter-Strike 2 oparty o CounterStrikeSharp na bazie SourceBans. Ułatwia zarządzanie graczami z poziomu menu i komend, obsługuje bany, kary głosowe, szybkie akcje administracyjne, listę ostatnio rozłączonych graczy, zgłoszenia oraz dodatkowe narzędzia dla administracji serwera.
Najważniejsze funkcje
- menu administracyjne pod
css_admin - bany, unbany, kicki i historia banów
- mute, gag i silence wraz z ich zdejmowaniem
- szybkie akcje: slap, slay, freeze, blind, noclip, scale
- zmiana drużyny, lista graczy, głosowanie i zmiana mapy
- lista ostatnio rozłączonych graczy z szybkim nadaniem kary
- system zgłoszeń podejrzanych graczy
- wykrywanie aktywnego bana po IP przy wejściu na serwer
- komunikaty administracyjne, tryb all-chat i opcje stealth
- opcjonalne powiadomienia na Discordzie
Wymagania
- CounterStrikeSharp
- Skonfigurowane połączenie do bazy MySQL -> SourceBans
Instalacja
- Wgraj plugin do katalogu pluginów CounterStrikeSharp.
- Skonfiguruj plugin w
addons/counterstrikesharp/configs/Qesik/qAdminPanel/AdminPanel.json.
Komendy
| Komenda | Opis |
|---|---|
css_admin |
Otwiera główne menu admina |
css_kick |
Wyrzuca gracza |
css_ban |
Nadaje bana |
css_unban |
Zdejmuje bana |
css_gag |
Blokuje czat tekstowy |
css_mute |
Blokuje mikrofon |
css_silence |
Blokuje czat tekstowy i mikrofon |
css_ungag |
Zdejmuje gag |
css_unmute |
Zdejmuje mute |
css_unsilence |
Zdejmuje silence |
css_team |
Zmienia drużynę gracza |
css_rcon |
Komendy RCON |
css_who |
Lista graczy |
css_map |
Zmienia mapę |
css_workshop |
Zmienia mapę warsztatową |
css_banhistory |
Pokazuje historię banów |
css_vote |
Uruchamia głosowanie |
css_infoban |
Pokazuje informacje o banach po IP |
css_oznaczenie |
Oznacza podejrzanego gracza |
css_disconnect |
Otwiera listę ostatnio rozłączonych graczy |
css_adminvoice |
Tryb administracyjnego voice |
css_stealth |
Tryb stealth dla admina |
css_noclip |
Noclip dla gracza |
css_slap |
Slap gracza |
css_slay |
Zabija gracza |
css_freeze |
Zamraża gracza |
css_blind |
Oślepia gracza |
css_scale |
Zmienia skalę gracza |
Uprawnienia zależą od standardowych flag CounterStrikeSharp. Przykładowo css_admin wymaga dostępu @css/generic, a większość komend administracyjnych korzysta z flag takich jak @css/ban, @css/chat, @css/kick, @css/changemap czy @css/xray.
Konfiguracja
Plik konfiguracyjny znajduje się w:
addons/counterstrikesharp/configs/Qesik/qAdminPanel/AdminPanel.json
Database
Sekcja połączenia z bazą MySQL używaną do banów, historii kar i zgłoszeń.
| Pole | Opis |
|---|---|
Hostname |
Adres serwera bazy |
Database |
Nazwa bazy |
UserName |
Nazwa użytkownika |
Password |
Hasło |
Main
| Pole | Opis |
|---|---|
ServerId |
Id serwera używane przy zapisie kar; -1 pozwala pluginowi dopasować serwer po IP i porcie |
ServerName |
Nazwa serwera używana w komunikatach i powiadomieniach |
ChatLog |
Poziom ogłoszeń o akcjach adminów |
MenuType |
Wybór typu menu używanego przez panel |
AutoStealth |
Automatycznie włącza stealth dla uprawnionych adminów |
AllChat |
Włącza komunikację all-chat dla adminów |
EnableAdmins |
Ładuje grupy adminów z bazy |
LastDisconnectedNum |
Liczba ostatnio rozłączonych graczy dostępnych w menu css_disconnect; 0 wyłącza funkcję |
EnableXray |
Włącza tryb xray dla adminów z odpowiednią flagą |
EnableAdminAllSpec |
Pozwala adminom obserwować wszystkich graczy |
VoteTime |
Czas trwania głosowania w sekundach |
ChatLog przyjmuje wartości:
| Wartość | Opis |
|---|---|
0 |
Brak logów na czacie |
1 |
Pokazuj komunikaty bez nazwy admina |
2 |
Pokazuj komunikaty z nazwą admina |
3 |
Pokazuj komunikaty tylko adminom |
Sleuth
Ustawienia wykrywania aktywnego bana po IP.
| Pole | Opis |
|---|---|
Actions |
Reakcja po wykryciu: kick, ban albo zapis informacji dla adminów |
BanDuration |
Czas automatycznego bana, gdy wybrana jest akcja ban |
BansAllowed |
Maksymalna liczba wpisów zanim zadziała reakcja |
BanType |
Tryb uwzględniania wpisów przy sprawdzaniu IP |
AdminByPass |
Admin z flagą @css/ban omija sprawdzanie |
ExcludeOld |
Włącza pomijanie starszych wpisów |
ExcludeTime |
Granica czasowa dla starych wpisów w sekundach |
Reason |
Powód używany przy automatycznej akcji |
Discord
Opcjonalne powiadomienia webhook dla wybranych akcji.
| Pole | Opis |
|---|---|
Thumbnail |
Miniatura embedu |
FooterImageUrl |
Ikona stopki embedu |
Ban, Kick, Mute, Gag, Silence, Slay, Slap, Freeze, Blind, Noclip, ChangeMap, ChangeTeam, Scale |
Adres webhooka dla danej akcji; puste pole wyłącza wysyłkę |
Report
| Pole | Opis |
|---|---|
Enabled |
Włącza lub wyłącza system zgłoszeń |
Duration |
Czas życia zgłoszenia w minutach |
Listy wspólne
| Sekcja | Opis |
|---|---|
BanReason |
Gotowe powody bana do menu i szybkich akcji |
KickReason |
Gotowe powody kicka |
MuteReason |
Gotowe powody dla mute, gag i silence |
BanTime |
Lista gotowych czasów kary, np. name i time w minutach; 0 oznacza karę permanentną, a -1 jest używane w wybranych akcjach jako wartość sesyjna |
MapsList |
Lista map widocznych w menu zmiany mapy; workshop = 0 oznacza zwykłą mapę, a inna wartość to workshop ID |
Uwagi praktyczne
- Plugin korzysta z bazy do zapisu banów, mute, gag, silence, historii i zgłoszeń.
- System zgłoszeń tworzy własną tabelę w bazie automatycznie, jeśli nie istnieje.
- Jeśli
EnableAdminsjest włączone, plugin pobiera grupy adminów z bazy i przypisuje im odpowiednie uprawnienia oraz immunity.