tabarra / txadmin

The official FiveM server management platform used by over 23k servers!

txAdmin for FiveM

Join our Discord Server:  

txAdmin is a full featured web panel to Manage & Monitor your FiveM/RedM Server remotely, in use by over 21.000 servers worldwide at any given time.

Main Features

• Recipe-based Server Deployer: create a server in under 60 seconds! (more info)
• Start/Stop/Restart your server instance or resources
• Full-featured in-game admin menu:
  • Player Mode: NoClip, God, SuperJump
  • Teleport: waypoint, coords and back
  • Vehicle: Spawn, Fix, Delete, Boost
  • Heal: yourself, everyone
  • Send Announcements
  • Reset World Area
  • Show player IDs
  • Player search/sort by distance, ID, name
  • Player interactions: Go To, Bring, Spectate, Freeze
  • Player troll: make drunk, set fire, wild attack
  • Player ban/warn/dm
• Access control:
  • Login via Password or CitizenFX
  • Admin permission system (more info)
  • Action logging
  • Brute-force protection
• Discord Integration:
  • Server configurable, persistent, auto-updated status embed
  • Command to whitelist players
  • Command to display player infos
• Monitoring:
  • Auto Restart FXServer on crash or hang
  • Server’s CPU/RAM consumption
  • Live Console (with log file, command history and search)
  • Server threads performance chart with player count
  • Server Activity Log (connections/disconnections, kills, chat, explosions and custom commands)
• Player Manager:
  • Warning system
  • Ban (temporary or permanently) system
  • Whitelist system (Discord member, Discord Role, Approved License, Admin-only)
  • Take notes about players
  • Keep track of player's play and session time
  • Self-contained player database with backup tool (no MySQL required!)
  • Clean/Optimize the database by removing old players, or bans/warns/whitelists
• Real-time playerlist
• Scheduled restarts with warning announcements and custom events (more info)
• Translation Support (more info)
• FiveM's Server CFG editor & validator
• Responsive web interface with Dark Mode 😎

Also, check our Feature Graveyard for the features that are no longer among us (RIP).

Running (Windows/Linux)

txAdmin is included in all FXServer builds above 2524, so to run it for the first time simply do the following:

• Update FXServer to the latest artifact/build (2524 or superior)
• If Windows, run FXServer.exe | If Linux, run screen ./run.sh
• Open one of the URLs shown and configure txAdmin

txAdmin requires to be launched from inside FXServer in monitor mode, to do that, just execute the run.sh or FXServer.exe without any +exec arguments.

ConVars

• serverProfile: The name of the server profile to start. Profiles are saved/loaded from the current directory inside the txData folder. The default is default.
• txAdminPort: The TCP port to use as HTTP Server. The default is 40120.
• txAdminInterface: The interface to use as HTTP Server. The default is 0.0.0.0.
• txDataPath: The path of the data folder. The default on Windows is <citizen_root>/../txData and on Linux <citizen_root>/../../../txData.
• txAdminVerbose: Set to true to print on the console more detailed information about errors and events. The default is false.

ConVar usage example for different port and profile:

# Windows
./FXServer.exe +set serverProfile dev_server +set txAdminPort 40121

# Linux
./run.sh +set serverProfile dev_server +set txAdminPort 40121

Contributing & Development

• All PRs should be based on the develop branch, including translation PRs.
• Before putting effort for any significant PR, make sure to join our discord and talk to us, since the change you want to do might not have been done for a reason or there might be some required context.
• If you want to run it from build & source, please do read this.

License, Credits and Thanks

• This project is licensed under the MIT License;
• "Kick" button icons made by SeyfDesigner from www.flaticon.com;
• Warning Sounds (1/2) made by Ultranova105 are licensed under CC 3.0 BY;
• Announcement Sound made by IENBA is licensed under CC BY 4.0;
• Message Sound made by Divinux is licensed under CC0 1.0;
• Especial thanks to everyone that contributed to this project, especially the very fine Discord folks that provide support for others;

txadmin's Issues

Default Messages

How do I Change Default Kick / Kickall Messages?

Error starting monitor

After updating to v1 i get a monitoring error

[txAdmin:webConsole] ::Started
[txAdmin] Error starting 'Monitor' module. Make sure you executed 'npm install'.
[txAdmin] >>Stopping txAdmin
gta@ubuntu:~/txAdmin$

Discord restart messages in game doesn't work

I have the discord bot on and scheduled restarts on. When a restart has been scheduled, this was neatly placed in the in-game chat in the previous version. Now only "txAdmin" appears and if I do an Admin Broadcast, my username will be there.

Rename txAdmin script running inside FXserver

I would like to suggest to rename the txAdmin script running inside the FXserver folder.

I did some testing and when you setup the FXserver and run it via txAdmin webpage normally, it adds a new folder to your set resources folder called "[txAdmin-cache]" which has a script/folder named "txAdmin".
The aforementioned "txAdmin" script needs to be renamed to "txAdminClient" for the txAdmin script to work properly, it should automatically install the script to have the name of "txAdminClient", I do not know the clear case of the issue but if I leave the script to the original state, it would not work properly. So I had to rename the script to "txAdminClient", in order to have a properly working txAdmin script.

I hope this issue gets fixed in the next update.

Errors

Can you make a page that only records errors?

Server restarts no longer announced

Both of our planned restarts are no longer getting their in-game announcement before a said restart. No specific errors or anything at all. All server settings look perfectly ok, I have double verified.

HealthCheck failed: Request failed with status code 400

Hi, I am in need of help with txAdmin, when it tries to refresh the Status Info pane in the Dashboard, it spams out a code 'HealthCheck failed: Request failed with status code 400' in the console and after some time it has a partial crash, I have tried reinstalling txAdmin and tried updating it to the latest version. Still no luck.

Committing semi space failed. Allocation failed - JavaScript heap out of memory

Windows server 2019
64GB of ram

https://i.imgur.com/OrfZOle.png

Seems like it's an issue with steam-snitch, would you know any fixes for this?

FXServer.exe stopped working

When the terminal stops working with the following pop-up which only lets you click "accept" the server spams the discord log and doesn't restart. It stays unoperative until someone manually clicks "accept" in the popup.

Performance issue in Windows

I recently noticed that the CPU consumption of FXAdmin skyrocketed for no apparent reason.
After many hours of troubleshooting this ghost bug I ended up with the conclusion that Windows itself is to blame: (soyuka/pidusage#67 and soyuka/pidusage#32).
I also tested the systeminformation lib and found out the same issue.
For Now I decided to disable performance monitoring on windows.

What can we still do?

Well, we can get the computers total / used memory, and cpu loadavg for the entire machine instead of only FXAdmin and its children.
This data is not as usefull but is still something.

One alternative could be getting the stats only once every 10 seconds instead of one. But this might still cause hitch warning in some low-end servers.
So, what do you guys think we should do?

Discord bot does not work

When I activate the discord bot it does not start the server, it stops after the launch command.
I followed the following manual to get the token that I am using. Is this okay?

https://www.youtube.com/watch?v=fv-H68OwsIA

I am use Linux Debian.

Cannot read property 'cpu' of null

Hi man,

Great script i love it. But there is only one issue my console is getting spammed with the following error:

[FXAdmin:Monitor] Players online: 23 [FXAdmin:Monitor] Error refreshing processes statuses TypeError: Cannot read property 'cpu' of null at Object.keys.forEach (/home/digit/fivem-test/fivem-fxadmin/src/components/monitor.js:180:38) at Array.forEach (<anonymous>) at Monitor.refreshProcessStatus (/home/digit/fivem-test/fivem-fxadmin/src/components/monitor.js:175:36)

Any idea on how to resolve this?

Im running Linux on a VPS server :)

Custom command logging

I have ESX server. I wanna log the /dw (darkweb) command. I've added this into my server where I register the command:

	TriggerEvent('txaLogger:CommandExecuted', raw)

But it gets displayed like this https://img.mrivanplays.com/vrWjo0bSVj

Help?

Timeout

Everyting is working fine, i love this.

But server was running for 20-30 minutes, and it timeout without error.

https://imgur.com/a/fAq2gEh

[Discussion] Bind to specific IP

I have looked through everything and I would want to bind this to the specific IP of 127.0.0.1 and then proxy it behind nignx or apache. Is there a way to do that?

Add delete cache on restart option

It would be nice to have an option to provide your cache folder and then delete it on the server restart / auto restart

Authentication - login page

First I want to say: Really nice project. Will definetly contribute to this, web control panel is what we needed.

But whole panel should have some kind of login screen with admin auth. Right now, anyone can see admin log and all the information should just be hidden to unauthorized people.

Can you add a player tracking system?

Maybe this https://github.com/PichotM/pTracker

API / POST request

Hi,
is there some api for post request?
Or it would be good idea to make.

What about if I have a website with some php code and I want to start some function on fivem server?
Is would be great if I can make POST request from php (with curl for example) to txAdmin panel.
In request will be some secret code for authenticate and autorize the request and then run some command in fivem console.

🤔

server IP issue

Any reason for not allowing anything other than 0.0.0.0 for the server IP? this makes it impossible to run multiple servers on multiple IPs.

"FXServer config error: You MUST have a TCP endpoint with interface 0.0.0.0"

Interface Rework discussion thread.

It's pretty clear the interface rework is a bit overdue.
To help organize and future-proof the enhancements, I would like to share what I see in the near-future of FXAdmin:

• Separate the admin log to another window
• Separate server Start/Stop/Restart from the other commands and add a confirmation modal.
• Adding a separate window or tab to show some configs from your server.json
• Statistics plotter window with charts for hitch detection, playercount and possibly more. This can even be in the home screen depending on the design
• Simple menu with the available windows + logout link

One of the most important factors to consider is that the playerlist might have no players, or up to 64 (or more!?) players, so responsiveness is quite essential.

What do you guys think?

Cant disable conservative mode

partial crashes detected and we cant disable the option in settings

question

works on CentOS 7.5? i having issues installing....

npm
http://puu.sh/DOaIJ/8d2aaac0ce.png

in this imagen can see its not supported, i think...
http://puu.sh/DOaKl/90d7645257.png

Running with run.sh

cant put in run.sh
cd /routetotxAdmin
node src server01.json

Any way to start together in Linux?

Choose language

Add an option in the settings for change the language(especially for the discord bot ) (and if you need a french translator, i'am your guy :) )

Issues with restarting or stopping/starting the server

When first launched on fresh boot of Windows, server starts up no problem and functions. Once the server is restarted, or stopped then started, we get this error in console during startup:

Started resource txAdminClient
Listening on socket failed - libuv error address already in use.
net-tcp-server failed to create server: couldn't listenCould not bind MultiplexTcpServer to 0.0.0.0:30120.

It's like it's not unbinding the IP or port when shutting down. Running on fresh install of Windows Server 2012 R2, fully updated.

Error trying to launch FXServer

(Counter: 11/15) HealthCheck request error: connect ECONNREFUSED 127.0.0.1:32528

my server.cfg contains 0.0.0.0:32528

Ram/CPU usage (serverside) per plugin

Hey,
I have been recently using etw traces to check performance on backend,

Is there any possibility to add any type of backend monitoring that show plugins that are running on the server and cpu msec/ram usage overtime (graphs)

Could be extremely helpful to track down troublesome plugins aswell check how each plugin reacts with different levels of traffic

Unable to authenticate txAdmin with Citizen

Hey,

I've been using this great utility for a while now and decided to upgrade to v2.0 but upon launching i've tried server times to login and link my Citizen account with txAdmin but it fails to do so.

The error I get upon trying to give rights to bind are:
"Failed to exchange code for token. Try again. If this problem persists, check terminal for more info."

In the server terminal I get:
"[txAdmin:WebServer:AddMaster] Code Exchange error: JWT not active yet, now 1585526928, nbf 1585526947"

Any solution?

EDIT:
Server Details:
"Server profile: dev_sv
txAdmin version: 2.0.0
FXServer build: 2310"

Add permission to acces Action Logs and Server Logs

Add permission to access Action Logs and Server Logs to admin!

Add the ability to disable authentication methods

To secure authentication, it would be great to be able to choose which methods are available for authentication.

Possibility to deactivate authentication:

• By password,
• By Fivem account,
• By Discord.

Thank

Total memory usage misleading in Linux instances

The current memory usage implementation uses os.freemem() which reports buff/cache as memory used. Avaliable memory should be used instead as it's a lot more useful imo. Maybe even show both as a stacked bar? https://getbootstrap.com/docs/4.3/components/progress/#multiple-bars

Russian language

Hello. If it is possible to add Russian language? If you need help translating, you can send me what you need to translate.

Fatal error fxserver

I need help, I get this error randomly and when it reaches 35/35 the server restarts https://prnt.sc/p1iij4

Trend Hitch Time in graph over time.

This would be extremely useful to be able to trend the hitch time in a graph over time.

Crashing when restarting server

Everytime I restart the server or autorestart

Crash Log
0 info it worked if it ends with ok
1 verbose cli [ 'C:\Program Files\nodejs\node.exe',
1 verbose cli 'C:\Program Files\nodejs\node_modules\npm\bin\npm-cli.js',
1 verbose cli 'start',
1 verbose cli 'server.json' ]
2 info using [email protected]
3 info using [email protected]
4 verbose run-script [ 'prestart', 'start', 'poststart' ]
5 info lifecycle [email protected]prestart: [email protected]
6 info lifecycle [email protected]start: [email protected]
7 verbose lifecycle [email protected]start: unsafe-perm in lifecycle true
8 verbose lifecycle [email protected]start: PATH: C:\Program Files\nodejs\node_modules\npm\node_modules\npm-lifecycle\node-gyp-bin;C:\fivem-fxadmin\node_modules.bin;C:\Program Files (x86)\Common Files\Oracle\Java\javapath;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0;C:\Program Files\nodejs;;C:\Users\killer\AppData\Local\Programs\Microsoft VS Code\bin;C:\Users\killer\AppData\Roaming\npm
9 verbose lifecycle [email protected]start: CWD: C:\fivem-fxadmin
10 silly lifecycle [email protected]start: Args: [ '/d /s /c', 'node src/main.js "server.json"' ]
11 silly lifecycle [email protected]start: Returned: code: 1 signal: null
12 info lifecycle [email protected]start: Failed to exec start script
13 verbose stack Error: [email protected] start: node src/main.js "server.json"
13 verbose stack Exit status 1
13 verbose stack at EventEmitter. (C:\Program Files\nodejs\node_modules\npm\node_modules\npm-lifecycle\index.js:301:16)
13 verbose stack at EventEmitter.emit (events.js:198:13)
13 verbose stack at ChildProcess. (C:\Program Files\nodejs\node_modules\npm\node_modules\npm-lifecycle\lib\spawn.js:55:14)
13 verbose stack at ChildProcess.emit (events.js:198:13)
13 verbose stack at maybeClose (internal/child_process.js:982:16)
13 verbose stack at Process.ChildProcess._handle.onexit (internal/child_process.js:259:5)
14 verbose pkgid [email protected]
15 verbose cwd C:\fivem-fxadmin
16 verbose Windows_NT 6.1.7601
17 verbose argv "C:\Program Files\nodejs\node.exe" "C:\Program Files\nodejs\node_modules\npm\bin\npm-cli.js" "start" "server.json"
18 verbose node v10.16.0
19 verbose npm v6.9.0
20 error code ELIFECYCLE
21 error errno 1
22 error [email protected] start: node src/main.js "server.json"
22 error Exit status 1
23 error Failed at the [email protected] start script.
23 error This is probably not a problem with npm. There is likely additional logging output above.
24 verbose exit [ 1, true ]

Update TR

Please add Turkish language

Update 2.0 launch error on Linux (version convar not set or in the wrong format)

Hey i try new 2.0 update on my dev server on Linux latest stable build 1971. I configure by your readme.md and when i try start my server i obtain this error. Can you help me?

Translating

How could I change the messages ingame when the server is gonna restart? for example

Random txAdmin server crashes

Hello,
im making new server now and use txAdmin for many thinks. But every day i saw some randomly crashs detected in discord-log:

Stats:
Uptime: 8 days, 8 hours, 1 minute
Full Crashes: 2 - From ME byged scripts
Partial Crashes: 7

And after those Partial Crashes, some of maps that are added on my server didn't laod, need to restart server to load them properly.

Issue when adding server config

As seen in the image above, it is saying that there are no endpoint_add_* commands being executed inside the config, which is false. This is just because I am passing [::] (IPv6) and not my local IPv4 address.

Question

Is there a way to disable partial crash restarts? Other then setting up in the config 9999... failures??

Multiple Instances

Can i run like 2 Different Instances of TXadmin on like different ports? Like a Sinusbot one on port 8088 and another one on 8089 or like 2 mc servers on different ports?

Only FiveM server are possible but i mean with txAdmin.

windows high cpu use

https://gyazo.com/d95231a24e1b1b93d3ff328c87b60728
https://gyazo.com/0726530281dd192bc4342306fb829b1b

SSL support

Using Lets Encrypt to apply SSL to all sites on my Centos 7 box. I am not familiar with NodeJS

What web server is it using and where would I go about applying the SSL to secure the web portal?

Permissions not work

No matter what permissions you set to any user, he get all permissions

domain

Hello, i have own server domain, how to use it instead of ip:40120

Permissions

Hi, with the new TxAdmin on version 2.0 the persmissions do not take any effect and everyone have "all_permisions" however we set them only few permissions.

windows

how to install in windows ?

Sometimes FXserver isn't closed / opened properly

Hi there,
I've had a few instances where TXadmin would restart the server (or we would call a restart) and the server doesn't end up coming back up, due to not closing FXserver properly before.
Is this something that was an issue in the past or known about?