Playtime Tracker 0.1

# Playtime Tracker pour Garry’s Mod

## Informations générales

• Nom : Player Stats System
• Auteur : Benjinski
• Version : 0.1
• Type : Addon serveur
• Dépendances : Aucune
• Langue : Français
• Fichier principal : lua/autorun/player_stats.lua

---

## Description

Player Stats System est un addon simple et léger pour Garry’s Mod permettant de suivre
les statistiques essentielles des joueurs :

• Nombre de connexions
• Temps total passé sur le serveur
• Date de la première connexion

L’addon inclut également un classement Top 10 basé sur le temps de jeu total.

Toutes les données sont stockées localement côté serveur, sans dépendance externe.

---

## Fonctionnalités

• Suivi automatique du temps de jeu
• Comptage des connexions
• Enregistrement de la première connexion
• Classement Top 10 par temps de jeu
• Sauvegarde persistante en JSON
• Léger et optimisé (aucun impact performance)

---

## Installation

1. Créez un dossier dans votre répertoire addons/ :
player_stats_system/

2. Ajoutez la structure suivante :
player_stats_system/
└── lua/
└── autorun/
└── player_stats.lua

3. Redémarrez votre serveur Garry’s Mod.

---

## Commandes disponibles

### !stats
Affiche vos statistiques personnelles dans le chat :

• Nombre total de connexions
• Temps total passé sur le serveur (en minutes)
• Date de la première connexion

### !top10
Affiche les 10 joueurs ayant le plus de temps de jeu cumulé sur le serveur.

---

## ️ Stockage des données

Les statistiques sont enregistrées dans le dossier :
data/player_stats/

Chaque joueur possède un fichier JSON unique, par SteamID, contenant :

connections : nombre total de connexions

totalTime : temps total joué (en minutes)

firstJoin : timestamp de la première connexion

sessionStart : timestamp de la session en cours

---

## Notes

Les données sont sauvegardées automatiquement

Compatible avec tous les modes de jeu

Fonctionne uniquement côté serveur

Aucun module ou addon requis

---

## Licence

Addon libre d’utilisation et de modification pour un usage personnel ou communautaire.
Merci de conserver les crédits de l’auteur.