Tento průvodce pokrývá vývoj zdrojů (resources), nastavení databáze, administrátorské nástroje, správu hráčů, správu vozidel a zbraní a řešení problémů pro váš alt:V server na Legion Hosting. Pro počáteční nastavení serveru, konfiguraci server.toml a pokyny k připojení si přečtěte Průvodce nastavením alt:V serveru.

---

Nastavení administrace

alt:V nemá vestavěný systém administrace. Funkce administrace se implementují prostřednictvím zdrojů (skriptů), které vytvoříte nebo nainstalujete. Většina herních módů implementuje vlastní systém administrace s úrovněmi oprávnění, rolemi a administrátorskými příkazy.

Běžné přístupy k administraci

• Role založené na databázi: Většina roleplay a herních frameworků ukládá administrátorské role v databázi. Administrátorům jsou přiřazeny role (např. moderátor, admin, superadmin), které udělují různé úrovně oprávnění.
• Administrátoři na základě konfigurace: Jednodušší nastavení mohou používat konfigurační soubor se seznamem administrátorských Steam ID nebo alt:V ID s jejich úrovněmi oprávnění.
• Konzolové příkazy: Konzole serveru v GPanel má vždy plný přístup. Můžete psát serverové skripty, které přijímají vstup z konzole pro administrátorské operace.

Nastavení administrátorského zdroje

1. Vyberte nebo vytvořte administrátorský zdroj, který odpovídá vašemu hernímu módu.
2. Nahrajte zdroj do adresáře resources/ přes záložku Files nebo SFTP.
3. Přidejte název zdroje do pole resources v server.toml.
4. Nakonfigurujte administrátorský zdroj (nastavte svá administrátorská Steam/alt:V ID, úrovně oprávnění atd.).
5. Restartujte server.

---

Systém zdrojů

Zdroje (resources) jsou základní stavební bloky alt:V serverů. Každý zdroj je samostatný modul, který může obsahovat serverový kód, klientský kód nebo obojí. Zdroje se píší v JavaScript, TypeScript nebo C#.

Struktura zdroje

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

Konfigurace resource.toml

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

Pole: type (js nebo csharp), main (vstupní bod na straně serveru), client-main (vstupní bod na straně klienta, běží v hráčově GTA V), client-files (soubory k odeslání klientovi, podporuje globy), deps (ostatní zdroje, které se mají načíst jako první).

---

Instalace zdrojů

Pro instalaci předpřipraveného zdroje na váš server:

1. Stáhněte soubory zdroje (typicky složka obsahující resource.toml a soubory skriptů).
2. Zastavte server v GPanel.
3. Nahrajte složku zdroje do resources/ přes záložku Files nebo SFTP.
4. Přidejte název složky zdroje do pole resources v server.toml:

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

5. Pokud má zdroj závislosti, ujistěte se, že jsou také nainstalovány a uvedeny v seznamu.
6. Nakonfigurujte zdroj podle jeho dokumentace (konfigurační soubory, nastavení databáze atd.).
7. Spusťte server. Zkontrolujte konzoli pro zprávy o načítání zdrojů a případné chyby.

Odebrání zdroje

1. Zastavte server.
2. Odeberte název zdroje z pole resources v server.toml.
3. Volitelně smažte složku zdroje z resources/.
4. Spusťte server.

---

Nastavení databáze

Většina alt:V herních módů vyžaduje databázi pro ukládání dat hráčů, vozidel, inventářů a dalších trvalých informací. Dva nejběžnější databázové systémy pro alt:V jsou MongoDB a MySQL/MariaDB.

MongoDB

MongoDB je NoSQL dokumentová databáze běžně používaná s JavaScript/TypeScript zdroji. Použijte spravovanou službu jako MongoDB Atlas (k dispozici je bezplatná úroveň) nebo vlastní instanci. Získejte svůj připojovací řetězec (např. mongodb+srv://user:[email protected]/mydb) a nakonfigurujte ho v konfiguračním souboru vašeho zdroje. Node.js zdroje používají balíček mongodb z npm.

MySQL / MariaDB

MySQL se běžně používá s C# zdroji a některými JavaScript frameworky. Získejte databázi od spravované služby nebo vlastní instance, nakonfigurujte své zdroje s údaji o připojení (host, port, uživatelské jméno, heslo, název databáze) a spusťte potřebné SQL migrační skripty.

---

Správa hráčů

Správa hráčů v alt:V se provádí prostřednictvím vašich zdrojů. Běžné operace zahrnují:

Identifikace hráčů

alt:V poskytuje několik identifikátorů pro každého připojeného hráče:

Vyhazování a banování

Implementujte funkce vyhazování a banování ve svých zdrojích:

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

---

Správa vozidel a zbraní

Vozidla a zbraně se spravují prostřednictvím serverových skriptů. alt:V vám dává plnou kontrolu nad spawnováním, úpravami a odebíráním vozidel a zbraní.

Spawnování vozidel

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

Udělení zbraní

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

// Remove all weapons
player.removeAllWeapons();

Trvalost vozidel

Ve výchozím nastavení vozidla existují pouze v paměti serveru a při restartu se ztratí. Pro zachování vozidel napříč restarty uložte jejich data (model, pozice, úpravy, vlastník) do databáze a znovu je vytvořte při startu serveru.

---

Řešení problémů

Zdroje se nenačítají

• Zkontrolujte, že název zdroje v server.toml přesně odpovídá názvu složky v resources/.
• Ověřte, že zdroj má platný soubor resource.toml se správnými poli type a main.
• Zkontrolujte konzoli pro chybové zprávy během načítání zdrojů. Syntaktické chyby ve skriptech zabrání spuštění zdroje.
• Ujistěte se, že všechny závislosti uvedené v deps jsou nainstalovány a načteny.
• Ověřte, že je v server.toml načten správný modul (js-module pro JavaScript, csharp-module pro C#).

Hráči se nemohou připojit

• Ověřte, že server běží a zobrazuje se jako online v GPanel.
• Zkontrolujte, že hráči používají alt:V launcher, ne běžný GTA V launcher.
• Ujistěte se, že větev alt:V serveru odpovídá tomu, co mají hráči (release, rc nebo dev). Neshodné větve zabraňují připojení.
• Pokud je server chráněn heslem, ověřte, že hráči zadávají správné heslo.
• Nechte hráče zkusit přímé připojení s IP a portem. Viz Jak najít IP adresu a port vašeho serveru.

Pády serveru

• Zkontrolujte konzoli pro chybové zprávy před pádem.
• Vadné zdroje jsou nejčastější příčinou pádů. Deaktivujte nedávno přidané zdroje pro izolaci problému.
• Ujistěte se, že soubory serveru jsou aktuální. V případě potřeby spusťte přeinstalaci ze záložky Startup.
• Úniky paměti ve zdrojích mohou způsobit, že serveru postupně dojde RAM. Sledujte grafy zdrojů v GPanel pro stále rostoucí využití paměti.

Problémy s databází a hlasovým chatem

• Ověřte přihlašovací údaje k databázi a připojovací řetězce. Pro MongoDB Atlas přidejte IP vašeho serveru do nastavení síťového přístupu na whitelist.
• Zkontrolujte konzoli pro chybové zprávy o připojení k databázi.
• Hlasový chat vyžaduje sekci [voice] v server.toml plus zdroje, které implementují logiku hlasových kanálů. Samotná konfigurace pouze nastaví infrastrukturu.

Problémy s výkonem

• Profilujte své zdroje pro náročné operace (těžké smyčky, synchronní databázová volání, nadměrné vytváření entit).
• Používejte alt.setInterval a alt.setTimeout střídmě. Náročné operace v každém tiktu jsou nejčastějším zabijákem výkonu.
• Sledujte grafy zdrojů v GPanel pro využití CPU a RAM.
• Zvažte upgrade vašeho serverového plánu pro vysoké počty hráčů. Otevřete tiket podpory pro projednání možností.

---

Související články

• Průvodce nastavením alt:V serveru — Počáteční nastavení, konfigurace server.toml, hlasový chat a pokyny k připojení
• Jak najít IP adresu a port vašeho serveru
• Jak nahrát soubory přes SFTP
• Průvodce spuštěním serveru — Obecný průvodce pro spuštění jakéhokoliv herního serveru na Legion Hosting

---

Potřebujete další pomoc?

Pokud máte problémy, které tento průvodce nepokrývá, náš tým podpory je k dispozici. Otevřete tiket na legionhosting.net/submitticket.php s údaji o vašem serveru, popisem problému a příslušnými chybovými zprávami z konzole GPanel.