Skip to content

Statistics ​

When the Player Stats plugin is enabled, a Statistics tab appears in the admin panel showing per-player game data ranked by games played. Use Refresh to reload and Reset All to clear all stats (requires confirmation).

Players can also check their own stats in-game with #stat (aliases: #stats, #mystats). The response is sent privately and localized to the player's language.

Configuration ​

Statistics are configured in the plugin's own config file, [Empostor.Plugins.PlayerStats]Config.json — not in config.json. See Player Stats — Configuration for the full field reference.

json
{
  "Enabled": false,
  "PersistToFile": true
}
KeyDefaultDescription
EnabledfalseWhether player statistics tracking is enabled.
PersistToFiletrueSave statistics to Data/player_stats.json. If false, stats are memory-only and lost on restart.

Tracked Metrics ​

StatDescription
Games PlayedTotal games participated in
WinsGames won as crewmate
LossesGames lost as crewmate
Impostor WinsGames won as impostor
KillsTotal kills performed
DeathsTotal times killed
Tasks CompletedTotal tasks completed
Times ExiledTotal times voted out

API Endpoints ​

MethodPathDescription
GET/api/admin/player/statsReturns all player stats sorted by games played
GET/api/admin/player/stats/{friendCode}Returns stats for a single player
POST/api/admin/player/stats/resetClears all player statistics (requires auth)