txAdmin: je FiveM-server voor het eerst instellen

txAdmin is een webpaneel voor het beheer van een FiveM-server: het deployt de server vanuit een kant-en-klaar recept, bewaakt en herstart hem en beheert admins, bans en de whitelist. We lopen de eerste start door, van de PIN tot een draaiende server, en leggen elk veld van de wizard uit.

Hoe txAdmin werkt#

txAdmin is onderdeel van elke FiveM-server (FXServer), je hoeft niets apart te downloaden. Als FXServer zonder de parameter +exec server.cfg wordt gestart, start txAdmin in plaats van het spel zelf. txAdmin start daarna het spel, houdt het in de gaten en start het bij een crash of bij vastlopen vanzelf opnieuw.

• Zijn eigen gegevens (adminaccounts, instellingen, logs, de database met spelers en bans) bewaart txAdmin in de map txData.
• De webinterface draait op een eigen poort. De standaardpoort is 40120, bij ons kan het een andere zijn.
• De interface is in het Engels. De namen van knoppen geven we in deze handleiding precies weer zoals je ze ziet.

txAdmin openen#

1. Open in je klantaccount Mijn diensten, klik op de FiveM-server en ga naar het tabblad Console.

2. Draait de server niet, klik dan op Starten.

3. Wacht op het kader met de tekst All ready! Please access:.

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

   • De regel onder All ready! Please access: is het adres van txAdmin. Daarvan is de poort belangrijk (het getal na de dubbele punt).
   • Onder Use the PIN below to register: staat een PIN van vier cijfers voor de eerste keer inloggen. Die wordt getoond totdat je de eerste admin hebt aangemaakt.

4. Typ in je browser het adres http://<IP_ADDRESS>:<TXADMIN_PORT>/.

   Vervang <IP_ADDRESS> door het IP-adres van het tabblad Netwerk (van de regel Verbindingsadres alleen het deel vóór de dubbele punt, bijvoorbeeld 203.0.113.10). Vervang <TXADMIN_PORT> door de poort uit het kader in de console. Het volledige adres ziet er dan bijvoorbeeld zo uit: http://203.0.113.10:40120/.

   Zie je in plaats van het IP-adres een gearceerde balk, dan staat de streamermodus aan. Klik bovenaan op Gegevens tonen. De streamermodus verbergt IP-adressen ook in de uitvoer van de console, inclusief de poort erachter. De poort van txAdmin lees je dan af uit de regel http://your-public-ip:<PORT>/, of je laat de gegevens tonen.

   De poort voor txAdmin wijzen we nog niet automatisch toe. Zie je hem niet op het tabblad Netwerk (Verbindingsadres of Extra poorten), vraag ons dan om een poort voor txAdmin (contactgegevens). Zonder die poort kun je txAdmin niet in je browser openen.

Verschijnt het kader niet en toont de console meteen het laden van resources (Started resource …), dan staat txAdmin uit. Je zet het aan op het tabblad Instellingen › Variabelen met de variabele voor txAdmin (1 = aan, 0 = uit) en een herstart van de server. Zie je zo'n variabele niet, neem dan contact met ons op (contactgegevens).

Koppelen aan je Cfx.re-account en wachtwoord#

Bij de eerste keer inloggen maak je de hoofdadmin aan (Master). Die heeft alle rechten en is de enige die niet kan worden verwijderd.

1. Voer op de pagina No Cfx.re account linked de PIN uit de console in (Type in the PIN from the terminal.).

2. Klik op Link Account.

3. Log in met je Cfx.re-account en bevestig de toegang met de knop Yes, Allow.

   Je komt terug in txAdmin, op het registratieformulier.

4. Vul het formulier in:

   Veld	Wat je invult	Waarom
   Discord ID	Optioneel. Je numerieke gebruikers-ID op Discord.	Koppelt de admin aan Discord (whitelist, commando's van de txAdmin-bot). Kun je later nog invullen.
   Backup Password	Een wachtwoord van 6–⁠128 tekens. Gebruik de wachtwoordgenerator.	Een reservemanier om in te loggen als inloggen via Cfx.re niet werkt.
   Confirm Password	Hetzelfde wachtwoord nog een keer.	Controle op typfouten.

5. Vink het akkoord met de licentievoorwaarden aan (Creator PLA) en klik op Register.

   De wizard voor het instellen van de server wordt geopend.

Wizard voor het instellen van de server#

Server Name#

Een korte servernaam voor de interface van txAdmin en voor berichten in de chat en op Discord, bijvoorbeeld Muj RP server. Het veld accepteert maximaal 18 tekens. Dit is niet de naam in de serverlijst van FiveM (die stel je in server.cfg in). Klik op Next.

Deployment Type#

Kies voor je eerste server Popular Recipes en selecteer een recept:

• Basisrecept (in de lijst als FiveM Basic Server of CFX Default FiveM, afhankelijk van de versie van txAdmin) – een minimale server zonder framework en zonder database. Geschikt om uit te proberen en voor freeroam- en driftservers.
• ESX Legacy, QBCore Framework, Qbox Framework – roleplayframeworks. Ze hebben een database nodig. De verschillen en hulp bij het kiezen vind je in de handleiding ESX, QBCore of Qbox?.

Map voor de servergegevens#

txAdmin stelt voor waar de server wordt gedeployd, meestal in txData/<NAME>_<CODE>.base. Laat het voorgestelde pad staan (We strongly recommend using the path suggested below.) en klik op Save. In deze map komen server.cfg en resources te staan.

Klik op het laatste scherm (We are almost there!) op Go to Recipe Deployer. Maak eerst de database klaar voordat je verdergaat (volgende gedeelte).

De database voorbereiden#

Recepten van frameworks (ESX, QBCore, Qbox) hebben een database nodig. Maak die aan in je klantaccount voordat je in txAdmin verdergaat. Het basisrecept heeft geen database nodig, sla dit gedeelte dan over.

1. Ga in je klantaccount naar het tabblad Databases.

2. Typ in het veld Databasenaam bijvoorbeeld fivem (alleen letters, cijfers en het onderstrepingsteken).

3. Laat het veld Toegang toegestaan vanaf op % staan. Het teken % betekent “overal vandaan”, zo kunnen zowel de server als je computer met de database verbinden.

4. Klik op Database aanmaken.

   In de lijst zie je Databasenaam, Gebruiker, Host en Wachtwoord. Houd de gegevens open, je neemt ze zo over in txAdmin. Neem de databasenaam exact over uit de lijst, die kan afwijken van wat je hebt getypt.

Het recept deployen (Server Deployer)#

Step 1: Review Recipe#

txAdmin toont de inhoud van het recept: wat het downloadt, waar het dat opslaat en welke SQL het uitvoert. Voer alleen recepten uit betrouwbare bronnen uit (Only run Recipes from trusted sources!). Klik op Next.

Step 2: Input Parameters#

De databasevelden verschijnen nadat je op Show/Hide Database options (advanced) hebt geklikt. Klik daarna op Run Recipe.

Step 3: Run Recipe#

txAdmin downloadt bestanden en importeert SQL. Bij grote recepten (QBCore, Qbox) kan dat enkele minuten duren. Klik na afloop op Next.

Step 4: Configure server.cfg#

Je ziet de gegenereerde server.cfg. Controleer en wijzig nu drie dingen, de rest wordt uitgelegd in de handleiding server.cfg regel voor regel:

• endpoint_add_tcp en endpoint_add_udp – de poort na de dubbele punt moet de gamepoort zijn uit de regel Verbindingsadres op het tabblad Netwerk (het getal na de dubbele punt). Als txAdmin de poort niet van de hostingprovider heeft gekregen, vult het de standaardwaarde 30120 in. Wijkt die af, pas de poort dan in beide regels aan, anders kunnen spelers niet verbinden.
• sv_hostname en sets sv_projectName – de naam van de server in de serverlijst.
• sets locale "root-AQ" – wijzig dit in de taal van je spelers, bijvoorbeeld sets locale "nl-NL" (of "cs-CZ" voor Tsjechisch), zodat de server in de lijst met de juiste taal wordt aangeduid.

Klik op Save & Run Server. De server start en txAdmin opent de Live Console.

Controle#

• In txAdmin heeft de server op de pagina Dashboard de status online en staan er in de Live Console geen rode foutmeldingen.
• Druk in het spel op F8, typ connect <IP_ADDRESS>:<PORT> (het adres uit de regel Verbindingsadres op het tabblad Netwerk) en maak verbinding.
• Typ in het spel /tx (of /txadmin) in de chat: het menu van txAdmin wordt geopend. Dat werkt alleen voor admins die in txAdmin een Cfx.re- of Discord-ID hebben ingevuld. Een toets voor het menu stel je in het spel in onder Game Settings › Key Bindings › FiveM (het onderdeel (txAdmin) Menu: Open Main Page).

Admins beheren#

1. Klik in het bovenste menu op Admins.

2. Klik op Add.

3. Vul het formulier in:

   Veld	Wat je invult
   Username	De gebruikersnaam om in te loggen bij txAdmin. Als je Cfx.re ID invult, moet die overeenkomen met de naam op het Cfx.re-forum.
   Cfx.re ID	Optioneel. De gebruikersnaam op forum.cfx.re (opent in een nieuw venster). Maakt inloggen met de Cfx.re-knop en het menu /tx in het spel mogelijk.
   Discord ID	Optioneel. Het numerieke gebruikers-ID op Discord.
   Permissions	Vink alleen aan wat iemand echt nodig heeft (tabel hieronder).

4. Sla op. txAdmin toont een tijdelijk wachtwoord, stuur dat naar de admin. Bij de eerste keer inloggen moet de admin het wijzigen.

De rechten worden opgeslagen in het bestand txData/admins.json. Een admin van txAdmin is niet automatisch admin van het framework (ESX, QBCore). Hoe je rechten in het framework geeft, staat in de handleiding ESX, QBCore of Qbox?.

Geplande herstarts#

Een regelmatige herstart (één tot twee keer per dag) maakt geheugen vrij en ruimt scripts op die in een foute toestand zijn geraakt. txAdmin waarschuwt spelers vooraf.

1. Klik in het bovenste menu op Settings en open het tabblad FXServer.
2. Klik bij Restart Schedule op de knop +. Voer in het venster Add Restart Time een tijd in, bijvoorbeeld 06:00. Je kunt in plaats daarvan ook op een kant-en-klare voorinstelling klikken (1x/day, 2x/day …).
3. Sla de instellingen op.

De tijd wordt berekend volgens de servertijd, niet volgens je computer (Make sure your schedule matches your server time and not your local time.). Toont txAdmin een waarschuwing over de tijdzone, verschuif de tijd dan met het verschil.

Handige onderdelen van txAdmin#

Als iets niet werkt#

De pagina van txAdmin laadt niet#

• Controleer of de server draait en of in de console het kader All ready! Please access: staat.
• Gebruik het IP-adres van het tabblad Netwerk en de poort uit het kader. Het adres begint met http://, niet met https://.
• Verandert je browser het adres zelf in https://, typ het dan handmatig in, inclusief http://.
• De poort van txAdmin moet bij de poorten van de server staan op het tabblad Netwerk (Verbindingsadres of Extra poorten). Zie je hem daar niet, neem dan contact met ons op.

De PIN werkt niet#

Zolang je nog geen eerste admin hebt, wordt bij elke start een nieuwe PIN aangemaakt. Gebruik de PIN uit de laatste uitvoer van de console. Nadat de admin is aangemaakt, wordt de PIN niet meer getoond: log dan in met de Cfx.re-knop of met je wachtwoord.

Ik ben mijn wachtwoord vergeten#

Log in met de Cfx.re-knop. Werkt ook dat niet en ben je de enige admin, neem dan contact met ons op. Als je het bestand txData/admins.json verwijdert, gaat txAdmin terug naar de PIN, maar raak je alle adminaccounts kwijt.

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

Het recept downloadt tientallen repository's van GitHub en GitHub heeft het aantal downloads tijdelijk beperkt. Wacht ongeveer een uur en start de deployment opnieuw.

Het recept eindigt met een databasefout (ER_ACCESS_DENIED_ERROR, ECONNREFUSED)#

• ER_ACCESS_DENIED_ERROR – verkeerde gebruiker of verkeerd wachtwoord. Kopieer ze opnieuw van het tabblad Databases, zonder spaties aan het begin en het einde.
• ECONNREFUSED of een time-out – verkeerd adres of verkeerde poort. In Database Host hoort het IP-adres uit het veld Host, niet localhost.
• ER_BAD_DB_ERROR – de databasenaam klopt niet. Neem hem exact over uit de lijst met databases.

Andere databasefouten worden behandeld in de handleiding Database voor FiveM.

De server start niet na het deployen#

Meestal ontbreekt de license key of klopt die niet (Could not authenticate server license key). Corrigeer hem in de CFG Editor volgens de handleiding license key. Andere fouten vind je in de handleiding Veelvoorkomende fouten van FiveM.

Spelers kunnen niet verbinden, terwijl txAdmin online meldt#

Spelers verbinden met de gamepoort uit de regel Verbindingsadres, niet met de poort van txAdmin. Controleer in de CFG Editor de regels endpoint_add_tcp en endpoint_add_udp: beide moeten de poort uit het Verbindingsadres hebben, niet de standaardwaarde 30120 uit het recept (tenzij dat toevallig jouw poort is). Herstart de server na de correctie. Meer in de handleiding server.cfg.

Meer bronnen#

• FiveM: Setting up a server using txAdmin (opent in een nieuw venster)
• FiveM: txAdmin en de rechten ervan (opent in een nieuw venster)
• txAdmin op GitHub (documentatie van recepten en variabelen) (opent in een nieuw venster)