Denne veiledningen dekker ressursutvikling, databaseoppsett, administratorverktøy, spilleradministrasjon, kjøretøy- og våpenadministrasjon, og feilsøking for din alt:V-server på Legion Hosting. For førstegangs serveroppsett, server.toml-konfigurasjon og tilkoblingsinstruksjoner, se alt:V Oppsettsveiledning for server.

---

Administratoroppsett

alt:V har ikke et innebygd administratorsystem. Administratorfunksjonalitet implementeres gjennom ressurser (skript) som du oppretter eller installerer. De fleste spillmoduser implementerer sitt eget administratorsystem med tilgangsnivåer, roller og administratorkommandoer.

Vanlige administratortilnærminger

• Databasebaserte roller: De fleste rollespill- og spillmodus-rammeverk lagrer administratorroller i en database. Administratorer tildeles roller (f.eks. moderator, admin, superadmin) som gir ulike tilgangsnivåer.
• Konfigurasjonsbaserte administratorer: Enklere oppsett kan bruke en konfigurasjonsfil som lister administratorenes Steam-IDer eller alt:V-IDer med deres tilgangsnivåer.
• Konsollkommandoer: GPanel-serverkonsollen har alltid full tilgang. Du kan skrive serverside-skript som tar imot konsollinndata for administratoroperasjoner.

Sette opp en administratorressurs

1. Velg eller utvikle en administratorressurs som passer din spillmodus.
2. Last opp ressursen til resources/-katalogen via Files-fanen eller SFTP.
3. Legg ressursnavnet til resources-tabellen i server.toml.
4. Konfigurer administratorressursen (sett dine administrator-Steam/alt:V-IDer, tilgangsnivåer osv.).
5. Restart serveren.

---

Ressurssystem

Ressurser er kjernebyggesteinene i alt:V-servere. Hver ressurs er en selvstendig modul som kan inneholde serverside-kode, klientside-kode, eller begge deler. Ressurser skrives i JavaScript, TypeScript eller C#.

Ressursstruktur

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-konfigurasjon

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

Felter: type (js eller csharp), main (serverside-inngangspunkt), client-main (klientside-inngangspunkt, kjører i spillerens GTA V), client-files (filer som sendes til klienten, støtter globs), deps (andre ressurser som skal lastes først).

---

Installere ressurser

Slik installerer du en ferdigbygd ressurs på serveren din:

1. Last ned ressursfilene (vanligvis en mappe som inneholder resource.toml og skriptfiler).
2. Stopp serveren din i GPanel.
3. Last opp ressursmappen til resources/ via Files-fanen eller SFTP.
4. Legg ressursmappens navn til resources-tabellen i server.toml:

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

5. Hvis ressursen har avhengigheter, sørg for at disse også er installert og oppført.
6. Konfigurer ressursen i henhold til dokumentasjonen (konfigurasjonsfiler, databaseoppsett osv.).
7. Start serveren. Sjekk konsollen for innlastingsmeldinger for ressurser og eventuelle feil.

Fjerne en ressurs

1. Stopp serveren din.
2. Fjern ressursnavnet fra resources-tabellen i server.toml.
3. Eventuelt slett ressursmappen fra resources/.
4. Start serveren.

---

Databaseoppsett

De fleste alt:V-spillmoduser krever en database for å lagre spillerdata, kjøretøy, inventarer og annen vedvarende informasjon. De to vanligste databasesystemene for alt:V er MongoDB og MySQL/MariaDB.

MongoDB

MongoDB er en NoSQL-dokumentdatabase som ofte brukes med JavaScript/TypeScript-ressurser. Bruk en administrert tjeneste som MongoDB Atlas (gratis nivå tilgjengelig) eller en selvhostet instans. Skaff tilkoblingsstrengen din (f.eks. mongodb+srv://user:[email protected]/mydb) og konfigurer den i ressursens konfigurasjonsfil. Node.js-ressurser bruker mongodb npm-pakken.

MySQL / MariaDB

MySQL brukes ofte med C#-ressurser og enkelte JavaScript-rammeverk. Skaff en database fra en administrert tjeneste eller selvhostet instans, konfigurer ressursene dine med tilkoblingsdetaljene (vert, port, brukernavn, passord, databasenavn), og kjør eventuelle nødvendige SQL-migreringsskript.

---

Spilleradministrasjon

Spilleradministrasjon i alt:V håndteres gjennom ressursene dine. Vanlige operasjoner inkluderer:

Identifisere spillere

alt:V tilbyr flere identifikatorer for hver tilkoblet spiller:

Sparke og utestenge

Implementer sparke- og utestengelsesfunksjonalitet i ressursene dine:

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

---

Kjøretøy- og våpenadministrasjon

Kjøretøy og våpen administreres gjennom serverside-skript. alt:V gir deg full kontroll over spawning, modifisering og fjerning av kjøretøy og våpen.

Spawne kjøretøy

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

Gi våpen

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

// Remove all weapons
player.removeAllWeapons();

Kjøretøypersistens

Som standard eksisterer kjøretøy kun i serverminnet og går tapt ved restart. For å bevare kjøretøy på tvers av restarter, lagre dataene deres (modell, posisjon, modifikasjoner, eier) i en database og gjenskap dem ved serveroppstart.

---

Feilsøking

Ressurser lastes ikke inn

• Sjekk at ressursnavnet i server.toml nøyaktig samsvarer med mappenavnet i resources/.
• Verifiser at ressursen har en gyldig resource.toml-fil med korrekte type- og main-felter.
• Sjekk konsollen for feilmeldinger under innlasting av ressurser. Syntaksfeil i skript vil hindre ressursen i å starte.
• Sørg for at alle avhengigheter som er oppført i deps er installert og lastet inn.
• Verifiser at riktig modul er lastet inn i server.toml (js-module for JavaScript, csharp-module for C#).

Spillere kan ikke koble til

• Verifiser at serveren kjører og vises som online i GPanel.
• Sjekk at spillere bruker alt:V-launcheren, ikke den vanlige GTA V-launcheren.
• Sørg for at alt:V-servergrenen samsvarer med det spillerne har (release, rc eller dev). Avvikende grener forhindrer tilkoblinger.
• Hvis serveren er passordbeskyttet, verifiser at spillerne skriver inn riktig passord.
• La spillere prøve direkte tilkobling med IP-en og porten. Se Hvordan finne server-IP og port.

Serverkrasj

• Sjekk konsollen for feilmeldinger før krasjet.
• Feilaktige ressurser er den vanligste årsaken til krasj. Deaktiver nylig lagt til ressurser for å isolere problemet.
• Sørg for at serverfilene dine er oppdatert. Utløs en reinstallasjon fra Startup-fanen om nødvendig.
• Minnelekkasjer i ressurser kan føre til at serveren går tom for RAM over tid. Overvåk GPanel-ressursgrafene for jevnt økende minnebruk.

Database- og taleproblemer

• Verifiser databaselegitimasjon og tilkoblingsstrenger. For MongoDB Atlas, hvitelist serverens IP i nettverkstilgangsinnstillingene.
• Sjekk konsollen for feilmeldinger om databasetilkobling.
• Talechat krever [voice]-seksjonen i server.toml pluss ressurser som implementerer talekanal-logikk. Konfigurasjonen alene setter kun opp infrastrukturen.

Ytelsesproblemer

• Profiler ressursene dine for kostbare operasjoner (tunge løkker, synkrone databasekall, overdreven entitetsoppretting).
• Bruk alt.setInterval og alt.setTimeout sparsomt. Tunge operasjoner per tick er den vanligste ytelsesdreperen.
• Overvåk GPanel-ressursgrafene for CPU- og RAM-bruk.
• Vurder å oppgradere serverplanen din for høye spillerantall. Opprett en supportsak for å diskutere alternativer.

---

Relaterte artikler

• alt:V Oppsettsveiledning for server — Førstegangsoppsett, server.toml-konfigurasjon, talechat og tilkoblingsinstruksjoner
• Hvordan finne server-IP og port
• Hvordan laste opp filer via SFTP
• Veiledning for serveroppstart — Generell veiledning for å starte enhver spillserver på Legion Hosting

---

Trenger du mer hjelp?

Hvis du opplever problemer som ikke dekkes i denne veiledningen, er supportteamet vårt tilgjengelig for å hjelpe. Opprett en sak på legionhosting.net/submitticket.php med serverdetaljene dine, en beskrivelse av problemet og eventuelle relevante feilmeldinger fra GPanel-konsollen.