txAdmin: prvé nastavenie FiveM servera

txAdmin je webový panel na správu FiveM servera: nasadí server z hotového receptu, stráži ho a reštartuje, spravuje adminov, bany a whitelist. Prejdeme prvé spustenie od PINu až po bežiaci server a vysvetlíme každé pole sprievodcu.

Ako txAdmin funguje#

txAdmin je súčasťou každého FiveM servera (FXServera), nič sa nesťahuje zvlášť. Keď sa FXServer spustí bez parametra +exec server.cfg, namiesto samotnej hry nabehne txAdmin. Ten potom hru spúšťa, sleduje a pri páde alebo zamrznutí ju sám znova spustí.

• Svoje dáta (účty adminov, nastavenia, logy, databázu hráčov a banov) si txAdmin ukladá do priečinka txData.
• Webové rozhranie beží na vlastnom porte. Predvolený port je 40120, u nás môže byť iný.
• Rozhranie je anglicky. Názvy tlačidiel v návode uvádzame presne, ako ich uvidíte.

Otvorenie txAdminu#

1. V zákazníckom účte otvorte Moje služby, kliknite na FiveM server a prejdite na záložku Konzola.

2. Ak server nebeží, kliknite na Spustiť.

3. Počkajte na rámček s textom All ready! Please access:.

   All ready! Please access:
   http://your-public-ip:40120/
   
   Use the PIN below to register:
   1234

   • Riadok pod All ready! Please access: je adresa txAdminu. Dôležitý je z nej port (číslo za dvojbodkou).
   • Pod Use the PIN below to register: je štvormiestny PIN na prvé prihlásenie. Zobrazuje sa, kým nevytvoríte prvého admina.

4. Do prehliadača napíšte adresu http://<IP_ADRESA>:<PORT_TXADMINU>/.

   Za <IP_ADRESA> dosaďte IP adresu zo záložky Sieť (z riadka Adresa na pripojenie iba časť pred dvojbodkou, napríklad 203.0.113.10). Za <PORT_TXADMINU> dosaďte port z rámčeka v konzole. Celá adresa potom vyzerá napríklad http://203.0.113.10:40120/.

   Ak namiesto IP adresy vidíte šrafovaný pruh, je zapnutý režim streamu. Kliknite hore na Zobraziť údaje. Režim streamu zakrýva IP adresy aj vo výpise konzoly, a to vrátane portu za nimi. Port txAdminu potom prečítate z riadka http://your-public-ip:<PORT>/, alebo údaje zobrazte.

   Port txAdminu zatiaľ neprideľujeme automaticky. Keď ho nevidíte v záložke Sieť (Adresa na pripojenie alebo Ďalšie porty), napíšte nám o port pre txAdmin (kontakty). Bez neho sa txAdmin z prehliadača neotvorí.

Ak sa rámček neobjaví a konzola rovno vypisuje načítanie resources (Started resource …), txAdmin je vypnutý. Zapnete ho v záložke Nastavenia › Premenné premennou pre txAdmin (1 = zapnuté, 0 = vypnuté) a reštartom servera. Ak takú premennú nevidíte, napíšte nám (kontakty).

Prepojenie s účtom Cfx.re a heslo#

Prvým prihlásením vytvoríte hlavného admina (Master). Ten má všetky oprávnenia a ako jediný sa nedá zmazať.

1. Na stránke No Cfx.re account linked zadajte PIN z konzoly (Type in the PIN from the terminal.).

2. Kliknite na Link Account.

3. Prihláste sa účtom Cfx.re a potvrďte prístup tlačidlom Yes, Allow.

   Vrátite sa do txAdminu na registračný formulár.

4. Vyplňte formulár:

   Pole	Čo zadať	Prečo
   Discord ID	Nepovinné. Vaše číselné ID používateľa na Discorde.	Prepojí admina s Discordom (whitelist, príkazy bota txAdminu). Dá sa doplniť neskôr.
   Backup Password	Heslo s dĺžkou 6–⁠128 znakov. Použite generátor hesiel.	Záložné prihlásenie, keď prihlásenie cez Cfx.re nefunguje.
   Confirm Password	Rovnaké heslo znova.	Kontrola preklepu.

5. Zaškrtnite súhlas s licenčnými podmienkami (Creator PLA) a kliknite na Register.

   Otvorí sa sprievodca nastavením servera.

Sprievodca nastavením servera#

Server Name#

Krátky názov servera pre rozhranie txAdminu a správy v chate a na Discorde, napríklad Muj RP server. Pole prijme najviac 18 znakov. Nie je to názov v zozname serverov FiveM (ten sa nastavuje v server.cfg). Kliknite na Next.

Deployment Type#

Pre prvý server zvoľte Popular Recipes a vyberte recept:

• Základný recept (v zozname ako FiveM Basic Server alebo CFX Default FiveM, podľa verzie txAdminu) – minimálny server bez frameworku a bez databázy. Hodí sa na vyskúšanie, freeroam a drift servery.
• ESX Legacy, QBCore Framework, Qbox Framework – roleplay frameworky. Potrebujú databázu. Rozdiely a výber nájdete v návode ESX, QBCore, alebo Qbox?.

Priečinok pre dáta servera#

txAdmin navrhne, kam server nasadiť, typicky do txData/<NAZEV>_<KOD>.base. Navrhnutú cestu ponechajte (We strongly recommend using the path suggested below.) a kliknite na Save. Do tohto priečinka sa uloží server.cfg a resources.

Na poslednej obrazovke (We are almost there!) kliknite na Go to Recipe Deployer. Než budete pokračovať, pripravte si databázu (ďalšia časť).

Príprava databázy#

Recepty frameworkov (ESX, QBCore, Qbox) potrebujú databázu. Než budete v txAdmine pokračovať, vytvorte ju v zákazníckom účte. Základný recept databázu nepotrebuje, túto časť potom preskočte.

1. V zákazníckom účte prejdite na záložku Databázy.

2. Do poľa Názov databázy napíšte napríklad fivem (iba písmená, číslice a podčiarkovník).

3. Pole Povolený prístup z nechajte %. Znak % znamená „odkiaľkoľvek“, server aj váš počítač sa tak k databáze pripoja.

4. Kliknite na Vytvoriť databázu.

   V zozname uvidíte Názov databázy, Používateľ, Server a Heslo. Údaje si nechajte otvorené, o chvíľu ich odpíšete do txAdminu. Názov databázy odpíšte presne zo zoznamu, môže sa líšiť od toho, čo ste napísali.

Nasadenie receptu (Server Deployer)#

Step 1: Review Recipe#

txAdmin ukáže obsah receptu: čo stiahne, kam to uloží a aké SQL spustí. Spúšťajte iba recepty z dôveryhodných zdrojov (Only run Recipes from trusted sources!). Kliknite na Next.

Step 2: Input Parameters#

Databázové polia sa zobrazia po kliknutí na Show/Hide Database options (advanced). Potom kliknite na Run Recipe.

Step 3: Run Recipe#

txAdmin sťahuje súbory a importuje SQL. Pri veľkých receptoch (QBCore, Qbox) to trvá aj niekoľko minút. Po dokončení kliknite na Next.

Step 4: Configure server.cfg#

Uvidíte vygenerovaný server.cfg. Teraz skontrolujte a upravte tri veci, ostatné vysvetľuje návod server.cfg riadok po riadku:

• endpoint_add_tcp a endpoint_add_udp – port za dvojbodkou musí byť port hry z riadka Adresa na pripojenie v záložke Sieť (číslo za dvojbodkou). Ak txAdmin nedostal port od hostingu, zapíše predvolený 30120. Keď sa líši, prepíšte ho v oboch riadkoch, inak sa hráči nepripoja.
• sv_hostname a sets sv_projectName – názov servera v zozname serverov.
• sets locale "root-AQ" – zmeňte na sets locale "sk-SK", aby bol server v zozname označený ako slovenský.

Kliknite na Save & Run Server. Server sa spustí a txAdmin otvorí Live Console.

Overenie#

• V txAdmine na stránke Dashboard je server v stave online a v Live Console nie sú červené chyby.
• V hre stlačte F8, napíšte connect <IP_ADRESA>:<PORT> (adresa z riadka Adresa na pripojenie v záložke Sieť) a pripojte sa.
• V hre napíšte do chatu /tx (alebo /txadmin): otvorí sa menu txAdminu. Funguje iba adminom, ktorí majú v txAdmine vyplnené Cfx.re alebo Discord ID. Kláves pre menu si môžete nastaviť v hre v Game Settings › Key Bindings › FiveM (položka (txAdmin) Menu: Open Main Page).

Správa adminov#

1. V hornom menu kliknite na Admins.

2. Kliknite na Add.

3. Vyplňte formulár:

   Pole	Čo zadať
   Username	Používateľské meno na prihlásenie do txAdminu. Ak vyplníte Cfx.re ID, musí sa zhodovať s menom na fóre Cfx.re.
   Cfx.re ID	Nepovinné. Používateľské meno na forum.cfx.re (otvorí sa v novom okne). Umožní prihlásenie tlačidlom Cfx.re a menu /tx v hre.
   Discord ID	Nepovinné. Číselné ID používateľa na Discorde.
   Permissions	Zaškrtnite iba to, čo človek naozaj potrebuje (tabuľka nižšie).

4. Uložte. txAdmin ukáže dočasné heslo, pošlite ho adminovi. Pri prvom prihlásení si ho musí zmeniť.

Oprávnenia sa ukladajú do súboru txData/admins.json. Admin txAdminu nie je automaticky admin frameworku (ESX, QBCore). Ako dať práva vo frameworku, opisuje návod ESX, QBCore, alebo Qbox?.

Plánované reštarty#

Pravidelný reštart (raz až dvakrát denne) uvoľní pamäť a vyčistí rozbitý stav skriptov. txAdmin hráčov vopred upozorní.

1. V hornom menu kliknite na Settings a otvorte záložku FXServer.
2. V položke Restart Schedule kliknite na tlačidlo +. V okne Add Restart Time zadajte čas, napríklad 06:00. Namiesto toho môžete kliknúť na hotovú predvoľbu (1x/day, 2x/day …).
3. Uložte nastavenia.

Čas sa počíta podľa času servera, nie podľa vášho počítača (Make sure your schedule matches your server time and not your local time.). Ak txAdmin ukáže varovanie o časovom pásme, posuňte čas o rozdiel.

Užitočné časti txAdminu#

Keď niečo nefunguje#

Stránka txAdminu sa nenačíta#

• Skontrolujte, že server beží a v konzole je rámček All ready! Please access:.
• Použite IP adresu zo záložky Sieť a port z rámčeka. Adresa začína http://, nie https://.
• Ak prehliadač adresu sám mení na https://, napíšte ju ručne aj s http://.
• Port txAdminu musí byť medzi portami servera v záložke Sieť (Adresa na pripojenie alebo Ďalšie porty). Ak ho tam nevidíte, napíšte nám.

PIN nefunguje#

PIN sa vytvorí znova pri každom štarte, kým nemáte prvého admina. Použite PIN z posledného výpisu konzoly. Po vytvorení admina sa už nezobrazuje, prihlasujte sa tlačidlom Cfx.re alebo heslom.

Zabudol som heslo#

Prihláste sa tlačidlom Cfx.re. Keď nefunguje ani to a ste jediný admin, napíšte nám. Zmazaním súboru txData/admins.json sa txAdmin vráti k PINu, ale prídete o všetky účty adminov.

Task Failed: Response code 403 (rate limit exceeded)#

Recept sťahuje desiatky repozitárov z GitHubu a GitHub dočasne obmedzil počet stiahnutí. Počkajte asi hodinu a spustite nasadenie znova.

Recept skončí chybou databázy (ER_ACCESS_DENIED_ERROR, ECONNREFUSED)#

• ER_ACCESS_DENIED_ERROR – nesprávny používateľ alebo heslo. Skopírujte ich znova zo záložky Databázy, bez medzier na začiatku a konci.
• ECONNREFUSED alebo vypršanie času – nesprávna adresa alebo port. Do Database Host patrí IP adresa z poľa Server, nie localhost.
• ER_BAD_DB_ERROR – názov databázy nesedí. Odpíšte ho presne zo zoznamu databáz.

Ďalšie chyby databázy rieši návod Databáza pre FiveM.

Server po nasadení nenabehne#

Najčastejšie chýba alebo nesedí license key (Could not authenticate server license key). Opravte ho v CFG Editore podľa návodu license key. Ostatné chyby nájdete v návode Časté chyby FiveM.

Hráči sa nepripoja, aj keď txAdmin hlási online#

Hráči sa pripájajú na port hry z riadka Adresa na pripojenie, nie na port txAdminu. Skontrolujte v CFG Editore riadky endpoint_add_tcp a endpoint_add_udp: oba musia mať port z Adresy na pripojenie, nie predvolený 30120 z receptu (ak to práve nie je váš port). Po oprave server reštartujte. Viac v návode server.cfg.

Ďalšie zdroje#

• FiveM: Setting up a server using txAdmin (otvorí sa v novom okne)
• FiveM: txAdmin a jeho oprávnenia (otvorí sa v novom okne)
• txAdmin na GitHube (dokumentácia receptov a premenných) (otvorí sa v novom okne)