Este guia abrange a configuração de administração, comandos de administração no jogo, configuração de RCON e comandos de gestão do servidor para o seu servidor dedicado de Soulmask na Legion Hosting. Para configuração e definições do servidor, consulte o Guia de Configuração do Servidor Soulmask.
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.
Definir Privilégios de Administrador
O Soulmask utiliza um sistema de administração baseado em palavra-passe. Para se tornar administrador, precisa de definir uma palavra-passe de administrador na configuração de arranque do servidor e depois autenticar-se no jogo.
Passo 1: Definir a Palavra-passe de Administrador
- No GPanel, selecione o seu servidor Soulmask.
- Clique no separador Startup.
- Defina a variável
ADMIN_PASSWORDcom uma palavra-passe forte e única. Isto corresponde ao parâmetro de linha de comandos-adminpsw. - Reinicie o servidor para que a alteração tenha efeito.
Mantenha a sua palavra-passe de administrador em segredo. Qualquer pessoa que conheça a palavra-passe de administrador pode obter privilégios completos de GM no seu servidor. Partilhe-a apenas com co-administradores de confiança.
Passo 2: Autenticar-se no Jogo
- Entre no seu servidor Soulmask como jogador.
- Abra a consola do jogo pressionando a tecla ` (grave/til) ou Numpad - (menos do teclado numérico).
- Escreva o seguinte comando e pressione Enter:
gm key YOUR_ADMIN_PASSWORD - Se a palavra-passe estiver correta, verá uma mensagem de confirmação e obterá privilégios de administrador GM (Game Master).
- Também pode clicar no botão "Become the admin" que aparece na interface do painel GM.
Autenticação baseada em sessão. Deve re-autenticar-se cada vez que entra no servidor. O estado de administrador não é guardado entre sessões -- terá de executar
gm key cada vez que iniciar sessão.
Comandos de Administração no Jogo
Depois de autenticado como administrador, abra a consola (` ou Numpad -) e introduza os comandos. Todos os comandos de administração começam com o prefixo gm.
Gestão de Jogadores
| Comando | Descrição |
|---|---|
gm AddExp [value] |
Adicionar pontos de experiência geral à sua personagem. |
gm Addmjexp [value] |
Adicionar experiência de máscara à sua personagem (sobe o nível da máscara). |
gm Addshoulieexp [value] |
Adicionar experiência de caça à sua personagem. |
gm XiDian |
Repor todos os pontos de habilidade da sua personagem, permitindo redistribuição. |
gm FuHuo |
Reviver a sua personagem (usar quando morto). |
gm ZiSha 1 |
Matar a sua própria personagem (comando de suicídio). |
gm shanhao |
Eliminar a sua conta/personagem do servidor. Use com extrema cautela -- isto é irreversível. |
gm ShowInfo 1 |
Mostrar informações detalhadas sobre a sua própria personagem (estatísticas, IDs, posição). |
gm ShowInfo 0 |
Mostrar informações detalhadas sobre a personagem ou NPC atualmente selecionado. |
gm ChongZhiRenWu |
Repor todos os tutoriais e missões de guia da sua personagem. |
Navegação e Visibilidade
| Comando | Descrição |
|---|---|
gm Go [x] [y] [z] |
Teletransportar para coordenadas específicas do mundo. Use GPS para encontrar as suas coordenadas atuais primeiro. |
GPS |
Mostrar as suas coordenadas atuais no mundo (X, Y, Z). Útil para alvos de teletransporte. |
gm SetAttr YinShen 1 |
Ativar invisibilidade. Monstros e NPCs não conseguem detetá-lo. |
gm SetAttr YinShen 0 |
Desativar invisibilidade. Voltar à visibilidade normal. |
gm ShowMap |
Revelar o mapa inteiro, desbloqueando toda a névoa de guerra da sua personagem. |
Controlo de NPCs e do Mundo
| Comando | Descrição |
|---|---|
gm ZhaoMu |
Recrutar instantaneamente o NPC selecionado para a sua tribo. |
gm ClearAllNpc |
Remover todos os NPCs não-jogadores do servidor. Use com cautela -- afeta todos os NPCs em todo o servidor. |
gm ClearSelect |
Remover a entidade atualmente selecionada/alvo (NPC, criatura ou objeto). |
gm ShuaXinZhiBei |
Atualizar e regenerar toda a vegetação e plantas coletáveis próximas. |
gm KeJiShu |
Desbloquear todos os nós da árvore de tecnologia da sua personagem. |
Gestão de Invasões e Calor
| Comando | Descrição |
|---|---|
gm ShowReDu |
Mostrar o gráfico atual de calor de invasão, exibindo os níveis de ameaça em diferentes áreas. |
gm ClearAllReDu |
Limpar todo o calor de invasão no mapa, repondo os níveis de ameaça a zero. |
gm AddReDu [value] |
Aumentar manualmente o calor de invasão pelo valor especificado. Calor mais elevado atrai mais invasões. |
Servidor e Depuração
| Comando | Descrição |
|---|---|
gm exit |
Encerrar o servidor de forma segura com um save. Esta é a forma mais segura de parar o servidor a partir do jogo. |
Debuginfo 1 |
Ativar a sobreposição de monitorização de desempenho do servidor, mostrando tick rate, contagem de entidades e utilização de recursos. |
Debuginfo 0 |
Desativar a sobreposição de monitorização de desempenho do servidor. |
Use os comandos com moderação. Os comandos de administração podem afetar significativamente a estabilidade do servidor e a experiência dos jogadores. Criar grandes quantidades de entidades, limpar NPCs em todo o servidor ou modificar rapidamente os dados do mundo pode causar lag ou crashes. Teste os comandos primeiro num período de baixa população.
Comandos de Gestão do Servidor
Estes comandos são utilizados para gestão a nível do servidor e podem ser executados tanto no jogo (via consola) como remotamente (via RCON/Telnet).
Controlo do Servidor
| Comando | Descrição |
|---|---|
SaveWorld |
Forçar um save imediato do mundo para a memória (e opcionalmente para disco). Use antes de realizar operações arriscadas. |
SaveAndExit [seconds] |
Guardar o mundo e encerrar o servidor após o número de segundos especificado. Os jogadores recebem uma contagem decrescente de aviso. |
StopCloseServer |
Cancelar um encerramento pendente que foi iniciado com SaveAndExit. |
shutdown [seconds] |
Iniciar um encerramento seguro do servidor com a contagem decrescente especificada em segundos. |
broadcast [message] |
Enviar uma mensagem global a todos os jogadores ligados. Útil para anúncios e avisos. |
Administração de Jogadores (Remota)
| Comando | Descrição |
|---|---|
List_AllPlayers |
Listar todas as contas de jogadores registadas no servidor (online e offline). |
List_OnlinePlayers |
Listar todos os jogadores atualmente ligados com os seus Steam IDs e nomes de personagem. |
List_Guilds |
Listar todas as tribos (guildas) no servidor com contagem de membros. |
kick [PlayerName] |
Expulsar um jogador do servidor pelo nome de personagem. |
ban [PlayerName] |
Banir um jogador do servidor. Não poderá voltar a ligar-se. |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
Adicionar itens diretamente ao inventário de um jogador específico por Steam ID. |
GotoPosition [SteamID] [x] [y] [z] |
Teletransportar um jogador específico para coordenadas do mundo. |
FlyMode [SteamID] [0/1] |
Ativar (1) ou desativar (0) o modo de voo/fantasma para um jogador. |
Informações do Servidor
| Comando | Descrição |
|---|---|
ServerFPS |
Mostrar o tick rate atual do servidor (FPS). Servidores saudáveis devem manter 30+ FPS. |
Show_Coefficient_Settings |
Listar todas as definições atuais de coeficientes de jogabilidade do GameXishu.json. |
Set_Coefficient [key] [value] |
Modificar um coeficiente de jogabilidade em tempo real sem editar ficheiros. As alterações têm efeito imediato. |
List_AllTalent [level] |
Ver todos os dons naturais (talentos) disponíveis no nível especificado. |
Depuração e Avançado
| Comando | Descrição |
|---|---|
Dump_AllActorPositions |
Exportar todas as posições de atores para um ficheiro de dados para depuração do estado do mundo. |
DrawActorImage |
Gerar uma visualização das posições dos atores no mapa. |
ExecScriptCommands [filename] |
Executar um ficheiro de lote de comandos. Útil para executar múltiplos comandos de uma vez. |
Acesso RCON
O RCON (Remote Console) permite-lhe executar comandos do servidor remotamente sem estar ligado ao jogo. O Soulmask suporta tanto RCON como Telnet para administração remota.
Ativar RCON
O RCON está desativado por predefinição e deve ser ativado através dos parâmetros de arranque:
- No GPanel, vá ao separador Startup.
- Adicione os seguintes parâmetros (através de parâmetros de arranque adicionais ou contactando o suporte para que sejam adicionados):
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - Reinicie o servidor.
Segurança RCON. A implementação de RCON do Soulmask utiliza uma lista branca de IPs para segurança. Apenas endereços IP na lista branca podem ligar-se ao serviço RCON. Verifique a documentação do servidor ou os ficheiros de configuração para a localização da lista branca se precisar de adicionar o seu IP.
Ligar via RCON
Depois de o RCON estar ativado, pode ligar-se utilizando qualquer cliente RCON padrão:
- Descarregue um cliente RCON como o rcon-cli ou uma ferramenta com interface gráfica como o mcrcon.
- Ligue-se ao seu servidor utilizando:
- Host: O endereço IP do seu servidor
- Port: A porta RCON (predefinição
19000) - Password: A palavra-passe RCON que definiu com
-rconpsw
- Uma vez ligado, escreva
helppara ver a lista de comandos disponíveis.
Acesso Telnet
O Soulmask também suporta administração baseada em Telnet na Echo Port (predefinição 18888). O Telnet está restrito apenas a ligações locais por predefinição e não requer reencaminhamento de portas adicional. Isto é utilizado principalmente para administração automatizada na própria máquina do servidor.
Exemplo de Sessão RCON
# Connect to RCON (using rcon-cli as example)
rcon -a your.server.ip:19000 -p YOUR_RCON_PASSWORD
# Check server performance
ServerFPS
# List online players
List_OnlinePlayers
# Send a global message
broadcast Server restart in 10 minutes!
# Initiate a 600-second (10-minute) shutdown countdown
SaveAndExit 600
# Cancel the shutdown if needed
StopCloseServerEncerramento Correto do Servidor
Existem vários métodos seguros para encerrar um servidor Soulmask. Utilize sempre um destes para prevenir perda de dados:
- Botão Stop do GPanel: O método mais simples. Clique em Stop no separador Console do GPanel.
- Comando no jogo: Autentique-se como administrador e execute
gm exitpara guardar e encerrar. - RCON/Telnet: Execute
shutdown [seconds]ouSaveAndExit [seconds]para um encerramento com contagem decrescente que dá tempo aos jogadores para se prepararem.
Evite forçar o encerramento do servidor. Utilizar o botão Kill do GPanel ou forçar o término do processo ignorará o passo de save. Qualquer progresso desde a última cópia de segurança automática para disco será perdido. Utilize o Kill apenas como último recurso quando o servidor estiver completamente sem resposta.
Dicas para Administradores de Servidor
- Configure cópias de segurança automáticas. Utilize
-initbackupe-backupinterval=30para criar snapshots regulares de cópia de segurança. - Monitorize o FPS do servidor. Utilize o comando
ServerFPSregularmente. Se o tick rate cair abaixo de 15-20 FPS, o servidor está com dificuldades e pode precisar de otimização ou reinício. - Utilize
Set_Coefficientpara ajustes em tempo real. Pode ajustar definições de jogabilidade em tempo real sem reiniciar o servidor. ExecuteShow_Coefficient_Settingsprimeiro para ver os valores atuais. - Agende reinícios regulares. Reinicie o servidor diariamente para limpar fugas de memória e aplicar quaisquer atualizações pendentes.
- Anuncie antes de manutenções. Utilize sempre o comando
broadcastpara avisar os jogadores antes de reinícios ou janelas de manutenção do servidor. - Utilize
SaveWorldantes de operações arriscadas. Force um save antes de fazer alterações significativas como limpar NPCs ou modificar coeficientes.
Artigos Relacionados
- Guia de Configuração do Servidor Soulmask
- Como Encontrar o IP e Porta do Seu Servidor
- Como Enviar Ficheiros via SFTP
- Começar com o Seu Novo Servidor
Precisa de Ajuda?
Se precisar de assistência adicional com os comandos de administração ou gestão do servidor Soulmask, por favor abra um ticket de suporte e a nossa equipa terá todo o gosto em ajudá-lo.
