Instalar o servidor no Windows

No Windows o servidor vem em um instalador com assistente gráfico. Você não precisa instalar dependências manualmente nem compilar nada: o próprio instalador cuida da extração, das bibliotecas e do atalho. Basicamente é baixar, avançar e confirmar.

Plataforma em desenvolvimento

Use o canal Release em produção. O canal Beta contém builds de teste e só é usado quando você o escolhe explicitamente. Se ainda não houver uma Release publicada, a API responde normalmente, mas sem um número de build; a página não muda para Beta sozinha.

Requisitos

Requisito	Suporte atual
Sistema recomendado	Windows 10 ou Windows 11 (64 bits)
Arquitetura	x86_64 / amd64
Redistribuível VC++	empacotado com o instalador; não precisa instalar à parte
Rede de saída	IPv4, DNS e HTTPS (443/TCP) para api.mtaxsa.com e para o host devolvido em downloadUrl (atualmente version.cdn.mtaxsa.com)
Licença	chave de servidor MTAX com 64 caracteres hexadecimais

Baixar o instalador

O botão consulta api.mtaxsa.com no momento do clique. Primeiro ele encontra a versão mais recente compatível, depois lê o manifesto para obter a URL, o tamanho e o BLAKE3 do pacote. As rotas de leitura e download são públicas e não exigem login.

Localizar download

A URL é consultada somente quando você clicar. O canal beta nunca é selecionado automaticamente.

Uma URL de download pode apontar para o CDN ou ser temporária. Por isso ela não fica gravada nesta página. Se a consulta de Release informar que não há pacote estável, aguarde uma publicação ou selecione Beta conscientemente.

Verifique antes de abrir

Confira o BLAKE3 mostrado pelo botão antes de executar o arquivo. O instalador é um executável baixado da internet — confirme o hash sempre que puder.

Instalar

1. Execute o instalador.

   Dê dois cliques no arquivo baixado. Se o Windows mostrar o SmartScreen, escolha Mais informações e Execar mesmo assim — o instalador ainda não é assinado com um certificado reconhecido pelo sistema.

2. Avance o assistente.

   Aceite a licença, confirme a pasta de destino (o padrão é C:\mtax-server) e clique em Instalar. Não há nada para configurar nesta etapa: o instalador extrai o executável, as bibliotecas e o server.cfg de exemplo.

3. Confira a pasta gerada.

   • MTAX Server.exe executável do Windows
   • server.cfg configuração principal
   • Directorylib/ bibliotecas distribuídas com o servidor

     • …
   • Directoryresources/ seus resources Lua

     • …

4. Conclua.

   Marque Iniciar o MTAX Server (ou deixe para depois) e feche o instalador. Pronto — o servidor já está no lugar.

Configurar a licença e o servidor

Crie sua chave no painel MTAX e abra o server.cfg na pasta de instalação com um editor de texto (o Bloco de Notas serve).

No mínimo, revise estas linhas:

endpoint_add_udp    "0.0.0.0:22003"
endpoint_add_tcp    "0.0.0.0:22005"
endpoint_add_voice  "0.0.0.0:22007"

sets locale         "pt-BR"
sets sv_projectName "Meu servidor"
set sv_licenseKey   "SUA_CHAVE_DE_64_CARACTERES_HEXADECIMAIS"

locale é a região anunciada pelo servidor e usada na listagem, não o idioma da interface. A licença deve usar set; nunca publique a chave com sets ou setr. Veja todas as opções em server.cfg.

Se o resources/ vier vazio, comente as linhas de exemplo ensure [mtax] / ensure [exemplos] ou instale os grupos correspondentes — sem isso o servidor inicia, mas registra unknown resource.

Iniciar o servidor

Dê dois cliques em MTAX Server.exe na pasta de instalação. Uma janela de console abre e o servidor valida a licença em api.mtaxsa.com antes de aceitar jogadores.

Para rodar em segundo plano, abra um PowerShell e chame o executável diretamente:

& 'C:\mtax-server\MTAX Server.exe' --no-console --config server.cfg

--no-console desliga a entrada interativa, útil para um servidor que fica aberto sem alguém digitando nele.

Liberar as portas no Windows

Por padrão, o MTAX usa:

Porta	Protocolo	Uso
22003	UDP	jogo e sincronização
22005	TCP	informações e download de assets
22007	TCP e UDP	controle e áudio do voice chat

Abra as portas no Firewall do Windows com privilégio de administrador:

New-NetFirewallRule -DisplayName "MTAX game"   -Direction Inbound -Protocol UDP -LocalPort 22003 -Action Allow
New-NetFirewallRule -DisplayName "MTAX assets" -Direction Inbound -Protocol TCP -LocalPort 22005 -Action Allow
New-NetFirewallRule -DisplayName "MTAX voice"  -Direction Inbound -Protocol TCP -LocalPort 22007 -Action Allow
New-NetFirewallRule -DisplayName "MTAX voice"  -Direction Inbound -Protocol UDP -LocalPort 22007 -Action Allow

Se o servidor estiver atrás de NAT, configure o encaminhamento das mesmas portas no roteador. Se não for usar voice, remova endpoint_add_voice ou defina set voice_enabled false e não abra 22007.

Verificar a instalação

Get-NetTCPConnection -LocalPort 22005 -State Listen
Get-NetUDPEndpoint   -LocalPort 22003
Invoke-RestMethod http://127.0.0.1:22005/info.json

O servidor também precisa manter acesso HTTPS à API para renovar sua licença. Se essa comunicação ficar indisponível até o vencimento do lease, o processo encerra de forma controlada.

Atualizar sem perder dados

No Windows, o MTAX verifica a versão ao iniciar, mas não substitui o próprio executável. Quando existir um build mais recente, o log mostra o pacote e a página de detalhes. Baixe o novo instalador pelo botão acima e execute-o sobre a instalação existente.

Antes de atualizar, faça backup de:

server.cfg
resources/
cache/
databases/
logs/

Preserve a identidade

Não apague cache/assets/identity.key. Ele mantém a identidade criptográfica do servidor. Perdê-lo gera uma nova identidade, altera a chave pública anunciada e força o reprocessamento/download de assets.

Se o instalador perguntar sobre sobrescrever o server.cfg, escolha Não para manter sua configuração.

Problemas comuns

Mensagem ou sintoma	O que conferir
VCRUNTIME140.dll não encontrado	Redistribuível VC++ ausente; reinstale pelo instalador oficial da Microsoft.
sv_licenseKey is empty	Preencha a chave no server.cfg com set sv_licenseKey.
could not validate the license key	Chave, DNS, relógio do sistema, certificados CA, IPv4 e saída 443/TCP.
SmartScreen bloqueia o instalador	Mais informações → Execar mesmo assim (instalador ainda não assinado).
unknown resource -> [mtax]	Instale o grupo citado ou comente o ensure de exemplo.
A consulta Release não encontra build	Ainda não há pacote estável compatível; aguarde ou opte conscientemente pelo Beta.
Jogadores não conectam	Firewall/NAT de 22003/UDP; para assets, confira também 22005/TCP.