Guia de Configuração do Servidor Soulmask

Este guia abrange tudo o que precisa para configurar o seu servidor dedicado de Soulmask na Legion Hosting, incluindo o primeiro arranque, variáveis de arranque do GPanel, configuração do servidor, modos PvE vs PvP, definições de mapa e mundo, ligação ao servidor e gestão de saves. Para configuração de administração e comandos no jogo, consulte os Comandos de Administração do Soulmask.

O Que É o Soulmask

O Soulmask é um jogo de sobrevivência e construção em mundo aberto onde os jogadores despertam usando uma misteriosa máscara antiga que concede habilidades sobrenaturais. Situado num mundo vasto e exuberante, os jogadores devem recolher recursos, fabricar ferramentas e armas, construir assentamentos e recrutar e gerir 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 o seu assentamento e eficácia em combate.

Funcionalidades principais do servidor dedicado incluem:

Suporte para até 70 jogadores em simultâneo num único servidor
Modos de jogo PvE e PvP com regras configuráveis
Ajuste extensivo de jogabilidade através do ficheiro de configuração GameXishu.json
Sistema de tribos (guildas) com limites de membros configuráveis
Suporte a RCON e Telnet para gestão remota do servidor
Cópias de segurança automáticas e gestão de saves

Pare o servidor antes de editar quaisquer ficheiros de configuração. Pare sempre o servidor a partir do separador Console no GPanel antes de editar ficheiros de configuração. Alterações feitas enquanto o servidor está em execução podem ser sobrescritas ou causar corrupção.

Primeiro Arranque

Quando receber pela primeira vez o seu servidor Soulmask da Legion Hosting, este precisa de completar uma instalação inicial antes de poder ser utilizado.

Inicie sessão no GPanel e selecione o seu servidor Soulmask na lista de servidores.
Clique no separador Console e pressione Start.
O servidor irá descarregar e instalar os ficheiros do servidor dedicado de Soulmask via Steam. Este download inicial pode demorar vários minutos pois o jogo requer espaço em disco significativo.
Após a conclusão do download, o servidor iniciará automaticamente. O primeiro arranque demora mais do que os subsequentes enquanto o servidor gera a base de dados inicial do mundo.
Aguarde até que a saída da consola indique que o servidor está pronto e à escuta de ligações.

Requisitos de RAM. O 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 o seu plano de alojamento fornece memória suficiente para o número de jogadores esperado. Contagens de jogadores mais elevadas e mundos maiores utilizarão mais RAM.

Variáveis de Arranque do GPanel

As definições principais do servidor são configuradas como variáveis de arranque no GPanel. Estes valores são passados ao processo do servidor como parâmetros de linha de comandos quando este é iniciado.

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

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

As variáveis de arranque sobrepõem-se aos ficheiros de configuração. Se uma definição estiver configurada tanto como variável de arranque como dentro de um ficheiro de configuração, a variável de arranque tem precedência. Utilize variáveis de arranque para definições de identidade principais e ficheiros de configuração para ajustes detalhados de jogabilidade.

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

O Soulmask utiliza parâmetros extensivos de linha de comandos para a configuração do servidor. Abaixo está a referência completa dos parâmetros disponíveis:

Parâmetro	Predefinição	Descrição
`-SteamServerName="Name"`	-	Nome de apresentação do servidor no browser de servidores.
`-MaxPlayers=N`	`60`	Número máximo de ligações simultâneas de jogadores (até 70).
`-PSW="password"`	(nenhuma)	Palavra-passe de entrada no servidor. Omita para um servidor público.
`-adminpsw="password"`	(nenhuma)	Palavra-passe de administrador/GM para comandos de administração no jogo.
`-pve`	-	Força o modo PvE. Os jogadores não podem causar dano uns aos outros.
`-pvp`	-	Força o modo PvP. Os jogadores podem causar dano uns aos outros.
`-Port=N`	`8777`	Porta de ligação de jogo (UDP).
`-QueryPort=N`	`27015`	Porta de consulta Steam (UDP).
`-EchoPort=N`	`18888`	Porta de consola Telnet (TCP, apenas local). Utilizada para gestão remota local.
`-saving=N`	-	Intervalo de save do estado do mundo para memória (em segundos).
`-backup=N`	-	Intervalo de cópia de segurança da base de dados em memória para disco (em segundos).
`-initbackup`	-	Cria uma cópia de segurança do mundo cada vez que o servidor inicia.
`-backupinterval=N`	-	Intervalo de criação de cópias de segurança automáticas (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"`	(nenhuma)	Ativa o acesso à consola remota RCON com a palavra-passe especificada.
`-rconport=N`	`19000`	Porta TCP do listener RCON. Apenas relevante se o RCON estiver ativado.
`-rconaddr=IP`	-	Vinculação de IP do listener RCON. Utilize `0.0.0.0` para escutar em todas as interfaces.
`-log`	-	Ativa a janela de consola e saída de logs.
`-UTF8Output`	-	Ativa o tratamento correto de caracteres não-latinos na saída.

O GPanel trata da maioria destes automaticamente. Na Legion Hosting, os parâmetros essenciais são configurados através do separador Startup do GPanel. Parâmetros avançados como definições de RCON ou limites de tribo podem ser adicionados através do campo de parâmetros de arranque adicionais do GPanel, se disponível, ou contactando o suporte.

Modo PvE vs PvP

O Soulmask suporta dois modos de jogo principais que alteram fundamentalmente a experiência multijogador:

Modo PvE (`-pve`)

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

Modo PvP (`-pvp`)

Os jogadores podem atacar e matar uns aos outros.
Bases e estruturas podem ser invadidas e destruídas por outros jogadores.
A guerra tribal e o controlo de território tornam-se elementos centrais da jogabilidade.
Os rácios de dano PvP podem ser ajustados no ficheiro de configuração GameXishu.json.
Recomendado para servidores competitivos e jogadores experientes.

O modo não pode ser alterado sem um wipe. Mudar entre PvE e PvP após o mundo ter sido criado pode causar inconsistências na jogabilidade. É recomendado decidir o modo antes do primeiro arranque. Se precisar de mudar de modo num mundo existente, considere começar de novo.

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

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

Localização do Ficheiro

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

WS/Saved/GameplaySettings/GameXishu.json

Aceda a este ficheiro através do separador Files do GPanel ou via SFTP.

Referência das Definições Principais

Abaixo estão as definições mais comummente ajustadas. Os nomes dos parâmetros estão no formato original (pinyin chinês). São fornecidas descrições em inglês para cada um.

Experiência e Progressão

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

Combate e Dano

Definiçã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 de combate corpo a corpo em PvP (predefinição: `0.4`).

Recursos e Consumo

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

Animais e Agricultura

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

Construção e Estruturas

Definição	Nome em Inglês	Descrição
`JianZhuFuLanKaiGuan`	Building Decay Toggle	Ativar ou desativar a deterioração de edifícios ao longo do tempo. Defina como `0` para desativar.
`JianZhuFuLanMul`	Building Decay Multiplier	Taxa a que as estruturas se deterioram. Valores mais baixos tornam a deterioração mais lenta.
`JianZhuXiuLiMul`	Building Repair Multiplier	Multiplicador para custos e velocidade de reparação de edifícios.
`JianZhuZiYuanJinShuaBanJing`	Building Resource Exclusion Radius	Raio ao redor de edifícios onde os recursos naturais não voltarão a aparecer.

Sistema de Invasão

Definição	Nome em Inglês	Predefinição	Descrição
`RuQinGuaiCountMax`	Max Invasion Monsters	`128`	Número máximo de monstros numa vaga de invasão.
`RuQinQiangDuXiShu`	Invasion Intensity	-	Controla a dificuldade geral da invasão e a 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 vaga individual.

Pare sempre o servidor antes de editar o GameXishu.json. Editar o ficheiro enquanto o servidor está em execução resultará nas suas alterações serem sobrescritas quando o servidor guardar. Pare o servidor, faça as suas alterações e depois inicie-o novamente.

Como Ligar-se

Os jogadores podem ligar-se ao seu servidor Soulmask através do browser de servidores no jogo ou por ligação direta.

Via Browser de Servidores do Jogo

Inicie o Soulmask.
No menu principal, selecione Multiplayer e depois Server Browser.
Procure o seu servidor pelo nome (o nome que definiu na variável de arranque SERVER_NAME).
Clique no seu servidor e pressione Join. Introduza a palavra-passe se estiver definida.

Via Browser de Servidores do Steam

No Steam, vá a View > Game Servers (ou Servers).
Clique no separador Favorites e depois em Add a Server.
Introduza o IP do seu servidor e a porta de query (predefinição 27015) no formato IP:PORT.
Assim que o servidor aparecer, faça duplo clique para ligar-se através do Soulmask.

Via Ligação Direta

Encontre o IP do servidor e a porta de jogo no separador Console do GPanel. Para ajuda, consulte Como Encontrar o IP e Porta do Seu Servidor.
No Soulmask, procure a opção Direct Connect no menu multijogador.
Introduza o IP do servidor e a porta de jogo (predefinição 8777) no formato IP:PORT.
Pressione Connect e introduza a palavra-passe do servidor se necessário.

O servidor não aparece? Se o seu servidor não aparecer no browser, certifique-se de que está totalmente iniciado e terminou o carregamento. Servidores novos podem demorar 2-5 minutos a aparecer na lista principal de servidores do Steam. Pode sempre utilizar a ligação direta com o IP e porta de jogo. As portas são atribuídas aleatoriamente a menos que tenha um IP privado.

Gestão de Saves

O Soulmask utiliza um sistema de save baseado em base de dados. Compreender como os saves funcionam é fundamental para evitar perda de dados.

Localização do Save

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

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

Esta base 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 Save

O Soulmask utiliza um processo de save em duas fases:

Save em memória (-saving): O estado do mundo é periodicamente escrito para uma base de dados em memória no intervalo especificado pelo parâmetro -saving (em segundos).
Cópia de segurança para disco (-backup): A base de dados em memória é transferida para disco no intervalo especificado pelo parâmetro -backup (em segundos).

Encerre sempre o servidor corretamente. É de vital importância que encerre o servidor de forma limpa utilizando o botão Stop do GPanel, o comando gm exit no jogo, ou o comando shutdown do RCON. Forçar o encerramento do processo do servidor pode fazer com que a base de dados em memória não seja escrita para disco, resultando em retrocessos até ao último save para disco.

Cópias de Segurança Automáticas

Configure cópias de segurança automáticas utilizando estes parâmetros de arranque:

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

Cópias de Segurança Manuais

Para criar uma cópia de segurança manual:

Pare o servidor a partir do GPanel.
Navegue até WS/Saved/ via o separador Files do GPanel ou SFTP.
Descarregue os seguintes ficheiros:
- Worlds/Dedicated/Level01_Main/world.db -- A base de dados de save do mundo
- GameplaySettings/GameXishu.json -- A sua configuração de jogabilidade
Guarde estes ficheiros em segurança no seu computador local.

Restaurar uma Cópia de Segurança

Pare o servidor.
Carregue o ficheiro world.db de cópia de segurança para WS/Saved/Worlds/Dedicated/Level01_Main/.
Carregue o ficheiro GameXishu.json de cópia de segurança para WS/Saved/GameplaySettings/ se quiser restaurar também as definições.
Inicie o servidor.

Iniciar um Novo Mundo

Para limpar o mundo e começar de novo:

Pare o servidor.
Renomeie ou elimine o ficheiro world.db em WS/Saved/Worlds/Dedicated/Level01_Main/.
Inicie o servidor. Irá gerar uma nova base de dados de mundo do zero.

Faça cópia de segurança antes de limpar. Antes de eliminar dados do mundo, descarregue uma cópia do world.db como cópia de segurança caso queira restaurá-lo mais tarde.

Referência de Portas

O Soulmask utiliza as seguintes portas. Estas são configuradas automaticamente pelo seu plano de alojamento na Legion Hosting.

Porta	Protocolo	Predefinição	Finalidade
Game Port	UDP	`8777`	Ligações de jogo principais. Os jogadores ligam-se a esta porta.
Query Port	UDP	`27015`	Consultas do browser de servidores do Steam.
Echo Port (Telnet)	TCP	`18888`	Administração local por telnet (apenas ligações locais).
RCON Port	TCP	`19000`	Acesso à consola remota (RCON). Apenas ativo se `-rconpsw` estiver definido.

Precisa de Ajuda?

Se continuar a ter problemas com o seu servidor Soulmask, por favor abra um ticket de suporte e a nossa equipa terá todo o gosto em ajudá-lo.

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

Suporte

Categorias