Как запустить Hytale сервер на MadHost

В данной статье описан официальный способ запуска Hytale сервера с учётом новой системы авторизации Hytale (OAuth 2.0).

⚠️ Важно: без прохождения авторизации сервер не сможет запуститься.


Шаг 1. Покупка сервера

  1. Перейдите на страницу заказа:
    https://my.madhost.pw/store/hytale

  2. Выберите подходящий тариф

  3. Оплатите заказ

После оплаты сервер автоматически появится в панели управления MadHost.


Шаг 2. Переход в панель управления

  1. Авторизуйтесь в панели управления MadHost

  2. Откройте ваш Hytale сервер

  3. Не запускайте сервер, пока не выполните шаги авторизации ниже


Почему сервер не запускается без токена

Hytale использует обязательную серверную авторизацию.
Каждый сервер должен быть привязан к аккаунту Hytale.

Если токены не указаны:

  • сервер не может скачать необходимые файлы

  • возникает ошибка 403 Forbidden

  • сервер останавливается

Это ограничение Hytale, а не хостинга.


Шаг 3. Получение токенов Hytale (Device Code Flow)

Данный шаг выполняется на вашем компьютере (Windows или Linux).
Команды одинаковы для обеих систем.

Требования

  • установлен curl

  • аккаунт Hytale с доступом к игре


Шаг 3.1. Запрос Device Code

Выполните команду:

 
curl -X POST "https://oauth.accounts.hytale.com/oauth2/device/auth" ^ -H "Content-Type: application/x-www-form-urlencoded" ^ -d "client_id=hytale-server" ^ -d "scope=openid offline auth:server"

Вы получите ответ вида:

 
{ "device_code": "...", "user_code": "ABCD-1234", "verification_uri": "https://accounts.hytale.com/device", "verification_uri_complete": "https://accounts.hytale.com/device?user_code=ABCD-1234", "expires_in": 900 }

Шаг 3.2. Подтверждение входа

  1. Откройте в браузере:
    https://accounts.hytale.com/device

  2. Войдите в аккаунт Hytale
  3. Введите user-code, например ABCD-1234


Шаг 3.3. Получение OAuth токенов

После подтверждения входа выполните:

 
curl -X POST "https://oauth.accounts.hytale.com/oauth2/token" ^ -H "Content-Type: application/x-www-form-urlencoded" ^ -d "client_id=hytale-server" ^ -d "grant_type=urn:ietf:params:oauth:grant-type:device_code" ^ -d "device_code=DEVICE_CODE"

Успешный ответ:

 
{ "access_token": "ACCESS_TOKEN", "refresh_token": "REFRESH_TOKEN", "expires_in": 3600 }

Шаг 3.4. Получение UUID профиля

 
curl -X GET "https://account-data.hytale.com/my-account/get-profiles" ^ -H "Authorization: Bearer ACCESS_TOKEN"

Ответ:

 
{ "profiles": [ { "uuid": "PROFILE_UUID", "username": "ServerOperator" } ] }

Шаг 3.5. Создание серверной сессии

 
curl -X POST "https://sessions.hytale.com/game-session/new" ^ -H "Authorization: Bearer ACCESS_TOKEN" ^ -H "Content-Type: application/json" ^ -d "{\"uuid\":\"PROFILE_UUID\"}"

Ответ:

 
{ "sessionToken": "SESSION_TOKEN", "identityToken": "IDENTITY_TOKEN", "expiresAt": "2026-01-07T15:00:00Z" }

Именно эти два токена используются сервером для авторизации.


Шаг 4. Указание токенов в панели управления

В панели управления сервера перейдите в раздел Запуск
и заполните Токен сессии и Токен идентификации


Шаг 5. Запуск сервера

  1. Запустите сервер

  2. В логах сервера должно появиться сообщение об успешной авторизации

  3. Сервер готов к использованию

Esta resposta lhe foi útil? 1 Usuários acharam útil (2 Votos)