See juhend käsitleb ressursside arendamist, andmebaasi seadistamist, administreerimistööriistu, mängijate haldamist, sõidukite ja relvade haldamist ning tõrkeotsingut teie alt:V serveri jaoks Legion Hosting platvormil. Esmase serveri seadistamise, server.toml konfiguratsiooni ja ühendamisjuhiste jaoks vaadake alt:V serveri seadistamise juhendit.

---

Administraatori seadistamine

alt:V-l puudub sisseehitatud administraatorisüsteem. Administraatorifunktsionaalsus rakendatakse ressursside (skriptide) kaudu, mille loote või installite. Enamik mängurežiime rakendab oma administraatorisüsteemi õiguste tasemete, rollide ja administraatorikäskudega.

Levinumad administraatori lähenemisviisid

• Andmebaasipõhised rollid: Enamik rollimängu ja mängurežiimi raamistikke salvestab administraatorirollid andmebaasi. Administraatoritele määratakse rollid (nt moderaator, admin, superadmin), mis annavad erinevaid õiguste tasemeid.
• Konfiguratsioonipõhised administraatorid: Lihtsamad seadistused võivad kasutada konfiguratsioonifaili, mis loetleb administraatorite Steam ID-d või alt:V ID-d koos nende õiguste tasemetega.
• Konsooli käsud: GPanel serverikonsoolis on alati täielik juurdepääs. Saate kirjutada serveripoolseid skripte, mis aktsepteerivad konsooli sisendit administraatoritoimingute jaoks.

Administraatori ressursi seadistamine

1. Valige või arendage administraatori ressurss, mis sobib teie mängurežiimiga.
2. Laadige ressurss üles resources/ kataloogi Files vahekaardi või SFTP kaudu.
3. Lisage ressursi nimi resources massiivi failis server.toml.
4. Konfigureerige administraatori ressurss (määrake oma administraatori Steam/alt:V ID-d, õiguste tasemed jne).
5. Taaskäivitage server.

---

Ressursside süsteem

Ressursid on alt:V serverite peamised ehitusplokid. Iga ressurss on iseseisev moodul, mis võib sisaldada serveripoolset koodi, kliendipoolset koodi või mõlemat. Ressursid on kirjutatud JavaScript, TypeScript või C# keeles.

Ressursi struktuur

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 konfiguratsioon

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

Väljad: type (js või csharp), main (serveripoolne sisenemispunkt), client-main (kliendipoolne sisenemispunkt, töötab mängija GTA V-s), client-files (kliendile saadetavad failid, toetab glob-mustreid), deps (teised ressursid, mis tuleb esmalt laadida).

---

Ressursside installimine

Eelvalmistatud ressursi installimiseks oma serverisse:

1. Laadige alla ressursi failid (tavaliselt kaust, mis sisaldab resource.toml ja skriptifaile).
2. Peatage oma server GPanel-is.
3. Laadige ressursi kaust üles resources/ kataloogi Files vahekaardi või SFTP kaudu.
4. Lisage ressursi kausta nimi resources massiivi failis server.toml:

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

5. Kui ressursil on sõltuvused, veenduge, et need on samuti installitud ja loetletud.
6. Konfigureerige ressurss vastavalt selle dokumentatsioonile (konfiguratsioonifailid, andmebaasi seadistamine jne).
7. Käivitage server. Kontrollige konsoolist ressursside laadimise teateid ja võimalikke vigu.

Ressursi eemaldamine

1. Peatage oma server.
2. Eemaldage ressursi nimi resources massiivist failis server.toml.
3. Valikuliselt kustutage ressursi kaust kataloogist resources/.
4. Käivitage server.

---

Andmebaasi seadistamine

Enamik alt:V mängurežiime vajab andmebaasi mängijate andmete, sõidukite, inventaride ja muu püsiva teabe salvestamiseks. Kaks levinumat andmebaasisüsteemi alt:V jaoks on MongoDB ja MySQL/MariaDB.

MongoDB

MongoDB on NoSQL dokumendiandmebaas, mida kasutatakse tavaliselt JavaScript/TypeScript ressurssidega. Kasutage hallatavat teenust nagu MongoDB Atlas (tasuta tase saadaval) või ise majutatud instantsi. Hankige oma ühendusstring (nt mongodb+srv://user:[email protected]/mydb) ja konfigureerige see oma ressursi konfiguratsioonifailis. Node.js ressursid kasutavad mongodb npm paketti.

MySQL / MariaDB

MySQL-i kasutatakse tavaliselt C# ressurssidega ja mõnede JavaScript raamistike puhul. Hankige andmebaas hallatavalt teenuselt või ise majutatud instantsist, konfigureerige oma ressursid ühenduse andmetega (host, port, kasutajanimi, parool, andmebaasi nimi) ja käivitage vajalikud SQL-i migratsiooni skriptid.

---

Mängijate haldamine

Mängijate haldamine alt:V-s toimub teie ressursside kaudu. Levinumad toimingud hõlmavad:

Mängijate tuvastamine

alt:V pakub igale ühendatud mängijale mitmeid identifikaatoreid:

Väljasaatmine ja keelamine

Rakendage väljasaatmise ja keelamise funktsionaalsus oma ressurssides:

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

---

Sõidukite ja relvade haldamine

Sõidukeid ja relvi hallatakse serveripoolsete skriptide kaudu. alt:V annab teile täieliku kontrolli sõidukite ja relvade loomise, muutmise ja eemaldamise üle.

Sõidukite loomine

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

Relvade andmine

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

// Remove all weapons
player.removeAllWeapons();

Sõidukite püsivus

Vaikimisi eksisteerivad sõidukid ainult serveri mälus ja lähevad taaskäivitamisel kaotsi. Sõidukite säilitamiseks taaskäivituste vahel salvestage nende andmed (mudel, asukoht, modifikatsioonid, omanik) andmebaasi ja looge need serveri käivitamisel uuesti.

---

Tõrkeotsing

Ressursid ei laadi

• Kontrollige, et ressursi nimi failis server.toml vastab täpselt kausta nimele kataloogis resources/.
• Veenduge, et ressursil on kehtiv resource.toml fail õigete type ja main väljadega.
• Kontrollige konsoolist veateateid ressursside laadimise ajal. Süntaksivead skriptides takistavad ressursi käivitumist.
• Veenduge, et kõik deps väljal loetletud sõltuvused on installitud ja laaditud.
• Kontrollige, et failis server.toml on laaditud õige moodul (js-module JavaScripti jaoks, csharp-module C# jaoks).

Mängijad ei saa ühenduda

• Veenduge, et server töötab ja kuvatakse GPanel-is võrgus olevana.
• Kontrollige, et mängijad kasutavad alt:V käivitajat, mitte tavalist GTA V käivitajat.
• Veenduge, et alt:V serveri haru vastab mängijate omale (release, rc või dev). Mittevastavad harud takistavad ühendusi.
• Kui server on parooliga kaitstud, veenduge, et mängijad sisestavad õige parooli.
• Laske mängijatel proovida otseühendust IP ja pordiga. Vaadake Kuidas leida oma serveri IP-d ja porti.

Serveri kokkujooksmised

• Kontrollige konsoolist veateateid enne kokkujooksmist.
• Vigased ressursid on kõige levinum kokkujooksmiste põhjus. Keelake hiljuti lisatud ressursid probleemi isoleerimiseks.
• Veenduge, et teie serveri failid on ajakohased. Vajadusel käivitage uuesti installimine Startup vahekaardilt.
• Mälulekked ressurssides võivad põhjustada serveri RAM-i ammendumise aja jooksul. Jälgige GPanel-i ressursigraafikutel pidevalt kasvavat mälukasutust.

Andmebaasi ja häälvestluse probleemid

• Kontrollige andmebaasi autentimisandmeid ja ühendusstringe. MongoDB Atlas puhul lisage oma serveri IP võrgujuurdepääsu lubatud nimekirja.
• Kontrollige konsoolist andmebaasi ühenduse veateateid.
• Häälvestlus nõuab [voice] sektsiooni failis server.toml ning ressursse, mis rakendavad häälkanali loogikat. Ainult konfiguratsioon seadistab infrastruktuuri.

Jõudlusprobleemid

• Profiilake oma ressursse kulukate operatsioonide osas (rasked tsüklid, sünkroonsed andmebaasikutsed, liigne olemite loomine).
• Kasutage alt.setInterval ja alt.setTimeout säästlikult. Rasked kaadrikaupa toimingud on kõige levinum jõudluse tapja.
• Jälgige GPanel-i ressursigraafikutel CPU ja RAM kasutust.
• Kaaluge serveriplaani uuendamist suure mängijate arvu korral. Avage tugiteenuse pilet valikute arutamiseks.

---

Seotud artiklid

• alt:V serveri seadistamise juhend — Esmane seadistamine, server.toml konfiguratsioon, häälvestlus ja ühendamisjuhised
• Kuidas leida oma serveri IP-d ja porti
• Kuidas üles laadida faile SFTP kaudu
• Serveri käivitamise juhend — Üldine juhend mis tahes mänguserveri käivitamiseks Legion Hosting platvormil

---

Vajate rohkem abi?

Kui teil esineb probleeme, mida see juhend ei kata, on meie tugimeeskond valmis aitama. Avage pilet aadressil legionhosting.net/submitticket.php oma serveri andmete, probleemi kirjelduse ja kõigi asjakohaste veateadetega GPanel konsoolist.