Player Stats System 0.1

Addon Information

• Name: Player Stats System
• Author: Benjdiii
• Main File: lua/autorun/player_stats.lua
• Dependencies: None
• Installation: Simply place the file inside your addons/ folder
• Version: 0.1

Description

This addon tracks and stores essential player statistics in real-time, making it ideal for community, RP, or PvP servers.

Each player’s stats are saved locally in the data/player_stats/ folder as individual JSON files based on their SteamID64.

Features

• Tracks number of connections
• Logs total playtime on the server
• Saves first connection date
• Players can check stats using !stats
• Displays top 10 most active players with !top10
• Uses local file storage (data/) – no database needed
• Lightweight, autonomous, and optimized

Configuration

No configuration is needed out of the box.
However, stats are stored automatically per player under:

bash
CopierModifier
data/player_stats/STEAMID64.txt


Each file contains:


json
CopierModifier
{
"connections": 5,
"totalTime": 3642,
"firstJoin": 1719322323,
"sessionStart": 1719325900
}

You can manually modify or remove these files to reset individual stats.

Commands

• !stats — Show personal statistics:
  • Number of connections
  • Total playtime (in minutes)
  • First connection date
• !top10 — List the 10 players with the highest total playtime

Notes

• Uses SteamID64 to identify players
• Works with any gamemode (DarkRP, Sandbox, MilitaryRP, etc.)
• No MySQL, SQLite, or external dependencies
• Perfect for servers that want lightweight player tracking