Den här guiden tar upp allt du behöver för att få din alt:V-server igång på Legion Hosting, från första uppstart och server.toml-konfiguration till gamemode-resurser, CDN-installation, röstchatt och hur spelare ansluter via alt:V-launchern. För resursutveckling, databasinstallation och administratörshantering, se alt:V administratörs- och resursinstallation.
Vad är alt:V?
alt:V är en gratis modifiering med öppen källkod för multiplayer i Grand Theft Auto V. Den låter spelare ansluta till anpassade servrar som kör unika gamemodes såsom roleplay (RP), deathmatch, racing, freeroam och mer. Servern kör anpassade resurser skrivna i JavaScript, TypeScript eller C#, vilket ger serverägare full kontroll över spellogiken. Spelare ansluter via alt:V-launchern, som modifierar GTA V för multiplayer-anslutning.
Första start
När du först får din alt:V-server, följ dessa steg för att få den online:
- Logga in på GPanel och välj din alt:V-server.
- Navigera till fliken Startup och konfigurera ditt servernamn, max antal spelare och andra startvariabler.
- Gå till fliken Console och klicka på Start.
- Servern laddar ner alt:V-serverfilerna vid första uppstart. Detta kan ta några minuter.
- När konsolen visar att servern lyssnar och är redo för anslutningar är din server online.
- Som standard startar servern utan några gamemode-resurser. Du behöver lägga till resurser för att skapa spelupplevelse. Se alt:V administratörs- och resursinstallation för detaljer.
GPanel-startvariabler
alt:V exponerar flera konfigurationsalternativ som startvariabler i GPanel. Navigera till fliken Startup för att ändra dessa. Ändringar kräver en omstart av servern.
| Variabel | Standard | Beskrivning |
|---|---|---|
PASSWORD |
ChangeMe |
Lösenord för att ansluta till servern. Minst 6 tecken. |
SERVER_DESC |
A Pterodactyl Hosted Server |
Serverbeskrivning som visas i alt:V-serverwebbläsaren. |
BUILD |
release |
alt:V-serverns gren: release (stabil), rc (release candidate) eller dev (utveckling). |
Serverkonfiguration (server.toml)
Den primära konfigurationsfilen för alt:V-servrar är server.toml, som finns i serverns rotkatalog. Du kan redigera den här filen via fliken Files i GPanel eller via SFTP.
Exempel på 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"]Viktiga inställningar: name (visningsnamn i webbläsaren), host (behåll 0.0.0.0), port (måste matcha GPanel), players (max antal), password (tomt för publik), announce (true för att visas i webbläsaren), token (announce-token från alt:V:s webbplats, krävs för listning i webbläsaren), gamemode (webbläsaretikett som "Roleplay"), modules (skriptmoduler: js-module eller csharp-module), resources (array av resursmappar att ladda), och tags (filtertaggar i webbläsaren).
Announce-token
För att din server ska visas i alt:V-serverwebbläsaren behöver du en announce-token från alt:V master server:
- Besök alt:V:s webbplats och logga in eller skapa ett konto.
- Navigera till serverhanteringssektionen och generera en ny servertoken.
- Kopiera token och klistra in den i fältet
tokeni dinserver.toml. - Säkerställ att
announce = truei din konfiguration. - Starta om servern. Den bör nu visas i den publika webbläsaren.
server.toml.
Gamemode-resurser
alt:V-servrar drivs av resurser — skript som definierar all spellogik. Utan resurser har en server ingen anpassad funktionalitet. Resurser placeras i katalogen resources/.
Resursstruktur
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)Ladda resurser
Lägg till resursnamn i arrayen resources i server.toml för att ladda dem vid uppstart:
resources = ["chat", "freeroam", "spawn"]Varje resurs måste ha en resource.toml-fil i sin katalog som definierar dess typ, beroenden och skript-entry points. För detaljer om att skapa och hantera resurser, se alt:V administratörs- och resursinstallation.
CDN-installation
alt:V använder en CDN-mekanism för att leverera client-side-filer (modeller, texturer, skript) till anslutande spelare. Den inbyggda CDN:en levererar filer direkt från servern utan att någon extra konfiguration behövs — detta är standard och fungerar bra för de flesta servrar. För storskaliga servrar med många anpassade tillgångar kan du valfritt konfigurera en extern CDN genom att ladda upp client-filer till en webbserver och ställa in CDN-URL:en i din resurskonfiguration, vilket minskar bandbreddsanvändningen på spelservern.
Röstchatt
alt:V inkluderar ett inbyggt röstchattsystem som möjliggör positionsbaserad (3D) röstkommunikation mellan spelare. Röstchatt aktiveras och konfigureras i server.toml.
Röstkonfiguration
[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0bitrate styr röstkvaliteten (64000 är standard). external*-fälten konfigurerar en extern röstserver — lämna dem tomma/noll för att använda den inbyggda röstservern, vilket rekommenderas för de flesta uppsättningar. Alternativet med extern röstserver behövs endast för avancerade konfigurationer där röstbearbetning flyttas till en separat maskin.
Hur spelare ansluter
Spelare ansluter till alt:V-servrar via alt:V-launchern, inte direkt via GTA V.
Via serverwebbläsaren
- Ladda ner och installera alt:V-launchern från altvmp.com.
- Starta alt:V-launchern. Den kommer att upptäcka och verifiera GTA V-installationen.
- Från launchern, bläddra i Server Browser.
- Sök efter din server efter namn eller använd filter (gamemode, taggar, spelarantal).
- Klicka på din server och välj Connect.
- Om servern har ett lösenord ombeds spelaren att ange det.
- GTA V startar med alt:V-multiplayer-modden och ansluter till din server.
Via direktanslutning
- I alt:V-launchern, välj Direct Connect.
- Ange din servers IP-adress och port i formatet
IP:PORT(t.ex.192.168.1.1:7788). - Klicka på Connect.
För att hitta din servers IP-adress och port, se Så hittar du din server-IP och port.
announce = true i din server.toml och att du har en giltig announce-token. Det kan ta en minut för servern att registrera sig efter uppstart. Kontrollera konsolen efter fel i anslutningen till master server. Observera att din port tilldelas slumpmässigt om du inte har en privat IP -- kontrollera GPanel för det korrekta värdet.
Max antal spelare och prestanda
alt:V-servrar kan stödja höga spelarantal, men prestandan beror i hög grad på dina resurser och ditt serverpaket:
- 32–128 spelare: Ett vanligt intervall för de flesta servrar. Enkla gamemodes körs smidigt vid högre antal.
- 128–512+ spelare: Möjligt för optimerade servrar med effektiva resurser. Kräver mer CPU och RAM.
- Resurseffektivitet: Dåligt optimerade skript är den främsta orsaken till prestandaproblem. Server-side-skript som kör tunga operationer varje tick eller upprätthåller stora datastrukturer i minnet kan skapa flaskhalsar på servern.
- Databasfrågor: Gamemodes som använder databaser (MySQL, MongoDB) bör använda asynkrona frågor för att undvika att blockera huvudtråden.
Relaterade artiklar
- alt:V administratörs- och resursinstallation — Resursutveckling, databasinstallation, administratörsverktyg och felsökning
- Så hittar du din server-IP och port
- Så laddar du upp filer via SFTP
- Guide för serverstart — Allmän guide för att starta valfri spelserver på Legion Hosting
Behöver du mer hjälp?
Om du har problem som inte tas upp i den här guiden finns vårt supportteam tillgängligt för att hjälpa till. Öppna ett ärende på legionhosting.net/submitticket.php med dina serveruppgifter och en beskrivning av problemet.
