Ovaj vodič pokriva razvoj resursa, podešavanje baze podataka, admin alate, upravljanje igračima, upravljanje vozilima i oružjem, kao i rešavanje problema za vaš alt:V server na Legion Hosting. Za početno podešavanje servera, konfiguraciju server.toml i uputstva za povezivanje, pogledajte Vodič za podešavanje alt:V servera.

---

Admin podešavanje

alt:V nema ugrađen admin sistem. Admin funkcionalnost se implementira kroz resurse (skripte) koje kreirate ili instalirate. Većina gamemode-ova implementira sopstveni admin sistem sa nivoima dozvola, ulogama i admin komandama.

Uobičajeni admin pristupi

• Uloge zasnovane na bazi podataka: Većina roleplay i gamemode okvira čuva admin uloge u bazi podataka. Administratorima se dodeljuju uloge (npr. moderator, admin, superadmin) koje daju različite nivoe dozvola.
• Administratori zasnovani na konfiguraciji: Jednostavnija podešavanja mogu koristiti konfiguracioni fajl koji navodi admin Steam ID-ove ili alt:V ID-ove sa njihovim nivoima dozvola.
• Konzolne komande: GPanel konzola servera uvek ima pun pristup. Možete pisati skripte na strani servera koje prihvataju unos iz konzole za admin operacije.

Podešavanje admin resursa

1. Izaberite ili razvijte admin resurs koji odgovara vašem gamemode-u.
2. Otpremite resurs u direktorijum resources/ preko kartice Files ili SFTP-a.
3. Dodajte ime resursa u resources niz u server.toml.
4. Konfigurišite admin resurs (postavite svoje admin Steam/alt:V ID-ove, nivoe dozvola, itd.).
5. Restartujte server.

---

Sistem resursa

Resursi su osnovni građevni blokovi alt:V servera. Svaki resurs je samostalni modul koji može sadržati kod na strani servera, kod na strani klijenta ili oba. Resursi su napisani u JavaScript, TypeScript ili C#.

Struktura resursa

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 konfiguracija

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

Polja: type (js ili csharp), main (ulazna tačka na strani servera), client-main (ulazna tačka na strani klijenta, radi u igračevom GTA V), client-files (fajlovi koji se šalju klijentu, podržava glob obrasce), deps (drugi resursi koji se učitavaju prvi).

---

Instaliranje resursa

Da biste instalirali unapred izgrađen resurs na svoj server:

1. Preuzmite fajlove resursa (obično folder koji sadrži resource.toml i fajlove skripti).
2. Zaustavite svoj server u GPanel-u.
3. Otpremite folder resursa u resources/ preko kartice Files ili SFTP-a.
4. Dodajte ime foldera resursa u resources niz u server.toml:

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

5. Ako resurs ima zavisnosti, uverite se da su i one instalirane i navedene.
6. Konfigurišite resurs prema njegovoj dokumentaciji (konfiguracioni fajlovi, podešavanje baze podataka, itd.).
7. Pokrenite server. Proverite konzolu za poruke o učitavanju resursa i bilo kakve greške.

Uklanjanje resursa

1. Zaustavite svoj server.
2. Uklonite ime resursa iz resources niza u server.toml.
3. Opciono izbrišite folder resursa iz resources/.
4. Pokrenite server.

---

Podešavanje baze podataka

Većina alt:V gamemode-ova zahteva bazu podataka za čuvanje podataka o igračima, vozilima, inventarima i drugih trajnih informacija. Dva najčešća sistema baza podataka za alt:V su MongoDB i MySQL/MariaDB.

MongoDB

MongoDB je NoSQL dokument baza podataka koja se obično koristi sa JavaScript/TypeScript resursima. Koristite upravljanu uslugu kao što je MongoDB Atlas (besplatni nivo dostupan) ili samostalno hostovanu instancu. Nabavite svoj connection string (npr. mongodb+srv://user:[email protected]/mydb) i konfigurišite ga u konfiguracionom fajlu vašeg resursa. Node.js resursi koriste mongodb npm paket.

MySQL / MariaDB

MySQL se obično koristi sa C# resursima i nekim JavaScript okvirima. Nabavite bazu podataka od upravljane usluge ili samostalno hostovane instance, konfigurišite svoje resurse sa detaljima veze (host, port, korisničko ime, lozinka, ime baze podataka) i pokrenite sve potrebne SQL migracione skripte.

---

Upravljanje igračima

Upravljanje igračima u alt:V obavlja se kroz vaše resurse. Uobičajene operacije uključuju:

Identifikacija igrača

alt:V pruža nekoliko identifikatora za svakog povezanog igrača:

Izbacivanje i banovanje

Implementirajte funkcionalnost izbacivanja i banovanja u svojim resursima:

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

---

Upravljanje vozilima i oružjem

Vozilima i oružjem upravlja se kroz skripte na strani servera. alt:V vam daje punu kontrolu nad stvaranjem, modifikovanjem i uklanjanjem vozila i oružja.

Stvaranje vozila

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

Davanje oružja

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

// Remove all weapons
player.removeAllWeapons();

Trajnost vozila

Podrazumevano, vozila postoje samo u memoriji servera i gube se pri restartu. Da biste sačuvali vozila kroz restartove, čuvajte njihove podatke (model, poziciju, modifikacije, vlasnika) u bazi podataka i ponovo ih kreirajte pri pokretanju servera.

---

Rešavanje problema

Resursi se ne učitavaju

• Proverite da li se ime resursa u server.toml tačno podudara sa imenom foldera u resources/.
• Verifikujte da resurs ima validan resource.toml fajl sa ispravnim type i main poljima.
• Proverite konzolu za poruke o greškama tokom učitavanja resursa. Sintaksne greške u skriptama sprečiće pokretanje resursa.
• Uverite se da su sve zavisnosti navedene u deps instalirane i učitane.
• Verifikujte da je ispravan modul učitan u server.toml (js-module za JavaScript, csharp-module za C#).

Igrači se ne mogu povezati

• Verifikujte da server radi i da se prikazuje kao na mreži u GPanel-u.
• Proverite da li igrači koriste alt:V launcher, a ne običan GTA V launcher.
• Uverite se da se alt:V server grana podudara sa onim što igrači imaju (release, rc ili dev). Nepodudarne grane sprečavaju povezivanje.
• Ako je zaštićeno lozinkom, verifikujte da igrači unose ispravnu lozinku.
• Neka igrači pokušaju direktno povezivanje sa IP adresom i portom. Pogledajte Kako pronaći IP adresu i port vašeg servera.

Padovi servera

• Proverite konzolu za poruke o greškama pre pada.
• Neispravni resursi su najčešći uzrok padova. Onemogućite nedavno dodate resurse da izolujete problem.
• Uverite se da su vaši fajlovi servera ažurirani. Pokrenite reinstalaciju sa kartice Startup ako je potrebno.
• Curenje memorije u resursima može izazvati da serveru ponestane RAM-a tokom vremena. Pratite GPanel grafikone resursa za postojano povećanje korišćenja memorije.

Problemi sa bazom podataka i glasom

• Verifikujte kredencijale baze podataka i connection string-ove. Za MongoDB Atlas, dodajte IP adresu vašeg servera na belu listu u postavkama mrežnog pristupa.
• Proverite konzolu za poruke o greškama veze sa bazom podataka.
• Glasovni chat zahteva [voice] sekciju u server.toml plus resurse koji implementiraju logiku glasovnih kanala. Sama konfiguracija samo postavlja infrastrukturu.

Problemi sa performansama

• Profilišite svoje resurse za skupe operacije (teške petlje, sinhroni pozivi baze podataka, prekomerno kreiranje entiteta).
• Koristite alt.setInterval i alt.setTimeout štedljivo. Teške operacije po tiku su najčešći ubica performansi.
• Pratite GPanel grafikone resursa za korišćenje CPU-a i RAM-a.
• Razmotrite nadogradnju plana servera za veliki broj igrača. Otvorite tiket za podršku da biste razgovarali o opcijama.

---

Povezani članci

• Vodič za podešavanje alt:V servera — Početno podešavanje, server.toml konfiguracija, glasovni chat i uputstva za povezivanje
• Kako pronaći IP adresu i port vašeg servera
• Kako otpremiti fajlove preko SFTP-a
• Vodič za pokretanje servera — Opšti vodič za pokretanje bilo kog game servera na Legion Hosting

---

Potrebna vam je dodatna pomoć?

Ako imate probleme koji nisu obrađeni u ovom vodiču, naš tim za podršku je dostupan da pomogne. Otvorite tiket na legionhosting.net/submitticket.php sa detaljima vašeg servera, opisom problema i bilo kojim relevantnim porukama o greškama iz GPanel konzole.