Server Stats

The Stats module creates auto-updating voice channels that display server and checkout metrics.

What It Does

  • Creates voice channels with live stats (checkouts, members, roles, etc.).

  • Updates on a timer (default: 5 minutes).

  • Supports per-stat time ranges and custom channel name templates.

Requirements

  • Manage Channels (to create and edit voice channels).

  • View Channel, Send Messages, Read Message History.

Quick Setup

/stats setup

Pick a category to hold the stat channels. The bot will create a default set of stat channels.

Add Custom Stat Channels

/stats add

Pick a stat type, optional role (for role-based stats), and a time range.

Supported stat types include:

  • total_checkouts, successful_checkouts, failed_checkouts, success_rate

  • unique_users, total_members, online_members, bot_count

  • channel_count, role_count, members_with_role

  • total_spending, avg_checkout_value, unique_sites, top_site

View Current Config

Shows current channels, time ranges, and templates.

Enable or Disable Updates

Set Global Time Range

Applies to checkout-based stats that use the global range.

Rename Channels with Templates

Use placeholders:

  • $value - current stat value

  • $stat_type - stat type key

  • $display_name - default display name

To restore the default format:

Remove Channels

User and Leaderboard Views

Lists users with checkout activity, with optional CSV export.

Shows top users by checkouts or spending.

Cleanup

Deletes all stat channels and configuration.

Tips

  • Keep stats in a dedicated category.

  • Use shorter names to avoid channel name limits.

Last updated