txAdmin og resources: sådan styrer du din FiveM server
Første opstart af txAdmin med PIN-kode, licensnøgle fra portal.cfx.re, de vigtige linjer i server.cfg, og hvordan du tilføjer resources uden at genstarte serveren.
Hvad er txAdmin?
txAdmin er det officielle webpanel til FiveM-servere. Det giver dig live-konsol, start og stop af serveren og enkelte resources, en indbygget CFG-editor, spillerdatabase med bans og advarsler, planlagte genstarter, automatisk genstart efter et crash og Discord-integration.
Du skal ikke installere noget. txAdmin har været en del af FXServer siden 2020 og ligger allerede i dine serverfiler.
To porte er i spil, og de forveksles ofte:
| Port | Protokol | Bruges til |
|---|---|---|
30120 |
TCP og UDP | Selve spilserveren - spillerne forbinder her |
40120 |
TCP | txAdmin-panelet i browseren |
Trin 1 - Første opstart og din master-konto
- Start serveren i Potionhost kontrolpanelet uden
+exec server.cfgi opstartsparametrene. Netop den udeladelse er det, der starter txAdmin i stedet for spilserveren. - Åbn Konsol. Der bliver skrevet en adresse og en PIN-kode.
- Åbn adressen i browseren - typisk
http://din-server-ip:40120. - Indtast PIN-koden og knyt din Cfx.re-konto til serveren.
- Vælg en adgangskode til panelet.
PIN-koden er engangsbrug og kortvarig, og den står kun i konsollen. Går den tabt, skal serveren startes forfra for at få en ny.
Trin 2 - Opsæt selve serveren
txAdmin tilbyder to veje i opsætningsguiden:
Recipe deployer - en færdig opskrift, der henter resources ned og skriver server.cfg for dig. Der ligger skabeloner til CFX Default, ESX Legacy og QBCore. Du bliver undervejs bedt om databaseoplysninger, servernavn og licensnøgle.
Eksisterende servermappe - peg txAdmin på en mappe, du allerede har bygget, og på dens server.cfg.
Recipe-opskrifter kører deres trin i rækkefølge, og ét fejlet trin stopper hele installationen. Går det galt undervejs, er årsagen næsten altid et dødt download-link eller forkerte databaseoplysninger.
Trin 3 - Hent din licensnøgle
Uden en gyldig nøgle starter serveren ikke.
- Log ind på portal.cfx.re og opret en server-registreringsnøgle.
- Sæt den i
server.cfg:
sv_licenseKey din_noegle_her
Nøglen hentes på portal.cfx.re i dag. Ældre guider peger på keymaster.fivem.net, som Cfx.re er ved at udfase. Nøglen er knyttet til én server - genbrug den ikke på to servere, der kører samtidig.
Trin 4 - Forstå server.cfg
Filen ligger i din server-data-mappe, sammen med resources. De linjer, du skal kende:
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_hostname "Mit servernavn"
sets sv_projectName "Mit projekt"
sets sv_projectDesc "Kort beskrivelse"
sv_maxclients 48
set onesync on
sv_licenseKey din_noegle_her
#sv_master1 ""
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.fivem:1 group.admin
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
To ting folk snubler over:
sv_master1skal blive stående udkommenteret med#foran. Fjerner du havelågen, forsvinder serveren fra den offentlige liste.sets sv_projectNameogsets sv_projectDescskal være udfyldt, ellers bliver serveren ikke vist.
Trin 5 - Tilføj en resource
- Læg resource-mappen i
resources/i din server-data-mappe. - Kontrollér at mappen indeholder en
fxmanifest.lua. Uden den er det ikke en resource. - Tilføj en linje i
server.cfg:
ensure navnet-paa-resourcen
Mapper i firkantede parenteser er kategorier, ikke resources. Strukturen ser typisk sådan ud:
resources/
├── [standalone]/
│ ├── min-resource/
│ └── en-anden/
└── [esx]/
└── es_extended/
Du kan starte en hel kategori på én gang med ensure [standalone].
Rækkefølgen betyder noget. Framework-kernen (
es_extendedellerqb-core) og databaselaget (oxmysql) skal stå før de resources, der bruger dem.
start, ensure og restart
| Kommando | Hvad den gør |
|---|---|
start navn |
Starter resourcen, hvis den er stoppet. Gør ingenting hvis den allerede kører |
ensure navn |
Genstarter resourcen hvis den kører - og starter den hvis den ikke gør |
stop navn |
Stopper resourcen |
restart navn |
Genstarter, kun hvis den allerede kører |
refresh |
Genindlæser mappen resources og opdager nye resources |
Brug ensure. Den virker uanset udgangspunktet, og det er derfor den anbefales i server.cfg.
Har du netop lagt en ny resource ind, kan du tage den i brug uden at genstarte serveren. Skriv i live-konsollen:
refresh
ensure navnet-paa-resourcen
refresh alene starter ingenting - den gør bare serveren opmærksom på, at mappen findes.
Husk stadig at tilføje ensure-linjen i server.cfg, ellers er den væk efter næste genstart.
Hvornår skal serveren genstartes helt?
Konsolkommandoer rækker til resources. Til alt andet skal serveren en tur ned:
- ændringer i
endpoint_add_tcp/udp,onesync,sv_maxclients,sv_licenseKeyellersv_enforceGameBuild - opdatering af selve FXServer-artefakten
- ændringer i load-rækkefølgen af framework-resources
Admins og spiller-identifikatorer
txAdmin-administratorer styres under Admin Manager og gemmes i txData/admins.json. Rettighederne er finkornede - fx players.kick, players.ban, console.write, control.server og manage.admins.
En txAdmin-admin er ikke automatisk admin i spillet. Kommandoer inde i spillet styres af ACE-rettighederne i
server.cfg(add_aceogadd_principal). Det er to adskilte systemer.
Spillere identificeres på flere måder:
| Identifikator | Kommer fra | Altid til stede |
|---|---|---|
license |
Rockstar Online Services | Ja |
steam |
Steam | Kun hvis Steam kører |
discord |
Discord | Kun hvis Discord er tilknyttet |
fivem |
Cfx.re-konto | Ja |
ip |
Forbindelsen | Ja, men skifter |
Brug license til bans og whitelist. Den er der altid og skifter ikke.
Fejlfinding
| Symptom | Sandsynlig årsag | Løsning |
|---|---|---|
| Panelet kan ikke nås | Port 40120 er ikke åben |
Tjek porten i kontrolpanelet |
| Serveren starter, men intet indlæses | Startet med +exec server.cfg under txAdmin |
Fjern parameteren |
| Serveren står ikke på listen | sv_master1 er ikke udkommenteret |
Sæt # foran igen |
| Serveren står ikke på listen | sets sv_projectName eller sv_projectDesc mangler |
Udfyld begge |
| Serveren dukker først op efter et stykke tid | Normal forsinkelse | Vent op til otte minutter |
does not have a resource manifest (fxmanifest.lua) |
Manifestet mangler, eller hedder stadig __resource.lua |
Tilføj en fxmanifest.lua |
Could not find resource |
Forkert mappe, forkert stavning, eller refresh ikke kørt |
Kør refresh - navne er versalfølsomme på Linux |
| Serveren starter ikke | sv_licenseKey står stadig som changeme eller nøglen bruges andetsteds |
Hent en ny nøgle på portal.cfx.re |
| Ændringer i cfg gør ingenting | Konvars kræver fuld genstart | Genstart serveren, ikke bare resourcen |
| Resourcen fejler på database-kald | oxmysql eller framework-kernen starter for sent |
Flyt deres ensure-linjer op |
| Serveren er låst til 48 pladser | Kræver et abonnement hos Cfx.re | Se Cfx.re for de aktuelle niveauer |
Skal spillerne bare have fat i serveren, kan du sende dem Sådan forbinder du til din FiveM server.