Ru/Master Server Query Protocol

На этой странице документируется протокол запросов к главному серверу Steam. Старый мастер-сервер по-прежнему используется более старыми играми и модами, но все текущие игры и моды запрашивают мастер-сервер непосредственно через Steam.
==От клиента к мастер серверу==
Отправьте следующий UDP-запрос на главный сервер, чтобы получить список серверов Source.
===Формат===
Тип	Поле 	Значение
 	Message Type	Символ '1' (0x31)
 	Region Code 	См. ниже
 	IP:Port 	См. ниже
 	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\ фильтр для отфильтровывания игр (которые предназначены для объединения с помощью функции матчмейкинга).
 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.
Формат представляет собой серию блоков адресов этих серверов:
Тип 	Данные
 	Первый октет IP-адреса
 	Второй октет IP-адреса
 	Третий октет IP-адреса
 	Четвёртый октет IP-адреса
Unsigned	Номер порта — обычно 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" игровой сервер посылает свою информацию о вызове в следующем формате:
========
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.
========
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 .
========
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.
====Различия====
Порядок расположения полей в немного отличается от порядка расположения полей в .
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 Community, Source и GoldSrc, а также к мастер-серверам Steam. В настоящее время она реализована на Java, PHP и Ruby.
* — пример кода для разбора пакета (Visual Basic).
* User:Pizzahut/msqp.php — пример кода для запроса мастер-сервера с использованием языка PHP.
* QueryMaster C# library
* vmsq Node.js implementation for querying master servers
==См. также==
* 
*