Guia de Configuração do Servidor Soulmask

Este guia cobre tudo que você precisa para configurar seu servidor dedicado de Soulmask na Legion Hosting, incluindo primeira inicialização, variáveis de inicialização do GPanel, configuração do servidor, modos PvE vs PvP, configurações de mapa e mundo, conexão ao servidor e gerenciamento de saves. Para configuração de admin e comandos no jogo, consulte Comandos de Admin do Soulmask.

O Que É Soulmask

Soulmask é um jogo de sobrevivência e crafting em mundo aberto onde os jogadores despertam usando uma misteriosa máscara antiga que concede habilidades sobrenaturais. Ambientado em um mundo vasto e exuberante, os jogadores devem coletar recursos, fabricar ferramentas e armas, construir assentamentos e recrutar e gerenciar uma tribo de NPCs. O sistema de máscara é central para a jogabilidade -- os jogadores podem possuir e controlar diferentes membros da tribo, cada um com habilidades e características únicas, para otimizar seu assentamento e eficácia em combate.

Principais recursos do servidor dedicado incluem:

Suporte para até 70 jogadores simultâneos em um único servidor
Modos de jogo PvE e PvP com regras configuráveis
Ajuste extensivo de gameplay através do arquivo de configuração GameXishu.json
Sistema de tribo (guilda) com limites de membros configuráveis
Suporte a RCON e Telnet para gerenciamento remoto do servidor
Backup automático e gerenciamento de saves

Pare seu servidor antes de editar qualquer arquivo de configuração. Sempre pare seu servidor pela aba Console no GPanel antes de editar arquivos de configuração. Alterações feitas enquanto o servidor está rodando podem ser sobrescritas ou causar corrupção.

Primeira Inicialização

Quando você recebe seu servidor de Soulmask da Legion Hosting pela primeira vez, ele precisa completar uma instalação inicial antes de poder ser jogado.

Faça login no GPanel e selecione seu servidor de Soulmask na lista de servidores.
Clique na aba Console e pressione Start.
O servidor irá baixar e instalar os arquivos do servidor dedicado de Soulmask via Steam. Este download inicial pode levar vários minutos, pois o jogo requer espaço significativo em disco.
Uma vez que o download seja concluído, o servidor iniciará automaticamente. A primeira inicialização leva mais tempo que as subsequentes enquanto o servidor gera o banco de dados do mundo inicial.
Aguarde até que a saída do console indique que o servidor está pronto e ouvindo conexões.

Requisitos de RAM. Soulmask é um jogo que consome muita memória. O servidor dedicado requer pelo menos 11 GB de RAM livre para iniciar. Certifique-se de que seu plano de hospedagem fornece memória suficiente para a quantidade esperada de jogadores. Contagens maiores de jogadores e mundos maiores usarão mais RAM.

Variáveis de Inicialização do GPanel

As configurações principais do servidor são definidas como variáveis de inicialização no GPanel. Esses valores são passados ao processo do servidor como parâmetros de linha de comando quando ele é iniciado.

No GPanel, selecione seu servidor de Soulmask.
Clique na aba Startup.
Defina as variáveis listadas abaixo. As alterações entram em vigor na próxima vez que você iniciar ou reiniciar o servidor.

Variável	Padrão	Descrição
`SERVER_NAME`	`My Soulmask Server`	O nome exibido no navegador de servidores do Steam e na lista de servidores do jogo. Torne-o descritivo para que os jogadores possam encontrar seu servidor facilmente.
`SERVER_PASSWORD`	(vazio)	Senha necessária para os jogadores entrarem (parâmetro `-PSW`). Deixe vazio para um servidor público. Defina uma senha para restringir o acesso apenas a jogadores convidados.
`ADMIN_PASSWORD`	(vazio)	Senha de administrador GM (parâmetro `-adminpsw`). Necessária para acessar o painel de admin no jogo e executar comandos de admin. Mantenha em segredo.
`MAX_PLAYERS`	`60`	Número máximo de jogadores simultâneos (parâmetro `-MaxPlayers`). Soulmask suporta até 70 jogadores, mas contagens maiores requerem mais RAM e CPU.
`GAME_MODE`	`pve`	Modo de jogo do servidor. Defina como `pve` para PvE ou `pvp` para PvP. Consulte a seção PvE vs PvP abaixo.
`GAME_PORT`	`8777`	A porta UDP principal para conexões de jogo (parâmetro `-Port`). Configurada automaticamente pelo seu plano de hospedagem.
`QUERY_PORT`	`27015`	A porta UDP usada pelo Steam para consultas do navegador de servidores (parâmetro `-QueryPort`). Configurada automaticamente.

Variáveis de inicialização substituem arquivos de configuração. Se uma configuração é definida tanto como variável de inicialização quanto dentro de um arquivo de configuração, a variável de inicialização tem precedência. Use variáveis de inicialização para configurações de identidade principais e arquivos de configuração para ajuste detalhado de gameplay.

Configuração do Servidor (Parâmetros de Linha de Comando)

Soulmask usa extensos parâmetros de linha de comando para configuração do servidor. Abaixo está a referência completa dos parâmetros disponíveis:

Parâmetro	Padrão	Descrição
`-SteamServerName="Name"`	-	Nome de exibição do servidor no navegador de servidores.
`-MaxPlayers=N`	`60`	Máximo de conexões simultâneas de jogadores (até 70).
`-PSW="password"`	(nenhum)	Senha para entrar no servidor. Omita para um servidor público.
`-adminpsw="password"`	(nenhum)	Senha de administrador/GM para comandos de admin no jogo.
`-pve`	-	Força o modo PvE. Jogadores não podem causar dano uns aos outros.
`-pvp`	-	Força o modo PvP. Jogadores podem causar dano uns aos outros.
`-Port=N`	`8777`	Porta de conexão do jogo (UDP).
`-QueryPort=N`	`27015`	Porta de consulta do Steam (UDP).
`-EchoPort=N`	`18888`	Porta do console Telnet (TCP, apenas local). Usada para gerenciamento remoto local.
`-saving=N`	-	Intervalo de salvamento do estado do mundo na memória (em segundos).
`-backup=N`	-	Intervalo de backup do banco de dados em memória para disco (em segundos).
`-initbackup`	-	Cria uma cópia de backup do mundo cada vez que o servidor inicia.
`-backupinterval=N`	-	Intervalo de criação automática de backup (em minutos).
`-GongHuiMaxMember=N`	-	Número máximo de membros por tribo (guilda).
`-MULTIHOME=IP`	-	Vincula o servidor a um endereço IP local específico (apenas servidores multi-homed).
`-rconpsw="password"`	(nenhum)	Habilita acesso ao console remoto RCON com a senha especificada.
`-rconport=N`	`19000`	Porta TCP do listener RCON. Relevante apenas se o RCON estiver habilitado.
`-rconaddr=IP`	-	Vinculação de IP do listener RCON. Use `0.0.0.0` para ouvir em todas as interfaces.
`-log`	-	Habilita janela de console e saída de log.
`-UTF8Output`	-	Habilita o tratamento correto de caracteres não-latinos na saída.

O GPanel gerencia a maioria destes automaticamente. Na Legion Hosting, os parâmetros essenciais são configurados através da aba Startup do GPanel. Parâmetros avançados como configurações de RCON ou limites de tribo podem ser adicionados através do campo de parâmetros de inicialização adicionais do GPanel, se disponível, ou entrando em contato com o suporte.

Modo PvE vs PvP

Soulmask suporta dois modos de jogo principais que mudam fundamentalmente a experiência multiplayer:

Modo PvE (`-pve`)

Jogadores não podem causar dano uns aos outros diretamente.
Estruturas e bases são protegidas de outros jogadores.
O foco é na sobrevivência cooperativa, construção e exploração.
Jogadores ainda podem interagir, negociar e formar tribos.
Recomendado para comunidades cooperativas e servidores casuais.

Modo PvP (`-pvp`)

Jogadores podem atacar e matar uns aos outros.
Bases e estruturas podem ser invadidas e destruídas por outros jogadores.
Guerra tribal e controle de território se tornam elementos centrais de gameplay.
Proporções de dano PvP podem ser ajustadas no arquivo de configuração GameXishu.json.
Recomendado para servidores competitivos e jogadores experientes.

O modo não pode ser alterado sem wipe. Mudar entre PvE e PvP após o mundo ter sido criado pode causar inconsistências de gameplay. É recomendado decidir o modo antes da primeira inicialização. Se você precisar mudar de modo em um mundo existente, considere começar do zero.

Configurações de Mapa e Mundo (GameXishu.json)

Configurações detalhadas de mundo e gameplay são controladas através do arquivo de configuração GameXishu.json. Este arquivo contém opções extensivas para ajustar taxas de recursos, combate, invasões, construção, animais e mais.

Localizando o Arquivo

O arquivo de configuração está localizado em:

WS/Saved/GameplaySettings/GameXishu.json

Acesse este arquivo através da aba Files do GPanel ou via SFTP.

Referência de Configurações Principais

Abaixo estão as configurações mais comumente ajustadas. Os nomes dos parâmetros estão em seu formato original (pinyin chinês). Descrições em português são fornecidas para cada um.

Experiência e Progressão

Configuração	Nome em Inglês	Descrição
`ExpRatio`	Experience Ratio	Multiplicador para ganho de experiência geral. Valores mais altos aceleram a evolução de nível.
`ChengZhangExpRatio`	Growth Experience Ratio	Multiplicador para ganho de experiência de crescimento do personagem.
`ShaGuaiExpRatio`	Monster Kill Experience Ratio	Multiplicador para experiência ganha ao matar monstros.

Combate e Dano

Configuração	Nome em Inglês	Descrição
`DongWuDamageRatio`	Animal Damage Ratio	Multiplicador para dano causado por animais selvagens e criaturas.
`BeDamageByYeShengRatio`	Damage Taken from Wildlife	Multiplicador para dano recebido de criaturas selvagens.
`ShengMingHuiFuRatio`	Health Recovery Ratio	Multiplicador para velocidade de regeneração natural de vida.
`QiXiHuiFuRatio`	Stamina Recovery Ratio	Multiplicador para velocidade de recuperação de stamina.
`TiLiHuiFuRatio`	Energy Recovery Ratio	Multiplicador para velocidade de recuperação de energia/resistência.
`PVP_ShangHaiRatio_JinZhan`	PvP Melee Damage Ratio	Multiplicador para dano corpo a corpo em PvP (padrão: `0.4`).

Recursos e Consumo

Configuração	Nome em Inglês	Descrição
`ShiWuXiaoHaoRatio`	Food Consumption Ratio	Multiplicador para velocidade de consumo de comida. Valores mais baixos reduzem o consumo de comida.
`ShuiXiaoHaoRatio`	Water Consumption Ratio	Multiplicador para velocidade de consumo de água.
`RanLiaoXiaoHaoRatio`	Fuel Consumption Ratio	Multiplicador para velocidade de consumo de combustível por estações de crafting e fogueiras.

Animais e Agricultura

Configuração	Nome em Inglês	Descrição
`DongWuShengZhangRatio`	Animal Growth Ratio	Multiplicador para velocidade de crescimento de animais. Valores mais altos fazem os animais amadurecerem mais rápido.
`FanZhiJianGeRatio`	Breeding Interval Ratio	Multiplicador para tempo entre ciclos de reprodução de animais.
`DongWuChanChuRatio`	Animal Production Ratio	Multiplicador para produção de animais (ovos, leite, etc.).
`DongWuPinZhiRatio`	Animal Quality Ratio	Multiplicador para qualidade dos atributos de animais domesticados.
`ZuoWuShengZhangRatio`	Crop Growth Ratio	Multiplicador para velocidade de crescimento de cultivos.
`ZuoWuFeiLiaoXiaoHaoRatio`	Crop Fertilizer Consumption	Multiplicador para taxa de consumo de fertilizante.

Construção e Estruturas

Configuração	Nome em Inglês	Descrição
`JianZhuFuLanKaiGuan`	Building Decay Toggle	Ativar ou desativar deterioração de construções ao longo do tempo. Defina como `0` para desativar.
`JianZhuFuLanMul`	Building Decay Multiplier	Taxa na qual estruturas se deterioram. Valores mais baixos desaceleram a deterioração.
`JianZhuXiuLiMul`	Building Repair Multiplier	Multiplicador para custos e velocidade de reparo de construções.
`JianZhuZiYuanJinShuaBanJing`	Building Resource Exclusion Radius	Raio ao redor de construções onde recursos naturais não renascerão.

Sistema de Invasão

Configuração	Nome em Inglês	Padrão	Descrição
`RuQinGuaiCountMax`	Max Invasion Monsters	`128`	Número máximo de monstros em uma onda de invasão.
`RuQinQiangDuXiShu`	Invasion Intensity	-	Controla a dificuldade geral da invasão e força dos monstros.
`RuQinBeginHour`	Invasion Start Hour	-	Hora no jogo em que as invasões podem começar.
`RuQinEndHour`	Invasion End Hour	-	Hora no jogo em que as invasões param.
`RuQinPerBoGuaiMax`	Max Monsters Per Wave	`16`	Máximo de monstros gerados por onda individual.

Sempre pare seu servidor antes de editar GameXishu.json. Editar o arquivo enquanto o servidor está rodando resultará em suas alterações sendo sobrescritas quando o servidor salvar. Pare o servidor, faça suas alterações e inicie-o novamente.

Como Conectar

Jogadores podem se conectar ao seu servidor de Soulmask através do navegador de servidores do jogo ou por conexão direta.

Via Navegador de Servidores do Jogo

Inicie o Soulmask.
No menu principal, selecione Multiplayer e depois Server Browser.
Procure seu servidor pelo nome (o nome que você definiu na variável de inicialização SERVER_NAME).
Clique no seu servidor e pressione Join. Digite a senha se uma estiver definida.

Via Navegador de Servidores do Steam

No Steam, vá em View > Game Servers (ou Servers).
Clique na aba Favorites e depois em Add a Server.
Digite o IP e a porta de consulta do seu servidor (padrão 27015) no formato IP:PORT.
Quando o servidor aparecer, clique duas vezes nele para conectar através do Soulmask.

Via Conexão Direta

Encontre o IP e a porta de jogo do seu servidor na aba Console do GPanel. Para ajuda, consulte Como Encontrar o IP e a Porta do Seu Servidor.
No Soulmask, procure a opção Direct Connect no menu multiplayer.
Digite o IP e a porta de jogo do seu servidor (padrão 8777) no formato IP:PORT.
Pressione Connect e digite a senha do servidor se necessário.

Servidor não aparece? Se seu servidor não aparecer no navegador, certifique-se de que ele está totalmente iniciado e terminou de carregar. Novos servidores podem levar de 2 a 5 minutos para aparecer na lista de servidores master do Steam. Você sempre pode usar conexão direta com o IP e a porta de jogo. As portas são atribuídas aleatoriamente, a menos que você tenha um IP privado.

Gerenciamento de Saves

Soulmask usa um sistema de save baseado em banco de dados. Entender como os saves funcionam é fundamental para evitar perda de dados.

Localização do Save

O arquivo principal de save do mundo está localizado em:

WS/Saved/Worlds/Dedicated/Level01_Main/world.db

Este banco de dados SQLite contém todos os dados do mundo, incluindo modificações de terreno, estruturas, estados de NPCs e dados de jogadores.

Processo de Salvamento

Soulmask usa um processo de salvamento em duas etapas:

Save na memória (-saving): O estado do mundo é periodicamente gravado em um banco de dados na memória no intervalo especificado pelo parâmetro -saving (em segundos).
Backup em disco (-backup): O banco de dados na memória é gravado em disco no intervalo especificado pelo parâmetro -backup (em segundos).

Sempre desligue seu servidor adequadamente. É de vital importância que você desligue seu servidor de forma limpa usando o botão Stop do GPanel, o comando gm exit no jogo ou o comando shutdown via RCON. Forçar o encerramento do processo do servidor pode fazer com que o banco de dados na memória não seja gravado em disco, resultando em rollbacks até o último save em disco.

Backups Automáticos

Configure backups automáticos usando estes parâmetros de inicialização:

-initbackup -- Cria uma cópia de backup cada vez que o servidor inicia.
-backupinterval=N -- Cria backups rotativos a cada N minutos durante a execução.

Backups Manuais

Para criar um backup manual:

Pare o servidor pelo GPanel.
Navegue até WS/Saved/ pela aba Files do GPanel ou via SFTP.
Baixe os seguintes arquivos:
- Worlds/Dedicated/Level01_Main/world.db -- O banco de dados de save do mundo
- GameplaySettings/GameXishu.json -- Sua configuração de gameplay
Armazene esses arquivos com segurança no seu computador local.

Restaurando um Backup

Pare o servidor.
Faça upload do arquivo world.db de backup para WS/Saved/Worlds/Dedicated/Level01_Main/.
Faça upload do GameXishu.json de backup para WS/Saved/GameplaySettings/ se você quiser restaurar as configurações também.
Inicie o servidor.

Iniciando um Novo Mundo

Para limpar o mundo e começar do zero:

Pare o servidor.
Renomeie ou exclua o arquivo world.db em WS/Saved/Worlds/Dedicated/Level01_Main/.
Inicie o servidor. Ele gerará um novo banco de dados de mundo do zero.

Faça backup antes de limpar. Antes de excluir dados do mundo, baixe uma cópia do world.db como backup caso você queira restaurá-lo depois.

Referência de Portas

Soulmask usa as seguintes portas. Estas são configuradas automaticamente pelo seu plano de hospedagem na Legion Hosting.

Porta	Protocolo	Padrão	Finalidade
Game Port	UDP	`8777`	Conexões principais do jogo. Jogadores se conectam nesta porta.
Query Port	UDP	`27015`	Consultas do navegador de servidores do Steam.
Echo Port (Telnet)	TCP	`18888`	Administração local via telnet (apenas conexões locais).
RCON Port	TCP	`19000`	Acesso ao console remoto (RCON). Ativo apenas se `-rconpsw` estiver definido.

Precisa de Ajuda?

Se você ainda estiver tendo problemas com seu servidor de Soulmask, por favor abra um ticket de suporte e nossa equipe terá prazer em ajudá-lo.

Guia de Configuração do Servidor Soulmask - Base de Conhecimento

Suporte

Categorias