Руководство для специалистов поддержки¶

Вводный документ для специалистов поддержки и AI-помощника. Прочитайте перед работой с обращениями.

Что такое VS:RP¶

VS:RP — русскоязычный ролевой сервер GTA San Andreas Multiplayer (SA-MP/open.mp). Игроки создают персонажей и взаимодействуют в открытом мире: работают, владеют имуществом, вступают в организации, участвуют в криминальной или легальной деятельности.

Важно: большинство «проблем» игроков — это игровые механики, а не технические ошибки. Ключевой навык поддержки — отделить «так работает игра» от «что-то сломалось».

Структура базы знаний¶

Docs/
├── player/          — документация для игроков
│   ├── getting-started.md   — первые шаги
│   ├── commands.md          — все команды
│   ├── character.md         — характеристики, навыки, смерть
│   ├── inventory.md         — инвентарь, предметы
│   ├── economy.md           — деньги, работа, заправка
│   ├── property.md          — дома, бизнесы, фермы
│   ├── transport.md         — транспорт, аренда
│   ├── fractions.md         — организации, команды
│   ├── quests.md            — задания
│   ├── roleplay.md          — RP-механики, чат
│   ├── zones.md             — безопасные зоны, захват территорий
│   ├── social.md            — брак, развлечения, Таро
│   ├── stocks.md            — биржа, трейдинг
│   └── world.md             — NPC, локации, GPS, мир
└── support/
    ├── overview.md          — этот файл
    ├── common-issues.md     — частые проблемы и ответы
    └── admin-tools.md       — инструменты администратора

Роли и уровни доступа¶

На сервере три независимых статуса: администратор, тестер и обычный игрок.

Статус	Как получить	Команды	Примечание
Администратор (1–9)	Ручная выдача уровня	`[RequireAdmin(N)]`, `[RequireOnDuty]`	Обязательно `/alogin` (TOTP 2FA), иначе команды недоступны
Тестер	Флаг `IsTester` в БД	`[RequireTester]`, частично `[AllowTesterAccess]`	На тест-сервере доступна команда `/gettester`
Игрок	—	—	—

Уровни администратора: 1 Помощник, 2 Мл. модератор, 3 Модератор, 4 Ст. модератор, 5 Администратор, 6 Ст. администратор, 7 Гл. администратор, 8 Спец. администратор, 9 Основатель.

Авторизация админки требует Google Authenticator (TOTP). При первом входе секрет генерируется и показывается один раз — после этого привязка обязательна. Для локальных IP (127.0.0.1, 192.168.*) 2FA пропускается.

Как отвечать на обращения¶

Принципы¶

Сначала проверьте по базе — большинство вопросов уже описаны в разделах player/ и support/common-issues.md.
Не обещайте невозможного — возврат предметов и денег только через старшего администратора и только с доказательствами.
Разграничивайте уровни — часть вопросов решаете вы, часть — только старший админ или разработчик.
Уточняйте детали — перед эскалацией соберите: ник персонажа, время события, обстоятельства, скриншоты/видео.

Матрица эскалации¶

Тип проблемы	Кто решает
Вопрос о механике игры	Специалист поддержки (ответ из базы знаний)
Команда/UI не работает	Специалист поддержки → проверить по доке → при необходимости старший
Потеря данных (предметы, деньги)	Старший администратор (5+), ручная проверка
Блокировка по античиту	Старший администратор (5+), обязательна ручная проверка CheatersPanel + /re
Восстановление пароля / 2FA	Старший администратор (через БД)
Сброс привязки Google Authenticator	Администратор 9 (поле `GAuthSecret` в `PlayerData`)
Баг в механике игры	Технический администратор / разработчик
Жалоба на нарушение правил	Дежурный админ через `/takerep`; игрок — через `/report` или `/ask`

Частые заблуждения игроков¶

Что говорит игрок	Что на самом деле
«Пропали деньги из инвентаря»	Наличные и банковский счёт — разные кошельки. В `/stats` наличные, в банкомате и банке — счёт.
«Потерял машину»	Личные авто уходят в гараж. Команда: `/loadcar <номер>`
«Не могу передать права другому»	Документы и лицензии непередаваемы — это задумано.
«Меня убили в безопасной зоне»	Зелёная зона отключает только физический урон, не RP-механики.
«Квест завис»	Обычно не выполнено предыдущее условие. Проверить: `/quest`
«Вышел из фракции без причины»	Решение руководства фракции, поддержка не вмешивается
«Арендованная машина исчезла»	Истёк срок аренды — это нормально
«При смерти не спросили, где возродиться»	Правильно: сервер всегда отправляет в больницу после ~3 сек. Выбор «дом/больница» не реализован.

Тон общения¶

Вежливо, по-русски, без официоза.
Не используйте игровой сленг в ответах на непонятные вопросы.
Если не знаете ответа — не гадайте, эскалируйте.
Никаких обещаний от имени администрации без прямого согласования.

Контекст для AI-помощника¶

Если вы — AI-ассистент поддержки, используйте эту базу знаний как единственный источник истины. Порядок работы:

Определите тему обращения.
Найдите релевантный раздел в player/ или support/common-issues.md.
Сформулируйте ответ на основе документации — кратко и понятно.
Если ответа нет в базе — сообщите игроку, что вопрос передаётся специалисту.
Никогда не придумывайте механики, которых нет в документации.