> For the complete documentation index, see [llms.txt](https://docs.fivemstats.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fivemstats.net/tgiann-fivem-stats-script.md).

# tgiann-fivem-stats-script

The server-side script that connects your FiveM server to fivemstats.net.

`tgiann-fivem-stats-script` collects player, session, chat, economy and inventory data on your FiveM server and serves it to the [FiveM Stats dashboard](https://www.fivemstats.net/dashboard/my-servers).

{% hint style="success" %}
**Version 2.0.0** runs on FXServer's built-in HTTP server. There is no extra port to open any more: FiveM Stats connects through your server IP and game port. Full script docs (configs, exports, upgrading from 1.x): [TGIANN docs](https://tgiann.gitbook.io/tgiann/scripts/tgiann-fivem-stats-script).
{% endhint %}

## Requirements

* FXServer artifact **10488** or newer
* [oxmysql](https://github.com/overextended/oxmysql)
* [ox\_lib](https://github.com/overextended/ox_lib)
* tgiann-core
* ESX, QB-Core or QBOX

## What the dashboard shows

* **Overview**: live player count, uptime, script version and an activity heatmap
* **Players**: a searchable player list and a detail page per character
* **Statistics**: playtime trend, login patterns, distributions and top players per period, with export
* **Inactivity**: players who have not joined for a chosen number of days, with export to PDF, Excel, CSV and JSON
* **Sessions, Chat logs, Combat, Economy, Items, Jobs, Vehicles, Leaderboards and Map**
* **Backups**: create, download and delete database backups
* **Members**: give other Discord users access to chosen pages

## Pages

* Installation
* [Upgrading from 1.x](https://tgiann.gitbook.io/tgiann/scripts/tgiann-fivem-stats-script/upgrading-from-1.x)
