Master Server Query Protocol
На этой странице документируется протокол запросов к главному серверу Steam. Старый мастер-сервер по-прежнему используется более старыми играми и модами, но все текущие игры и моды запрашивают мастер-сервер непосредственно через Steam.
Contents
От клиента к мастер серверу
Отправьте следующий UDP-запрос на главный сервер, чтобы получить список серверов Source.
Формат
| Тип | Поле | Значение |
|---|---|---|
| Byte | Message Type | Символ '1' (0x31) |
| Byte | Region Code | См. ниже |
| String Zero | IP:Port | См. ниже |
| String Zero | Filter | См. ниже |
Региональные коды
Регион мира, в котором вы хотите найти серверы.
| Байт | Комментарий |
|---|---|
| 0x00 | Восточное побережье США |
| 0x01 | Западное побережье США |
| 0x02 | Южная Америка |
| 0x03 | Европа |
| 0x04 | Азия |
| 0x05 | Австралия |
| 0x06 | Ближний Восток |
| 0x07 | Африка |
| 0xFF | Остальной мир (Океания) |
IP:Port
Первый IP:Port, который вы должны послать это "0.0.0.0:0".
С этого момента IP:Port становится последним IP:Port, полученным в ответе главного сервера. Это позволяет затем захватить другой список дополнительных серверов. Закончите её с нуль-терминированной строкой (0x00)
Обратите внимание, что всякий раз, когда вы открываете новый сокет (и таким образом получаете новый случайный клиентский порт), Мастер-сервер всегда будет посылать вам первую партию IP-адресов, даже если вы пропустили действительный IP-адрес игрового сервера. Не закрывайте сокет между пакетами.
Filter
Позволяет ограничить результаты на серверах, на которых запущена определённая игра, карта и т. д.
Вставить \ между параметрами фильтра
| Код фильтра | Что возвращает фильтр |
|---|---|
0x00 (NULL, пустая строка) |
Все сервера |
\nor\[x] |
Специальный фильтр, указывает, что серверы, соответствующие любым из следующих условий [x] не должны возвращаться |
\nand\[x] |
Специальный фильтр, указывает, что серверы, соответствующие всем из следующих условий [x], не должны возвращаться |
\dedicated\1 |
Выделенные сервера |
\secure\1 |
Серверы, использующие технологию анти-читов (VAC, но потенциально и другие). |
\gamedir\[mod] |
Серверы с указанной модификацией (например, tf) |
\map\[map] |
Серверы, работающие с указанной картой (например, ctf_2fort). |
\linux\1 |
Серверы, работающие на платформе Linux |
\password\0 |
Серверы, которые не защищены не паролем |
\empty\1 |
Серверы, которые не пустые |
\full\1 |
Серверы, которые не полные |
\proxy\1 |
Серверы, являющиеся прокси-серверами |
\appid\[appid] |
Серверы, на которых запущена игра [appid] |
\napp\[appid] |
Серверы, на которых НЕ запущена игра [appid] (Это было введено для блокирования левых 4 мертвых игр из браузера парового сервера). |
\noplayers\1 |
Серверы на которых нет игроков |
\white\1 |
Серверы внесённые в белый список |
\gametype\[tag,...] |
Серверы со всеми тегами, которые перечислены в запросе, которые находятся в sv_tags
|
\gamedata\[tag,...] |
Серверы со всеми тегами, которые перечислены в запросе, в 'скрытых' тегах (L4D2) |
\gamedataor\[tag,...] |
Серверы с любыми тегами, которые перечислены в запросе, в 'скрытых' тегах (L4D2) |
\name_match\[hostname] |
Серверы с совпадающим именем хоста [hostname] (можно использовать '*' в качестве wildcard) |
\version_match\[version] |
Серверы с запущенной версией [version] (может использовать '*' в качестве wildcard) |
\collapse_addr_hash\1 |
Возвращать только один сервер для каждого уникального IP-адреса |
\gameaddr\[ip] |
Возвращать только сервера с указанным IP-адресом (можно указать порт, он поддерживается и необязателен) |
Пример запроса
Получить все сервера отовсюду:
0000 31 FF 30 2E 30 2E 30 2E 1.0.0.0. 0008 30 3A 30 00 00 0:0..
Это стандартный запрос браузера сервера Steam к Source Master Server.
Он использует \napp\ фильтр для отфильтровывания игр 
Left 4 Dead (которые предназначены для объединения с помощью функции матчмейкинга).
31 ff 30 2e 30 2e 30 2e 30 3a 30 00 5c 6e 61 70 1.0.0.0.0:0.\nap 70 5c 35 30 30 00 p\500.
Формат ответа
Ответ всегда начинается с FF FF FF 66 0A.
Формат представляет собой серию блоков адресов этих серверов:
| Тип | Данные |
|---|---|
| Byte | Первый октет IP-адреса |
| Byte | Второй октет IP-адреса |
| Byte | Третий октет IP-адреса |
| Byte | Четвёртый октет IP-адреса |
| Unsigned Short | Номер порта — обычно 27015 (69 87) — это network ordered, который отличается от всех других протоколов Steam.
|
Некоторые из серверов могут быть недоступны, поэтому запросите каждый сервер напрямую, чтобы выяснить это.
Примечание:Обратите внимание, что этот список не является исчерпывающим, поэтому, если вы ищете определённый тип сервера, убедитесь, что вы указали фильтр с запросом, а не фильтрацию с клиентской стороны.Конец списка IP-адресов
Полный запрошенный список IP-адресов может не поместиться в 1 пакет. Последующие пакеты должны быть запрошены с использованием последнего полученного IP-адреса и порта в качестве seed в следующем запросе.
Конец списка IP-адресов обозначается полученным IP-адресом 0.0.0.0. Порт: "0".
Игровой сервер к мастер серверу
Соединение
Вскоре после инициализации игрового сервера, он выбирает два главных сервера, чтобы "присоединиться". Для того чтобы клиенты увидели конкретный игровой сервер, когда они нажимают на вкладку "Интернет", игровой сервер должен присутствовать в записях мастер-серверов Steam.
Игровой сервер посылает каждому мастер серверу "q" (71).
Мастер сервер каждый раз отвечает посылая FF FF FF 73 0A, за которым следует уникальное 4-байтовое "challenge" число. Если вы отправите недействительный вызов мастер серверам, вы получите другой вызов в качестве ответа.
Ответ на вызов
После получения пакета "challenge" игровой сервер посылает свою информацию о вызове в следующем формате:
Примечание:Номер "challenge" — это просто вызов, посланный мастер сервером, преобразованный в int
GoldSrc
002a 30 0a 5c 70 72 6f 0.\pro 0030 74 6f 63 6f 6c 5c 34 37 5c 63 68 61 6c 6c 65 6e tocol\47\challen 0040 67 65 5c 31 33 33 39 38 39 35 37 30 32 5c 70 6c ge\1339895702\pl 0050 61 79 65 72 73 5c 30 5c 6d 61 78 5c 32 5c 62 6f ayers\0\max\2\bo 0060 74 73 5c 30 5c 67 61 6d 65 64 69 72 5c 63 73 74 ts\0\gamedir\cst 0070 72 69 6b 65 5c 6d 61 70 5c 64 65 5f 64 75 73 74 rike\map\de_dust 0080 5c 74 79 70 65 5c 64 5c 70 61 73 73 77 6f 72 64 \type\d\password 0090 5c 30 5c 6f 73 5c 6c 5c 73 65 63 75 72 65 5c 30 \0\os\l\secure\0 00a0 5c 6c 61 6e 5c 30 5c 76 65 72 73 69 6f 6e 5c 31 \lan\0\version\1 00b0 2e 31 2e 32 2e 35 2f 53 74 64 69 6f 5c 72 65 67 .1.2.5/Stdio\reg 00c0 69 6f 6e 5c 32 35 35 5c 70 72 6f 64 75 63 74 5c ion\255\product\ 00d0 63 73 74 72 69 6b 65 0a cstrike.
Source
002a 30 0a 5c 70 72 6f 0.\pro 0030 74 6f 63 6f 6c 5c 37 5c 63 68 61 6c 6c 65 6e 67 tocol\7\challeng 0040 65 5c 31 33 33 39 36 31 38 32 33 5c 70 6c 61 79 e\133961823\play 0050 65 72 73 5c 30 5c 6d 61 78 5c 32 5c 62 6f 74 73 ers\0\max\2\bots 0060 5c 30 5c 67 61 6d 65 64 69 72 5c 63 73 74 72 69 \0\gamedir\cstri 0070 6b 65 5c 6d 61 70 5c 64 65 5f 64 75 73 74 5c 70 ke\map\de_dust\p 0080 61 73 73 77 6f 72 64 5c 30 5c 6f 73 5c 6c 5c 6c assword\0\os\l\l 0090 61 6e 5c 30 5c 72 65 67 69 6f 6e 5c 32 35 35 5c an\0\region\255\ 00a0 74 79 70 65 5c 64 5c 73 65 63 75 72 65 5c 30 5c type\d\secure\0\ 00b0 76 65 72 73 69 6f 6e 5c 31 2e 30 2e 30 2e 32 38 version\1.0.0.28 00c0 5c 70 72 6f 64 75 63 74 5c 63 73 74 72 69 6b 65 \product\cstrike 00d0 0a .
Orangebox
0000 30 0a 5c 70 72 6f 74 6f 63 6f 6c 5c 37 5c 63 68 0.\protocol\7\ch 0010 61 6c 6c 65 6e 67 65 5c 31 39 35 39 36 38 37 33 allenge\19596873 0020 39 39 5c 70 6c 61 79 65 72 73 5c 31 5c 6d 61 78 99\players\1\max 0030 5c 34 5c 62 6f 74 73 5c 30 5c 67 61 6d 65 64 69 \4\bots\0\gamedi 0040 72 5c 74 66 5c 6d 61 70 5c 61 72 65 6e 61 5f 62 r\tf\map\arena_b 0050 61 64 6c 61 6e 64 73 5c 70 61 73 73 77 6f 72 64 adlands\password 0060 5c 30 5c 6f 73 5c 77 5c 6c 61 6e 5c 31 5c 72 65 \0\os\w\lan\1\re 0070 67 69 6f 6e 5c 2d 31 5c 67 61 6d 65 74 79 70 65 gion\-1\gametype 0080 5c 61 72 65 6e 61 5c 74 79 70 65 5c 6c 5c 73 65 \arena\type\l\se 0090 63 75 72 65 5c 30 5c 76 65 72 73 69 6f 6e 5c 31 cure\0\version\1 00a0 2e 30 2e 34 2e 33 5c 70 72 6f 64 75 63 74 5c 74 .0.4.3\product\t 00b0 66 0a f.
Различия
Порядок расположения полей в Source немного отличается от порядка расположения полей в GoldSrc.
| Goldsource | protocol | challenge | players | max | bots | gamedir | map | type | password | os | secure | lan | version | region | product |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Source | protocol | challenge | players | max | bots | gamedir | map | password | os | lan | region | type | secure | version | product |
Heartbeat-сообщение
"Heartbeat" происходит каждые пять минут, чтобы дать знать мастер-серверам, что игровой сервер всё ещё "жив". Игровой сервер просто проходит через процесс "присоединения" к списку мастер-серверов снова.
Выход
Игровой сервер посылает главному серверу байты, чтобы сигнализировать, что игровой сервер выключился.
| Движок | Байты |
|---|---|
| GoldSrc | 62 0A |
| Source | 62 0A 00 |
Мастер сервера
Работающие:
| Движок | IP:Port |
|---|---|
| GoldSrc | hl1master.steampowered.com:27010 |
| Source | hl2master.steampowered.com:27011 |
Реализации
- Asynchronous Game Query Library Java 8 библиотека асинхронных игровых запросов на основе Netty
- Steam Condenser — многоязычная библиотека для запросов к игровым серверам Steam Community, Source и GoldSrc, а также к мастер-серверам Steam. В настоящее время она реализована на Java, PHP и Ruby.
- Master Server Query Protocol/Parsing packet — пример кода для разбора пакета (Visual Basic).
- User:Pizzahut/msqp.php — пример кода для запроса мастер-сервера
Half-Life с использованием языка PHP. - QueryMaster C# library
- vmsq Node.js implementation for querying master servers
