Посібник з налаштування сервера 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 — ваш код 2FA 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" призначена для однорангових ігор, що хостяться, а не для виділених серверів. Гравці повинні використовувати метод прямого підключення через IP, описаний вище, щоб приєднатися до вашого сервера Legion Hosting.
- Сервер запущений та повністю стартував (перевірте консоль GPanel на наявність "Info: Server listened on").
- Використовуються правильні IP та порт.
- Якщо використовується пароль сервера, гравець вводить правильні облікові дані
serverUsers. - Якщо
allowAssetsMismatchмає значенняfalse, встановлені моди гравця повинні точно відповідати модам сервера. - І сервер, і клієнт працюють на одній версії Starbound.
Керування збереженнями
Starbound зберігає всі дані сервера в каталозі storage/. Розуміння структури файлів допомагає з резервним копіюванням, перенесенням та усуненням неполадок.
Ключові каталоги та файли 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, вказавши дані вашого сервера та опис проблеми.