Este guia abrange como configurar os ficheiros GameUserSettings.ini e Game.ini do seu servidor ARK: Survival Ascended alojado na Legion Hosting.
.ini. O ARK pode sobrescrever ficheiros ao encerrar, pelo que as alterações feitas enquanto o servidor está em execução podem ser perdidas.
Visão Geral dos Ficheiros de Configuração
O ARK: Survival Ascended utiliza dois ficheiros de configuração principais para controlar o comportamento do servidor. Ambos são encontrados dentro do diretório ShooterGame/Saved/Config/WindowsServer/ no seu servidor.
| Ficheiro | Finalidade |
|---|---|
GameUserSettings.ini |
Definições principais do servidor — nome da sessão, palavras-passe, contagem de jogadores, taxas, crossplay, BattleEye e mais. Este ficheiro é criado no primeiro arranque do servidor. |
Game.ini |
Substituições avançadas de jogabilidade — pontos de engram, escalonamento de atributos, tamanhos de pilha de itens, spawns personalizados de NPCs. Deve ser exatamente Game.ini (sensível a maiúsculas e minúsculas). Crie manualmente se não existir. |
Game.ini com G e I maiúsculos — game.ini ou GAME.INI não funcionarão.
Passo 1 — Aceder ao Gestor de Ficheiros no GPanel
- Inicie sessão no GPanel.
- Selecione o seu servidor ARK: Survival Ascended na lista de servidores.
- Se o servidor estiver em execução, clique em Stop no separador Console e aguarde que o estado mude para Offline.
- Clique no separador Files para abrir o gestor de ficheiros.
- Navegue até
ShooterGame/Saved/Config/WindowsServer/. Encontrará oGameUserSettings.iniaqui assim que o servidor tiver arrancado pelo menos uma vez. Se oGame.ininão estiver presente, vai criá-lo manualmente no Passo 3.
Passo 2 — Configurar o GameUserSettings.ini
Clique em GameUserSettings.ini no gestor de ficheiros para o abrir no editor inline. O ficheiro está dividido em secções — as mais importantes para a configuração do servidor são [SessionSettings] e [ServerSettings].
Definições Principais em [SessionSettings]
| Definição | Valor de Exemplo | Descrição |
|---|---|---|
SessionName |
My Legion Server |
O nome que aparece no navegador de servidores do jogo. Mantenha-o único para que os jogadores o possam encontrar facilmente. |
QueryPort |
7778 |
A porta de consulta utilizada pelo navegador de servidores. Deve corresponder à porta atribuída no GPanel. Predefinição: porta do jogo + 1. |
Definições Principais em [ServerSettings]
| Definição | Valor de Exemplo | Descrição |
|---|---|---|
ServerPassword |
mypassword |
Palavra-passe necessária para os jogadores entrarem. Deixe vazio para um servidor público. |
ServerAdminPassword |
adminpass123 |
Palavra-passe de administrador usada para autenticar comandos de administrador no jogo. Mantenha-a privada. |
MaxPlayers |
20 |
Número máximo de jogadores simultâneos. Deve corresponder ao limite de slots do seu plano. |
XPMultiplier |
2.0 |
Multiplicador de XP ganho. 1.0 é o predefinido, 2.0 duplica o ganho de XP. |
TamingSpeedMultiplier |
3.0 |
Multiplicador de velocidade de domesticação. Valores mais altos aceleram a domesticação. |
HarvestAmountMultiplier |
2.0 |
Multiplicador de recursos recolhidos por ação de colheita. |
DifficultyOffset |
1.0 |
Controla a distribuição de níveis das criaturas. Defina para 1.0 para níveis selvagens máximos com definições estilo oficial. |
OverrideOfficialDifficulty |
5.0 |
Define o nível máximo de dinos selvagens quando DifficultyOffset=1.0. Um valor de 5.0 permite níveis até 150. |
AllowCrateSpawnsOnTopOfStructures |
True |
Permite que drops de abastecimento aterrem em estruturas de jogadores. Recomendado para servidores PvE. |
EnablePvPGamma |
True |
Permite que os jogadores ajustem o gamma em PvP. Desative para uma experiência mais competitiva. |
Um exemplo mínimo de uma secção configurada do GameUserSettings.ini:
[SessionSettings]
SessionName=My Legion Server
QueryPort=7778
[ServerSettings]
ServerPassword=
ServerAdminPassword=adminpass123
MaxPlayers=20
XPMultiplier=2.0
TamingSpeedMultiplier=3.0
HarvestAmountMultiplier=2.0
DifficultyOffset=1.0
OverrideOfficialDifficulty=5.0
Passo 3 — Criar e Configurar o Game.ini
Criar o Game.ini
O Game.ini deve ser criado manualmente pelo utilizador se ainda não existir. Navegue até ShooterGame/Saved/Config/WindowsServer/ no gestor de ficheiros do GPanel. Se o Game.ini não estiver listado, crie um novo ficheiro com o nome exato Game.ini (G maiúsculo e I maiúsculo — game.ini ou GAME.INI não funcionarão).
Comece o ficheiro com o seguinte cabeçalho — todas as definições do Game.ini vão sob esta única secção:
[/script/shootergame.shootergamemode]
Editar o Game.ini
O Game.ini utiliza um formato baseado em secções. A secção mais comum para personalização do servidor é [/script/shootergame.shootergamemode]. As definições são adicionadas uma por linha dentro da secção apropriada.
Personalizações comuns do Game.ini:
[/script/shootergame.shootergamemode]
; Engram points per level (one entry per level, starting at level 1)
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
; Increase max XP required per level (one entry per level)
LevelExperienceRampOverrides=(...)
; Custom harvest amounts per resource
ResourceItemReplacementClasses=(...)
; Disable specific engrams
EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TurretGun_Rocket_C",LevelToAutoUnlock=0)
| Definição | Descrição |
|---|---|
OverridePlayerLevelEngramPoints=N |
Define os pontos de engram concedidos em cada nível. Adicione uma linha por nível de jogador. Use isto para conceder mais engrams por subida de nível. |
MaxCustomNodes=N |
Controla o máximo de nós de spawn personalizados. Relevante para configurações avançadas de spawn com mods. |
EngramEntryAutoUnlocks=(...) |
Força engrams específicos a serem desbloqueados automaticamente num nível definido, útil para dar a todos os jogadores acesso a determinados itens sem gastar pontos. |
ConfigOverrideItemMaxQuantity=(...) |
Substitui os tamanhos máximos de pilha para itens específicos. |
[/script/shootergame.shootergamemode] deve estar presente exatamente uma vez no Game.ini. Se o adicionar uma segunda vez, apenas a última ocorrência será utilizada. Adicione todas as suas definições sob o único cabeçalho.
Configuração da Porta de Consulta
A porta de consulta é separada da porta do jogo e é utilizada exclusivamente pelo navegador de servidores (Steam/Epic) para listar o seu servidor. Se a porta de consulta estiver errada ou inacessível, o seu servidor não aparecerá no navegador mesmo que esteja a funcionar corretamente.
| Porta | Predefinição | Configurada em | Finalidade |
|---|---|---|---|
| Game Port | 7777 |
Separador Startup / Network do GPanel | Os jogadores conectam-se através desta porta para entrar no servidor |
| Query Port | 7778 |
GameUserSettings.ini — QueryPort na secção [SessionSettings] |
Consulta do navegador de servidores — deve corresponder à porta alocada no GPanel |
QueryPort no GameUserSettings.ini deve corresponder exatamente à porta de consulta mostrada no separador Network do seu GPanel. A Legion Hosting pré-atribui ambas as portas quando o seu servidor é criado — verifique o separador Network para os seus valores específicos antes de editar o ficheiro .ini. Não assuma que os valores predefinidos de 7777/7778 se aplicam ao seu servidor.
Aplicar Alterações
- Guarde o seu ficheiro
.inieditado usando o botão Save no editor de ficheiros do GPanel. - Volte ao separador Console.
- Clique em Start para iniciar o servidor. O GPanel carregará a sua configuração atualizada no arranque.
- Monitorize a saída da consola para quaisquer erros. Erros de configuração como valores inválidos ou cabeçalhos de secção duplicados produzirão frequentemente avisos no log de arranque.
GameUserSettings.ini ou Game.ini enquanto o servidor está parado e depois iniciar o servidor é suficiente. Não tente recarregar ficheiros de configuração em tempo real enquanto o servidor está em execução — o ARK não suporta recarregamento de configuração ao vivo para a maioria das definições.
Resolução de Problemas
O Game.ini não existe ou as definições não estão a ser lidas
- O
Game.ininão é criado automaticamente. Se o ficheiro não existir, crie-o manualmente no editor de ficheiros do GPanel dentro deShooterGame/Saved/Config/WindowsServer/. - O nome do ficheiro é sensível a maiúsculas e minúsculas. Deve ser exatamente
Game.ini— nãogame.ini,GAME.INIou qualquer outra variação. - Certifique-se de que o ficheiro contém o cabeçalho
[/script/shootergame.shootergamemode]como primeira linha e que este cabeçalho aparece apenas uma vez.
As definições no Game.ini ou GameUserSettings.ini não estão a ser aplicadas
- Confirme que o servidor foi totalmente parado antes de editar o ficheiro. Se o servidor estava em execução, pode ter sobrescrito as suas alterações no próximo encerramento.
- Verifique que o cabeçalho da secção (por exemplo,
[ServerSettings]ou[/script/shootergame.shootergamemode]) aparece exatamente uma vez no ficheiro. Cabeçalhos de secção duplicados farão com que as definições posteriores substituam as anteriores, ou sejam ignoradas completamente dependendo do analisador. - Após guardar o ficheiro, reinicie o servidor completamente a partir do GPanel antes de testar.
- Verifique que o ficheiro está no diretório correto:
ShooterGame/Saved/Config/WindowsServer/. Ficheiros colocados no local errado são silenciosamente ignorados.
O servidor não aparece no navegador de servidores após configurar as definições
- Confirme que o
QueryPortnoGameUserSettings.inicorresponde exatamente à porta listada no separador Network do GPanel. - O navegador de servidores pode demorar 5–10 minutos a indexar um servidor recém-iniciado ou reconfigurado. Tente uma conexão direta com
open IP:GAMEPORTna consola do jogo ASA para verificar que o servidor está acessível enquanto o navegador se atualiza. - Se o crossplay estiver ativado, os jogadores devem desmarcar os filtros de bloqueio de plataforma no navegador de servidores. Consulte o guia de conexão para detalhes.