Este guia abrange tudo o que precisa para colocar o seu servidor alt:V a funcionar na Legion Hosting, desde o primeiro arranque 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 base de dados e gestão de administração, consulte alt:V Configuração de Admin e Resources.

O que é o alt:V?

O alt:V é uma modificação multijogador gratuita e de código aberto para Grand Theft Auto V. Permite que os jogadores se conectem a servidores personalizados com gamemodes únicos como roleplay (RP), deathmatch, corridas, freeroam e muito mais. O servidor executa resources personalizados escritos em JavaScript, TypeScript ou C#, dando aos proprietários de servidores controlo total sobre a lógica de jogo. Os jogadores conectam-se através do launcher alt:V, que modifica o GTA V para conectividade multijogador.

Primeiro Arranque

Quando receber o seu servidor alt:V pela primeira vez, siga estes passos para o colocar online:

1. Inicie sessão no GPanel e selecione o seu servidor alt:V.
2. Navegue até ao separador Startup e configure o nome do servidor, máximo de jogadores e outras variáveis de arranque.
3. Vá ao separador Console e clique em Start.
4. O servidor irá descarregar os ficheiros do servidor alt:V no primeiro arranque. Isto pode demorar alguns minutos.
5. Assim que a consola mostrar que o servidor está à escuta e pronto para conexões, o seu servidor está online.
6. Por predefinição, o servidor inicia sem resources de gamemode. Precisará de adicionar resources para criar jogabilidade. Consulte alt:V Configuração de Admin e Resources para detalhes.

Variáveis de Arranque do GPanel

O alt:V expõe várias opções de configuração como variáveis de arranque no GPanel. Navegue até ao separador Startup para modificá-las. As alterações requerem um reinício do servidor.

Configuração do Servidor (server.toml)

O ficheiro de configuração principal dos servidores alt:V é o server.toml, localizado no diretório raiz do servidor. Pode editar este ficheiro através do separador 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"]

Definições principais: name (nome apresentado no navegador), host (manter 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 (etiqueta do navegador como "Roleplay"), modules (módulos de script: js-module ou csharp-module), resources (array de pastas de resources a carregar) e tags (etiquetas de filtro do navegador).

Token de Anúncio

Para que o seu servidor apareça no navegador de servidores alt:V, precisa de um token de anúncio do servidor mestre alt:V:

1. Visite o site do alt:V e inicie sessão ou crie uma conta.
2. Navegue até à secção de gestão de servidores e gere um novo token de servidor.
3. Copie o token e cole-o no campo token do seu server.toml.
4. Certifique-se de que announce = true na sua configuração.
5. Reinicie o servidor. Deverá agora aparecer no navegador público.

Resources de Gamemode

Os servidores alt:V são alimentados por resources — scripts que definem toda a lógica de jogo. Sem resources, um servidor não tem funcionalidade personalizada. Os 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)

Carregar Resources

Adicione os nomes dos resources ao array resources no server.toml para os carregar no arranque:

resources = ["chat", "freeroam", "spawn"]

Cada resource deve ter um ficheiro resource.toml no seu diretório que define o tipo, dependências e pontos de entrada dos scripts. Para detalhes sobre como criar e gerir resources, consulte alt:V Configuração de Admin e Resources.

Configuração de CDN

O alt:V usa um mecanismo de CDN para servir ficheiros do lado do cliente (modelos, texturas, scripts) aos jogadores que se conectam. O CDN integrado serve ficheiros 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, pode opcionalmente configurar um CDN externo enviando ficheiros do cliente para um servidor web e definindo o URL do CDN na configuração do resource, reduzindo o uso de largura de banda do servidor de jogo.

Chat de Voz

O alt:V inclui um sistema de chat de voz integrado que permite comunicação vocal posicional (3D) entre jogadores. O chat de voz é ativado e configurado no server.toml.

Configuração de Voz

[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0

O bitrate controla a qualidade de 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 conectam-se aos servidores alt:V através do launcher alt:V, não diretamente pelo GTA V.

Através do Navegador de Servidores

1. Descarregue e instale o launcher alt:V a partir de altvmp.com.
2. Inicie o launcher alt:V. Ele irá detetar e verificar a instalação do GTA V.
3. A partir do launcher, navegue no Server Browser.
4. Procure o seu servidor pelo nome ou use filtros (gamemode, tags, contagem de jogadores).
5. Clique no seu servidor e selecione Connect.
6. Se o servidor tiver palavra-passe, o jogador será solicitado a introduzi-la.
7. O GTA V será iniciado com o mod multijogador alt:V e conectará ao seu servidor.

Através de Conexão Direta

1. No launcher alt:V, selecione Direct Connect.
2. Introduza o endereço IP e port do seu servidor no formato IP:PORT (por exemplo, 192.168.1.1:7788).
3. Clique em Connect.

Para encontrar o endereço IP e port do seu servidor, consulte Como Encontrar o IP e Port do Seu Servidor.

Máximo de Jogadores e Desempenho

Os servidores alt:V podem suportar contagens elevadas 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 funcionam sem problemas com contagens mais elevadas.
• 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 causa principal de problemas de desempenho. Scripts do lado do servidor que executam operações pesadas a cada tick ou mantêm grandes estruturas de dados em memória podem criar estrangulamentos no servidor.
• Consultas à base de dados: Gamemodes que usam bases 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 base de dados, ferramentas de admin e resolução de problemas
• Como Encontrar o IP e Port do Seu Servidor
• Como Enviar Ficheiros via SFTP
• Guia de Início do Servidor — Guia geral para iniciar qualquer servidor de jogo na Legion Hosting

Precisa de Mais Ajuda?

Se está a ter problemas não abordados neste guia, a nossa equipa 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.