super-admin-menu/README.md

# Super Admin Menu

Расширенное меню администратора для CS:GO серверов на SourceMod. Открывается одной командой и предоставляет все нужные инструменты управления игроками с разграничением прав.

## Функции

- Выдача снаряжения (сет с оружием): AK-47, M4A4, M4A1-S, AWP, Deagle Only
- Выдача денег: 3000 / 5000 / 10000 / 16000$
- Респавн игроков (себе / всем / конкретному игроку)
- Восстановление 100 HP + 100 Armor
- Невидимость для администратора с сокрытием оружия
- Телепорт к игроку / телепорт игрока к себе
- Телепорт на плент A или B (автоопределение по карте)
- Эффекты на игрока:
  - 0 урона при стрельбе
  - Супер-отдача
  - Drug-эффект (дёргание экрана + случайный FOV)
  - Случайный FOV
  - Инверсия движения
  - Сильное сотрясение экрана
- Уведомления о действиях в чате членам групп DEIDARA / TESTER
- Логирование действий обычных админов в файл

## Зависимости

- [SourceMod](https://www.sourcemod.net/) 1.10+
- [SDKHooks](https://wiki.alliedmods.net/SDK_Hooks) (входит в SourceMod)
- [CS:Strike](https://wiki.alliedmods.net/CSStrike) (входит в SourceMod)

## Установка

1. Скомпилировать `scripting/super_admin_menu.sp`
2. Положить `.smx` в `addons/sourcemod/plugins/`
3. Перезапустить сервер или загрузить плагин: `sm plugins load super_admin_menu`

## Команды

| Команда | Доступ | Описание |
|---|---|---|
| `!sadmin` / `sm_sadmin` | Группа DEIDARA / TESTER или обычный админ (флаги `a`–`j`) | Открыть супер-админ меню |

## Уровни доступа

| Уровень | Возможности |
|---|---|
| Группа **DEIDARA** | Все функции меню (полный доступ) |
| Группа **TESTER** | Все функции меню (полный доступ) |
| Обычный админ (любые флаги `abcdefghij`, без `z`) | Только меню «Эффекты игрока» |
| Без админ-флагов | Доступ запрещён |

> Группы DEIDARA / TESTER определяются по имени группы в `admin_groups.cfg` (регистр не важен) — флаги роли не нужны.
> Обычные админы — все, у кого есть любой флаг кроме `z` (Root) и кто не состоит в группах DEIDARA/TESTER. Им доступно только подменю «Эффекты игрока» с полным набором эффектов.

## Логирование

Все действия **обычных админов** в подменю «Эффекты игрока» автоматически пишутся в лог-файл:

```
addons/sourcemod/logs/super_admin_menu.log
```

Формат записи:
```
[YYYY-MM-DD HH:MM:SS] АдминИмя (STEAM_X:Y:Z) -> Действие -> ВКЛ/ВЫКЛ на игроке Имя (STEAM_X:Y:Z)
```

Примеры:
```
[2026-05-01 18:42:11] AdminBob (STEAM_1:0:12345) -> 0 урона -> ВКЛ на игроке player1 (STEAM_1:1:67890)
[2026-05-01 18:42:34] AdminBob (STEAM_1:0:12345) -> Тряска экрана на игроке player2 (STEAM_1:0:55555)
```

Действия членов групп DEIDARA / TESTER в файл **не пишутся** (они отображаются только в чате другим членам этих групп через `PrintToRootAdmins`).

## Версия

`1.3.3` — Автор: deidara.dev

### Changelog

- **1.3.3**
  - Расстояние телепорта в пунктах «Телепорт к игроку» и «Телепортировать игрока к себе» увеличено с **20** до **75 юнитов** (раньше игроки оказывались впритык — теперь нормальная дистанция)
  - Author в `myinfo` приведён к `"deidara.dev"`

- **1.3.2**
  - Логирование переведено с `OpenFile` на `LogToFileEx` — родной механизм SourceMod, надёжно работает на shared-хостингах (MyArena и т.п.)
- **1.3**
  - Разграничение прав: обычные админы (флаги `a`–`j`, без `z`) теперь имеют доступ только к меню «Эффекты игрока»
  - Полный доступ — только у групп DEIDARA / TESTER
  - Добавлено логирование действий обычных админов в `addons/sourcemod/logs/super_admin_menu.log`
  - Удалён эффект «Ослепление на 2 секунды»
  - Удалён эффект «Инверсия мыши»
- **1.2** — Базовая версия меню