Протокол сервера Classic — различия между версиями

Текущая версия на 03:21, 1 февраля 2013

Протокол сервера Classic используется в Minecraft Classic Creative Multiplayer сервере.

Связь с Minecraft.net

Сердцебиения

Чтобы подключится к серверу Classic из окна списка серверов, он должен поддерживать связь с основным сервером minecraft.net. Акт/сеанс такой связи называется "сердцебиение" и происходит каждые несколько минут.

Главный сервер посылает такие "сердцебиения" каждые 45 секунд.

"Сердцебиение" принимает форму HTTP-запроса на http://www.minecraft.net/heartbeat.jsp. После отправки "сердцебиения", URL-адрес для сервера возвращается.

Это может быть GET или POST запрос.Таблица необходимых параметров ниже:

Наиболее простым способом послать сердцебиение это открыть протокол TCP для порта 80 на www.minecraft.net, и послать следующее (изменяя соотвествующие части, очевидно):

GET /heartbeat.jsp?port=25565&max=32&name=My%20Server&public=True&version=7&salt=wo6kVAHjxoJcInKx&users=0, плюс CRLF (Carriage-return and Line feed - возврат каретки и перевод строки).

Убедитесь, что любые строки, типа "имя", заполнены.

Если все будет хорошо, то в теле ответа вы получите URL к серверу. В противном случае вы получите HTML сообщение об ошибке. Так как версия HTTP не определена, то отсутствуют HTML заголовки для парсинга, поскольку используется HTTP/0.9 в которой их не существует.

Авторизация пользователя

"Ключ" который образуется при подключении пользователя к серверу можно представляет собой контрольную сумму MD5 серверной "соли" плюс имя пользователя для определения конкретного пользователя, который подключился к minecraft.net. Это полезно при блокировке или смены привилегий пользователя, поскольку гарантирует его уникальность.

if( player.key == md5( server.salt + player.name ) ) {
 // игрок подключился к minecraft.net
} else {
 // игрок создает имя пользователя
}

Это также является методом, которым Нотч предотвращает возможность подключения с пиратских клиентов к онлайн-серверу. Когда пиратский клиент старается подключится к серверу, всплывает окно с ошибкой, гласящей: "Failed to Connect: User Not Premium" (Невозможно подключится: Отсутствует премиум-аккаунт)

Заметка: Это указывает на то, что вы должны держать свою "соль" в секрете, и распространять только с heartbeat.jsp. Если "соль" вашего сервера видна для других игроков, они смогут создать подобие правильного "ключа" и зайти на сервер без подключения к minecraft.net.

Пакеты протоколов

Каждый пакет начинается с байта, представляющего ID.

Протокол типов данных

Клиент → Сервер пакеты

Сервер → Клиент пакеты

Позиция игрока

Фиксированная точка

Позиция игрока представлена ​​через координаты X, Y, Z с фиксированной точкой. Дробная часть равна 5 битов, поэтому деление коротких целых чисел, полученных в пакетах обновления позиции на 32, будет иметь координаты с плавающей точкой для игрока. Эта позиция соответствует центру просмотра клиента.

Стоя на объектах

Нижний край стопы игрока расположен на 1.59375 (фиксированная точка: 51) блоков ниже центра окна просмотра, поэтому для определения, правильно ли расположен игрок, можно посылать teleport-пакет (0x08), в котором бы содержалось положение головы по оси Y от нижнего блока: Y x 32 = 51.

Ориентация

Параметр, отвечающий за рысканье при значении 0 указывает на то, что игрок смотрит в направлении Z=0 (противоположное Z). Это значение увеличивается, если игрок поворачивает взгляд в направлении часовой стрелки. Если направление, противоположное Z назвать "север", тогда значение "64" значит "восход", 128 - "юг" и 192 это "запад".

Значение 0 склонения означает линию горизонта, и это значение увеличивается в нисходящем направлении. 64 указывает на то, что игрок смотрит в точку надир (прямо под ноги), а 192 - в зенит (над головой). Интервал значений 64-191 никогда не может быть реализован, поскольку игрок не может смотреть выше или ниже чем 64 → 0, 255 → 192. Например, если игрок поворачивает камеру из надира вверх, то значение склонения будет спадать из 64 до 0, где 0 это линия горизонта. Далее, после пересечения этой линии значение изменится на 255 и будет спадать до 192. Однако клиент Minecraft Classic не делает анализ невозможных значений склонения, поэтому технически возможно обратить игрока "вверх ногами".

Коды цветов

Сообщения, отправленные с сервера на клиент может содержать коды цветов, которые позволяют окрашивать текст для различных целей.

Амперсанд (&), а затем шестнадцатеричное число в сообщении указывает клиенту сменить цвет при выводе текста.

Цветовое кодирование в начале сообщения будет работать только в том случае, если ID байт игрока меньше, чем 127. Если значение 127 или выше, игра автоматически добавляет &e до сообщения, что делает его желтым. Тем не менее, цветовые коды после первого символа до сих пор работают. Если вы используете ID ниже 127, это не добавляет цветовой код, так что те, которые вы используете, будут работать.

Важно отметить, что амперсанд (&) в конце сообщения, после которого не следуют шестнадцатеричные цифры, приведет к краху всех клиентов, которые получают его,поэтому он является обязательным с целью обезвреживания сообщений чата, полученных от клиентов.

Кроме того, &k даст немного прокрутки текста, который используется в Splash'ах и в Финальных титрах

Также &l, &m, &n и &o создает жирный, зачеркнутый, подчеркнутый и курсив соответственно, а &r сбрасывает предыдущие форматы текста.

Шестнадцате-ричное число цвета

Коды форматирования

Текст может быть отформатирован с использованием символа §, а затем буква. В настоящее время единственный способ использовать символ § скопировать и вставить его. Он не может быть использован на многопользовательских серверах (сервер "кикает" пользователя, который пытается использовать символ), но он может быть использованы в книгах, хотя почти невидим.

Если код цвета используется после форматирования кода, форматирование кода будет отключено.

§r может быть использован для сброса всех форматов текста за его пределами.

Например: §nXXX§rYYY, будет рассматриваться как: XXXYYY