Skip to content

citizenfx/txAdmin-playerGen

Repository files navigation

txAdmin-playerGen

This project is a development tool for txAdmin that sends fake playerJoining and playerDropped events to txAdmin for the purposes of populating the web player list in a realistic manner.

Important

This project does not create "fake players" for the FiveM server list, nor to the in-game player list.
It exclusively mocks a playerlist inside the txAdmin Web Panel.
This is a development utility and nothing more.

screenshot

Dev Notes

  • To simulate the players, I did statistical analysis on all servers for the ideal size (max, median, quantile, etc) of player identifiers, name and HWIDs. As far as I can tell, HWIDs change with time. The ideal name length was dropped in favor of looking real and safe.
  • To simulate realistic join/leave behavior, I used the exponential random PRNG (which looks like radioactive decay), which lambda can be adjusted through a slider, as well as the join/leave bias.
  • There is no error handling for failed API calls, but that doesn't really matter in this use case.
  • Due to the item above, if the speed is at the max it is expected some small desync issues with txAdmin.
  • I used this opportunity to test DaisyUI, so the theme of course doesn't match txAdmin.

Future Work (TODO)

As needed during the txAdmin development, the changes below might be welcomed:

  • Option to add/remove arbitrary players with arbitrary data.
  • Option to actually Sync the txAdmin playerlist instead of just pushing events to it.

License and Credits

About

Tool to mock txAdmin playerlists for dev purposes.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published