# Административен мениджър за CS2
**Пълна система за администриране на вашия сървър за Counter-Strike 2: администратори, групи, забрани, ограничения на чата, предупреждения и всички команди за администратори в един плъгин, като всичко това се съхранява във вашата MySQL база данни.**
*от illusion @ CodeStrike*
---
## Защо „Admin Manager“?
- **Един плъгин вместо пет.** Включени са администратори, групи, забрани, заглушаване, предупреждения, команди за играчи, команди за сървъра, чат за администратори и менюта.
- **Всичко се съхранява във вашата база данни.** Няма повече `admins.json`ръчно редактиране. Добавете администратор веднъж и той ще бъде администратор на всеки сървър, който използва същата база данни.
- **Промените влизат в сила незабавно.** Добавете, премахнете или променете администратор – в играта или на уебсайта си – и играчът получава или губи правата си, без да се налага да се свързва отново.
- **Преминаването от SimpleAdmin става с една команда.** Администраторите, групите, забраните, ограниченията за изказване, предупрежденията и дори правата ви за команди се прехвърлят автоматично.
- **Работи с останалите ви плъгини.** Чат етикетите, VIP, менютата и всичко останало, което проверява администраторските права или групите на администраторите, продължават да разпознават вашите администратори.
- **Вие решавате кой какво може да прави.** Всяка команда има собствено разрешение, което можете да промените чрез един лесен файл.
- **Включени са английски и български**, а можете да добавите и всеки друг език.
---
## Характеристики
### 👮 Администратори и групи
- Създайте **групи** („Собственик“, „Администратор“, „Модератор“ и др.) със собствени права и изключения, след което добавете администраторите в някоя от групите.
- Предоставете на администратора група, допълнителни права за достъп или и двете.
- **Наследяване на права на група**: да се направи така, че *ролята „Администратор“* автоматично да включва всички права на *ролята „Модератор“*, както и допълнителни права.
- **Временни администратори**: предоставете достъп за 7 дни, 30 дни или за какъвто период пожелаете. Достъпът се отменя автоматично при изтичане на срока.
- Администраторите получават напомняне, когато се присъединят: *„Достъпът ви като администратор изтича след 2 дни.“*
- **Имунитет**: администраторите с по-нисък ранг никога не могат да налагат наказания на тези с по-висок ранг.
- **Няколко сървъра**: можете да използвате едни и същи администратори за всичките си сървъри или да ограничите достъпа на даден администратор до един сървър.
- **Истински групи в CounterStrikeSharp**: всеки администратор се добавя и в група с името на неговата група „Admin Manager“ (както и групите, които тя наследява), така че плъгините, които проверяват групите – като например етикетите в чата или VIP – работят веднага, без да се налага допълнителна настройка.
### 🔨 Наказания
- **Блокиране** по играч или SteamID – за определен период от време или завинаги. Всяко блокиране засяга както **Steam акаунта**, **така и IP адреса**, така че втори акаунт, ползващ същата връзка, не може да заобиколи ограничението. Блокираните играчи биват изхвърляни веднага щом се опитат да се присъединят.
- **„Gag“** (чат), **„Mute“** (глас) или **„Silence“** (и двете). Тези ограничения не могат да бъдат заобиколени чрез повторно свързване и действат на всеки сървър.
- **Предупреждения** с автоматични наказания, например *3 предупреждения = изключване, 4 предупреждения = 1 час забрана*.
- **Удар**, **шамар** и **поразяване**.
- Наказания в офлайн режим: блокиране или ограничаване на SteamID, дори когато играчът не е онлайн.
- Наказаният играч винаги вижда кой го е наказал, защо и за колко време.
### 🎮 Команди за играчи и сървъри
- Преместване на играчи между отбори, преименуване, замразяване, респаун, телепортиране (bring / goto), noclip, режим „бог“, здраве, скорост и гравитация.
- Променете картата (включително и картите от работилницата), рестартирайте играта, променете cvars, изпълнете команди на сървъра.
- **Чат за администратори**: в`@message` екипния чат съобщенията се изпращат директно към онлайн администраторите. Обикновените играчи могат да го използват, за да подадат сигнал за някого.
- Съобщения в чата, в центъра на екрана или в HUD, както и лични съобщения.
- `!who` и `!players`показват цялата информация за даден играч с един поглед.
### 📋 Менюта
- **`!admin`**: изберете играч, изберете действие (изгонване, запушване на устата, забрана, предупреждение и т.н.), изберете момент и причина. Готово.
- **`!am`**: управлявайте администраторите и групите, без да въвеждате нито една команда.
- Администраторите виждат само действията, които имат право да извършват.
### 🕵️ Режим „Стелт“
- **`!hide`**: наблюдавай сървъра като невидим зрител.
- Не фигурираш в класирането, не си в списъка със зрители на никого и няма съобщения за присъединяване, напускане или отбора, свързани с теб.
- Наказанията, които налагате, докато сте в скрит режим, се показват само на другите администратори.
- `!hide` Отново, или като се присъедините към екип, това ви прави забележими.
- По избор: администраторите се присъединяват автоматично към скритите групи.
- Освен това ви скрива от `status`конзолната команда, когато е инсталиран плъгин на Metamod за скриване на статуса.
### 👀 За вашите играчи
- **`!admins`** показва кои администратори са онлайн в момента.
- Администраторите могат да се скрият от списъка с помощта на `!adminhide`.
### 📝 Лог файлове и Discord
- Всяка промяна, извършена от администратора, и всяко наказание се записват: кой какво е направил, на кого, кога и защо.
- **Известия в Discord** с изчистени вградени елементи за забрани, ограничения, предупреждения, промени в администрацията и др.
- Промените, свързани с администраторите и групите, които са направени директно в базата данни или на вашия уебсайт, също се записват.
### 🌍 Езици
- Включени са английски и български език. Превключване с едно натискане на бутона.
- Всяко съобщение може да бъде редактирано, като се поддържат цветове.
- Добавете свой собствен език, като копирате един файл.
---
## Команди
Всички команди работят в чата с (`!`видими) или `/`(невидими), а в конзолата на сървъра – с `css_`.
| Команда | Какво прави |
|---|---|
| `!admin` | Меню „Наказания“ |
| `!am` | Меню за администриране |
| `!ban <player> [time] [reason]` | Забраняване на играч (Steam акаунт + IP) |
| `!addban <steamid> [time] [reason]` | Забрана на офлайн играч |
| `!unban <steamid/ip>` | Премахване на забрана |
| `!kick <player> [reason]` | Изгони играч |
| `!gag` / `!mute` / `!silence <player> [time] [reason]` | Блокиране на чат / гласови разговори / и двете |
| `!ungag` / `!unmute` / `!unsilence <player>` | Повдигни го отново |
| `!warn <player> [time] [reason]` | Предупреди играч |
| `!warns` / `!unwarn <player>` | Показване/скриване на предупрежденията |
| `!slap <player> [damage]` · `!slay <player>` | Удар / поразяване |
| `!team <player> <t/ct/spec>` | Прехвърли се в отбор |
| `!rename <player> <name>` | Преименуване на играч |
| `!freeze` / `!unfreeze <player>` | Замразяване на играч |
| `!respawn` · `!noclip` · `!god <player>` | Забавни команди |
| `!bring` / `!goto <player>` | Телепорт |
| `!hp` · `!speed` · `!gravity <player> <value>` | Здраве, скорост, гравитация |
| `!map <map>` · `!wsmap <id>` | Смени картата |
| `!rr` | Рестартирай играта |
| `!rcon <command>` · `!cvar <cvar> [value]` | Сървърни команди |
| `!asay` · `!say` · `!csay` · `!hsay` · `!psay` | Чат за администратори и съобщения |
| `!who <player>` · `!players` | Информация за играча |
| `!admins` · `!adminhide` | Списък с администраторите онлайн |
| `!hide` | Режим „невидим зрител“ за администраторите |
**Времето** може да се изписва като `30`(минути), `12h`, `7d`, `4w`, или `0`за продължителност.
**„Играч“** може да бъде име, `#userid`, SteamID или група като `@t`, или`@ct` `@all`.
Административно управление (от конзолата или от собственика):
`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`.
---
## Опростени разрешения
Всяка команда заема отделен ред в**`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"] }
```
- **Променете дадено разрешение,** като редактирате една дума. Можете дори да измислите свое собствено, например `@css/god`.
- **Оставете го празно** (`""`) и всеки играч ще може да използва командата.
- **Добавете допълнителни имена**: това позволява`["slay", "kill"]` `!slay`и двете да работят`!kill`.
- **Деактивирайте командата** с `"Enabled": false`.
Правата по подразбиране следват тези на SimpleAdmin, като настройките за „здраве“, „скорост“ и „тежест“ са малко по-строги по подразбиране, а импортът от SimpleAdmin копира точно вашата конфигурация, така че вашите администратори запазват достъпа, с който са свикнали.
---
## Идвате ли от SimpleAdmin?
С една команда всичко се премества:
```
css_am_import_simpleadmin ← shows what will be imported (nothing is changed)
css_am_import_simpleadmin confirm ← imports it
```
Това пренася:
- ✅ Всички администратори и групи, заедно с техните права, имунитет и срокове на валидност
- ✅ Всички активни забрани, ограничения на изразяването, заглушавания, блокирания и предупреждения, заедно с оставащото време
- ✅ Правата за достъп до команди и имената на команди, точно както са били
- ✅ Групите, които се срещат два пъти в SimpleAdmin, се обединяват в една, точно както се прави в SimpleAdmin в играта
- ✅ `!hide`замества командата „hide“ на SimpleAdmin и неговия модул „Stealth“
Данните ви в SimpleAdmin се четат само, без да се променят или изтриват. Можете да стартирате импорта отново по всяко време и нищо няма да се дублира.
**Останалите ви плъгини продължават да работят.** Плъгините за чат етикети, VIP и менюта, които проверяват администраторските групи (като `#Staff`), все още разпознават вашите администратори: всеки администратор е добавен в група със същото име като групата му в Admin Manager. Имената на групите не могат да съдържат интервали, така че групата „SimpleAdmin“ се `#Staff Manager`превръща в `#Staff_Manager`— актуализирайте това име в конфигурациите на тези плъгини.
Ако SimpleAdmin все още е инсталиран, Admin Manager ви предупреждава и го деактивира автоматично, така че двете програми никога да не си пречат взаимно.
---
## Изисквания
- **CounterStrikeSharp** v1.0.368 или по-нова версия
- База данни **MySQL** или **MariaDB**
- **MenuManager** *(незадължително)*, необходимо само за `!am`менютата и`!admin`
---
## Инсталиране
1. Копирайте папката `AdminManager`в `addons/counterstrikesharp/plugins/`.
2. Стартирайте сървъра веднъж. Файловете с настройките се създават автоматично.
3. Отворете `addons/counterstrikesharp/configs/plugins/AdminManager/AdminManager.json`и въведете данните за вашата база данни.
4. Рестартирайте сървъра. Таблиците на базата данни се създават автоматично.
5. Назначете се за администратор от конзолата на сървъра:
```
css_am_group_add Owner @css/root 100
css_am_add <your SteamID64> Owner
```
Това е всичко. Въведете командата в`!am` играта, за да управлявате всичко от менюто.
---
## Настройките на един поглед
**`AdminManager.json`**: основните настройки
- Свързване с база данни
- Език (`en` / `bg`) и префиксът за чата
- Стандартни срокове за забрани, ограничения на изказването и предупреждения, както и наказанията, свързани с предупрежденията
- Кой вижда съобщенията за наказания (всички, само администраторите или никой)
- Режим „Скритост“: автоматично скриване на администраторите, когато се присъединят
- Дали администраторите също са добавени в групите на CounterStrikeSharp (по подразбиране е включено)
- Уебхук за Discord
- Идентификатор на сървъра, ако използвате няколко сървъра с една база данни
**`commands.json`**: всяка команда, нейните права за достъп и имената ѝ
**`lang/en.json`, `lang/bg.json`**: всяко съобщение, което плъгинът показва
Всички файлове се създават автоматично с подходящи настройки по подразбиране. Грешките се отчитат ясно в конзолата на сървъра, а плъгинът продължава да работи.
---
## Често задавани въпроси
**Трябва ли да рестартирам системата, когато добавям администратор?**
Не. Новите администратори получават правата си незабавно, дори ако вече са на сървъра.
**Мога ли да добавям администратори от моя уебсайт?**
Да. Запишете данните в базата данни и сървърът ги засича автоматично в рамките на една минута.
**Може ли забранен играч да се присъедини отново чрез повторно свързване?**
Не. Забраните, ограниченията за изразяване и блокирането на звука се съхраняват в базата данни и се проверяват при всяко присъединяване на играч.
**Може ли забранен играч да се върне с втори Steam акаунт?**
Не от същата връзка: всяка забрана блокира и IP адреса на играча. Вашите администратори никога не биват изхвърляни от играта, защото споделят IP адрес с забранен играч.
**Имам няколко сървъра. Трябва ли да добавям администратори на всеки един от тях?**
Не. Насочете всички сървъри към една и съща база данни. Все пак можете да предоставите администраторски права на някого само за един сървър.
**Ще продължат ли останалите ми плъгини да разпознават администраторите?**
Да. Admin Manager предоставя на администраторите стандартните права за достъп в CounterStrikeSharp и ги добавя към групите в CounterStrikeSharp, така че плъгините, които проверяват правата за достъп (`@css/ban`) или групите (`#Admin`), работят както обикновено.
**Моят плъгин за чат етикети/VIP използваше имена на групи в SimpleAdmin с интервали. Какво да правя сега?**
Имената на групите не могат да съдържат интервали, затова се `#Staff Manager`превръща в `#Staff_Manager`след импортирането. Променете това име в конфигурацията на другия плъгин и всичко ще заработи отново.
**Има ли режим на скриване/невидимост, подобен на този в SimpleAdmin?**
Да`!hide`. Превръщаш се в невидим зрител: нито на таблото с резултатите, нито в списъка със зрителите, и няма съобщения за присъединяване или напускане.
**Мога ли да преведа плъгина?**
Да. Копирайте `lang/en.json`и преведете текстовете и задайте езика в конфигурацията.