background image

alt:V Server Setup Guide - База знаний

  1. Портал
  2. База знаний
  3. alt:V
  4. alt:V Server Setup Guide
База знаний Создать тикет Открытые тикеты
Game Servers 380 7 Days to Die 4 Abiotic Factor 2 Aloft 2 alt:V 2 Americas Army Proving Grounds 2 Among Us 2 Archean 2 ARK Survival Ascended 6 ARK Survival Evolved 3 Arma 3 3 Arma Reforger 2 Aska 2 AssaultCube 2 Assetto Corsa 3 Astro Colony 2 Astroneer 2 Automobilista 2 2 Avorion 2 Banana Shooter 2 Barotrauma 3 BATTALION Legacy 2 BeamNG.drive (BeamMP) 2 Black Mesa 2 Brickadia 2 Call of Duty 2 Citadel: Forged with Fire 2 ClassiCube 2 Clone Hero 2 Colony Survival 2 Conan Exiles 4 Contagion 2 Core Keeper 2 Counter-Strike 2 3 Craftopia 2 CryoFall 2 CS2D 2 Cube 2: Sauerbraten 2 Cubic Odyssey 2 DayZ 4 DDNet 2 DDRaceNetwork 2 Dead Matter 2 Dont Starve Together 4 Eco 2 Empyrion Galactic Survival 2 Enshrouded 3 Escape from Tarkov 2 Euro Truck Simulator 2 2 Factorio 2 Farming Simulator 25 2 Fistful of Frags 2 FiveM 3 FortressCraft Evolved 2 Foundry 2 Foundry VTT 2 Frozen Flame 2 FTL Tachyon 2 Garrys Mod 3 Ground Branch 2 Half-Life 2 Deathmatch 2 Hogwarp 2 Holdfast: Nations at War 2 HumanitZ 2 Hurtworld 2 Hytale 1 Icarus 2 Insurgency Sandstorm 2 IOSoccer 2 Just Cause 3 Multiplayer 2 Kerbal Space Program 2 Killing Floor 2 3 LeagueSandbox 2 Left 4 Dead 2 Left 4 Dead 2 3 Longvinter 2 Los Angeles Crimes 2 Medal of Honor 2 Midnight Ghost Hunt 2 Mindustry 2 Minecraft 4 Minetest 2 Modiverse 2 Mordhau 3 Mount & Blade II: Bannerlord 2 Myth of Empires 2 Nazi Zombies Portable 2 Necesse 2 NeosVR 2 Neverwinter Nights EE 2 Night of the Dead 2 Nightingale 2 No Love Lost 2 No More Room in Hell 2 No One Survived 2 Nova-Life Amboise 2 Nuclear Option 2 Onset 2 Open Fortress 2 OpenArena 2 OpenRA 2 OpenRCT2 2 OpenTTD 2 Operation Harsh Doorstop 2 Palworld 3 Path of Titans 2 Pavlov VR 3 PixARK 2 Plains of Pain 2 Portal Knights 2 Post Scriptum 2 Project Zomboid 8 Puck 2 Quake Live 2 R5Reloaded 2 RedM 2 Renown 2 Resonite 2 Return to Moria 2 Rimworld Together 2 Rising World 2 Risk of Rain 2 1 Rust 4 Satisfactory 1 SCP Secret Laboratory 3 SCUM 2 Smalland 2 Solace Crafting 2 Soldat 2 Soldat 2 2 Sonic Robo Blast 2 2 Sons of the Forest 2 Soulmask 2 SourceCoop 2 Space Engineers 3 Space Station 14 2 Squad 3 Starbound 3 StarMade 2 Stationeers 2 Stormworks 2 Subnautica Nitrox 2 Sunkenland 2 SuperTuxKart 2 Sven Co-op 2 Swords 'n Magic and Stuff 2 Team Fortress 2 3 Teeworlds 2 Terraria 3 TerraTech Worlds 2 TF2 Classified 2 The Forest 3 The Front 2 The Isle 2 Tower Unite 2 Trackmania 2 Unturned 4 Urban Terror 2 V Rising 3 Valheim 3 VEIN 2 Veloren 2 Vintage Story 3 Voyagers of Nera 2 Wolfenstein: Enemy Territory 2 Wreckfest 2 Wurm Unlimited 2 Xonotic 2 Zandronum 2 Getting Started 2 Network & Connectivity 1 Server Management 2
Поддержка
Категории

alt:V Server Setup Guide

altv gta-v setup config multiplayer Полезно для 0 чел.
Доступно на: ESPAÑOL PORTUGUÊS (BRASIL)

This guide covers everything you need to get your alt:V server running on Legion Hosting, from first-time startup and server.toml configuration to gamemode resources, CDN setup, voice chat, and how players connect through the alt:V launcher. For resource development, database setup, and admin management, see alt:V Admin and Resource Setup.

Server Panel: All server management is done through GPanel at gpanel.legionhosting.net. alt:V servers run as a standalone dedicated server application, separate from the GTA V game client.

What is alt:V?

alt:V is a free, open-source multiplayer modification for Grand Theft Auto V. It allows players to connect to custom servers running unique gamemodes such as roleplay (RP), deathmatch, racing, freeroam, and more. The server runs custom resources written in JavaScript, TypeScript, or C#, giving server owners full control over gameplay logic. Players connect through the alt:V launcher, which modifies GTA V for multiplayer connectivity.

GTA V license required: Every player connecting to your alt:V server must own a legitimate copy of Grand Theft Auto V on their Rockstar Games account. The alt:V launcher verifies game ownership before allowing connections.

First Start

When you first receive your alt:V server, follow these steps to get it online:

  1. Log in to GPanel and select your alt:V server.
  2. Navigate to the Startup tab and configure your server name, max players, and other startup variables.
  3. Go to the Console tab and click Start.
  4. The server will download the alt:V server files on first boot. This may take a few minutes.
  5. Once the console displays that the server is listening and ready for connections, your server is online.
  6. By default, the server starts with no gamemode resources. You will need to add resources to create gameplay. See alt:V Admin and Resource Setup for details.
No gamemode by default: A fresh alt:V server starts with no gameplay resources. Players can connect but will spawn with no custom features. You need to install or develop resources to create your desired gamemode.

GPanel Startup Variables

alt:V exposes several configuration options as startup variables in GPanel. Navigate to the Startup tab to modify these. Changes require a server restart.

Variable Default Description
PASSWORD ChangeMe Password to join the server. Minimum 6 characters.
SERVER_DESC A Pterodactyl Hosted Server Server description displayed in the alt:V server browser.
BUILD release The alt:V server branch: release (stable), rc (release candidate), or dev (development).

Server Configuration (server.toml)

The primary configuration file for alt:V servers is server.toml, located in the server root directory. You can edit this file through the Files tab in GPanel or via SFTP.

Example 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"]

Key settings: name (browser display name), host (keep 0.0.0.0), port (must match GPanel), players (max count), password (empty for public), announce (true to appear in browser), token (announce token from alt:V website, required for browser listing), gamemode (browser label like "Roleplay"), modules (script modules: js-module or csharp-module), resources (array of resource folders to load), and tags (browser filter tags).

Always stop your server before editing server.toml. Changes made while the server is running will not take effect until restart and may be overwritten.

Announce Token

For your server to appear in the alt:V server browser, you need an announce token from the alt:V master server:

  1. Visit the alt:V website and log in or create an account.
  2. Navigate to the server management section and generate a new server token.
  3. Copy the token and paste it into the token field in your server.toml.
  4. Ensure announce = true in your configuration.
  5. Restart the server. It should now appear in the public browser.
Keep your announce token private. Do not share it publicly. The token is unique to your server and should only be in your server.toml.

Gamemode Resources

alt:V servers are powered by resources — scripts that define all gameplay logic. Without resources, a server has no custom functionality. Resources are placed in the resources/ directory.

Resource Structure

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)

Loading Resources

Add resource names to the resources array in server.toml to load them on startup:

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

Each resource must have a resource.toml file in its directory that defines its type, dependencies, and script entry points. For details on creating and managing resources, see alt:V Admin and Resource Setup.

CDN Setup

alt:V uses a CDN mechanism to serve client-side files (models, textures, scripts) to connecting players. The built-in CDN serves files directly from the server with no extra configuration needed — this is the default and works well for most servers. For large-scale servers with many custom assets, you can optionally configure an external CDN by uploading client files to a web server and setting the CDN URL in your resource configuration, reducing game server bandwidth usage.

Voice Chat

alt:V includes a built-in voice chat system that allows positional (3D) voice communication between players. Voice chat is enabled and configured in server.toml.

Voice Configuration

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

The bitrate controls voice quality (64000 is standard). The external* fields configure an external voice server — leave them empty/zero to use the built-in voice server, which is recommended for most setups. The external voice server option is only needed for advanced configurations where voice processing is offloaded to a separate machine.

How Players Connect

Players connect to alt:V servers through the alt:V launcher, not through GTA V directly.

Via the Server Browser

  1. Download and install the alt:V launcher from altvmp.com.
  2. Launch the alt:V launcher. It will detect and verify the GTA V installation.
  3. From the launcher, browse the Server Browser.
  4. Search for your server by name or use filters (gamemode, tags, player count).
  5. Click on your server and select Connect.
  6. If the server has a password, the player will be prompted to enter it.
  7. GTA V will launch with the alt:V multiplayer mod and connect to your server.

Via Direct Connect

  1. In the alt:V launcher, select Direct Connect.
  2. Enter your server's IP address and port in the format IP:PORT (e.g., 192.168.1.1:7788).
  3. Click Connect.

To find your server's IP address and port, see How to Find Your Server IP and Port.

Server not showing in the browser? Make sure announce = true in your server.toml and that you have a valid announce token. The server may take a minute to register after startup. Check the console for master server connection errors. Note that your port is randomly assigned unless you have a private IP -- check GPanel for the correct value.

Max Players and Performance

alt:V servers can support high player counts, but performance depends heavily on your resources and server plan:

  • 32–128 players: A common range for most servers. Simple gamemodes run smoothly at higher counts.
  • 128–512+ players: Possible for optimized servers with efficient resources. Requires more CPU and RAM.
  • Resource efficiency: Poorly optimized scripts are the primary cause of performance issues. Server-side scripts that run heavy operations every tick or maintain large data structures in memory can bottleneck the server.
  • Database queries: Gamemodes using databases (MySQL, MongoDB) should use async queries to avoid blocking the main thread.
Performance tip: If your server experiences lag, profile your resources for expensive operations. Optimize database queries, reduce per-tick operations, and use event-driven patterns instead of polling loops.

Related Articles

Need More Help?

If you are experiencing issues not covered in this guide, our support team is available to assist. Open a ticket at legionhosting.net/submitticket.php with your server details and a description of the problem.

Была ли эта статья полезной?
Помочь улучшить

Похожие статьи

alt:V Admin and Resource Setup
This guide covers resource development, database setup, admin tools, player management, vehicle and ...
Назад

Ready to Get Started?

The servers are booted, select your plan and become our latest satisfied client.