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.
## Main Features
- Recipe-based Server Deployer: create a server in under 60 seconds! ([more info](docs/recipe.md))
- Start/Stop/Restart your server instance or resources
- Server tick time performance chart ([example](https://i.imgur.com/VG8hpzr.gif))
- 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](docs/permissions.md))
- 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](docs/custom_serverlog.md))
- Player Manager:
- [Warning system](https://www.youtube.com/watch?v=DeE0-5vtZ4E)
- 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](docs/events.md))
- Translation Support ([more info](docs/translation.md))
- FiveM's Server CFG editor & validator
- Responsive web interface with Dark Mode 😎
Also, check our [Feature Graveyard](docs/feature_graveyard.md) 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 `/../txData` and on Linux `/../../../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:
```bash
# 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](docs/development.md).
## License, Credits and Thanks
- This project is licensed under the [MIT License](https://github.com/tabarra/txAdmin/blob/master/LICENSE);
- [Favicons](https://www.flaticon.com/free-icon/support_1545728?term=gear%20wrench&page=2&position=11) made by Freepik from [www.flaticon.com](https://www.flaticon.com) are licensed under [CC 3.0 BY](http://creativecommons.org/licenses/by/3.0/);
- Warning Sounds ([1](https://freesound.org/people/Ultranova105/sounds/136756/)/[2](https://freesound.org/people/Ultranova105/sounds/136754/)) made by Ultranova105 are licensed under [CC 3.0 BY](http://creativecommons.org/licenses/by/3.0/);
- 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.