background image
Game Servers 380 7 Days to Die 4 Abiotic Factor 2 Aloft 2 alt:V 2 Americas Army Proving Grounds 2 Among Us 2 Archean 2 ARK Survival Ascended 6 ARK Survival Evolved 3 Arma 3 3 Arma Reforger 2 Aska 2 AssaultCube 2 Assetto Corsa 3 Astro Colony 2 Astroneer 2 Automobilista 2 2 Avorion 2 Banana Shooter 2 Barotrauma 3 BATTALION Legacy 2 BeamNG.drive (BeamMP) 2 Black Mesa 2 Brickadia 2 Call of Duty 2 Citadel: Forged with Fire 2 ClassiCube 2 Clone Hero 2 Colony Survival 2 Conan Exiles 4 Contagion 2 Core Keeper 2 Counter-Strike 2 3 Craftopia 2 CryoFall 2 CS2D 2 Cube 2: Sauerbraten 2 Cubic Odyssey 2 DayZ 4 DDNet 2 DDRaceNetwork 2 Dead Matter 2 Dont Starve Together 4 Eco 2 Empyrion Galactic Survival 2 Enshrouded 3 Escape from Tarkov 2 Euro Truck Simulator 2 2 Factorio 2 Farming Simulator 25 2 Fistful of Frags 2 FiveM 3 FortressCraft Evolved 2 Foundry 2 Foundry VTT 2 Frozen Flame 2 FTL Tachyon 2 Garrys Mod 3 Ground Branch 2 Half-Life 2 Deathmatch 2 Hogwarp 2 Holdfast: Nations at War 2 HumanitZ 2 Hurtworld 2 Hytale 1 Icarus 2 Insurgency Sandstorm 2 IOSoccer 2 Just Cause 3 Multiplayer 2 Kerbal Space Program 2 Killing Floor 2 3 LeagueSandbox 2 Left 4 Dead 2 Left 4 Dead 2 3 Longvinter 2 Los Angeles Crimes 2 Medal of Honor 2 Midnight Ghost Hunt 2 Mindustry 2 Minecraft 4 Minetest 2 Modiverse 2 Mordhau 3 Mount & Blade II: Bannerlord 2 Myth of Empires 2 Nazi Zombies Portable 2 Necesse 2 NeosVR 2 Neverwinter Nights EE 2 Night of the Dead 2 Nightingale 2 No Love Lost 2 No More Room in Hell 2 No One Survived 2 Nova-Life Amboise 2 Nuclear Option 2 Onset 2 Open Fortress 2 OpenArena 2 OpenRA 2 OpenRCT2 2 OpenTTD 2 Operation Harsh Doorstop 2 Palworld 3 Path of Titans 2 Pavlov VR 3 PixARK 2 Plains of Pain 2 Portal Knights 2 Post Scriptum 2 Project Zomboid 8 Puck 2 Quake Live 2 R5Reloaded 2 RedM 2 Renown 2 Resonite 2 Return to Moria 2 Rimworld Together 2 Rising World 2 Risk of Rain 2 1 Rust 4 Satisfactory 1 SCP Secret Laboratory 3 SCUM 2 Smalland 2 Solace Crafting 2 Soldat 2 Soldat 2 2 Sonic Robo Blast 2 2 Sons of the Forest 2 Soulmask 2 SourceCoop 2 Space Engineers 3 Space Station 14 2 Squad 3 Starbound 3 StarMade 2 Stationeers 2 Stormworks 2 Subnautica Nitrox 2 Sunkenland 2 SuperTuxKart 2 Sven Co-op 2 Swords 'n Magic and Stuff 2 Team Fortress 2 3 Teeworlds 2 Terraria 3 TerraTech Worlds 2 TF2 Classified 2 The Forest 3 The Front 2 The Isle 2 Tower Unite 2 Trackmania 2 Unturned 4 Urban Terror 2 V Rising 3 Valheim 3 VEIN 2 Veloren 2 Vintage Story 3 Voyagers of Nera 2 Wolfenstein: Enemy Territory 2 Wreckfest 2 Wurm Unlimited 2 Xonotic 2 Zandronum 2 Getting Started 2 Network & Connectivity 1 Server Management 2
Categorias

Guia de Configuração do Servidor de Starbound


Guia de Configuração do Servidor de Starbound

Este guia aborda a configuração e instalação do seu servidor dedicado de Starbound na Legion Hosting, incluindo pré-requisitos de autenticação Steam, primeiro arranque, configuração do servidor, definições do universo, ligação de jogadores e gestão de saves. Para instalação de mods, consulte Instalação de Mods do Starbound. Para comandos e privilégios de administrador, consulte Comandos de Administrador do Starbound.

Painel do Servidor: Toda a gestão do servidor é feita através do GPanel em gpanel.legionhosting.net. Utilize o Gestor de Ficheiros ou SFTP para editar ficheiros de configuração.

Pré-requisitos

Antes de iniciar o seu servidor de Starbound, deve ter o seguinte:

Conta Steam Autenticada Necessária. Os ficheiros do servidor dedicado de Starbound (Steam App ID: 211820) não podem ser descarregados via SteamCMD anónimo. Deve fornecer um nome de utilizador e palavra-passe de conta Steam válidos no separador Startup do GPanel. A conta Steam utilizada deve possuir uma cópia do Starbound.
  • Uma conta Steam que possua o Starbound. O binário do servidor não está disponível para descarga anónima -- a conta que fornecer deve ter o Starbound na sua biblioteca.
  • Considerações sobre o Steam Guard. Se a sua conta Steam tem o Steam Guard (autenticação de dois fatores) ativado, terá de fornecer o código de autenticação através da variável de arranque STEAM_AUTH durante a primeira instalação. Após a autenticação inicial, o SteamCMD guarda a sessão em cache e os arranques subsequentes não devem requerer o código novamente, a menos que a cache expire.
  • Conta Steam dedicada recomendada. Por segurança, considere utilizar uma conta Steam separada que possua o Starbound exclusivamente para alojamento de servidores. Isto evita partilhar as credenciais da sua conta principal e previne conflitos se quiser jogar na mesma conta simultaneamente.

Primeiro Arranque

Após adquirir o seu servidor de Starbound na Legion Hosting, siga estes passos para o colocar a funcionar pela primeira vez:

  1. Inicie sessão no GPanel e selecione o seu servidor de Starbound.
  2. Vá ao separador Startup.
  3. Preencha as credenciais Steam necessárias:
    • STEAM_USER -- O nome de utilizador da sua conta Steam (obrigatório).
    • STEAM_PASS -- A palavra-passe da sua conta Steam (obrigatório).
    • STEAM_AUTH -- O código 2FA do Steam Guard, se solicitado (opcional, apenas necessário na primeira instalação ou quando a sessão em cache expira).
  4. Vá ao separador Console e clique em Start.
  5. O servidor irá descarregar os ficheiros do servidor dedicado de Starbound via SteamCMD. Isto pode demorar vários minutos no primeiro arranque.
  6. Após a conclusão do download, o servidor irá gerar um universo predefinido e começar a aguardar ligações.
Pedido do Steam Guard: Se o servidor não iniciar com um erro de autenticação, volte ao separador Startup, introduza o seu código Steam Guard atual no campo STEAM_AUTH e reinicie o servidor. Verifique o seu email ou aplicação de autenticação para obter o código. Normalmente só precisa de fazer isto uma vez -- o SteamCMD guardará a sessão em cache para arranques futuros.

Variáveis de Arranque do GPanel

Variável Obrigatório Descrição
STEAM_USER Sim Nome de utilizador da conta Steam. Deve possuir o Starbound. Não pode ser anonymous.
STEAM_PASS Sim Palavra-passe da conta Steam para o nome de utilizador acima.
STEAM_AUTH Não Código de autenticação de dois fatores do Steam Guard. Apenas necessário durante a configuração inicial ou quando a sessão em cache expira.
WORKSHOP Não Defina como 1 para ativar o suporte a mods do Steam Workshop, ou 0 para desativar. A predefinição é 0. Consulte Instalação de Mods do Starbound para mais detalhes.

starbound_server.config

O ficheiro de configuração principal do servidor está localizado em:

storage/starbound_server.config

Este ficheiro utiliza o formato JSON. Edite-o através do Gestor de Ficheiros no GPanel ou através de SFTP. O servidor deve estar parado antes de editar, pois as alterações são carregadas no arranque.

JSON válido necessário. O analisador de configuração do Starbound é rigoroso quanto à formatação JSON. Certifique-se de que não há vírgulas finais, todas as strings estão entre aspas duplas e os parênteses/chavetas estão corretamente emparelhados. Um único erro de sintaxe impedirá o servidor de iniciar.

Definições Principais do Servidor

Definição Predefinição Descrição
serverName "A Starbound Server" O nome apresentado no navegador de servidores e quando os jogadores se conectam.
maxPlayers 8 Número máximo de jogadores que podem estar conectados simultaneamente.
gameServerPort 21025 A porta na qual o servidor de jogo escuta. Na Legion Hosting, esta é definida automaticamente -- não a altere a menos que seja instruído pelo suporte.
gameServerBind "::" A interface de rede à qual se vincular. A predefinição "::" vincula-se a todas as interfaces (IPv4 e IPv6). Deixe como está.
serverPassword "" Palavra-passe necessária para entrar no servidor. Deixe vazio para sem palavra-passe (acesso público).
allowAnonymousConnections true Quando true, os jogadores podem conectar-se sem uma conta Starbound. Defina como false para exigir autenticação de conta para todos os jogadores.
allowAssetsMismatch true Quando true, jogadores com conjuntos de mods diferentes podem ainda conectar-se. Defina como false para impor correspondência de assets entre servidor e cliente (recomendado para servidores com mods).
maxTeamSize 4 Número máximo de jogadores por grupo/equipa.
clientIPJoinable false Se o servidor pode ser acedido via IP direto. Deve ser true para servidores dedicados.
clientP2PJoinable false Se ligações peer-to-peer são permitidas. Tipicamente false para servidores dedicados.

Exemplo de 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"
    }
  }
}

Definições do Mundo e Universo

O Starbound utiliza um universo gerado proceduralmente. Cada vez que um jogador visita um novo sistema estelar ou planeta, o jogo gera-o com base numa semente do universo e num sistema de coordenadas. Os dados do universo do servidor são armazenados em:

storage/universe/

Este diretório contém todos os dados do mundo gerados, incluindo planetas, estações espaciais e estruturas construídas por jogadores colocadas no mundo.

Configuração do Universo

Os parâmetros de geração do universo podem ser ajustados no ficheiro starbound_server.config ou através de ficheiros de assets relacionados com o universo. Conceitos-chave:

Conceito Descrição
Semente do Universo O universo é gerado proceduralmente com base em coordenadas. Todos os servidores com a mesma versão do jogo irão gerar planetas idênticos nas mesmas coordenadas, mas os objetos colocados por jogadores e as modificações são únicos de cada servidor.
Planeta Inicial Os novos jogadores aparecem num planeta inicial selecionado proceduralmente. O mundo inicial é um planeta do tipo jardim adequado para a progressão inicial do jogo.
Ficheiros de Mundo Cada planeta visitado gera um ficheiro .world em storage/universe/. Estes ficheiros contêm modificações de terreno, objetos colocados e alterações de blocos feitas por jogadores.
Dados Celestiais Os ficheiros universe.chunks e universe.dat no diretório do universo armazenam o estado geral do mapa do universo.
Universo partilhado: Todos os jogadores no servidor partilham o mesmo universo. As alterações que um jogador faz a um planeta (construir, minerar, colocar objetos) serão visíveis para todos os outros jogadores que visitarem esse planeta.
Reiniciar o universo: Para iniciar um universo completamente novo, pare o servidor e elimine ou renomeie todo o diretório storage/universe/. Tenha em atenção que isto remove todos os mundos gerados, incluindo quaisquer estruturas construídas por jogadores. Faça sempre uma cópia de segurança antes de fazer isto.

Como Conectar

Os jogadores conectam-se ao seu servidor de Starbound utilizando o menu multijogador no jogo.

Ligação Direta via IP

  1. Inicie o Starbound.
  2. No menu principal, clique em Multiplayer.
  3. Selecione o seu personagem.
  4. No campo Server Address, introduza o endereço IP e a porta do seu servidor no formato: IP:Port
  5. Se o servidor tem uma palavra-passe definida, introduza o Account Name e a Password correspondentes a uma entrada de serverUsers na configuração do servidor. Se allowAnonymousConnections está definido como true e não há palavra-passe de servidor definida, estes campos podem ser deixados vazios.
  6. Clique em Join Server.
Encontrar o seu IP e porta: Consulte Como Encontrar o IP e a Porta do Seu Servidor para saber onde localizar estes dados no GPanel.

Amigos Steam (Não Aplicável)

A funcionalidade "Join Game" do Steam é para jogos alojados peer-to-peer, não para servidores dedicados. Os jogadores devem utilizar o método de ligação direta por IP descrito acima para entrar no seu servidor da Legion Hosting.

Resolução de problemas de ligação: Se os jogadores não conseguem conectar-se, verifique o seguinte:
  • O servidor está a funcionar e totalmente iniciado (verifique a consola do GPanel para "Info: Server listened on").
  • O IP e a porta corretos estão a ser utilizados.
  • Se utiliza uma palavra-passe de servidor, o jogador está a introduzir as credenciais serverUsers corretas.
  • Se allowAssetsMismatch está definido como false, os mods instalados pelo jogador devem corresponder exatamente aos mods do servidor.
  • Tanto o servidor como o cliente estão a executar a mesma versão do Starbound.
Se os problemas persistirem, abra um ticket de suporte.

Gestão de Saves

O Starbound armazena todos os dados do servidor dentro do diretório storage/. Compreender a estrutura de ficheiros ajuda com cópias de segurança, transferências e resolução de problemas.

Diretórios e Ficheiros de Armazenamento Principais

Caminho Descrição
storage/universe/ Contém todos os dados do mundo gerados -- planetas, estações espaciais e modificações de jogadores aos mundos. Cada planeta visitado tem um ficheiro .world.
storage/player/ Contém ficheiros de save dos jogadores. Cada jogador tem um ficheiro .player que armazena o seu inventário, progresso, estado de missões e dados da nave.
storage/starbound_server.config O ficheiro de configuração principal do servidor.
storage/starbound_server.log Ficheiro de registo do servidor. Útil para diagnosticar crashes, erros e problemas de ligação.

Criar Cópias de Segurança

Cópias de segurança regulares protegem o universo, dados dos jogadores e configuração do seu servidor contra perda acidental ou corrupção.

  1. Pare o seu servidor no GPanel para garantir que todos os dados foram escritos no disco.
  2. Conecte-se ao seu servidor via SFTP ou utilize o Gestor de Ficheiros.
  3. Descarregue todo o diretório storage/ para o seu computador local.
  4. Guarde a cópia de segurança num local seguro com uma etiqueta de data (por ex., storage-backup-2026-02-26).
O que incluir na cópia de segurança: No mínimo, faça cópia de segurança dos diretórios storage/universe/ e storage/player/. Estes contêm todos os dados de progresso do mundo e dos jogadores. Deve também fazer cópia de segurança de starbound_server.config para preservar as definições do servidor.

Restaurar a partir de Cópia de Segurança

  1. Pare o seu servidor.
  2. Carregue os ficheiros de cópia de segurança para as localizações correspondentes no diretório storage/, substituindo os ficheiros existentes.
  3. Inicie o servidor.

Transferir um Mundo de Outro Servidor

Para mover o seu universo Starbound de outro servidor ou de um jogo local:

  1. Pare tanto o servidor de origem como o de destino.
  2. Copie o diretório storage/universe/ da origem para o servidor de destino.
  3. Opcionalmente, copie storage/player/ se quiser transferir também os dados dos jogadores.
  4. Copie o seu starbound_server.config para preservar as definições do servidor.
  5. Inicie o servidor de destino e verifique se o mundo carrega corretamente.
Dependência de mods: Se o universo foi gerado com mods, esses mesmos mods devem estar instalados no servidor de destino. Mods em falta causarão erros ou conteúdo em falta ao carregar os mundos afetados.

Artigos Relacionados


Precisa de Ajuda?

Se está a ter problemas não abordados neste guia, a nossa equipa de suporte está disponível para ajudar. Abra um ticket em legionhosting.net/submitticket.php com os detalhes do seu servidor e uma descrição do problema.


Este artigo foi útil?

Ready to Get Started?

The servers are booted, select your plan and become our latest satisfied client.