FableStats

FableStats is a lightweight and highly flexible Spigot/Paper plugin (compatible with versions 1.16–1.21.x) that allows players to instantly view their personal statistics directly in the chat.

Forget bulky menus - now your players can check their progress with a single, simple command. With full PlaceholderAPI support, you can tailor every message to match your server's unique style.

!example

✨ Features

• Customizable Statistics: Display anything from total playtime to specific combat data.
• Complete Control: Every message sent to the player is fully configurable in the config.yml, including support for color codes.
• Multi-language Support: Includes built-in support for English and Russian.
• PlaceholderAPI Integration: Use hundreds of external placeholders to create detailed player summaries.
• Built-in Placeholders: The plugin provides its own set of placeholders for session tracking and specific stats.

📊 Available Placeholders

The plugin registers its own expansion with the following built-in placeholders:

  Placeholder: %fablestats_player_name%                 
  Description: Player name                              
  ────────────────────────────────────────              
  Placeholder: %fablestats_time_played_total%           
  Description: Total play time                          
  ────────────────────────────────────────              
  Placeholder: %fablestats_time_since_last_played%
  Description: Current session duration
  ────────────────────────────────────────
  Placeholder: %fablestats_first_join_date%
  Description: First join date (DD.MM.YYYY)
  ────────────────────────────────────────
  Placeholder: %fablestats_deaths%
  Description: Total deaths
  ────────────────────────────────────────
  Placeholder: %fablestats_kills%
  Description: Player kills (PvP)
  ────────────────────────────────────────
  Placeholder: %fablestats_mob_kills%
  Description: Mob kills
  ────────────────────────────────────────
  Placeholder: %fablestats_damage_dealt%
  Description: Total damage dealt
  ────────────────────────────────────────
  Placeholder: %fablestats_damage_taken%
  Description: Total damage taken
  ────────────────────────────────────────
  Placeholder: %fablestats_distance_walked%
  Description: Distance walked

💬 Supported Languages

• English
• Ukranian
• Russian

🛠 Commands & Permissions

• /stats - Displays the player's statistics (Permission: customstats.use).
• /stats reload - Reloads the configuration and language files (Permission: customstats.reload).

Note: You can change the base command name in the config.yml.

⚙️ Installation

1. Download the JAR file and place it into your server's plugins folder.
2. (Recommended) Install PlaceholderAPI to enable full placeholder functionality.
3. Restart your server to generate the default configuration.
4. Configure your preferred language and message format in plugins/CustomStats/config.yml.