Ovaj vodič pokriva razvoj resursa, postavljanje baze podataka, administratorske alate, upravljanje igračima, upravljanje vozilima i oružjem te rješavanje problema za vaš alt:V server na Legion Hosting. Za početno postavljanje servera, konfiguraciju server.toml i upute za povezivanje, pogledajte alt:V Vodič za Postavljanje Servera.

---

Postavljanje Administratora

alt:V nema ugrađeni sustav administracije. Administratorska funkcionalnost implementira se putem resursa (skripti) koje kreirate ili instalirate. Većina modova igre implementira vlastiti sustav administracije s razinama dozvola, ulogama i administratorskim naredbama.

Uobičajeni Pristupi Administraciji

• Uloge temeljene na bazi podataka: Većina roleplay i gamemode okvira pohranjuje administratorske uloge u bazu podataka. Administratorima se dodjeljuju uloge (npr. moderator, admin, superadmin) koje daju različite razine dozvola.
• Administratori temeljeni na konfiguraciji: Jednostavnija postavljanja mogu koristiti konfiguracijsku datoteku s popisom administratorskih Steam ID-ova ili alt:V ID-ova s njihovim razinama dozvola.
• Naredbe konzole: GPanel konzola servera uvijek ima potpuni pristup. Možete pisati skripte na strani servera koje prihvaćaju unos putem konzole za administratorske operacije.

Postavljanje Administratorskog Resursa

1. Odaberite ili razvijte administratorski resurs koji odgovara vašem modu igre.
2. Prenesite resurs u direktorij resources/ putem kartice Files ili SFTP.
3. Dodajte naziv resursa u polje resources u server.toml.
4. Konfigurirajte administratorski resurs (postavite svoje administratorske Steam/alt:V ID-ove, razine dozvola itd.).
5. Ponovno pokrenite server.

---

Sustav Resursa

Resursi su temeljni građevni blokovi alt:V servera. Svaki resurs je samostalni modul koji može sadržavati kod na strani servera, kod na strani klijenta ili oboje. Resursi se pišu 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

Konfiguracija resource.toml

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

Polja: type (js ili csharp), main (ulazna točka na strani servera), client-main (ulazna točka na strani klijenta, pokreće se u igračevom GTA V), client-files (datoteke za slanje klijentu, podržava glob uzorke), deps (drugi resursi koji se moraju učitati prvi).

---

Instaliranje Resursa

Za instaliranje unaprijed izrađenog resursa na vaš server:

1. Preuzmite datoteke resursa (obično mapa koja sadrži resource.toml i datoteke skripti).
2. Zaustavite svoj server u GPanel.
3. Prenesite mapu resursa u resources/ putem kartice Files ili SFTP.
4. Dodajte naziv mape resursa u polje resources u server.toml:

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

5. Ako resurs ima ovisnosti, osigurajte da su i one instalirane i navedene.
6. Konfigurirajte resurs prema njegovoj dokumentaciji (konfiguracijske datoteke, postavljanje baze podataka itd.).
7. Pokrenite server. Provjerite konzolu za poruke o učitavanju resursa i eventualne greške.

Uklanjanje Resursa

1. Zaustavite svoj server.
2. Uklonite naziv resursa iz polja resources u server.toml.
3. Po želji izbrišite mapu resursa iz resources/.
4. Pokrenite server.

---

Postavljanje Baze Podataka

Većina alt:V modova igre zahtijeva bazu podataka za pohranu podataka igrača, vozila, inventara i drugih trajnih informacija. Dva najčešća sustava baza podataka za alt:V su MongoDB i MySQL/MariaDB.

MongoDB

MongoDB je NoSQL dokumentna baza podataka koja se često koristi s JavaScript/TypeScript resursima. Koristite upravljanu uslugu poput MongoDB Atlas (dostupna besplatna razina) ili vlastitu instancu. Pribavite svoju povezničku niz (npr. mongodb+srv://user:[email protected]/mydb) i konfigurirajte ga u konfiguracijskoj datoteci vašeg resursa. Node.js resursi koriste mongodb npm paket.

MySQL / MariaDB

MySQL se često koristi s C# resursima i nekim JavaScript okvirima. Pribavite bazu podataka od upravljane usluge ili vlastite instance, konfigurirajte svoje resurse s detaljima povezivanja (host, port, korisničko ime, lozinka, naziv baze podataka) i pokrenite sve potrebne SQL migracijske skripte.

---

Upravljanje Igračima

Upravljanje igračima u alt:V obavlja se putem vaših resursa. Uobičajene operacije uključuju:

Identificiranje Igrača

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

Izbacivanje i Zabrana Pristupa

Implementirajte funkcionalnost izbacivanja i zabrane pristupa 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

Vozila i oružje upravljaju se putem skripti na strani servera. alt:V vam daje potpunu kontrolu nad stvaranjem, modificiranjem 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

Prema zadanim postavkama, vozila postoje samo u memoriji servera i gube se pri ponovnom pokretanju. Za trajnost vozila između ponovnih pokretanja, pohranite njihove podatke (model, poziciju, modifikacije, vlasnika) u bazu podataka i ponovno ih kreirajte pri pokretanju servera.

---

Rješavanje Problema

Resursi se Ne Učitavaju

• Provjerite da naziv resursa u server.toml točno odgovara nazivu mape u resources/.
• Provjerite da resurs ima valjanu datoteku resource.toml s ispravnim poljima type i main.
• Provjerite konzolu za poruke o greškama tijekom učitavanja resursa. Sintaksne greške u skriptama spriječit će pokretanje resursa.
• Osigurajte da su sve ovisnosti navedene u deps instalirane i učitane.
• Provjerite da je ispravan modul učitan u server.toml (js-module za JavaScript, csharp-module za C#).

Igrači se Ne Mogu Povezati

• Provjerite da server radi i da se prikazuje kao online u GPanel.
• Provjerite da igrači koriste alt:V pokretač, a ne obični GTA V pokretač.
• Osigurajte da grana alt:V servera odgovara onoj koju igrači imaju (release, rc ili dev). Neusklađene grane sprječavaju povezivanje.
• Ako je zaštićen lozinkom, provjerite da igrači unose ispravnu lozinku.
• Neka igrači pokušaju izravno povezivanje s IP adresom i portom. Pogledajte Kako Pronaći IP Adresu i Port Vašeg Servera.

Rušenje Servera

• Provjerite konzolu za poruke o greškama prije rušenja.
• Neispravni resursi najčešći su uzrok rušenja. Onemogućite nedavno dodane resurse kako biste izolirali problem.
• Osigurajte da su datoteke vašeg servera ažurne. Pokrenite ponovnu instalaciju s kartice Startup ako je potrebno.
• Curenje memorije u resursima može uzrokovati da server ostane bez RAM-a s vremenom. Pratite GPanel grafove resursa za stalno rastuću upotrebu memorije.

Problemi s Bazom Podataka i Glasovnim Chatom

• Provjerite vjerodajnice baze podataka i povezničke nizove. Za MongoDB Atlas, dodajte IP adresu vašeg servera na popis dopuštenih u postavkama mrežnog pristupa.
• Provjerite konzolu za poruke o greškama povezivanja s bazom podataka.
• Glasovni chat zahtijeva sekciju [voice] u server.toml plus resurse koji implementiraju logiku glasovnih kanala. Sama konfiguracija samo postavlja infrastrukturu.

Problemi s Performansama

• Profilirajte svoje resurse za skupe operacije (teške petlje, sinkroni pozivi baze podataka, prekomjerno stvaranje entiteta).
• Koristite alt.setInterval i alt.setTimeout umjereno. Teške operacije po taktu najčešći su ubojica performansi.
• Pratite GPanel grafove resursa za upotrebu CPU-a i RAM-a.
• Razmotrite nadogradnju plana servera za veliki broj igrača. Otvorite zahtjev za podršku kako biste razgovarali o opcijama.

---

Povezani Članci

• alt:V Vodič za Postavljanje Servera — Početno postavljanje, konfiguracija server.toml, glasovni chat i upute za povezivanje
• Kako Pronaći IP Adresu i Port Vašeg Servera
• Kako Prenijeti Datoteke putem SFTP
• Vodič za Pokretanje Servera — Opći vodič za pokretanje bilo kojeg poslužitelja igara na Legion Hosting

---

Trebate Dodatnu Pomoć?

Ako imate problema koji nisu pokriveni ovim vodičem, naš tim za podršku dostupan je za pomoć. Otvorite zahtjev na legionhosting.net/submitticket.php s detaljima o vašem serveru, opisom problema i svim relevantnim porukama o greškama iz GPanel konzole.