Skip to content

Latest commit

 

History

History
105 lines (93 loc) · 4.99 KB

README.md

File metadata and controls

105 lines (93 loc) · 4.99 KB
Raw

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 18000 servers worldwide at any given time.

zap-hosting


Main Features

  • Recipe-based Server Deployer: create a server in under 60 seconds! (more info)
  • Start/Stop/Restart your server instance or resources
  • Server tick time performance chart (example)
  • Full-featured in-game admin menu:
    • Player Mode: NoClip, God
    • Teleport: waypoint, coords and back
    • Vehicle: Spawn, Fix, Delete
    • 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
  • Access control:
    • Login via Password or CitizenFX
    • Admin permission system (more info)
    • Action logging
    • Brute-force protection
  • Discord Integration:
    • Server status command (/status)
    • Add to Whitelist command (/addwl)
    • Command spam prevention
  • Monitoring:
    • Auto Restart FXServer on crash
    • Server’s CPU/RAM consumption
    • Live Console (with log file and command history)
    • Online players chart
    • Server Activity Log (connections/disconnections, kills, chat, explosions and custom commands)
  • Player Manager:
    • Warning system
    • Ban (temporary or permanently) system
    • Whitelist system
    • Take notes about players
    • Keep track of player's play and session time
    • Import bans from EasyAdmin, BanSQL, vMenu, vRP, el_bwh
    • 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

Development

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;
  • Favicons made by Freepik from www.flaticon.com are licensed under CC 3.0 BY;
  • Warning Sounds (1/2) made by Ultranova105 are licensed under CC 3.0 BY;
  • Special thanks to everyone that contributed to this project, specially the very fine Discord folks that provide support for others;
  • Also thanks to our Discord's sky{something} bot, who will hopefully spare us when he becomes self aware and rebels against humanity.