# Менеджер администрирования для 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 даже в том случае, если игрок не находится в сети.
- Наказанный игрок всегда видит, кто его наказал, за что и на какой срок.
### 🎮 Команды для игроков и сервера
- Перемещение игроков между командами, переименование, замораживание, возрождение, телепортация (призыв / переход), 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"]`обеспечит работу`!kill` как , так и`!slay` .
- **Отключите команду** с помощью `"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 дважды, объединяются в одну, точно так же, как это происходит в игре
- ✅ заменяет`!hide` команду «hide» из SimpleAdmin и его модуль Stealth
Данные SimpleAdmin только читаются, но никогда не изменяются и не удаляются. Вы можете в любой момент запустить импорт заново, и никаких дубликатов не возникнет.
**Остальные ваши плагины продолжают работать.** Плагины чата, VIP и меню, которые проверяют группы администраторов (например, `#Staff`), по-прежнему распознают ваших администраторов: каждый администратор помещается в группу с тем же названием, что и его группа в Admin Manager. Названия групп не могут содержать пробелы, поэтому группа SimpleAdmin `#Staff Manager`превращается в `#Staff_Manager`— обновите это название в настройках этих плагинов.
Если SimpleAdmin по-прежнему установлен, Admin Manager выдает предупреждение и автоматически отключает его, чтобы эти две программы не мешали друг другу.
---
## Требования
- **CounterStrikeSharp** версии 1.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`и переведите тексты, а затем установите язык в файле конфигурации.