Denne guide dækker ressourceudvikling, databaseopsætning, adminværktøjer, spilleradministration, køretøjs- og våbenadministration samt fejlfinding for din alt:V-server på Legion Hosting. For indledende serveropsætning, server.toml-konfiguration og forbindelsesinstruktioner, se alt:V Serveropsætningsguide.

---

Adminopsætning

alt:V har ikke et indbygget adminsystem. Adminfunktionalitet implementeres gennem ressourcer (scripts), som du opretter eller installerer. De fleste gamemodes implementerer deres eget adminsystem med tilladelsesniveauer, roller og adminkommandoer.

Almindelige admintilgange

• Databasebaserede roller: De fleste roleplay- og gamemode-frameworks gemmer adminroller i en database. Admins tildeles roller (f.eks. moderator, admin, superadmin), der giver forskellige tilladelsesniveauer.
• Konfigurationsbaserede admins: Enklere opsætninger kan bruge en konfigurationsfil med admin Steam ID'er eller alt:V ID'er med deres tilladelsesniveauer.
• Konsolkommandoer: GPanel-serverkonsollen har altid fuld adgang. Du kan skrive server-side scripts, der accepterer konsolinput til adminoperationer.

Opsætning af en adminressource

1. Vælg eller udvikl en adminressource, der passer til din gamemode.
2. Upload ressourcen til mappen resources/ via fanen Files eller SFTP.
3. Tilføj ressourcenavnet til resources-arrayet i server.toml.
4. Konfigurer adminressourcen (angiv dine admin Steam/alt:V ID'er, tilladelsesniveauer osv.).
5. Genstart serveren.

---

Ressourcesystem

Ressourcer er de grundlæggende byggesten i alt:V-servere. Hver ressource er et selvstændigt modul, der kan indeholde server-side kode, client-side kode eller begge dele. Ressourcer skrives i JavaScript, TypeScript eller C#.

Ressourcestruktur

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

Felter: type (js eller csharp), main (server-side indgangspunkt), client-main (client-side indgangspunkt, kører i spillerens GTA V), client-files (filer der sendes til klienten, understøtter globs), deps (andre ressourcer der skal indlæses først).

---

Installation af ressourcer

For at installere en færdigbygget ressource på din server:

1. Download ressourcefilerne (typisk en mappe indeholdende resource.toml og scriptfiler).
2. Stop din server i GPanel.
3. Upload ressourcemappen til resources/ via fanen Files eller SFTP.
4. Tilføj ressourcemappens navn til resources-arrayet i server.toml:

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

5. Hvis ressourcen har afhængigheder, skal du sikre, at disse også er installeret og opført.
6. Konfigurer ressourcen i henhold til dens dokumentation (konfigurationsfiler, databaseopsætning osv.).
7. Start serveren. Tjek konsollen for meddelelser om ressourceindlæsning og eventuelle fejl.

Fjernelse af en ressource

1. Stop din server.
2. Fjern ressourcenavnet fra resources-arrayet i server.toml.
3. Slet eventuelt ressourcemappen fra resources/.
4. Start serveren.

---

Databaseopsætning

De fleste alt:V gamemodes kræver en database til at gemme spillerdata, køretøjer, inventarer og anden vedvarende information. De to mest almindelige databasesystemer til alt:V er MongoDB og MySQL/MariaDB.

MongoDB

MongoDB er en NoSQL-dokumentdatabase, der almindeligvis bruges med JavaScript/TypeScript-ressourcer. Brug en administreret tjeneste som MongoDB Atlas (gratis niveau tilgængeligt) eller en selvhostet instans. Hent din forbindelsesstreng (f.eks. mongodb+srv://user:[email protected]/mydb) og konfigurer den i din ressources konfigurationsfil. Node.js-ressourcer bruger npm-pakken mongodb.

MySQL / MariaDB

MySQL bruges almindeligvis med C#-ressourcer og nogle JavaScript-frameworks. Anskaf en database fra en administreret tjeneste eller selvhostet instans, konfigurer dine ressourcer med forbindelsesoplysningerne (host, port, brugernavn, adgangskode, databasenavn), og kør eventuelle nødvendige SQL-migrationsscripts.

---

Spilleradministration

Spilleradministration i alt:V håndteres gennem dine ressourcer. Almindelige operationer inkluderer:

Identifikation af spillere

alt:V giver flere identifikatorer for hver tilsluttet spiller:

Kick og ban

Implementer kick- og banfunktionalitet i dine ressourcer:

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.");
    }
});

---

Køretøjs- og våbenadministration

Køretøjer og våben administreres gennem server-side scripts. alt:V giver dig fuld kontrol over spawn, ændring og fjernelse af køretøjer og våben.

Spawn af køretøjer

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";

Tildeling af våben

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

// Remove all weapons
player.removeAllWeapons();

Køretøjspersistens

Som standard eksisterer køretøjer kun i serverhukommelsen og går tabt ved genstart. For at bevare køretøjer på tværs af genstarter skal du gemme deres data (model, position, modifikationer, ejer) i en database og genskabe dem ved serverstart.

---

Fejlfinding

Ressourcer indlæses ikke

• Tjek at ressourcenavnet i server.toml matcher mappenavnet i resources/ nøjagtigt.
• Verificer at ressourcen har en gyldig resource.toml-fil med korrekte type- og main-felter.
• Tjek konsollen for fejlmeddelelser under ressourceindlæsning. Syntaksfejl i scripts forhindrer ressourcen i at starte.
• Sørg for at alle afhængigheder opført i deps er installeret og indlæst.
• Verificer at det korrekte modul er indlæst i server.toml (js-module for JavaScript, csharp-module for C#).

Spillere kan ikke forbinde

• Verificer at serveren kører og vises som online i GPanel.
• Tjek at spillere bruger alt:V-launcheren, ikke den almindelige GTA V-launcher.
• Sørg for at alt:V-serverens branch matcher det spillerne har (release, rc eller dev). Uoverensstemmende branches forhindrer forbindelser.
• Hvis serveren er adgangskodebeskyttet, verificer at spillerne indtaster den korrekte adgangskode.
• Bed spillere om at prøve direkte forbindelse med IP og port. Se Sådan finder du din servers IP og port.

Servernedbrud

• Tjek konsollen for fejlmeddelelser før nedbruddet.
• Fejlbehæftede ressourcer er den mest almindelige årsag til nedbrud. Deaktiver nyligt tilføjede ressourcer for at isolere problemet.
• Sørg for at dine serverfiler er opdaterede. Udløs en geninstallation fra fanen Startup, hvis det er nødvendigt.
• Hukommelseslækager i ressourcer kan få serveren til at løbe tør for RAM over tid. Overvåg GPanel-ressourcegrafer for støt stigende hukommelsesforbrug.

Database- og stemmeproblemer

• Verificer databaselegitimationsoplysninger og forbindelsesstrenge. For MongoDB Atlas skal du hvidliste din servers IP i netværksadgangsindstillingerne.
• Tjek konsollen for fejlmeddelelser om databaseforbindelse.
• Stemmechat kræver sektionen [voice] i server.toml plus ressourcer, der implementerer stemmekanallogik. Konfigurationen alene opsætter kun infrastrukturen.

Ydelsesproblemer

• Profiler dine ressourcer for dyre operationer (tunge løkker, synkrone databasekald, overdreven entity-oprettelse).
• Brug alt.setInterval og alt.setTimeout sparsomt. Tunge per-tick-operationer er den mest almindelige årsag til ydelsesproblemer.
• Overvåg GPanel-ressourcegrafer for CPU- og RAM-forbrug.
• Overvej at opgradere din serverplan for højt spillerantal. Opret en supportbillet for at diskutere mulighederne.

---

Relaterede artikler

• alt:V Serveropsætningsguide — Indledende opsætning, server.toml-konfiguration, stemmechat og forbindelsesinstruktioner
• Sådan finder du din servers IP og port
• Sådan uploader du filer via SFTP
• Serveropstartsguide — Generel guide til at starte enhver gameserver på Legion Hosting

---

Brug for mere hjælp?

Hvis du oplever problemer, der ikke er dækket i denne guide, er vores supportteam klar til at hjælpe. Opret en billet på legionhosting.net/submitticket.php med dine serveroplysninger, en beskrivelse af problemet og eventuelle relevante fejlmeddelelser fra GPanel-konsollen.