Servidor MTAX

Em desenvolvimento

A plataforma MTAX ainda está em desenvolvimento. Esta documentação acompanha o estado atual do servidor e pode mudar entre versões.

O servidor MTAX é um executável próprio: ele hospeda o mundo, roda os resources em Lua e sincroniza os jogadores conectados. A máquina do servidor precisa de acesso HTTPS à plataforma MTAX para validar e renovar a licença, autorizar resources protegidos e consultar atualizações; os arquivos originais do GTA: San Andreas continuam sendo necessários apenas no lado do jogador.

Estrutura de pastas

Uma instalação do servidor tem este formato:

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

  • …
• Directoryresources/ seus resources (scripts, mapas, assets)

  • Directorymeu-resource/

    • mtaxmanifest.lua
• Directorydatabases/ bancos SQLite criados por dbConnect

  • …
• Directorycache/ identidade e pacotes gerados pelo servidor

  • Directoryassets/

    • identity.key identidade persistente
  • Directoryvoice/

    • …

Cada pacote contém apenas o executável da sua plataforma. As pastas cache/ e databases/ são preenchidas pelo servidor e não precisam entrar no repositório dos seus scripts, mas devem ser preservadas em backups e atualizações — especialmente cache/assets/identity.key.

Ciclo de vida

1. O servidor lê o server.cfg e aplica as configurações.
2. A pasta resources/ é escaneada e cada mtaxmanifest.lua é validado.
3. Cada ensure do server.cfg inicia o resource correspondente, na ordem em que aparece.
4. As portas UDP (jogo), TCP (HTTP/downloads) e de voz sobem e o servidor passa a aceitar conexões.

Cada resource roda em uma VM Lua própria. Reiniciar um resource cria uma VM nova e reempacota os assets dele — nada vaza de uma execução para a outra.

Links de entrada

O launcher registra o esquema de URL mtax:// na máquina do jogador, então um link no seu site ou numa mensagem do Discord pode jogar alguém direto no seu servidor:

mtax://play.exemplo.com:22003
mtax://connect/play.exemplo.com:22003
mtax://connect/203.0.113.10:22003?password=abracadabra

As duas formas fazem a mesma coisa; o connect/ existe só para ler melhor. O endereço é o mesmo host e porta UDP que o jogador digitaria à mão — o do endpoint_add_udp no server.cfg — e pode ser um hostname, um IPv4 ou um IPv6 entre colchetes.

Abrir o link inicia o launcher, ou entrega o endereço para a cópia que já está rodando.

Cuidado

O ?password= coloca a senha de entrada num link que vai ser colado, registrado e indexado. Prefira deixar de fora: o cliente pede a senha ao jogador por conta própria. Uma senha que o cliente recusaria de qualquer jeito — longa demais, ou com espaços — é descartada do link em vez de virar erro.

Nota

O esquema é registrado por uma etapa opcional do instalador do Windows, então um jogador que desmarcou essa opção, ou que roda o launcher sem instalar, não vê nada ao clicar no link. Mostre sempre o endereço em texto ao lado do botão.

Por onde começar

Instalação no Linux

Baixe pela API, verifique o BLAKE3 e configure o serviço systemd.

Instalar no Ubuntu

Instalação no Windows

Baixe o instalador, avance o assistente e rode pelo atalho. É o caminho mais simples.

Instalar no Windows

server.cfg

Todas as diretivas e convars aceitas pelo arquivo de configuração.

Ver referência

Resources

Como estruturar um resource e escrever o mtaxmanifest.lua.

Ver referência

Console

Comandos para iniciar, parar e inspecionar resources em tempo real.

Ver referência

Scripting

Introdução ao Lua no MTAX: eventos, comandos e funções.

Começar