Este guia abrange todos os comandos de admin, suporte a mods e ferramentas de gestão de servidor disponíveis para o seu servidor dedicado de Avorion na Legion Hosting. Aprenda a gerir jogadores, controlar a galáxia, instalar mods e resolver problemas comuns. Para a configuração inicial do servidor, consulte o nosso Guia de Configuração do Servidor Avorion.

Configuração de Admin

O Avorion utiliza um sistema de admin baseado em XML que concede permissões elevadas a jogadores específicos. Os admins são definidos no ficheiro admin.xml ou podem ser adicionados através de comandos no jogo.

Adicionar Admins via admin.xml

O ficheiro admin.xml está localizado na pasta de gravação da sua galáxia (ex.: galaxies/your_galaxy_name/admin.xml). Pode editar este ficheiro através do File Manager do GPanel.

<?xml version="1.0" encoding="UTF-8"?>
<admin>
    <admin id="76561198012345678" />
    <admin id="76561198087654321" />
</admin>

Cada entrada <admin> contém o Steam ID de um jogador (formato SteamID64). Para encontrar o Steam ID de um jogador:

1. Aceda ao perfil Steam do jogador
2. Se o URL do perfil utilizar um nome personalizado, use uma ferramenta de pesquisa de SteamID para encontrar o SteamID64
3. O SteamID64 é um número de 17 dígitos que começa com 7656119

Adicionar Admins no Jogo

Se já for admin, pode adicionar outros admins utilizando o comando de chat no jogo:

/admin <playerName>

Isto adiciona o jogador especificado à lista de admins imediatamente sem necessitar de reiniciar o servidor.

Comandos de Admin Comuns

Os comandos de admin são introduzidos no chat do jogo (pressione Enter para abrir o chat) com o prefixo /. Estes também podem ser executados a partir da consola do servidor no GPanel.

Gestão de Jogadores

Controlo do Servidor

Teletransporte e Navegação

Gestão da Galáxia

Como admin, tem ferramentas para gerir a estrutura da galáxia e os setores.

Gestão de Setores

Níveis de Material

A galáxia do Avorion está organizada em anéis de níveis de material crescentes, irradiando para dentro em direção à barreira no núcleo. Compreender isto ajuda ao teletransportar jogadores ou gerir conteúdo de setores.

Suporte a Mods e Workshop

O Avorion tem suporte robusto ao Steam Workshop, permitindo-lhe expandir o seu servidor com mods criados pela comunidade.

Instalar Mods

1. Encontre o mod que deseja no Steam Workshop do Avorion
2. Anote o Workshop ID do URL do mod (o número no final)
3. Pare o servidor no GPanel
4. Abra o File Manager do GPanel
5. Navegue até ao diretório galaxies/your_galaxy_name/
6. Edite o ficheiro modconfig.lua (crie-o se não existir)
7. Adicione o Workshop ID do mod à configuração
8. Inicie o servidor — o mod será descarregado automaticamente

Formato do modconfig.lua

-- Avorion Mod Configuration
modLocation = ""
forceEnabling = false

mods =
{
    {workshopid = "1234567890"},
    {workshopid = "0987654321"},
    {workshopid = "1122334455"},
}

Dicas de Gestão de Mods

• Adicione mods um de cada vez e teste após cada adição para identificar problemas de compatibilidade
• Alguns mods requerem um reset da galáxia para terem efeito completo (especialmente os que modificam a geração de setores)
• Verifique os comentários e descrições dos mods para incompatibilidades conhecidas antes de instalar
• Mantenha uma cópia de segurança do seu modconfig.lua e da pasta da galáxia antes de adicionar ou remover mods
• Mods apenas do lado do servidor não requerem que os clientes os instalem, mas a maioria dos mods de jogabilidade precisa de ambos os lados

Resolução de Problemas

Servidor Não Aparece no Navegador

1. Verifique que listed=true no seu server.ini ou variáveis de arranque
2. Confirme que a porta de consulta Steam (steamQueryPort) está acessível — normalmente é a porta do jogo + 1
3. Aguarde 2-3 minutos após o arranque do servidor para a listagem Steam propagar
4. Tente conectar via Direct Connect para confirmar que o servidor está em execução
5. Certifique-se de que o servidor arrancou completamente verificando Server startup complete na consola

Crashes do Servidor

Se o seu servidor Avorion estiver a crashar, siga estes passos:

1. Verifique os logs de crash — Procure na consola do GPanel e na pasta logs/ dentro do diretório da galáxia por mensagens de erro
2. Remova mods adicionados recentemente — Se os crashes começaram após adicionar um mod, remova-o do modconfig.lua e reinicie
3. Verifique corrupção de setores — Se o crash ocorre ao carregar um setor específico, esse setor pode estar corrompido. Use /regeneratesector a partir da consola (se acessível) ou elimine o ficheiro do setor da pasta sectors/
4. Atualize o servidor — Certifique-se de que o servidor está a executar a versão mais recente através do GPanel
5. Reduza os worker threads — Se o servidor está a ficar sem recursos, tente reduzir workerThreads e generatorThreads no server.ini
6. Restaure a partir de cópia de segurança — Se tudo o resto falhar, restaure a pasta da galáxia a partir de uma cópia de segurança feita antes dos problemas começarem

Problemas de Desempenho

• Tick time elevado — Use /status para verificar o desempenho do servidor. Tick times elevados indicam que o servidor está com dificuldades em manter a simulação.
• Demasiados setores carregados — Cada setor com jogadores ou IA ativa consome recursos. Encoraje os jogadores a evitar espalhar-se demasiado pela galáxia simultaneamente.
• Naves grandes — Naves com contagens excessivas de blocos aumentam a carga de simulação. Considere definir orientações para tamanhos máximos de naves.
• Excesso de estações — Muitas estações construídas por jogadores num único setor podem degradar o desempenho. Monitorize a contagem de entidades do setor com /sector.

Problemas de Conexão dos Jogadores

• Incompatibilidade de versão — Todos os jogadores devem estar na mesma versão do jogo que o servidor. Certifique-se de que todos atualizaram através do Steam.
• Incompatibilidade de mods — Os jogadores precisam dos mesmos mods instalados. Se um jogador não consegue conectar, verifique se a lista de mods corresponde ao modconfig.lua do servidor.
• Erros de timeout — Podem indicar sobrecarga do servidor ou problemas de rede. Verifique o desempenho do servidor com /status.
• Problemas com palavra-passe — Se os jogadores reportam que a palavra-passe não funciona, verifique se a palavra-passe nas variáveis de arranque e no server.ini correspondem.

Referência Rápida

Os comandos de admin mais utilizados para a gestão diária do servidor:

# Check server health
/status

# See who is online
/players

# Save all data
/save

# Broadcast a message
/say Server restarting in 5 minutes!

# Kick a player
/kick PlayerName

# Ban a player
/ban PlayerName

# Teleport to a player
/tp PlayerName

# Give resources to a player
/give PlayerName 10000 Trinium

# View current sector info
/sector

# Check galaxy seed
/seed

# Safely shut down
/stop

Artigos Relacionados

• Guia de Configuração do Servidor Avorion
• Como Encontrar o IP e a Porta do Seu Servidor
• Como Carregar Ficheiros via SFTP
• Começar com o Seu Novo Servidor

Precisa de Ajuda?

Se precisar de assistência adicional com a administração do servidor Avorion ou tiver questões sobre comandos específicos, a nossa equipa de suporte está pronta para ajudar. Submeta um ticket de suporte e responderemos o mais brevemente possível.