# Kierownik ds. administracji w CS2
**Kompletny system administracyjny dla Twojego serwera Counter-Strike 2: administratorzy, grupy, blokady, ograniczenia mowy, ostrzeżenia oraz wszystkie polecenia administracyjne w jednej wtyczce – wszystko przechowywane w bazie danych MySQL.**
*autor: illusion @ CodeStrike*
---
## Dlaczego Admin Manager?
- **Jedna wtyczka zamiast pięciu.** Zawiera funkcje związane z administratorami, grupami, blokadami, wyciszeniami, ostrzeżeniami, poleceniami dla graczy, poleceniami serwera, czatem administratorów oraz menu.
- **Wszystko znajduje się w bazie danych.** Koniec z ręczną`admins.json` edycją. Wystarczy raz dodać administratora, a stanie się on administratorem na każdym serwerze korzystającym z tej samej bazy danych.
- **Zmiany wchodzą w życie natychmiast.** Dodaj, usuń lub zmień administratora – w grze lub na swojej stronie internetowej – a gracz uzyska lub utraci uprawnienia bez konieczności ponownego logowania się.
- **Przejście z SimpleAdmin wymaga wykonania tylko jednego polecenia.** Administratorzy, grupy, blokady, ograniczenia wypowiedzi, ostrzeżenia, a nawet uprawnienia do wydawania poleceń są przenoszone automatycznie.
- **Działa z innymi wtyczkami.** Tagi czatu, VIP, menu i wszystkie inne elementy sprawdzające uprawnienia administratorów lub grupy administratorów nadal rozpoznają Twoich administratorów.
- **To Ty decydujesz, kto może co robić.** Każde polecenie ma swoje własne uprawnienia, które możesz zmienić w jednym prostym pliku.
- **W zestawie są język angielski i bułgarski**, a ponadto można dodać dowolny inny język.
---
## Funkcje
### 👮 Administratorzy i grupy
- Utwórz **grupy** (Właściciel, Administrator, Moderator itp.) z własnymi uprawnieniami i immunitetem, a następnie dodaj administratorów do jednej z grup.
- Przyznaj administratorowi grupę, dodatkowe uprawnienia lub jedno i drugie.
- **Dziedziczenie uprawnień grupowych**: spraw, by *uprawnienia administratora* automatycznie obejmowały wszystkie uprawnienia *moderatora* oraz dodatkowe uprawnienia.
- **Administratorzy tymczasowi**: przyznajcie dostęp na 7 dni, 30 dni lub na dowolny okres. Uprawnienia zostaną automatycznie cofnięte po upływie tego czasu.
- Administratorzy otrzymują przypomnienie po dołączeniu do grupy: *„Twój dostęp administratora wygaśnie za 2 dni”.*
- **Immunitet**: administratorzy niższego szczebla nigdy nie mogą karać administratorów wyższego szczebla.
- **Wiele serwerów**: przypisz administratorów do wszystkich serwerów lub ogranicz uprawnienia administratora do jednego serwera.
- **Prawdziwe grupy w CounterStrikeSharp**: każdy administrator jest również umieszczany w grupie o nazwie odpowiadającej jego grupie w Admin Managerze (wraz z grupami, które z niej wynikają), dzięki czemu wtyczki sprawdzające przynależność do grup, takie jak tagi czatu czy VIP, działają od razu po instalacji.
### 🔨 Kary
- **Blokada** gracza lub identyfikatora SteamID na określony czas lub na stałe. Każda blokada obejmuje zarówno **konto** **Steam**, **jak i adres IP**, więc drugie konto korzystające z tego samego połączenia nie może jej ominąć. Zablokowani gracze są natychmiast wyrzucani z gry, gdy tylko spróbują do niej dołączyć.
- **Zablokuj** czat, **wycisz** głos lub **wycisz** wszystko. Nie da się tego obejść poprzez ponowne połączenie, a funkcje te działają na każdym serwerze.
- **Ostrzeżenia** z automatycznymi karami, na przykład: *3 ostrzeżenia = wyrzucenie z gry, 4 ostrzeżenia = 1 godzina blokady*.
- **Kop**, **uderz** i **pokonaj**.
- Kary stosowane w trybie offline: blokowanie lub cenzurowanie identyfikatora SteamID nawet wtedy, gdy gracz nie jest online.
- Ukarany gracz zawsze widzi, kto go ukarał, dlaczego i na jak długo.
### 🎮 Polecenia dla graczy i serwerów
- Przenoszenie graczy między drużynami, zmiana nazw, zamrażanie, odrodzenie, teleportacja (przenieś / przejdź), tryb bez klipów, tryb boski, zdrowie, prędkość i grawitacja.
- Zmień mapę (dotyczy to również map warsztatowych), uruchom grę od nowa, zmień parametry CVAR, wykonaj polecenia serwera.
- **Czat administratorów**: w`@message` czacie drużynowym wiadomości trafiają bezpośrednio do administratorów obecnych online. Zwykli gracze mogą z niego korzystać, aby zgłosić kogoś.
- Komunikaty na czacie, wyświetlane na środku ekranu lub w interfejsie HUD, a także wiadomości prywatne.
- `!who` i `!players`przedstawiają wszystkie informacje o graczu w skrócie.
### 📋 Menu
- **`!admin`**: wybierz gracza, wybierz działanie (wykluczenie, zakneblowanie, zablokowanie, ostrzeżenie itp.), wybierz czas i powód. Gotowe.
- **`!am`**: zarządzaj administratorami i grupami bez wpisywania ani jednego polecenia.
- Administratorzy widzą tylko te działania, do których mają uprawnienia.
### 🕵️ Tryb ukryty
- **`!hide`**: obserwuj serwer jako niewidzialny widz.
- Nie figurujesz na tablicy wyników, nie ma Cię na liście widzów żadnego użytkownika i nie ma żadnych wiadomości dotyczących dołączenia, opuszczenia ani drużyny, które dotyczyłyby Ciebie.
- Kary, które nakładasz, będąc w trybie ukrytym, są widoczne wyłącznie dla innych administratorów.
- `!hide` ponownie albo dołączenie do zespołu sprawia, że stajesz się widoczny.
- Opcjonalnie: administratorzy są automatycznie dodawani do grupy ukrytej.
- Ponadto ukrywa użytkownika przed poleceniem konsoli`status`, gdy zainstalowana jest wtyczka Metamod służąca do ukrywania statusu.
### 👀 Dla Twoich graczy
- **`!admins`** pokazuje, którzy administratorzy są obecnie online.
- Administratorzy mogą ukryć się na liście za pomocą `!adminhide`.
### 📝 Logi i Discord
- Każda zmiana wprowadzona przez administratora i każda kara są rejestrowane: kto co zrobił, komu, kiedy i dlaczego.
- **Powiadomienia na Discordzie** z przejrzystymi osadzeniami dotyczącymi blokad, ograniczeń, ostrzeżeń, zmian w składzie administratorów i nie tylko.
- Zmiany dotyczące administratorów i grup, wprowadzone bezpośrednio w bazie danych lub na stronie internetowej, są również rejestrowane.
### 🌍 Języki
- W zestawie znajdują się języki angielski i bułgarski. Wystarczy jedno przełączenie.
- Każdą wiadomość można edytować; obsługiwane są kolory.
- Aby dodać własny język, wystarczy skopiować jeden plik.
---
## Polecenia
Wszystkie polecenia działają na czacie z opcją (`!`widoczne) lub `/`(ciche), a w konsoli serwera z opcją `css_`.
| Polecenie | Jak to działa |
|---|---|
| `!admin` | Menu kar |
| `!am` | Menu zarządzania administratorem |
| `!ban <player> [time] [reason]` | Zablokuj gracza (konto Steam + adres IP) |
| `!addban <steamid> [time] [reason]` | Zablokuj gracza grającego w trybie offline |
| `!unban <steamid/ip>` | Znieść blokadę |
| `!kick <player> [reason]` | Wyrzucić gracza |
| `!gag` / `!mute` / `!silence <player> [time] [reason]` | Zablokuj czat / rozmowę głosową / obie opcje |
| `!ungag` / `!unmute` / `!unsilence <player>` | Podnieś to jeszcze raz |
| `!warn <player> [time] [reason]` | Ostrzec gracza |
| `!warns` / `!unwarn <player>` | Pokaż / ukryj ostrzeżenia |
| `!slap <player> [damage]` · `!slay <player>` | Uderzyć / zabić |
| `!team <player> <t/ct/spec>` | Przejdź do drużyny |
| `!rename <player> <name>` | Zmień nazwę gracza |
| `!freeze` / `!unfreeze <player>` | Zablokuj gracza |
| `!respawn` · `!noclip` · `!god <player>` | Zabawne polecenia |
| `!bring` / `!goto <player>` | Teleportacja |
| `!hp` · `!speed` · `!gravity <player> <value>` | Zdrowie, prędkość, grawitacja |
| `!map <map>` · `!wsmap <id>` | Zmień mapę |
| `!rr` | Uruchom grę ponownie |
| `!rcon <command>` · `!cvar <cvar> [value]` | Polecenia serwera |
| `!asay` · `!say` · `!csay` · `!hsay` · `!psay` | Czat administracyjny i ogłoszenia |
| `!who <player>` · `!players` | Informacje o graczu |
| `!admins` · `!adminhide` | Lista administratorów online |
| `!hide` | Tryb niewidzialnego obserwatora dla administratorów |
**Czas** można zapisać jako `30`(minuty), `12h`, `7d`, `4w`, lub `0`w przypadku czasu stałego.
**Graczem** może być imię i nazwisko, `#userid`, identyfikator SteamID lub grupa, np. `@t`, `@ct`lub `@all`.
Zarządzanie przez administratora (z poziomu konsoli lub przez właściciela):
`css_am_add`, `css_am_remove`, `css_am_list`, `css_am_group_add`, `css_am_group_remove`, `css_am_group_inherit`, `css_am_groups`, `css_am_logs`, `css_am_reload`, `css_am_import_simpleadmin`.
---
## Uprawnienia w prosty sposób
Każde polecenie zajmuje osobny wiersz w pliku**`commands.json`**:
```json
"god": { "Enabled": true, "Permission": "@css/cheats", "Commands": ["god"] },
"slay": { "Enabled": true, "Permission": "@css/slay", "Commands": ["slay", "kill"] },
"who": { "Enabled": true, "Permission": "", "Commands": ["who"] }
```
- **Zmień uprawnienie**, edytując jedno słowo. Możesz nawet wymyślić własne, na przykład `@css/god`.
- **Pozostaw to puste** (`""`) – wtedy każdy gracz będzie mógł używać tego polecenia.
- **Dodaj dodatkowe nazwy**: dzięki temu `["slay", "kill"]`będą działać`!kill` zarówno `!slay`jak i .
- **Wyłącz polecenie** za pomocą `"Enabled": false`.
Domyślne uprawnienia są zgodne z ustawieniami SimpleAdmin, przy czym ustawienia dotyczące stanu, szybkości i wagi są domyślnie nieco bardziej restrykcyjne, a funkcja importu z SimpleAdmin kopiuje dokładnie Twoją konfigurację, dzięki czemu administratorzy zachowują dostęp, do którego są przyzwyczajeni.
---
## Przechodzisz z serwisu SimpleAdmin?
Wystarczy jedno polecenie, aby przenieść wszystko:
```
css_am_import_simpleadmin ← shows what will be imported (nothing is changed)
css_am_import_simpleadmin confirm ← imports it
```
Przenosi:
- ✅ Wszyscy administratorzy i grupy wraz z ich uprawnieniami, immunitetem i datami wygaśnięcia
- ✅ Wszystkie aktywne blokady, ograniczenia wypowiedzi, wyciszenia, blokady komunikacji i ostrzeżenia wraz z pozostałym czasem
- ✅ Twoje uprawnienia do poleceń oraz nazwy poleceń – dokładnie takie, jakie były wcześniej
- ✅ Grupy, które występują dwukrotnie w SimpleAdmin, są łączone w jedną, tak jak robi to SimpleAdmin w grze
- ✅ `!hide`zastępuje polecenie „hide” z SimpleAdmin oraz jego moduł Stealth
Dane w SimpleAdmin są wyłącznie odczytywane – nigdy nie są modyfikowane ani usuwane. W dowolnym momencie możesz ponownie uruchomić import, a żadne dane nie zostaną zduplikowane.
**Pozostałe wtyczki nadal działają.** Wtyczki czatu, VIP oraz wtyczki menu sprawdzające grupy administratorów (takie jak `#Staff`) nadal rozpoznają Twoich administratorów: każdy administrator jest umieszczany w grupie o nazwie identycznej z nazwą jego grupy w Admin Managerze. Nazwy grup nie mogą zawierać spacji, więc grupa „SimpleAdmin” `#Staff Manager`staje się `#Staff_Manager`– zaktualizuj tę nazwę w konfiguracjach tych wtyczek.
Jeśli program SimpleAdmin jest nadal zainstalowany, Admin Manager wyświetla ostrzeżenie i automatycznie go wyłącza, dzięki czemu oba programy nigdy nie kolidują ze sobą.
---
## Wymagania
- **CounterStrikeSharp** w wersji 1.0.368 lub nowszej
- Baza danych **MySQL** lub **MariaDB**
- **MenuManager** *(opcjonalnie)*, wymagany wyłącznie dla menu`!am` i`!admin` ;
---
## Instalacja
1. Skopiuj folder`AdminManager` do `addons/counterstrikesharp/plugins/`.
2. Uruchom serwer raz. Pliki konfiguracyjne zostaną utworzone automatycznie.
3. Otwórz `addons/counterstrikesharp/configs/plugins/AdminManager/AdminManager.json`i wprowadź dane swojej bazy danych.
4. Uruchom ponownie serwer. Tabele bazy danych zostaną utworzone automatycznie.
5. Nadaj sobie uprawnienia administratora z poziomu konsoli serwera:
```
css_am_group_add Owner @css/root 100
css_am_add <your SteamID64> Owner
```
To wszystko. Wpisz `!am`w grze, aby zarządzać wszystkim z poziomu menu.
---
## Przegląd ustawień
**`AdminManager.json`**: główne ustawienia
- Połączenie z bazą danych
- Język (`en` / `bg`) i prefiks czatu
- Domyślne okresy obowiązywania blokad, ograniczeń wypowiedzi i ostrzeżeń oraz kary związane z ostrzeżeniami
- Kto widzi ogłoszenia o karach (wszyscy, tylko administratorzy czy nikt)
- Tryb ukryty: automatyczne ukrywanie administratorów po dołączeniu do grupy
- Czy administratorzy są również dodawani do grup CounterStrikeSharp (opcja domyślnie włączona)
- Webhook serwisu Discord
- Identyfikator serwera, jeśli na jednej bazie danych działa kilka serwerów
**`commands.json`**: każde polecenie, jego uprawnienia i nazwy
**`lang/en.json`, `lang/bg.json`**: każda wiadomość wyświetlana przez wtyczkę
Wszystkie pliki są tworzone automatycznie z rozsądnymi ustawieniami domyślnymi. Błędy są wyraźnie zgłaszane w konsoli serwera, a wtyczka nadal działa.
---
## Najczęściej zadawane pytania
**Czy po dodaniu administratora muszę zrestartować system?**
Nie. Nowi administratorzy otrzymują uprawnienia natychmiast, nawet jeśli są już na serwerze.
**Czy mogę dodawać administratorów z mojej strony internetowej?**
Tak. Wystarczy zapisać dane w bazie danych, a serwer automatycznie je pobierze w ciągu minuty.
**Czy zablokowany gracz może ponownie dołączyć do gry po ponownym połączeniu?**
Nie. Informacje o blokadach, ograniczeniach wypowiedzi i wyciszeniach są przechowywane w bazie danych i sprawdzane za każdym razem, gdy gracz dołącza do gry.
**Czy zablokowany gracz może powrócić, korzystając z drugiego konta Steam?**
Nie z tego samego połączenia: każda blokada obejmuje również adres IP gracza. Waszych administratorów nigdy nie wyrzuca z gry tylko dlatego, że dzielą adres IP z zablokowanym graczem.
**Mam kilka serwerów. Czy muszę dodawać administratorów na każdym z nich?**
Nie. Należy skonfigurować wszystkie serwery tak, aby korzystały z tej samej bazy danych. Nadal można przyznać komuś uprawnienia administratora tylko na jednym serwerze.
**Czy moje pozostałe wtyczki nadal będą rozpoznawać administratorów?**
Tak. Admin Manager przyznaje administratorom standardowe uprawnienia w CounterStrikeSharp i dodaje ich do grup w CounterStrikeSharp, dzięki czemu wtyczki sprawdzające uprawnienia (`@css/ban`) lub grupy (`#Admin`) działają jak zwykle.
**Moja wtyczka do czatu / wtyczka VIP korzystała z nazw grup w SimpleAdmin zawierających spacje. Co teraz?**
Nazwy grup nie mogą zawierać spacji, więc po`#Staff_Manager` zaimportowaniu `#Staff Manager`zmienia się w . Wystarczy zmienić tę nazwę w pliku konfiguracyjnym drugiej wtyczki, a wszystko znów będzie działać.
**Czy istnieje tryb ukrycia / tryb niewidzialności, podobny do tego w SimpleAdmin?**
Tak`!hide`. Stajesz się niewidzialnym widzem: nie pojawiasz się na tablicy wyników ani na liście widzów, a także nie wyświetlają się żadne komunikaty o dołączeniu lub opuszczeniu.
**Czy mogę przetłumaczyć tę wtyczkę?**
Tak. Skopiuj `lang/en.json`i przetłumacz teksty, a następnie ustaw język w pliku konfiguracyjnym.