Este guia cobre tudo o que você precisa para colocar seu servidor alt:V em funcionamento na Legion Hosting, desde a primeira inicialização e configuração do server.toml até resources de gamemode, configuração de CDN, chat de voz e como os jogadores se conectam através do launcher alt:V. Para desenvolvimento de resources, configuração de banco de dados e gerenciamento de admin, veja alt:V Configuração de Admin e Resources.
O que é alt:V?
alt:V é uma modificação multiplayer gratuita e de código aberto para Grand Theft Auto V. Ela permite que jogadores se conectem a servidores personalizados rodando gamemodes únicos como roleplay (RP), deathmatch, corrida, freeroam e mais. O servidor roda resources personalizados escritos em JavaScript, TypeScript ou C#, dando aos donos de servidor controle total sobre a lógica de gameplay. Os jogadores se conectam através do launcher alt:V, que modifica o GTA V para conectividade multiplayer.
Primeira Inicialização
Quando você receber seu servidor alt:V pela primeira vez, siga estes passos para colocá-lo online:
- Faça login no GPanel e selecione seu servidor alt:V.
- Navegue até a aba Startup e configure o nome do servidor, máximo de jogadores e outras variáveis de inicialização.
- Vá para a aba Console e clique em Start.
- O servidor irá baixar os arquivos do servidor alt:V na primeira inicialização. Isso pode levar alguns minutos.
- Quando o console exibir que o servidor está ouvindo e pronto para conexões, seu servidor está online.
- Por padrão, o servidor inicia sem resources de gamemode. Você precisará adicionar resources para criar gameplay. Veja alt:V Configuração de Admin e Resources para detalhes.
Variáveis de Inicialização do GPanel
O alt:V expõe várias opções de configuração como variáveis de inicialização no GPanel. Navegue até a aba Startup para modificá-las. Alterações requerem reinicialização do servidor.
| Variável | Padrão | Descrição |
|---|---|---|
PASSWORD |
ChangeMe |
Senha para entrar no servidor. Mínimo de 6 caracteres. |
SERVER_DESC |
A Pterodactyl Hosted Server |
Descrição do servidor exibida no navegador de servidores alt:V. |
BUILD |
release |
A branch do servidor alt:V: release (estável), rc (release candidate) ou dev (desenvolvimento). |
Configuração do Servidor (server.toml)
O arquivo de configuração principal dos servidores alt:V é o server.toml, localizado no diretório raiz do servidor. Você pode editar este arquivo através da aba Files no GPanel ou via SFTP.
Exemplo de server.toml
name = "My alt:V Server"
host = "0.0.0.0"
port = 7788
players = 128
password = ""
announce = true
token = ""
gamemode = "Freeroam"
website = ""
language = "en"
description = "A custom GTA V multiplayer server"
modules = ["js-module"]
resources = ["myresource"]
tags = ["freeroam", "fun"]Configurações principais: name (nome exibido no navegador), host (mantenha 0.0.0.0), port (deve corresponder ao GPanel), players (contagem máxima), password (vazio para público), announce (true para aparecer no navegador), token (token de anúncio do site alt:V, necessário para listagem no navegador), gamemode (rótulo no navegador como "Roleplay"), modules (módulos de script: js-module ou csharp-module), resources (array de pastas de resources para carregar) e tags (tags de filtro do navegador).
Token de Anúncio
Para que seu servidor apareça no navegador de servidores alt:V, você precisa de um token de anúncio do servidor mestre alt:V:
- Visite o site do alt:V e faça login ou crie uma conta.
- Navegue até a seção de gerenciamento de servidores e gere um novo token de servidor.
- Copie o token e cole no campo
tokendo seuserver.toml. - Certifique-se de que
announce = truena sua configuração. - Reinicie o servidor. Ele agora deve aparecer no navegador público.
server.toml.
Resources de Gamemode
Servidores alt:V são alimentados por resources — scripts que definem toda a lógica de gameplay. Sem resources, um servidor não tem funcionalidade personalizada. Resources são colocados no diretório resources/.
Estrutura de um Resource
resources/
myresource/
resource.toml <-- Resource configuration
server/
index.js <-- Server-side script
client/
index.js <-- Client-side script (runs on the player's GTA V)Carregando Resources
Adicione nomes de resources ao array resources no server.toml para carregá-los na inicialização:
resources = ["chat", "freeroam", "spawn"]Cada resource deve ter um arquivo resource.toml em seu diretório que define seu tipo, dependências e pontos de entrada de script. Para detalhes sobre criação e gerenciamento de resources, veja alt:V Configuração de Admin e Resources.
Configuração de CDN
O alt:V usa um mecanismo de CDN para servir arquivos client-side (modelos, texturas, scripts) aos jogadores que se conectam. O CDN integrado serve arquivos diretamente do servidor sem necessidade de configuração extra — este é o padrão e funciona bem para a maioria dos servidores. Para servidores de grande escala com muitos assets personalizados, você pode opcionalmente configurar um CDN externo enviando arquivos de cliente para um servidor web e definindo a URL do CDN na configuração do seu resource, reduzindo o uso de banda do servidor de jogo.
Chat de Voz
O alt:V inclui um sistema de chat de voz integrado que permite comunicação por voz posicional (3D) entre jogadores. O chat de voz é habilitado e configurado no server.toml.
Configuração de Voz
[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0O bitrate controla a qualidade da voz (64000 é o padrão). Os campos external* configuram um servidor de voz externo — deixe-os vazios/zero para usar o servidor de voz integrado, que é recomendado para a maioria das configurações. A opção de servidor de voz externo é necessária apenas para configurações avançadas onde o processamento de voz é transferido para uma máquina separada.
Como os Jogadores se Conectam
Os jogadores se conectam aos servidores alt:V através do launcher alt:V, não diretamente pelo GTA V.
Pelo Navegador de Servidores
- Baixe e instale o launcher alt:V em altvmp.com.
- Inicie o launcher alt:V. Ele irá detectar e verificar a instalação do GTA V.
- No launcher, navegue pelo Server Browser.
- Pesquise seu servidor pelo nome ou use filtros (gamemode, tags, contagem de jogadores).
- Clique no seu servidor e selecione Connect.
- Se o servidor tiver senha, o jogador será solicitado a inseri-la.
- O GTA V será iniciado com o mod multiplayer alt:V e conectará ao seu servidor.
Por Conexão Direta
- No launcher alt:V, selecione Direct Connect.
- Digite o endereço IP e porta do seu servidor no formato
IP:PORT(ex.:192.168.1.1:7788). - Clique em Connect.
Para encontrar o endereço IP e porta do seu servidor, veja Como Encontrar o IP e Porta do Seu Servidor.
announce = true no seu server.toml e que você tem um token de anúncio válido. O servidor pode levar um minuto para se registrar após a inicialização. Verifique o console para erros de conexão com o servidor mestre. Note que sua porta é atribuída aleatoriamente a menos que você tenha um IP privado -- verifique o GPanel para o valor correto.
Máximo de Jogadores e Desempenho
Servidores alt:V podem suportar altas contagens de jogadores, mas o desempenho depende fortemente dos seus resources e plano de servidor:
- 32–128 jogadores: Uma faixa comum para a maioria dos servidores. Gamemodes simples rodam suavemente com contagens mais altas.
- 128–512+ jogadores: Possível para servidores otimizados com resources eficientes. Requer mais CPU e RAM.
- Eficiência dos resources: Scripts mal otimizados são a principal causa de problemas de desempenho. Scripts server-side que executam operações pesadas a cada tick ou mantêm grandes estruturas de dados na memória podem criar gargalos no servidor.
- Consultas ao banco de dados: Gamemodes usando bancos de dados (MySQL, MongoDB) devem usar consultas assíncronas para evitar bloquear a thread principal.
Artigos Relacionados
- alt:V Configuração de Admin e Resources — Desenvolvimento de resources, configuração de banco de dados, ferramentas de admin e solução de problemas
- Como Encontrar o IP e Porta do Seu Servidor
- Como Enviar Arquivos via SFTP
- Guia de Início do Servidor — Guia geral para iniciar qualquer servidor de jogo na Legion Hosting
Precisa de Mais Ajuda?
Se você está enfrentando problemas não cobertos neste guia, nossa equipe de suporte está disponível para ajudar. Abra um ticket em legionhosting.net/submitticket.php com os detalhes do seu servidor e uma descrição do problema.
