Este guia aborda a configuração de admin, comandos de admin no jogo, configuração de RCON e comandos de gerenciamento de servidor para 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: Todo o gerenciamento do servidor é feito através do GPanel em gpanel.legionhosting.net. Use o Gerenciador de Arquivos ou SFTP para editar arquivos de configuração.
Configurando Privilégios de Admin
Soulmask usa um sistema de admin baseado em senha. Para se tornar admin, você precisa definir uma senha de admin na configuração de inicialização do servidor e então se autenticar no jogo.
Passo 1: Definir a Senha de Admin
- No GPanel, selecione seu servidor de Soulmask.
- Clique na aba Startup.
- Defina a variável
ADMIN_PASSWORDcom uma senha forte e única. Isso corresponde ao parâmetro de linha de comando-adminpsw. - Reinicie o servidor para que a alteração entre em vigor.
Mantenha sua senha de admin em segredo. Qualquer pessoa que conheça a senha de admin pode obter privilégios completos de GM no seu servidor. Compartilhe apenas com co-admins de confiança.
Passo 2: Autenticar-se no Jogo
- Entre no seu servidor de Soulmask como jogador.
- Abra o console do jogo pressionando a tecla ` (crase/til) ou Numpad - (menos do teclado numérico).
- Digite o seguinte comando e pressione Enter:
gm key YOUR_ADMIN_PASSWORD - Se a senha estiver correta, você verá uma mensagem de confirmação e receberá privilégios de admin GM (Game Master).
- Você também pode clicar no botão "Become the admin" que aparece na interface do painel GM.
Autenticação baseada em sessão. Você deve se autenticar novamente cada vez que entrar no servidor. O status de admin não é salvo entre sessões -- você precisará executar
gm key cada vez que fizer login.
Comandos de Admin no Jogo
Uma vez autenticado como admin, abra o console (` ou Numpad -) e digite os comandos. Todos os comandos de admin começam com o prefixo gm.
Gerenciamento de Jogadores
| Comando | Descrição |
|---|---|
gm AddExp [value] |
Adicionar pontos de experiência geral ao seu personagem. |
gm Addmjexp [value] |
Adicionar experiência de máscara ao seu personagem (evolui a máscara). |
gm Addshoulieexp [value] |
Adicionar experiência de caça ao seu personagem. |
gm XiDian |
Redefinir todos os pontos de habilidade do seu personagem, permitindo redistribuição. |
gm FuHuo |
Reviver seu personagem (usar quando morto). |
gm ZiSha 1 |
Matar seu próprio personagem (comando de suicídio). |
gm shanhao |
Excluir sua conta/personagem do servidor. Use com extrema cautela -- isso é irreversível. |
gm ShowInfo 1 |
Exibir informações detalhadas sobre seu próprio personagem (atributos, IDs, posição). |
gm ShowInfo 0 |
Exibir informações detalhadas sobre o personagem ou NPC atualmente selecionado. |
gm ChongZhiRenWu |
Redefinir todos os tutoriais e missões guia do seu personagem. |
Navegação e Visibilidade
| Comando | Descrição |
|---|---|
gm Go [x] [y] [z] |
Teleportar para coordenadas específicas do mundo. Use GPS para encontrar suas coordenadas atuais primeiro. |
GPS |
Exibir suas coordenadas atuais do mundo (X, Y, Z). Útil para alvos de teleporte. |
gm SetAttr YinShen 1 |
Ativar invisibilidade. Monstros e NPCs não podem detectar você. |
gm SetAttr YinShen 0 |
Desativar invisibilidade. Retornar à visibilidade normal. |
gm ShowMap |
Revelar o mapa inteiro, desbloqueando toda a névoa de guerra do seu personagem. |
Controle de NPCs e Mundo
| Comando | Descrição |
|---|---|
gm ZhaoMu |
Recrutar instantaneamente o NPC selecionado para sua tribo. |
gm ClearAllNpc |
Remover todos os NPCs não-jogadores do servidor. Use com cautela -- afeta todos os NPCs do 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 do seu personagem. |
Gerenciamento de Invasão e Calor
| Comando | Descrição |
|---|---|
gm ShowReDu |
Exibir o gráfico atual de calor de invasão, mostrando níveis de ameaça em diferentes áreas. |
gm ClearAllReDu |
Limpar todo o calor de invasão no mapa, redefinindo os níveis de ameaça para zero. |
gm AddReDu [value] |
Aumentar manualmente o calor de invasão pela quantidade especificada. Calor mais alto atrai mais invasões. |
Servidor e Debug
| Comando | Descrição |
|---|---|
gm exit |
Desligar o servidor graciosamente com um save. Esta é a forma mais segura de parar o servidor pelo jogo. |
Debuginfo 1 |
Ativar overlay de monitoramento de desempenho do servidor, mostrando taxa de tick, contagem de entidades e uso de recursos. |
Debuginfo 0 |
Desativar o overlay de monitoramento de desempenho do servidor. |
Use comandos com moderação. Comandos de admin podem impactar significativamente a estabilidade do servidor e a experiência dos jogadores. Spawnar grandes quantidades de entidades, limpar NPCs de todo o servidor ou modificar dados do mundo rapidamente pode causar lag ou travamentos. Teste comandos primeiro em um período de baixa população.
Comandos de Gerenciamento do Servidor
Estes comandos são usados para gerenciamento geral do servidor e podem ser executados tanto no jogo (via console) quanto remotamente (via RCON/Telnet).
Controle do Servidor
| Comando | Descrição |
|---|---|
SaveWorld |
Forçar um save imediato do mundo na memória (e opcionalmente no disco). Use antes de realizar operações arriscadas. |
SaveAndExit [seconds] |
Salvar o mundo e desligar o servidor após o número especificado de segundos. Os jogadores recebem uma contagem regressiva de aviso. |
StopCloseServer |
Cancelar um desligamento pendente que foi iniciado com SaveAndExit. |
shutdown [seconds] |
Iniciar um desligamento gracioso do servidor com a contagem regressiva especificada em segundos. |
broadcast [message] |
Enviar uma mensagem global para todos os jogadores conectados. Útil para anúncios e avisos. |
Administração de Jogadores (Remoto)
| Comando | Descrição |
|---|---|
List_AllPlayers |
Listar todas as contas de jogadores registradas no servidor (online e offline). |
List_OnlinePlayers |
Listar todos os jogadores conectados atualmente com 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 do personagem. |
ban [PlayerName] |
Banir um jogador do servidor. Ele não poderá se reconectar. |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
Adicionar itens diretamente ao inventário de um jogador específico pelo Steam ID. |
GotoPosition [SteamID] [x] [y] [z] |
Teleportar um jogador específico para coordenadas do mundo. |
FlyMode [SteamID] [0/1] |
Ativar (1) ou desativar (0) o modo fantasma/voo para um jogador. |
Informações do Servidor
| Comando | Descrição |
|---|---|
ServerFPS |
Exibir a taxa de tick atual do servidor (FPS). Servidores saudáveis devem manter 30+ FPS. |
Show_Coefficient_Settings |
Listar todas as configurações atuais de coeficientes de gameplay do GameXishu.json. |
Set_Coefficient [key] [value] |
Modificar um coeficiente de gameplay em tempo real sem editar arquivos. As alterações entram em vigor imediatamente. |
List_AllTalent [level] |
Ver todos os dons naturais (talentos) disponíveis no nível especificado. |
Debug e Avançado
| Comando | Descrição |
|---|---|
Dump_AllActorPositions |
Exportar todas as posições de atores para um arquivo de dados para debug do estado do mundo. |
DrawActorImage |
Gerar uma visualização das posições dos atores no mapa. |
ExecScriptCommands [filename] |
Executar um arquivo em lote de comandos. Útil para executar múltiplos comandos de uma vez. |
Acesso RCON
RCON (Remote Console) permite que você execute comandos do servidor remotamente sem estar conectado ao jogo. Soulmask suporta tanto RCON quanto Telnet para administração remota.
Habilitando RCON
RCON está desabilitado por padrão e deve ser habilitado através de parâmetros de inicialização:
- No GPanel, vá para a aba Startup.
- Adicione os seguintes parâmetros (através de parâmetros de inicialização adicionais ou entrando em contato com o suporte para que sejam adicionados):
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - Reinicie o servidor.
Segurança do RCON. A implementação de RCON do Soulmask usa uma lista de IPs permitidos para segurança. Apenas endereços IP na lista podem se conectar ao serviço RCON. Verifique a documentação do servidor ou os arquivos de configuração para encontrar a localização da lista de permissões se precisar adicionar seu IP.
Conectando via RCON
Uma vez que o RCON esteja habilitado, você pode se conectar usando qualquer cliente RCON padrão:
- Baixe um cliente RCON como rcon-cli ou uma ferramenta com interface gráfica como mcrcon.
- Conecte-se ao seu servidor usando:
- Host: O endereço IP do seu servidor
- Port: A porta RCON (padrão
19000) - Password: A senha RCON que você definiu com
-rconpsw
- Uma vez conectado, digite
helppara ver uma lista de comandos disponíveis.
Acesso Telnet
Soulmask também suporta administração baseada em Telnet na Echo Port (padrão 18888). Telnet é restrito apenas a conexões locais por padrão e não requer encaminhamento de porta adicional. Isso é usado 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
StopCloseServerDesligamento Adequado do Servidor
Existem vários métodos seguros para desligar um servidor de Soulmask. Sempre use um destes para prevenir perda de dados:
- Botão Stop do GPanel: O método mais simples. Clique em Stop na aba Console do GPanel.
- Comando no jogo: Autentique-se como admin e execute
gm exitpara salvar e desligar. - RCON/Telnet: Execute
shutdown [seconds]ouSaveAndExit [seconds]para um desligamento com contagem regressiva que dá tempo aos jogadores para se prepararem.
Evite forçar o encerramento do servidor. Usar o botão Kill do GPanel ou forçar o encerramento do processo irá pular a etapa de save. Qualquer progresso desde o último backup automático em disco será perdido. Use Kill apenas como último recurso quando o servidor estiver completamente sem resposta.
Dicas para Administradores de Servidor
- Configure backups automáticos. Use
-initbackupe-backupinterval=30para criar snapshots de backup regulares. - Monitore o FPS do servidor. Use o comando
ServerFPSregularmente. Se a taxa de tick cair abaixo de 15-20 FPS, o servidor está com dificuldades e pode precisar de otimização ou reinício. - Use
Set_Coefficientpara ajustes em tempo real. Você pode ajustar configurações de gameplay 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 vazamentos de memória e aplicar quaisquer atualizações pendentes.
- Avise antes de manutenções. Sempre use o comando
broadcastpara avisar os jogadores antes de reinícios ou janelas de manutenção do servidor. - Use
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 a Porta do Seu Servidor
- Como Enviar Arquivos via SFTP
- Primeiros Passos com Seu Novo Servidor
Precisa de Ajuda?
Se você precisar de assistência adicional com comandos de admin do Soulmask ou gerenciamento de servidor, por favor abra um ticket de suporte e nossa equipe terá prazer em ajudá-lo.
