Solifex Studios
DiscordSynthesisWiki
Browse the wiki

Features

Live stats & bot status

Player-count channels that update themselves, and a bot presence that reflects your server.

Module

modules.stats

Config

features.stats, config.yml bot

Platform

All

Stat channels

Show the live player count and unique-player total in a Discord channel name or topic. Point each stat at a voice or text channel and the plugin keeps it current.

yamlfeatures.yml
stats:
  playerCount:
    channelId: '123456789012345678'
    text: 'Player Count: %v%'
    # NAME_ONLY / TOPIC_ONLY / BOTH
    updateType: NAME_ONLY
    updateIntervalSeconds: 0    # 0 = default 300s (min 60 — Discord limits)
    enabled: true
  uniquePlayersCount:
    channelId: '123456789012345678'
    text: 'Unique players: %v%'
    enabled: true

Note

%v% is the stat's value. Discord rate-limits channel edits, so the minimum update interval is 60 seconds.

Bot presence

The bot's status line lives in config.yml. Use a single static status, or cycle through several.

yamlconfig.yml
bot:
  # 0 PLAYING · 1 STREAMING · 2 LISTENING · 3 WATCHING · 4 CUSTOM · 5 COMPETING
  activityTypeId: 0
  # Placeholders: %players%, %maxplayers%, %server%
  activity: '%players% players are currently online!'
  status: ONLINE               # ONLINE / IDLE / DND / INVISIBLE
  changeBotStatus: true
  enablePresenceCycling: false
  presenceCycleInterval: 60

With enablePresenceCycling: true, the static status is ignored and the bot rotates through the presences list, each with its own optional duration.