Руководство по настройке сервера Starbound
В этом руководстве рассматривается настройка и конфигурация вашего выделенного сервера Starbound на Legion Hosting, включая предварительные требования к аутентификации Steam, первый запуск, конфигурацию сервера, настройки вселенной, подключение игроков и управление сохранениями. Для установки модов см. Установка модов Starbound. Для команд администратора и привилегий см. Команды администратора Starbound.
Предварительные требования
Перед запуском вашего сервера Starbound у вас должно быть следующее:
- Аккаунт Steam, владеющий Starbound. Бинарный файл сервера недоступен для анонимной загрузки — указанный вами аккаунт должен иметь Starbound в своей библиотеке.
- Соображения по Steam Guard. Если на вашем аккаунте Steam включён Steam Guard (двухфакторная аутентификация), вам потребуется указать код аутентификации через переменную запуска
STEAM_AUTHво время первой установки. После начальной аутентификации SteamCMD кэширует сессию, и последующие запуски не должны снова требовать код, если только кэш не истечёт. - Рекомендуется выделенный аккаунт Steam. В целях безопасности рассмотрите возможность использования отдельного аккаунта Steam, владеющего Starbound, исключительно для хостинга сервера. Это позволяет избежать передачи учётных данных вашего основного аккаунта и предотвращает конфликты, если вы хотите играть на том же аккаунте одновременно.
Первый запуск
После покупки вашего сервера Starbound на Legion Hosting выполните следующие шаги, чтобы запустить его в первый раз:
- Войдите в GPanel и выберите ваш сервер Starbound.
- Перейдите на вкладку Startup.
- Заполните необходимые учётные данные Steam:
- STEAM_USER — Имя пользователя вашего аккаунта Steam (обязательно).
- STEAM_PASS — Пароль вашего аккаунта Steam (обязательно).
- STEAM_AUTH — Ваш код двухфакторной аутентификации Steam Guard, если запрашивается (необязательно, нужен только при первой установке или когда кэшированная сессия истекает).
- Перейдите на вкладку Console и нажмите Start.
- Сервер загрузит файлы выделенного сервера Starbound через SteamCMD. Это может занять несколько минут при первом запуске.
- После завершения загрузки сервер сгенерирует вселенную по умолчанию и начнёт принимать подключения.
STEAM_AUTH и перезапустите сервер. Проверьте вашу электронную почту или приложение аутентификатора для получения кода. Обычно это нужно сделать только один раз — SteamCMD кэширует сессию для будущих запусков.
Переменные запуска GPanel
| Переменная | Обязательно | Описание |
|---|---|---|
STEAM_USER |
Да | Имя пользователя аккаунта Steam. Должен владеть Starbound. Не может быть anonymous. |
STEAM_PASS |
Да | Пароль аккаунта Steam для указанного выше имени пользователя. |
STEAM_AUTH |
Нет | Код двухфакторной аутентификации Steam Guard. Нужен только во время начальной настройки или когда кэшированная сессия истекает. |
WORKSHOP |
Нет | Установите в 1, чтобы включить поддержку модов Steam Workshop, или в 0, чтобы отключить. По умолчанию 0. См. Установка модов Starbound для подробностей. |
starbound_server.config
Основной конфигурационный файл сервера находится по адресу:
storage/starbound_server.config
Этот файл использует формат JSON. Редактируйте его через Файловый менеджер в GPanel или через SFTP. Сервер должен быть остановлен перед редактированием, так как изменения загружаются при запуске.
Ключевые настройки сервера
| Настройка | По умолчанию | Описание |
|---|---|---|
serverName |
"A Starbound Server" |
Имя, отображаемое в браузере серверов и при подключении игроков. |
maxPlayers |
8 |
Максимальное количество игроков, которые могут быть подключены одновременно. |
gameServerPort |
21025 |
Порт, который прослушивает игровой сервер. На Legion Hosting это устанавливается автоматически — не меняйте, если только это не указано поддержкой. |
gameServerBind |
"::" |
Сетевой интерфейс для привязки. Значение по умолчанию "::" привязывается ко всем интерфейсам (IPv4 и IPv6). Оставьте как есть. |
serverPassword |
"" |
Пароль, необходимый для входа на сервер. Оставьте пустым для отсутствия пароля (публичный доступ). |
allowAnonymousConnections |
true |
При значении true игроки могут подключаться без аккаунта Starbound. Установите в false, чтобы требовать аутентификацию аккаунта для всех игроков. |
allowAssetsMismatch |
true |
При значении true игроки с разными наборами модов всё равно могут подключаться. Установите в false, чтобы требовать соответствия ассетов между сервером и клиентом (рекомендуется для модифицированных серверов). |
maxTeamSize |
4 |
Максимальное количество игроков в группе/команде. |
clientIPJoinable |
false |
Можно ли подключаться к серверу через прямой IP. Должно быть true для выделенных серверов. |
clientP2PJoinable |
false |
Разрешены ли пиринговые (peer-to-peer) подключения. Обычно false для выделенных серверов. |
Пример starbound_server.config
{
"serverName" : "My Legion Starbound Server",
"maxPlayers" : 8,
"gameServerBind" : "::",
"serverPassword" : "",
"allowAnonymousConnections" : true,
"allowAssetsMismatch" : true,
"maxTeamSize" : 4,
"clientIPJoinable" : true,
"clientP2PJoinable" : false,
"allowAdminCommands" : true,
"allowAdminCommandsFromAnyone" : false,
"serverUsers" : {
"YourUsername" : {
"admin" : true,
"password" : "your-admin-password"
}
}
}
Настройки мира и вселенной
Starbound использует процедурно генерируемую вселенную. Каждый раз, когда игрок посещает новую звёздную систему или планету, игра генерирует её на основе семени вселенной и системы координат. Данные вселенной сервера хранятся в:
storage/universe/
Эта директория содержит все сгенерированные данные миров, включая планеты, космические станции и построенные игроками структуры, размещённые в мире.
Конфигурация вселенной
Параметры генерации вселенной можно настроить в файле starbound_server.config или через связанные со вселенной файлы ассетов. Ключевые концепции:
| Концепция | Описание |
|---|---|
| Семя вселенной | Вселенная процедурно генерируется на основе координат. Все серверы с одинаковой версией игры будут генерировать идентичные планеты в одних и тех же координатах, но размещённые игроками объекты и модификации уникальны для каждого сервера. |
| Начальная планета | Новые игроки появляются на процедурно выбранной начальной планете. Начальный мир — это планета типа сад, подходящая для прогресса в начале игры. |
| Файлы миров | Каждая посещённая планета генерирует файл .world в storage/universe/. Эти файлы содержат изменения ландшафта, размещённые объекты и изменения тайлов, сделанные игроками. |
| Небесные данные | Файлы universe.chunks и universe.dat в директории вселенной хранят общее состояние карты вселенной. |
storage/universe/. Имейте в виду, что это удаляет все сгенерированные миры, включая любые построенные игроками структуры. Всегда создавайте резервную копию перед этим.
Как подключиться
Игроки подключаются к вашему серверу Starbound, используя внутриигровое меню мультиплеера.
Прямое подключение через IP
- Запустите Starbound.
- В главном меню нажмите Multiplayer.
- Выберите вашего персонажа.
- В поле Server Address введите IP-адрес вашего сервера и порт в формате:
IP:Port - Если на сервере установлен пароль, введите Account Name и Password, соответствующие записи
serverUsersв конфигурации сервера. ЕслиallowAnonymousConnectionsустановлено вtrueи пароль сервера не задан, эти поля можно оставить пустыми. - Нажмите Join Server.
Друзья Steam (не применимо)
Функция Steam «Join Game» предназначена для пиринговых (peer-to-peer) хостинговых игр, а не для выделенных серверов. Игроки должны использовать метод прямого подключения по IP, описанный выше, чтобы присоединиться к вашему серверу Legion Hosting.
- Сервер запущен и полностью загружен (проверьте консоль GPanel на наличие «Info: Server listened on»).
- Используются правильные IP и порт.
- Если используется пароль сервера, игрок вводит правильные учётные данные
serverUsers. - Если
allowAssetsMismatchустановлено вfalse, установленные у игрока моды должны точно соответствовать модам сервера. - И сервер, и клиент работают на одной и той же версии Starbound.
Управление сохранениями
Starbound хранит все данные сервера в директории storage/. Понимание структуры файлов помогает с резервным копированием, переносом и устранением неполадок.
Ключевые директории и файлы хранилища
| Путь | Описание |
|---|---|
storage/universe/ |
Содержит все сгенерированные данные миров — планеты, космические станции и модификации миров игроками. Каждая посещённая планета имеет файл .world. |
storage/player/ |
Содержит файлы сохранений игроков. У каждого игрока есть файл .player, хранящий его инвентарь, прогресс, состояние квестов и данные корабля. |
storage/starbound_server.config |
Основной конфигурационный файл сервера. |
storage/starbound_server.log |
Файл журнала сервера. Полезен для диагностики вылетов, ошибок и проблем с подключением. |
Создание резервных копий
Регулярное резервное копирование защищает вселенную вашего сервера, данные игроков и конфигурацию от случайной потери или повреждения.
- Остановите ваш сервер в GPanel, чтобы все данные были записаны на диск.
- Подключитесь к вашему серверу через SFTP или используйте Файловый менеджер.
- Скачайте всю директорию
storage/на ваш локальный компьютер. - Сохраните резервную копию в надёжном месте с меткой даты (например,
storage-backup-2026-02-26).
storage/universe/ и storage/player/. Они содержат все данные о прогрессе мира и игроков. Вам также следует создать резервную копию starbound_server.config, чтобы сохранить настройки вашего сервера.
Восстановление из резервной копии
- Остановите ваш сервер.
- Загрузите файлы резервной копии в соответствующие места в директории
storage/, перезаписывая существующие файлы. - Запустите сервер.
Перенос мира с другого сервера
Чтобы перенести вашу вселенную Starbound с другого сервера или из локальной игры:
- Остановите и исходный, и целевой серверы.
- Скопируйте директорию
storage/universe/с исходного на целевой сервер. - При желании скопируйте
storage/player/, если вы хотите также перенести данные игроков. - Скопируйте ваш
starbound_server.config, чтобы сохранить настройки сервера. - Запустите целевой сервер и убедитесь, что мир загружается корректно.
Связанные статьи
- Установка модов Starbound
- Команды администратора Starbound
- Как найти IP и порт вашего сервера
- Как загружать файлы через SFTP
- Руководство по запуску сервера
Нужна помощь?
Если вы столкнулись с проблемами, не описанными в этом руководстве, наша служба поддержки готова помочь. Откройте тикет на legionhosting.net/submitticket.php, указав данные вашего сервера и описание проблемы.