Den här guiden tar upp resursutveckling, databasinstallation, administratörsverktyg, spelarhantering, fordons- och vapenhantering samt felsökning för din alt:V-server på Legion Hosting. För grundläggande serverinstallation, server.toml-konfiguration och anslutningsinstruktioner, se Installationsguide för alt:V-server.

---

Administratörsinstallation

alt:V har inget inbyggt administratörssystem. Administratörsfunktionalitet implementeras genom resurser (skript) som du skapar eller installerar. De flesta gamemodes implementerar sitt eget administratörssystem med behörighetsnivåer, roller och administratörskommandon.

Vanliga administratörsmetoder

• Databasbaserade roller: De flesta roleplay- och gamemode-ramverk lagrar administratörsroller i en databas. Administratörer tilldelas roller (t.ex. moderator, admin, superadmin) som ger olika behörighetsnivåer.
• Konfigurationsbaserade administratörer: Enklare uppsättningar kan använda en konfigurationsfil som listar administratörers Steam-ID:n eller alt:V-ID:n med deras behörighetsnivåer.
• Konsolkommandon: GPanel-serverkonsolen har alltid full åtkomst. Du kan skriva server-side-skript som accepterar konsolinmatning för administratörsoperationer.

Konfigurera en administratörsresurs

1. Välj eller utveckla en administratörsresurs som passar din gamemode.
2. Ladda upp resursen till katalogen resources/ via fliken Files eller SFTP.
3. Lägg till resursnamnet i arrayen resources i server.toml.
4. Konfigurera administratörsresursen (ange dina administratörers Steam-/alt:V-ID:n, behörighetsnivåer osv.).
5. Starta om servern.

---

Resurssystem

Resurser är de centrala byggstenarna i alt:V-servrar. Varje resurs är en fristående modul som kan innehålla server-side-kod, client-side-kod eller båda. Resurser skrivs i JavaScript, TypeScript eller C#.

Resursstruktur

resources/
  my-resource/
    resource.toml         <-- Resource configuration (required)
    server/
      index.js            <-- Server-side entry point
      utils.js            <-- Additional server-side files
    client/
      index.js            <-- Client-side entry point (runs in player's GTA V)
    shared/
      config.js           <-- Shared code accessible by both server and client

resource.toml-konfiguration

type = "js"
main = "server/index.js"
client-main = "client/index.js"
client-files = ["client/*"]
deps = ["chat"]

Fält: type (js eller csharp), main (server-side entry point), client-main (client-side entry point, körs i spelarens GTA V), client-files (filer som skickas till klienten, stöder globbar), deps (andra resurser som ska laddas först).

---

Installera resurser

Så här installerar du en färdigbyggd resurs på din server:

1. Ladda ner resursfilerna (vanligtvis en mapp som innehåller resource.toml och skriptfiler).
2. Stoppa din server i GPanel.
3. Ladda upp resursmappen till resources/ via fliken Files eller SFTP.
4. Lägg till resursmappens namn i arrayen resources i server.toml:

resources = ["existing-resource", "new-resource"]

5. Om resursen har beroenden, säkerställ att även dessa är installerade och listade.
6. Konfigurera resursen enligt dess dokumentation (konfigurationsfiler, databasinstallation osv.).
7. Starta servern. Kontrollera konsolen efter meddelanden om resursladdning och eventuella fel.

Ta bort en resurs

1. Stoppa din server.
2. Ta bort resursnamnet från arrayen resources i server.toml.
3. Ta eventuellt bort resursmappen från resources/.
4. Starta servern.

---

Databasinstallation

De flesta alt:V-gamemodes kräver en databas för att lagra spelardata, fordon, inventarier och annan beständig information. De två vanligaste databassystemen för alt:V är MongoDB och MySQL/MariaDB.

MongoDB

MongoDB är en NoSQL-dokumentdatabas som ofta används med JavaScript/TypeScript-resurser. Använd en hanterad tjänst som MongoDB Atlas (gratisnivå tillgänglig) eller en självhostad instans. Hämta din anslutningssträng (t.ex. mongodb+srv://user:[email protected]/mydb) och konfigurera den i din resurs konfigurationsfil. Node.js-resurser använder npm-paketet mongodb.

MySQL / MariaDB

MySQL används ofta med C#-resurser och vissa JavaScript-ramverk. Skaffa en databas från en hanterad tjänst eller självhostad instans, konfigurera dina resurser med anslutningsuppgifterna (host, port, användarnamn, lösenord, databasnamn) och kör eventuella nödvändiga SQL-migreringsskript.

---

Spelarhantering

Spelarhantering i alt:V hanteras genom dina resurser. Vanliga operationer inkluderar:

Identifiera spelare

alt:V tillhandahåller flera identifierare för varje ansluten spelare:

Sparka och bannlysa

Implementera funktionalitet för att sparka och bannlysa i dina resurser:

import alt from "alt-server";

// Kick a player
player.kick("Reason for kick");

// Ban check on connect (store bans in database)
alt.on("playerConnect", (player) => {
    if (isPlayerBanned(player.socialID)) {
        player.kick("You are banned from this server.");
    }
});

---

Fordons- och vapenhantering

Fordon och vapen hanteras genom server-side-skript. alt:V ger dig full kontroll över att spawna, modifiera och ta bort fordon och vapen.

Spawna fordon

import alt from "alt-server";

// Spawn a vehicle at a position
const vehicle = new alt.Vehicle(
    "sultan",            // Vehicle model name
    0, 0, 72,           // Position (x, y, z)
    0, 0, 0             // Rotation (rx, ry, rz)
);
vehicle.numberPlateText = "LEGION";

Ge vapen

// Give a weapon to a player
player.giveWeapon(alt.hash("weapon_pistol"), 100, true);

// Remove all weapons
player.removeAllWeapons();

Fordonsbeständighet

Som standard existerar fordon endast i serverns minne och går förlorade vid omstart. För att bevara fordon mellan omstarter, lagra deras data (modell, position, modifieringar, ägare) i en databas och återskapa dem vid serverstart.

---

Felsökning

Resurser laddas inte

• Kontrollera att resursnamnet i server.toml exakt matchar mappnamnet i resources/.
• Verifiera att resursen har en giltig resource.toml-fil med korrekta type- och main-fält.
• Kontrollera konsolen efter felmeddelanden under resursladdning. Syntaxfel i skript hindrar resursen från att starta.
• Säkerställ att alla beroenden som listas i deps är installerade och laddade.
• Verifiera att rätt modul är laddad i server.toml (js-module för JavaScript, csharp-module för C#).

Spelare kan inte ansluta

• Verifiera att servern körs och visas som online i GPanel.
• Kontrollera att spelare använder alt:V-launchern, inte den vanliga GTA V-launchern.
• Säkerställ att alt:V-serverns gren matchar den som spelarna har (release, rc eller dev). Felmatchade grenar förhindrar anslutningar.
• Om servern är lösenordsskyddad, verifiera att spelare anger rätt lösenord.
• Låt spelare prova direktanslutning med IP och port. Se Så hittar du din server-IP och port.

Serverkrascher

• Kontrollera konsolen efter felmeddelanden före kraschen.
• Felaktiga resurser är den vanligaste orsaken till krascher. Inaktivera nyligen tillagda resurser för att isolera problemet.
• Säkerställ att dina serverfiler är uppdaterade. Utlös en ominstallation från fliken Startup vid behov.
• Minnesläckor i resurser kan få servern att få slut på RAM över tid. Övervaka GPanels resursgrafer efter stadigt ökande minnesanvändning.

Problem med databas och röst

• Verifiera databasuppgifter och anslutningssträngar. För MongoDB Atlas, vitlista din servers IP i inställningarna för nätverksåtkomst.
• Kontrollera konsolen efter felmeddelanden om databasanslutning.
• Röstchatt kräver sektionen [voice] i server.toml plus resurser som implementerar logik för röstkanaler. Konfigurationen ensam ställer endast in infrastrukturen.

Prestandaproblem

• Profilera dina resurser efter dyra operationer (tunga loopar, synkrona databasanrop, överdriven entitetsskapelse).
• Använd alt.setInterval och alt.setTimeout sparsamt. Tunga operationer per tick är den vanligaste prestandadödaren.
• Övervaka GPanels resursgrafer för CPU- och RAM-användning.
• Överväg att uppgradera ditt serverpaket för höga spelarantal. Öppna ett supportärende för att diskutera alternativ.

---

Relaterade artiklar

• Installationsguide för alt:V-server — Grundläggande installation, server.toml-konfiguration, röstchatt och anslutningsinstruktioner
• 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, en beskrivning av problemet och eventuella relevanta felmeddelanden från GPanel-konsolen.