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

Configuração de Admin

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

Adicionando Admins via admin.xml

O arquivo admin.xml está localizado na pasta de save da sua galáxia (ex.: galaxies/your_galaxy_name/admin.xml). Você pode editar este arquivo através do Gerenciador de Arquivos 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 do jogador (formato SteamID64). Para encontrar o Steam ID de um jogador:

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

Adicionando Admins no Jogo

Se você já é um admin, pode adicionar outros admins usando o comando de chat no jogo:

/admin <playerName>

Isso adiciona o jogador especificado à lista de admins imediatamente, sem necessidade de reiniciar o servidor.

Comandos de Admin Comuns

Os comandos de admin são digitados no chat do jogo (pressione Enter para abrir o chat) com o prefixo /. Eles também podem ser executados no console do servidor no GPanel.

Gerenciamento de Jogadores

Controle do Servidor

Teletransporte e Navegação

Gerenciamento da Galáxia

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

Gerenciamento de Setores

Níveis de Material

A galáxia de Avorion é organizada em anéis de níveis crescentes de material, irradiando para dentro em direção à barreira no centro. Entender isso ajuda ao teletransportar jogadores ou gerenciar o conteúdo dos setores.

Suporte a Mods e Workshop

Avorion possui suporte robusto ao Steam Workshop, permitindo que você expanda seu servidor com mods criados pela comunidade.

Instalando Mods

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

Formato do modconfig.lua

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

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

Dicas de Gerenciamento 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 ter efeito completo (especialmente aqueles que modificam a geração de setores)
• Verifique os comentários e descrições dos mods para incompatibilidades conhecidas antes de instalar
• Mantenha um backup do seu modconfig.lua e da pasta da galáxia antes de adicionar ou remover mods
• Mods exclusivos do servidor não exigem que os clientes os instalem, mas a maioria dos mods de gameplay precisa de ambos os lados

Solução de Problemas

Servidor Não Aparece no Navegador

1. Verifique se listed=true no seu server.ini ou variáveis de inicialização
2. Confirme que a porta de consulta Steam (steamQueryPort) está acessível — geralmente é a porta do jogo + 1
3. Aguarde 2-3 minutos após a inicialização do servidor para a listagem Steam se propagar
4. Tente conectar via Conexão Direta para confirmar que o servidor está funcionando
5. Certifique-se de que o servidor iniciou completamente verificando a mensagem Server startup complete no console

Crashes do Servidor

Se o seu servidor Avorion está travando, siga estas etapas:

1. Verifique os logs de crash — Procure no console 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 setor — Se o crash ocorre ao carregar um setor específico, esse setor pode estar corrompido. Use /regeneratesector pelo console (se acessível) ou delete o arquivo do setor da pasta sectors/
4. Atualize o servidor — Certifique-se de que seu servidor está executando a versão mais recente através do GPanel
5. Reduza as threads de trabalho — Se o servidor está ficando sem recursos, tente reduzir workerThreads e generatorThreads no server.ini
6. Restaure a partir de um backup — Se tudo mais falhar, restaure a pasta da galáxia a partir de um backup feito antes dos problemas começarem

Problemas de Desempenho

• Tick time alto — Use /status para verificar o desempenho do servidor. Tick times altos indicam que o servidor está tendo dificuldade para acompanhar as demandas da simulação.
• Muitos setores carregados — Cada setor com jogadores ou IA ativa consome recursos. Incentive os jogadores a não se espalharem demais pela galáxia simultaneamente.
• Naves grandes — Naves com contagem excessiva de blocos aumentam a carga de simulação. Considere definir diretrizes para tamanhos máximos de naves.
• Excesso de estações — Muitas estações construídas por jogadores em um único setor podem degradar o desempenho. Monitore a contagem de entidades do setor com /sector.

Problemas de Conexão dos Jogadores

• Versão incompatível — Todos os jogadores devem estar na mesma versão do jogo que o servidor. Certifique-se de que todos atualizaram pelo Steam.
• Mods incompatíveis — Os jogadores precisam ter os mesmos mods instalados. Se um jogador não consegue conectar, verifique se a lista de mods dele 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 de senha — Se jogadores relatam que a senha não está funcionando, verifique se a senha nas variáveis de inicialização e no server.ini correspondem.

Referência Rápida

Os comandos de admin mais utilizados para o gerenciamento diário 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 Enviar Arquivos via SFTP
• Primeiros Passos com Seu Novo Servidor

Precisa de Ajuda?

Se você precisa de mais assistência com a administração do servidor Avorion ou tem perguntas sobre comandos específicos, nossa equipe de suporte está pronta para ajudar. Envie um ticket de suporte e responderemos o mais rápido possível.