КАК ЗАПУСТИТЬ СВОЙ СЕРВЕР HYTALE НА MACOS

Hytale вышла в Early Access 13 января 2026 года — и да, она работает на macOS. Hypixel Studios официально поддерживают Mac, включая Apple Silicon. Единственный нюанс: macOS любит всё усложнять с точки зрения безопасности. Gatekeeper, права доступа, App Firewall — всё это нужно обойти. Этот гайд написан специально для macOS 13 Ventura и выше, учитывает разницу между Intel и Apple Silicon, и не предполагает никакого опыта работы с терминалом.

Важное предупреждение: macOS — не лучшая платформа для постоянного серверного хостинга. MacBook засыпает, греется при нагрузке и имеет ограниченную RAM по сравнению с VPS. Для сервера на несколько друзей — подойдёт. Для публичного сервера 24/7 — рассмотрите VPS на Ubuntu.

---

СОДЕРЖАНИЕ

1. Системные требования и совместимость
2. Открываем Терминал
3. Устанавливаем Homebrew
4. Установка Java 25 через Homebrew
5. Создание папки сервера
6. Скачивание файлов сервера
7. Обходим Gatekeeper (macOS Security)
8. Настройка macOS Firewall
9. Проброс портов на роутере
10. Первый запуск и аутентификация
11. Конфигурация config.json
12. Создание скрипта запуска
13. Автозапуск через launchd
14. Обновление сервера
15. Оптимизация и решение проблем

---

1. СИСТЕМНЫЕ ТРЕБОВАНИЯ И СОВМЕСТИМОСТЬ

Параметр	Минимум	Рекомендуется
ОС	macOS 12 Monterey	macOS 13 Ventura или выше
RAM	4 GB (Unified Memory)	8–16 GB
CPU	Intel Core i5 / Apple M1	Apple M2/M3/M4 или Intel i7+
Диск	5 GB	20+ GB SSD
Java	Java 25 (обязательно!)	Eclipse Temurin 25 LTS
Архитектура	x64 или arm64	arm64 (Apple Silicon) — нативно
Порт	UDP 5520	UDP 5520 (протокол QUIC)

Apple Silicon (M1/M2/M3/M4) — что нужно знать

Hytale поддерживает архитектуру arm64 — это значит сервер запускается нативно на M-чипах без Rosetta. Производительность на Apple Silicon заметно лучше чем на старых Intel Mac.

• M1/M2/M3/M4 — нативная поддержка arm64, быстрый запуск, меньший нагрев
• Intel Mac — работает на x64, всё будет функционировать, но греется сильнее при нагрузке

Unified Memory на M-чипах: В отличие от обычных ПК, у MacBook с Apple Silicon RAM делится между CPU и GPU. 8 GB Unified Memory на M-чипе по производительности ближе к 12–16 GB обычной DDR5. Для небольшого сервера хватит.

---

2. ОТКРЫВАЕМ ТЕРМИНАЛ

Всё что нам понадобится — Терминал. macOS поставляется с ним из коробки.

Способы открыть Терминал:

• Spotlight: Cmd+Пробел → введите "Terminal" → Enter
• Finder: Программы → Утилиты → Terminal.app
• Launchpad: Папка "Другие" → Terminal

Совет: Закрепите Терминал в Dock — он вам понадобится часто. Правый клик по иконке → "Параметры" → "Оставить в Dock".

Если хотите более удобный терминал — установите iTerm2. Он бесплатный и значительно удобнее стандартного.

---

3. УСТАНАВЛИВАЕМ HOMEBREW

Homebrew — это пакетный менеджер для macOS. Через него проще всего установить Java и другие инструменты. Если он уже установлен — пропустите этот шаг.

Открываем Терминал и вставляем:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Установщик попросит пароль администратора и может занять несколько минут. Для Apple Silicon также попросит установить Xcode Command Line Tools — соглашаемся.

После установки на Apple Silicon (M1/M2/M3/M4) — добавляем Homebrew в PATH:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Примечание: На Intel Mac Homebrew устанавливается в /usr/local, на Apple Silicon — в /opt/homebrew. Команды выше нужны только для Apple Silicon.

Проверяем установку:

brew --version

Если видите версию — Homebrew работает.

---

4. УСТАНОВКА JAVA 25 ЧЕРЕЗ HOMEBREW

Hytale не запустится на Java ниже 25. Стандартный macOS не поставляется с Java — устанавливаем через Homebrew.

Добавляем репозиторий Adoptium (Temurin):

brew tap homebrew/cask-versions

Устанавливаем Temurin JDK 25:

brew install --cask temurin@25

Homebrew скачает и установит Java автоматически. На Apple Silicon установится нативная arm64-версия.

Проверяем версию:

java --version

Ожидаемый вывод:

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing)

Если команда java не найдена — нужно задать JAVA_HOME вручную. Добавляем в конец файла ~/.zprofile:

echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 25)' >> ~/.zprofile
source ~/.zprofile

Проверяем:

java --version
echo $JAVA_HOME

JAVA_HOME должна указывать на папку вида /Library/Java/JavaVirtualMachines/temurin-25.jdk/Contents/Home.

---

5. СОЗДАНИЕ ПАПКИ СЕРВЕРА

Создаём папку для сервера в домашней директории:

mkdir -p ~/HytaleServer
cd ~/HytaleServer

Итоговая структура будет выглядеть так:

~/HytaleServer/
├── HytaleServer.jar     ← основной файл сервера
├── Assets.zip           ← ассеты (~3.2 GB, обязателен!)
├── start.sh             ← скрипт запуска (создадим позже)
├── config.json          ← конфиг (создаётся при первом запуске)
└── worlds/              ← данные миров

Совет: Если вы планируете держать сервер долго — создайте папку на внешнем SSD или на диске с достаточным объёмом. Assets.zip занимает ~3.2 GB, плюс данные миров будут расти.

---

6. СКАЧИВАНИЕ ФАЙЛОВ СЕРВЕРА

Есть два способа получить файлы сервера:

Способ А — Копировать из установленной игры (быстро)

Если Hytale уже установлена на этом Mac, файлы сервера уже у вас. В Терминале:

cp -r "~/Library/Application Support/Hytale/install/release/package/game/latest/Server" ~/HytaleServer/
cp "~/Library/Application Support/Hytale/install/release/package/game/latest/Assets.zip" ~/HytaleServer/

Внимание на пробелы в пути. "Application Support" содержит пробел — именно поэтому путь заключён в кавычки. Без кавычек команда не сработает.

Способ Б — Официальный Downloader (рекомендуется)

Переходим в папку сервера:

cd ~/HytaleServer

Скачиваем официальный downloader:

curl -L -o hytale-downloader.zip https://downloader.hytale.com/hytale-downloader.zip

Распаковываем:

unzip hytale-downloader.zip

Даём права на выполнение. Определяем нужный бинарник по архитектуре:

# Для Apple Silicon (M1/M2/M3/M4):
chmod +x bin/hytale-downloader-darwin-arm64

# Для Intel Mac:
chmod +x bin/hytale-downloader-darwin-amd64

Запускаем скачивание серверных файлов:

# Apple Silicon:
./bin/hytale-downloader-darwin-arm64 --server

# Intel:
./bin/hytale-downloader-darwin-amd64 --server

Downloader запросит авторизацию через браузер — переходим по ссылке, вводим код. После авторизации начнётся скачивание архива вида 2026.01.13-50e69c385.zip.

Распаковываем:

unzip 2026.01.13-50e69c385.zip

Pre-release версия:

# Apple Silicon:
./bin/hytale-downloader-darwin-arm64 -patchline pre-release

# Intel:
./bin/hytale-downloader-darwin-amd64 -patchline pre-release

---

7. ОБХОДИМ GATEKEEPER (MACOS SECURITY)

Это раздел которого нет в большинстве гайдов — а зря. macOS заблокирует запуск hytale-downloader и HytaleServer.jar через Gatekeeper, потому что они скачаны из интернета, а не из App Store.

При первой попытке запустить downloader вы увидите:
"hytale-downloader-darwin-arm64" cannot be opened because the developer cannot be verified."

Решение — убираем карантинный флаг:

# Для Apple Silicon:
xattr -d com.apple.quarantine ~/HytaleServer/bin/hytale-downloader-darwin-arm64

# Для Intel:
xattr -d com.apple.quarantine ~/HytaleServer/bin/hytale-downloader-darwin-amd64

# Для всей папки сервера (рекомендуется):
xattr -dr com.apple.quarantine ~/HytaleServer/

Альтернативный способ через System Settings:

Если вы уже получили диалог "не удаётся проверить разработчика" — идём в:
Системные настройки → Конфиденциальность и безопасность → Security

Внизу будет сообщение вида "hytale-downloader was blocked" с кнопкой "Allow Anyway" — нажимаем её.

Почему macOS блокирует файл? Это не значит что файл опасный. macOS добавляет атрибут "com.apple.quarantine" ко всему что скачано из интернета. Команда xattr просто убирает этот атрибут — это стандартная практика для серверного ПО не из App Store.

---

8. НАСТРОЙКА MACOS FIREWALL

macOS использует собственный Application Firewall — он работает на уровне приложений, а не портов. Нам нужно разрешить Java принимать входящие подключения.

Через System Settings (проще):

Системные настройки → Конфиденциальность и безопасность → Firewall

Убедитесь что Firewall включён, затем нажмите "Firewall Options...":

• Нажмите "+"
• Перейдите в /Library/Java/JavaVirtualMachines/temurin-25.jdk/Contents/Home/bin/
• Выберите java
• Установите "Allow incoming connections"

Через Терминал (для продвинутых):

# Находим путь к java
JAVA_BIN=$(/usr/libexec/java_home -v 25)/bin/java

# Добавляем разрешение через socketfilterfw
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add "$JAVA_BIN"
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --unblockapp "$JAVA_BIN"

Проверяем что правило создано:

sudo /usr/libexec/ApplicationFirewall/socketfilterfw --listapps | grep java

При первом запуске сервера macOS также сам покажет диалог "Разрешить входящие подключения для java?" — нажмите "Allow".

---

9. ПРОБРОС ПОРТОВ НА РОУТЕРЕ

Если сервер работает дома (не на VPS) — нужно пробросить порт чтобы игроки из интернета могли подключиться.

Шаг 1. Назначаем статический локальный IP

Системные настройки → Сеть → Wi-Fi (или Ethernet) → Подробнее → TCP/IP

Записываем текущий IP (например 192.168.1.105) и Router (например 192.168.1.1).

Меняем Configure IPv4 с "Using DHCP" на "Manually":

• IP Address: записанный IP (например 192.168.1.105)
• Subnet Mask: 255.255.255.0
• Router: ваш шлюз (например 192.168.1.1)
• DNS: 8.8.8.8

Шаг 2. Port Forwarding на роутере

Открываем браузер → адрес роутера (обычно 192.168.1.1 или 192.168.0.1) → раздел Port Forwarding:

Параметр	Значение
External Port	5520
Internal Port	5520
Protocol	UDP (не TCP!)
Internal IP	Статический IP вашего Mac

Шаг 3. Отключаем Sleep для Mac

MacBook засыпает когда закрыта крышка — сервер останавливается. Чтобы этого не происходило:

Системные настройки → Батарея (или Energy Saver) → "Prevent automatic sleeping when the display is off" → включить.

Либо через Терминал — блокируем сон пока работает сервер:

caffeinate -i -w $(pgrep -f HytaleServer.jar) &

Эта команда предотвращает сон пока процесс сервера активен.

Безопасность: Внешний IP раскрывает ваше местоположение. Давайте его только людям которым доверяете. Для публичного сервера — используйте VPS.

---

10. ПЕРВЫЙ ЗАПУСК И АУТЕНТИФИКАЦИЯ

Открываем Терминал и переходим в папку сервера:

cd ~/HytaleServer

Запускаем сервер:

java -Xms4G -Xmx6G -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:5520

Параметры:

• -Xms4G — стартовый размер хипа (начальная RAM)
• -Xmx6G — максимальная RAM для JVM (80% от доступной)
• --assets Assets.zip — путь к ассетам, обязателен!
• --bind 0.0.0.0:5520 — слушаем все интерфейсы, порт 5520

Apple Silicon и Unified Memory:</B> На MacBook с 8 GB Unified Memory выделяйте не больше -Xmx5G, оставляя память для ОС и других процессов. На 16 GB — можно -Xmx10G.

После запуска появится предупреждение:

[WARNING] NO SERVER TOKENS CONFIGURED

Это нормально. В консоли сервера вводим:

/auth login device

Получаем код авторизации:

==================================================================
DEVICE AUTHORIZATION
==================================================================
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234
==================================================================
Waiting for authorization (expires in 900 seconds)...

Открываем ссылку в браузере Safari или Chrome, вводим код, авторизуемся через аккаунт Hytale.

После успешной авторизации:

Authentication successful!

Сервер готов принимать игроков. Подключение по вашему_IP:5520.

Лимит серверов: Один аккаунт Hytale поддерживает до 100 серверов. Для большинства этого более чем достаточно.

---

11. КОНФИГУРАЦИЯ CONFIG.JSON

После первого запуска в ~/HytaleServer/ появится config.json. Редактировать его только когда сервер остановлен — иначе изменения будут перезаписаны.

Останавливаем сервер: Ctrl+C в Терминале.

Открываем конфиг в текстовом редакторе:

# Встроенный редактор nano:
nano ~/HytaleServer/config.json

# Или открыть в TextEdit:
open -e ~/HytaleServer/config.json

# Или в VS Code (если установлен):
code ~/HytaleServer/config.json

Пример конфига:

{
  "Version": 3,
  "ServerName": "Мой Hytale Mac Сервер",
  "MOTD": "Добро пожаловать в Orbis!",
  "Password": "",
  "MaxPlayers": 10,
  "MaxViewRadius": 12,
  "LocalCompressionEnabled": false,
  "Defaults": {
    "World": "default",
    "GameMode": "Adventure"
  },
  "ConnectionTimeouts": {
    "JoinTimeouts": {}
  },
  "RateLimit": {},
  "Modules": {},
  "LogLevels": {},
  "Mods": {},
  "PlayerStorage": {
    "Type": "Hytale"
  }
}

Ключевые параметры для Mac:

Параметр	Описание	Для Mac
MaxPlayers	Максимум игроков	8–10 на 8 GB, 15–20 на 16 GB
MaxViewRadius	Радиус прогрузки мира	10–12 — ниже чем на VPS из-за Unified Memory
Password	Пароль входа	Рекомендуем поставить для домашних серверов
GameMode	Режим по умолчанию	"Adventure" или "Creative"

Для сравнения: MaxViewRadius 16 в Hytale ≈ 24 чанкам Minecraft (384 блока). На MacBook рекомендуем начинать с 10–12 и наблюдать за загрузкой в Activity Monitor.

---

12. СОЗДАНИЕ СКРИПТА ЗАПУСКА

Создаём удобный shell-скрипт для запуска сервера одной командой:

nano ~/HytaleServer/start.sh

Вставляем содержимое:

#!/bin/bash

cd ~/HytaleServer

# Определяем архитектуру автоматически
ARCH=$(uname -m)
if [ "$ARCH" = "arm64" ]; then
    echo ">> Apple Silicon (arm64) detected"
else
    echo ">> Intel (x64) detected"
fi

# JVM параметры
JAVA_OPTS="-Xms4G -Xmx6G"
JAVA_OPTS="$JAVA_OPTS -XX:+UseG1GC"
JAVA_OPTS="$JAVA_OPTS -XX:MaxGCPauseMillis=200"
JAVA_OPTS="$JAVA_OPTS -XX:+ParallelRefProcEnabled"
JAVA_OPTS="$JAVA_OPTS -XX:+UnlockExperimentalVMOptions"
JAVA_OPTS="$JAVA_OPTS -XX:+DisableExplicitGC"

# Предотвращаем сон Mac пока сервер работает
caffeinate -i &
CAFFEINATE_PID=$!

echo "================================================"
echo "  Hytale Server - Starting..."
echo "  Press Ctrl+C to stop"
echo "================================================"

# Запуск сервера
java $JAVA_OPTS -jar HytaleServer.jar \
    --assets Assets.zip \
    --bind 0.0.0.0:5520

# Завершаем caffeinate когда сервер остановлен
kill $CAFFEINATE_PID 2>/dev/null
echo "Server stopped. caffeinate released."

Сохраняем в nano: Ctrl+O → Enter → Ctrl+X.

Даём права на выполнение:

chmod +x ~/HytaleServer/start.sh

Теперь для запуска сервера достаточно одной команды:

~/HytaleServer/start.sh

Или создаём псевдоним в ~/.zprofile для быстрого запуска из любого места:

echo 'alias hytale-server="~/HytaleServer/start.sh"' >> ~/.zprofile
source ~/.zprofile

Теперь сервер запускается командой:

hytale-server

---

13. АВТОЗАПУСК ЧЕРЕЗ LAUNCHD

launchd — это системный менеджер процессов в macOS (аналог systemd на Linux). Через него можно настроить автозапуск сервера при загрузке системы.

Нужен ли вам launchd? Если вы запускаете сервер только когда сами за компьютером — пропустите этот раздел. launchd актуален если Mac используется как мини-сервер 24/7 без вашего присутствия.

Создаём plist-файл:

nano ~/Library/LaunchAgents/com.hytale.server.plist

Вставляем:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.hytale.server</string>

    <key>ProgramArguments</key>
    <array>
        <string>/bin/bash</string>
        <string>/Users/ВАШ_ЮЗЕРНЕЙМ/HytaleServer/start.sh</string>
    </array>

    <key>WorkingDirectory</key>
    <string>/Users/ВАШ_ЮЗЕРНЕЙМ/HytaleServer</string>

    <key>RunAtLoad</key>
    <true/>

    <key>KeepAlive</key>
    <true/>

    <key>StandardOutPath</key>
    <string>/Users/ВАШ_ЮЗЕРНЕЙМ/HytaleServer/logs/server.log</string>

    <key>StandardErrorPath</key>
    <string>/Users/ВАШ_ЮЗЕРНЕЙМ/HytaleServer/logs/server-error.log</string>
</dict>
</plist>

Замените ВАШ_ЮЗЕРНЕЙМ на ваше имя пользователя. Узнать его можно командой:

whoami

Создаём папку для логов:

mkdir -p ~/HytaleServer/logs

Регистрируем и запускаем launchd агент:

launchctl load ~/Library/LaunchAgents/com.hytale.server.plist

Управление:

# Запустить
launchctl start com.hytale.server

# Остановить
launchctl stop com.hytale.server

# Отключить автозапуск
launchctl unload ~/Library/LaunchAgents/com.hytale.server.plist

# Просмотр логов в реальном времени
tail -f ~/HytaleServer/logs/server.log

---

14. ОБНОВЛЕНИЕ СЕРВЕРА

После каждого патча клиент и сервер должны быть на одной версии протокола. Если клиент обновился — сразу обновляйте сервер.

# Шаг 1. Останавливаем сервер (Ctrl+C или:)
launchctl stop com.hytale.server

# Шаг 2. Переходим в папку
cd ~/HytaleServer

# Шаг 3. Проверяем обновления (Apple Silicon)
./bin/hytale-downloader-darwin-arm64 -check-update

# Шаг 4. Скачиваем новую версию
./bin/hytale-downloader-darwin-arm64 --server
# (для Intel: ./bin/hytale-downloader-darwin-amd64 --server)

# Шаг 5. Распаковываем новый архив
unzip 2026.XX.XX-xxxxxxxxx.zip

# Шаг 6. Запускаем сервер
~/HytaleServer/start.sh
# или если используете launchd:
launchctl start com.hytale.server

---

15. ОПТИМИЗАЦИЯ И РЕШЕНИЕ ПРОБЛЕМ

Мониторинг нагрузки на Mac

Открываем Activity Monitor (Мониторинг системы) — Cmd+Пробел → "Activity Monitor":

• Вкладка CPU — следим за процессом java
• Вкладка Memory — следим за Memory Pressure (зелёный = норм, красный = мало)
• Вкладка Network — входящий/исходящий трафик сервера

Рекомендуемые JVM параметры для Mac

-XX:+UseG1GC                    # G1 GC — оптимален для macOS
-XX:MaxGCPauseMillis=200        # Максимальная пауза GC
-XX:+ParallelRefProcEnabled     # Параллельная обработка ссылок
-XX:+UnlockExperimentalVMOptions
-XX:+DisableExplicitGC          # Отключить принудительный GC из кода

Сколько RAM выделять на Mac

Unified Memory Mac	-Xmx	Игроков
8 GB	4–5G	до 8
16 GB	8–10G	до 20
24 GB (Pro/Max)	14–16G	до 35
32 GB (Max/Ultra)	20–24G	50+

Быстрые бэкапы через cron

Открываем crontab:

crontab -e

Добавляем строку для бэкапа каждые 6 часов:

0 */6 * * * tar -czf ~/HytaleServer/backups/worlds_$(date +\%Y-\%m-\%d_\%H-\%M).tar.gz ~/HytaleServer/worlds/ 2>/dev/null

Создаём папку для бэкапов:

mkdir -p ~/HytaleServer/backups

Частые проблемы и решения на macOS

• "cannot be opened because the developer cannot be verified" — Gatekeeper блокирует файл. Запустите:

  xattr -dr com.apple.quarantine ~/HytaleServer/

• java: command not found — Java не в PATH. Добавьте в ~/.zprofile:

  export JAVA_HOME=$(/usr/libexec/java_home -v 25)

• Игроки не подключаются — проверьте UFW, проброс UDP (не TCP!), и аутентификацию (/auth login device)
• "NO SERVER TOKENS CONFIGURED" — введите /auth login device в консоли сервера
• Mac засыпает — сервер падает — добавьте caffeinate в скрипт запуска или отключите сон в Energy Saver
• Высокая температура MacBook — снизьте MaxViewRadius до 8–10, уменьшите MaxPlayers
• Сервер лагает — снизьте MaxViewRadius в config.json
• OutOfMemoryError — увеличьте -Xmx или снизьте MaxViewRadius/MaxPlayers
• Ошибка после обновления клиента — версии клиента и сервера не совпадают, обновите сервер
• "Operation not permitted" при xattr — запустите команду с sudo

Проверка температуры Mac (только для MacBook)

# Установить через Homebrew:
brew install osx-cpu-temp

# Проверить температуру CPU:
osx-cpu-temp

Если температура стабильно выше 90°C при работе сервера — снижайте MaxViewRadius и MaxPlayers. MacBook не предназначен для длительной серверной нагрузки 24/7.

---

ГОТОВО! СЕРВЕР НА MAC ЗАПУЩЕН

Ваш Hytale сервер работает на macOS. Зовите друзей, открывайте Orbis и наслаждайтесь игрой.

Если у вас MacBook Air и планируете держать сервер долго — рассмотрите VPS на Ubuntu. Это надёжнее и дешевле в долгосрочной перспективе.

Есть вопросы? Пишите в комментариях — отвечаем в течение 24 часов.​

---

Источники: Официальная документация Hypixel Studios (support.hytale.com), Hytale Server Manual (January 2026), Hostinger Hytale Server Requirements, Evolution Host Setup Guide.