RCON и инструменты админа в WARDOGS

Что такое RCON в WARDOGS

RCON в WARDOGS — это не старый сокетный протокол в стиле Source. Выделенный сервер запускает небольшой HTTP API с версионированием по пути /v1, который отвечает в JSON. Каждый запрос передаёт пароль RCON как bearer-токен, и один и тот же токен даёт право и на чтение, и на запись: роли «только чтение» нет, поэтому давай пароль только тем админам, которым доверяешь, а для всех остальных поставь перед ним панель с отдельными логинами.

По умолчанию слушатель выключен. Он включается в файле сервера ServerSettings.ini, в разделе WDRCONSettings: там задаются адрес привязки, порт (по умолчанию 7776, его можно задать и параметром запуска) и пароль открытым текстом или хеш пароля. Слушатель, привязанный к чему-либо, кроме loopback, обязан использовать TLS, поэтому хостер, который открывает тебе RCON, выдаст https-адрес, порт и пароль.

Что с ним могут делать админы

В API около 35 эндпоинтов. Вот те, что нужны каждый день:

• Статус и список подключённых игроков со Steam ID.
• Кикнуть, убить, написать игроку и перевести его в другую фракцию; отправить сообщение всем.
• Бан и разбан по Steam ID с сохраняемым бан-листом; резервные слоты — так же.
• Сменить карту прямо сейчас, завершить или перезапустить матч, менять освещение и погоду на лету.
• Читать, править и сохранять ротацию карт; справочные эндпоинты перечисляют карты, режимы и пресеты освещения, которые принимает сервер.
• Получать, проверять и заменять весь конфиг сервера, а также читать журнал аудита действий админов.

Как получить доступ у хостера

Серверы WARDOGS есть только у трёх одобренных хостеров, так что доступ к RCON — ровно такой, какой дают их панели. Перед арендой спроси:

Официальной документации для разработчиков пока нет. Самый полный справочник — неофициальный, его ведёт сообщество на wardogs.tech: там описан каждый эндпоинт и ключ конфига и есть файл OpenAPI, по которому можно сгенерировать клиент.

• Включён ли слушатель RCON, доступен ли он снаружи по TLS и можно ли задать пароль самостоятельно?
• Можно ли править ServerSettings.ini напрямую или только через панель?
• Сохраняет ли панель баны и ротацию после перезапусков и переустановок?
• Можно ли подключить к серверу стороннюю панель или обязательно пользоваться вашей?

Неофициальный справочник по RCON API WARDOGS (wardogs.tech) ↗

BattleMetrics

BattleMetrics добавил WARDOGS в свой RCON-сервис, так что если твоё сообщество уже управляет там другими играми, можно добавить сервер WARDOGS по адресу и паролю RCON и получить список игроков, инструменты кика и бана и логи в том же месте.

Сверх бесплатного тарифа сервис платный, и он хранит твой пароль RCON, который здесь даёт полный доступ. Это цена того, что ничего не нужно поднимать у себя.

BattleMetrics: поддержка RCON для WARDOGS ↗

Warcon: панель RCON, которую можно поднять у себя

Мы сделали Warcon — панель RCON с открытым кодом для выделенных серверов WARDOGS. Она стоит между твоими админами и RCON-слушателем сервера, так что у каждого админа свой логин и своя роль вместо общего пароля RCON. Она работает с несколькими серверами, ведёт журнал аудита — кто что сделал — и покрывает перечисленные выше эндпоинты для игроков, банов, карт и ротации.

Она работает на Linux или в Docker, код лежит на GitHub под лицензией MIT, а если не хочется поднимать её у себя, есть готовая консоль на warcon.app. Доступ к RCON от хостера всё равно нужен — спроси о нём до аренды.

Warcon: панель RCON с открытым кодом для WARDOGS ↗

Как держать сервер, пока нет инструментов

Пусть в часы пик в игре будут админы. Принимай жалобы в одном канале Discord, и пусть их разбирает один человек. Правила — коротко. Кик или бан через API занимает секунды, если у кого-то есть пароль и способ отправить запрос, так что настрой это в первый же день, а не после первого грифера.