Como criar um servidor alt:V (Guia de início rápido de 2025)

Quer hospedar seu próprio mundo multijogador GTA V com alt:V? Este guia mostra dois caminhos de configuração confiáveis (Windows e Linux), oferece uma maneira limpa servidor.toml, um primeiro recurso JavaScript funcional, firewall/portas e serviço systemd opcional para que você possa ir do zero a um servidor público e listado rapidamente.

---

O que você vai precisar

• Uma cópia legítima de GTA V (os jogadores precisam disso; o servidor não).
• Windows 10/11 ou Ubuntu 22.04+ (ou qualquer Linux x64 recente).
• Habilidades básicas de terminal/PowerShell.

Os servidores alt:V são independentes; você não instala o GTA no servidor.

---

Layout da pasta (nós criaremos isso)

altv-server/ ├─ altv-server.exe (Windows) ou altv-server (Linux) ├─ libnode.dll / libnode.so ├─ server.toml ├─ package.json ← define ESM (tipo: módulo) para recursos JS └─ resources/ └─ example/ ├─ resource.toml ├─ server.mjs └─ client/ └─ client.mjs

---

Opção A — Início rápido (Windows e Linux) com pacote altv

Isso extrai os binários oficiais mais recentes para você.

1. Criar um diretório de trabalho

mkdir altv-server && cd altv-server

2. Inicializar nó (somente para ferramentas)

npm init -y npm i --save-dev altv-pkg

3. Baixar binários do servidor

lançamento do npx altv-pkg

Reexecutar lançamento do npx altv-pkg sempre que você quiser atualizar.

---

Opção B — Instalação manual

1. Baixe o Servidor compile a partir da página oficial de downloads do alt:V (escolha Windows ou Linux).
2. Extrair para dentro servidor altv/.

---

Criar pacote.json (nível superior)

Isso permite ESM sintaxe (importar ...) para seus recursos JS.

{ "nome": "altv-server", "privado": verdadeiro, "tipo": "módulo" }

---

Mínimo servidor.toml

Criar servidor.toml na raiz do servidor:

# Nome exibido no alt:V nome do cliente = "Meu servidor alt:V" # Vincular a todas as interfaces host = "0.0.0.0" # Porta padrão do jogo (TCP e UDP) port = 7788 # Slots de jogador players = 128 # Mostrar na lista principal? (definir como verdadeiro para público) announce = true # Obter um token do painel alt:V e colar aqui quando for público # token = "SEU_TOKEN_DA_LISTA_PRINCIPAL" # Carregar o módulo JS e nosso recurso de exemplo modules = ["js-module"] resources = ["example"] # Útil no desenvolvimento debug = true logStreams = ["console", "file"]

Dica: Portas ao usar externo As vozes são normalmente 7798 (servidor) e 7799 (cliente); abra-as somente se você executar o servidor de voz separadamente. A voz básica em processo precisa apenas da sua porta de jogo.

---

Seu primeiro recurso (JavaScript)

Criar recursos/exemplo/recurso.toml:

# Linguagem do lado do servidor para este tipo de recurso = "js" # Linguagem do lado do cliente para este recurso client-type = "js" # Arquivos de entrada main = "server.mjs" client-main = "client/client.mjs" # Arquivos que o cliente pode baixar client-files = [ "client/*", ]

recursos/exemplo/servidor.mjs

importar * como alt de 'alt-server'; alt.on('playerConnect', (jogador) => { alt.log(`+ ${jogador.nome} conectado`); player.emit('welcome:notify', `Bem-vindo ao ${alt.getServerConfig().nome}!`); }); alt.on('playerDisconnect', (jogador, motivo) => { alt.log(`- ${jogador?.nome ?? 'desconhecido'} restante (${motivo})`); });

recursos/exemplo/cliente/client.mjs

importar * como alt de 'alt-client'; alt.onServer('welcome:notify', (msg) => { alt.log(`Server says: ${msg}`); // Texto de ajuda simples na tela alt.everyTick(() => { alt.drawText2d(msg, 0.5, 0.9, 0.5, 255, 255, 255, 255, 0, true, true, 0); }); // Remover após ~8 segundos alt.setTimeout(() => alt.clearEveryTick(), 8000); });

Este é um recurso completo. Quando um jogador se conecta, ele recebe uma mensagem de boas-vindas.

---

Inicie o servidor

Windows (PowerShell)

cd C:\caminho\para\altv-server ./altv-server.exe

Linux

cd /opt/altv-server # ou seu caminho chmod +x altv-server ./altv-server

Se a inicialização for limpa, você verá os logs e o servidor estará acessível em seu.ip:7788. Junte-se através do cliente alt:V (Direct Connect) ou da Masterlist (se anunciar = verdadeiro e um válido símbolo está definido).

---

Abra o firewall

Windows (PowerShell, executar como administrador)

New-NetFirewallRule -DisplayName "altV 7788 TCP" -Direção de entrada -Protocolo TCP -Porta local 7788 -Permitir ação New-NetFirewallRule -DisplayName "altV 7788 UDP" -Direção de entrada -Protocolo UDP -Porta local 7788 -Permitir ação

Linux (UFW)

sudo ufw permitir 7788/tcp sudo ufw permitir 7788/udp

Se estiver usando um externo servidor de voz, também permite 7798/udp e 7799/udp.

---

(Opcional) Execute alt:V como um serviço no Linux

Criar /etc/systemd/system/altv.service:

[Unidade] Descrição=alt:V Server After=network.target [Serviço] Usuário=altv WorkingDirectory=/opt/altv-server ExecStart=/opt/altv-server/altv-server --porta 7788 Reiniciar=em caso de falha [Instalar] WantedBy=multi-user.target

Habilitar e iniciar:

sudo systemctl daemon-reload sudo systemctl enable --now altv journalctl -u altv -f

---

Qualidade de vida para o desenvolvimento

• Modo de depuração: manter depurar = verdadeiro durante a construção; desative para produção.
• Inspetor de nós (servidor JS): adicione isso a recursos/exemplo/recurso.toml se você precisar de depuração do lado do servidor: [js-module] inspetor = verdadeiro Em seguida, anexe Chrome DevTools → Destino do nó.
• TypeScript: adicionar um tsconfig.json, compilar para dist/, e ponto principal/cliente-principal para arquivos compilados. Tipos de instalação: npm i -D @altv/tipos-servidor @altv/tipos-cliente.

---

Atualização e backups

• Atualizar binários: reprise lançamento do npx altv-pkg (Opção A) ou baixe novamente o ZIP (Opção B).
• Cópias de segurança: fecho eclair recursos/, servidor.tomle quaisquer configurações externas/de banco de dados. Automatize com um cron ou tarefa agendada.

---

Lista de verificação de endurecimento da produção

• Defina um forte símbolo e anunciar = verdadeiro para a lista principal.
• Manter depurar = falso em produção.
• Usar logStreams = ["arquivo"] em prod e gire os logs externamente, se necessário.
• Exponha apenas as portas necessárias (7788; 7798/7799 se voz externa).
• Considerar useCdn = verdadeiro para downloads grandes; gerar pacotes com --justpack e servir via HTTPS.
• Monitore com um watchdog (systemd Reiniciar=em caso de falha) e configurar alertas.

---

Solução de problemas (soluções rápidas)

• Não é possível ver o servidor na lista: garantir anunciar = verdadeiro, válido símbolo, abra 7788 TCP/UDP no host e roteador/NAT; aguarde alguns minutos para propagação.
• Clientes travados no download: se você adicionou grandes ativos, considere useCdn = verdadeiro e embalagem (--justpack).
• Portas já em uso: escolha um diferente porta em servidor.toml ou interromper o serviço conflitante.
• Nada acontece na conexão: confirmar se os nomes dos recursos correspondem recursos = ["exemplo"] e sua pasta fica em recursos/exemplo.

---

FAQ – Servidores alt:V

Preciso ter o GTA V instalado na máquina do servidor?
Não. Somente jogadores precisam de uma cópia legítima do GTA V. O servidor em si funciona sem o jogo instalado.

Quais sistemas operacionais são suportados para hospedar alt:V?
O Windows 10/11 e distribuições Linux modernas (Ubuntu 22.04+ ou qualquer Linux x64 recente) são suportados.

Quais portas devem estar abertas para que o alt:V funcione?
Por padrão, porta TCP/UDP 7788 deve estar aberto. Se você executar um servidor de voz externo, abra também 7798/UDP e 7799/UDP.

Por que meu servidor não aparece na lista principal?
Certifique-se de definir anunciar = verdadeiro, adicionou um válido token da lista principale permitiu 7788 TCP/UDP através do seu firewall e roteador. Pode levar alguns minutos para que a listagem seja propagada.

Como atualizo os binários do servidor?
Se você instalou via pacote altv, basta executar:

lançamento do npx altv-pkg

Se você instalou manualmente, baixe a versão mais recente do página oficial de download do alt:V.

Posso executar o servidor como um serviço em segundo plano?
Sim. No Linux, você pode configurar um sistemad serviço (serviço altv) para iniciar automaticamente e reiniciar em caso de falha.

Como posso tornar meu servidor mais seguro para produção?

• Desabilitar depurar modo.
• Definir logStreams = ["arquivo"].
• Use um token de lista mestre forte.
• Exponha somente as portas necessárias.
• Automatize backups de recursos e configurações.

Onde posso encontrar mais recursos para meu servidor?
O alt:V Hub oficial e os repositórios comunitários GitHub contêm muitos recursos de exemplo. Você também pode consultar guias em CincoMX para otimização e crescimento do servidor.

---

Para onde ir a seguir

• Adicione mais recursos do Hub da comunidade e repositórios de exemplo.
• Configurar um servidor de voz externamente para grandes populações.
• Automatize o CI/CD para enviar atualizações para sua caixa.

Leituras recomendadas (no FiveMX)

• Comparar estruturas: FiveM vs RAGE:MP vs alt:V — Qual você deve escolher?
• Aumente sua comunidade: Como anunciar seu servidor (funciona para qualquer GTA V MP)
• Construa sua base: Como criar um site para seu servidor de jogos
• Dicas de afinação: Desempenho e Otimização

---

Copiar e colar trechos (referência rápida)

Início do Windows:

./altv-server.exe

Início do Linux:

./servidor-altv

Portas abertas (Windows):

New-NetFirewallRule -DisplayName "altV 7788 TCP" -Direção de entrada -Protocolo TCP -Porta local 7788 -Permitir ação New-NetFirewallRule -DisplayName "altV 7788 UDP" -Direção de entrada -Protocolo UDP -Porta local 7788 -Permitir ação

Portas abertas (Linux):

sudo ufw permitir 7788/tcp && sudo ufw permitir 7788/udp

Pronto! Inicie, conecte-se pelo cliente alt:V e comece a criar recursos!