txAdmin: první nastavení FiveM serveru

txAdmin je webový panel pro správu FiveM serveru: nasadí server z hotového receptu, hlídá ho a restartuje, spravuje adminy, bany a whitelist. Projdeme první spuštění od PINu až po běžící server a vysvětlíme každé pole průvodce.

Jak txAdmin funguje#

txAdmin je součástí každého FiveM serveru (FXServeru), nic se nestahuje zvlášť. Když se FXServer spustí bez parametru +exec server.cfg, místo samotné hry naběhne txAdmin. Ten pak hru spouští, sleduje a při pádu nebo zamrznutí ji sám znovu spustí.

• Svá data (účty adminů, nastavení, logy, databázi hráčů a banů) si txAdmin ukládá do složky txData.
• Webové rozhraní běží na vlastním portu. Výchozí port je 40120, u nás může být jiný.
• Rozhraní je anglicky. Názvy tlačítek v návodu uvádíme přesně, jak je uvidíte.

Otevření txAdminu#

1. V zákaznické zóně otevřete Moje služby, klikněte na FiveM server a přejděte na záložku Konzole.

2. Pokud server neběží, klikněte na Spustit.

3. Počkejte na rámeček s textem All ready! Please access:.

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

   • Řádek pod All ready! Please access: je adresa txAdminu. Důležitý je z ní port (číslo za dvojtečkou).
   • Pod Use the PIN below to register: je čtyřmístný PIN pro první přihlášení. Zobrazuje se, dokud nevytvoříte prvního admina.

4. Do prohlížeče napište adresu http://<IP_ADRESA>:<PORT_TXADMINU>/.

   Za <IP_ADRESA> dosaďte IP adresu ze záložky Síť (z řádku Adresa pro připojení jen část před dvojtečkou, například 203.0.113.10). Za <PORT_TXADMINU> dosaďte port z rámečku v konzoli. Celá adresa pak vypadá například http://203.0.113.10:40120/.

   Pokud místo IP adresy vidíte šrafovaný pruh, je zapnutý režim streamu. Klikněte nahoře na Zobrazit údaje. Režim streamu zakrývá IP adresy i ve výpisu konzole, a to včetně portu za nimi. Port txAdminu pak přečtete z řádku http://your-public-ip:<PORT>/, nebo údaje zobrazte.

   Port txAdminu zatím nepřidělujeme automaticky. Když ho nevidíte v záložce Síť (Adresa pro připojení nebo Další porty), napište nám o port pro txAdmin (kontakty). Bez něj se txAdmin z prohlížeče neotevře.

Pokud se rámeček neobjeví a konzole rovnou vypisuje načítání resources (Started resource …), txAdmin je vypnutý. Zapnete ho v záložce Nastavení › Proměnné proměnnou pro txAdmin (1 = zapnuto, 0 = vypnuto) a restartem serveru. Pokud takovou proměnnou nevidíte, napište nám (kontakty).

Propojení s účtem Cfx.re a heslo#

Prvním přihlášením vytvoříte hlavního admina (Master). Ten má všechna oprávnění a jako jediný ho nejde smazat.

1. Na stránce No Cfx.re account linked zadejte PIN z konzole (Type in the PIN from the terminal.).

2. Klikněte na Link Account.

3. Přihlaste se účtem Cfx.re a potvrďte přístup tlačítkem Yes, Allow.

   Vrátíte se do txAdminu na registrační formulář.

4. Vyplňte formulář:

   Pole	Co zadat	Proč
   Discord ID	Nepovinné. Vaše číselné ID uživatele na Discordu.	Propojí admina s Discordem (whitelist, příkazy bota txAdminu). Jde doplnit později.
   Backup Password	Heslo o délce 6–⁠128 znaků. Použijte generátor hesel.	Záložní přihlášení, když přihlášení přes Cfx.re nefunguje.
   Confirm Password	Stejné heslo znovu.	Kontrola překlepu.

5. Zaškrtněte souhlas s licenčními podmínkami (Creator PLA) a klikněte na Register.

   Otevře se průvodce nastavením serveru.

Průvodce nastavením serveru#

Server Name#

Krátký název serveru pro rozhraní txAdminu a zprávy v chatu a na Discordu, například Muj RP server. Pole přijme nejvýš 18 znaků. Není to název v seznamu serverů FiveM (ten se nastavuje v server.cfg). Klikněte na Next.

Deployment Type#

Pro první server zvolte Popular Recipes a vyberte recept:

• Základní recept (v seznamu jako FiveM Basic Server nebo CFX Default FiveM, podle verze txAdminu) – minimální server bez frameworku a bez databáze. Hodí se na vyzkoušení, freeroam a drift servery.
• ESX Legacy, QBCore Framework, Qbox Framework – roleplay frameworky. Potřebují databázi. Rozdíly a výběr najdete v návodu ESX, QBCore, nebo Qbox?.

Složka pro data serveru#

txAdmin navrhne, kam server nasadit, typicky do txData/<NAZEV>_<KOD>.base. Navrženou cestu ponechte (We strongly recommend using the path suggested below.) a klikněte na Save. Do této složky se uloží server.cfg a resources.

Na poslední obrazovce (We are almost there!) klikněte na Go to Recipe Deployer. Než budete pokračovat, připravte si databázi (další část).

Příprava databáze#

Recepty frameworků (ESX, QBCore, Qbox) potřebují databázi. Než budete v txAdminu pokračovat, vytvořte ji v zákaznické zóně. Základní recept databázi nepotřebuje, tuto část pak přeskočte.

1. V zákaznické zóně přejděte na záložku Databáze.

2. Do pole Název databáze napište například fivem (jen písmena, číslice a podtržítko).

3. Pole Povolený přístup z nechte %. Znak % znamená „odkudkoli“, server i váš počítač se tak k databázi připojí.

4. Klikněte na Vytvořit databázi.

   V seznamu uvidíte Název databáze, Uživatel, Server a Heslo. Údaje si nechte otevřené, za chvíli je opíšete do txAdminu. Název databáze opište přesně ze seznamu, může se lišit od toho, co jste napsali.

Nasazení receptu (Server Deployer)#

Step 1: Review Recipe#

txAdmin ukáže obsah receptu: co stáhne, kam to uloží a jaké SQL spustí. Spouštějte jen recepty z důvěryhodných zdrojů (Only run Recipes from trusted sources!). Klikněte na Next.

Step 2: Input Parameters#

Databázová pole se zobrazí po kliknutí na Show/Hide Database options (advanced). Pak klikněte na Run Recipe.

Step 3: Run Recipe#

txAdmin stahuje soubory a importuje SQL. U velkých receptů (QBCore, Qbox) to trvá i několik minut. Po dokončení klikněte na Next.

Step 4: Configure server.cfg#

Uvidíte vygenerovaný server.cfg. Teď zkontrolujte a upravte tři věci, ostatní vysvětluje návod server.cfg řádek po řádku:

• endpoint_add_tcp a endpoint_add_udp – port za dvojtečkou musí být port hry z řádku Adresa pro připojení v záložce Síť (číslo za dvojtečkou). Pokud txAdmin nedostal port od hostingu, zapíše výchozí 30120. Když se liší, přepište ho v obou řádcích, jinak se hráči nepřipojí.
• sv_hostname a sets sv_projectName – název serveru v seznamu serverů.
• sets locale "root-AQ" – změňte na sets locale "cs-CZ", aby byl server v seznamu označený jako český.

Klikněte na Save & Run Server. Server se spustí a txAdmin otevře Live Console.

Ověření#

• V txAdminu na stránce Dashboard je server ve stavu online a v Live Console nejsou červené chyby.
• Ve hře stiskněte F8, napište connect <IP_ADRESA>:<PORT> (adresa z řádku Adresa pro připojení v záložce Síť) a připojte se.
• Ve hře napište do chatu /tx (nebo /txadmin): otevře se menu txAdminu. Funguje jen adminům, kteří mají v txAdminu vyplněné Cfx.re nebo Discord ID. Klávesu pro menu si můžete nastavit ve hře v Game Settings › Key Bindings › FiveM (položka (txAdmin) Menu: Open Main Page).

Správa adminů#

1. V horním menu klikněte na Admins.

2. Klikněte na Add.

3. Vyplňte formulář:

   Pole	Co zadat
   Username	Uživatelské jméno pro přihlášení do txAdminu. Pokud vyplníte Cfx.re ID, musí se shodovat se jménem na fóru Cfx.re.
   Cfx.re ID	Nepovinné. Uživatelské jméno na forum.cfx.re (otevře se v novém okně). Umožní přihlášení tlačítkem Cfx.re a menu /tx ve hře.
   Discord ID	Nepovinné. Číselné ID uživatele na Discordu.
   Permissions	Zaškrtněte jen to, co člověk opravdu potřebuje (tabulka níže).

4. Uložte. txAdmin ukáže dočasné heslo, pošlete ho adminovi. Při prvním přihlášení si ho musí změnit.

Oprávnění se ukládají do souboru txData/admins.json. Admin txAdminu není automaticky admin frameworku (ESX, QBCore). Jak dát práva ve frameworku, popisuje návod ESX, QBCore, nebo Qbox?.

Plánované restarty#

Pravidelný restart (jednou až dvakrát denně) uvolní paměť a vyčistí rozbitý stav skriptů. txAdmin hráče předem upozorní.

1. V horním menu klikněte na Settings a otevřete záložku FXServer.
2. V položce Restart Schedule klikněte na tlačítko +. V okně Add Restart Time zadejte čas, například 06:00. Místo toho můžete kliknout na hotovou předvolbu (1x/day, 2x/day …).
3. Uložte nastavení.

Čas se počítá podle času serveru, ne podle vašeho počítače (Make sure your schedule matches your server time and not your local time.). Pokud txAdmin ukáže varování o časovém pásmu, posuňte čas o rozdíl.

Užitečné části txAdminu#

Když něco nefunguje#

Stránka txAdminu se nenačte#

• Zkontrolujte, že server běží a v konzoli je rámeček All ready! Please access:.
• Použijte IP adresu ze záložky Síť a port z rámečku. Adresa začíná http://, ne https://.
• Pokud prohlížeč adresu sám mění na https://, napište ji ručně i s http://.
• Port txAdminu musí být mezi porty serveru v záložce Síť (Adresa pro připojení nebo Další porty). Pokud ho tam nevidíte, napište nám.

PIN nefunguje#

PIN se vytvoří znovu při každém startu, dokud nemáte prvního admina. Použijte PIN z posledního výpisu konzole. Po vytvoření admina se už nezobrazuje, přihlašujte se tlačítkem Cfx.re nebo heslem.

Zapomněl jsem heslo#

Přihlaste se tlačítkem Cfx.re. Když nefunguje ani to a jste jediný admin, napište nám. Smazáním souboru txData/admins.json se txAdmin vrátí k PINu, ale přijdete o všechny účty adminů.

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

Recept stahuje desítky repozitářů z GitHubu a GitHub dočasně omezil počet stažení. Počkejte asi hodinu a spusťte nasazení znovu.

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

• ER_ACCESS_DENIED_ERROR – špatný uživatel nebo heslo. Zkopírujte je znovu ze záložky Databáze, bez mezer na začátku a konci.
• ECONNREFUSED nebo vypršení času – špatná adresa nebo port. Do Database Host patří IP adresa z pole Server, ne localhost.
• ER_BAD_DB_ERROR – název databáze nesedí. Opište ho přesně ze seznamu databází.

Další chyby databáze řeší návod Databáze pro FiveM.

Server po nasazení nenaběhne#

Nejčastěji chybí nebo nesedí license key (Could not authenticate server license key). Opravte ho v CFG Editoru podle návodu license key. Ostatní chyby najdete v návodu Časté chyby FiveM.

Hráči se nepřipojí, i když txAdmin hlásí online#

Hráči se připojují na port hry z řádku Adresa pro připojení, ne na port txAdminu. Zkontrolujte v CFG Editoru řádky endpoint_add_tcp a endpoint_add_udp: oba musí mít port z Adresy pro připojení, ne výchozí 30120 z receptu (pokud to zrovna není váš port). Po opravě server restartujte. Víc v návodu server.cfg.

Další zdroje#

• FiveM: Setting up a server using txAdmin (otevře se v novém okně)
• FiveM: txAdmin a jeho oprávnění (otevře se v novém okně)
• txAdmin na GitHubu (dokumentace receptů a proměnných) (otevře se v novém okně)