Statistics System

CocoGuild tracks detailed kill and death statistics for each guild.

Configuration

plugins/CocoGuild/config.yml

settings:
  statistics:
    type: "sqlite" # Options: sqlite, mysql
    sqlite-file: "stats.db"
    mysql:
      table-prefix: "stats_"
    pool:
      maximum-pool-size: 5
      minimum-idle: 1

    count-own-guild-kills: false  # Count kills on your own guild members
    count-ally-kills: true        # Count kills on allied guild members
    count-own-guild-deaths: false # Count deaths by your own guild members
    count-ally-deaths: true       # Count deaths by allied guild members

Tracked Statistics

Statistic	Description
🔱 Kills	Total player kills by guild members
💀 Deaths	Total player deaths of guild members
📊 KDR	Kill/Death Ratio (Kills ÷ Deaths)

PlaceholderAPI Integration

Use these placeholders to display statistics:

Placeholder	Description
%cocoguild_guild_kills%	Your guild's total kills
%cocoguild_guild_deaths%	Your guild's total deaths
%cocoguild_guild_kdr%	Your guild's Kill/Death Ratio

Toplists

Display leaderboards using these placeholders:

Placeholder	Description
%cocoguild_toplist_kills_<place>%	Guild at position in kills leaderboard
%cocoguild_toplist_deaths_<place>%	Guild at position in deaths leaderboard
%cocoguild_toplist_kdr_<place>%	Guild at position in KDR leaderboard

Example Usage

Top 3 Guilds by Kills:
%cocoguild_toplist_kills_1%
%cocoguild_toplist_kills_2%
%cocoguild_toplist_kills_3%

Customizing Toplist Format

plugins/CocoGuild/config.yml

placeholders:
  toplist_kills:
    placeholder: "toplist_kills_<place>"
    value: "&#f5c400#%place% &f%player% &7» &#FF3737%count% kills"
    none: "&#f5c400#%place% &f- &7» &#FF3737- kills"

  toplist_deaths:
    placeholder: "toplist_deaths_<place>"
    value: "&#f5c400#%place% &f%player% &7» &#FF3737%count% deaths"
    none: "&#f5c400#%place% &f- &7» &#FF3737- deaths"

  toplist_kdr:
    placeholder: "toplist_kdr_<place>"
    value: "&#f5c400#%place% &f%player% &7» &#FF3737%count% KDR"
    none: "&#f5c400#%place% &f- &7» &#FF3737- KDR"

Multi-Server Statistics

For networks with multiple servers, you can track statistics separately:

plugins/CocoGuild/config.yml

settings:
  statistics:
    type: mysql
    mysql:
      table-prefix: "survival_stats_"  # Unique prefix per server

Each server should have a unique table-prefix (e.g., survival_stats_, kitpvp_stats_, factions_stats_).

Reset Statistics

Admins can reset a guild's statistics using:

/guild admin resetstatistic <guild>

This requires the cocoguild.admin.resetstatistic permission.