Giter Club home page Giter Club logo

txadmin's Introduction

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.

zap-hosting


Why this fork?

It's been several years since many servers have requested third-party authentication for their systems to simply have one platform to manage their admins. Now, I also wanted this feature for new projects and started developing this feature!

While I was developing this feature, I asked tabarra some questions and showed them the idea. He simply said that we won't merge this into txAdmin because of the new partnership with R*.

So, this will be a modified version of txAdmin which is always up to date with the original txAdmin and my third-party authentication changes. You can easily use this version, which is never outdated because I will keep this repository updated with the original version and merge changes.

How to use "Third-Party Authentication"

  • Go to http://ip:port/login?thirdPartyRedirect=...
  • The thirdPartyRedirect is the endpoint that should get the session information. It must be encoded, by just using this tool.

    As an example, we want to authenticate with your custom endpoint, which is http://ip:port/authenticate. http://ip:port/login?thirdPartyRedirect=http%3A%2F%2Fip%3Aport%2Fauthenticate

  • After authenticating with CFX.RE or username/password, you will be redirected to your thirdPartyRedirect URL with the session, which is Base64 encoded.

    In our example, it's http://ip:port/authenticate?session=... You can use tools to display the response, which is a JSON pair containing information about the user and the token.

Main Features

  • Third-Party Authentication
  • 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 tick time performance chart with player count (example)
    • 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

txadmin's People

Contributors

tabarra avatar tasooneasia avatar goatg33k avatar itschip avatar 1337dragneel avatar avarianknight avatar blattersturm avatar monsterzockerhd avatar evandarwin avatar koko991 avatar trsak avatar yannickboy15 avatar latesttt avatar plokmjnb avatar wowjeeez avatar tr1ckz avatar rex2630 avatar osenex avatar rdlh avatar nimplex avatar hypelevels avatar flawwsx avatar chatdisabled avatar jonisssonis avatar carlos55ml avatar poggicek avatar oskarssonn avatar abdulkadiraktas avatar azelout avatar cata-a1138 avatar

Stargazers

Lukas Leisten avatar

Watchers

Lukas Leisten avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.