Skip to main content

👤 Presence Settings

Customize how your TKI Auth bot appears in the Discord user list with dynamic status updates and activity messages.

Configuration Overview​

Presence:
  Status: "idle"
  Activity:
    Enabled: true
    Type: "Competing"
    Intervall: 5
    Texts:
      - "{total-products} - Total Products"
      - "{total-user} - Total Members"
      # ... more status texts

Setting Details​

Status​

Type: string | Required: Yes | Default: "online"

Sets the bot's online status indicator that appears next to its name.

Status: "idle"

Available Options:

  • "online" - 🟢 Green dot (Online)
  • "idle" - 🟡 Yellow dot (Away/Idle)
  • "dnd" - 🔴 Red dot (Do Not Disturb)
  • "invisible" - ⚫ No dot (Appears offline)

Activity Settings​

Enabled​

Type: boolean | Required: Yes | Default: true

Controls whether the bot displays activity status messages.

Activity:
  Enabled: true  # Shows activity status
  Enabled: false # No activity status shown

Type​

Type: string | Required: Yes | Default: "Playing"

The type of activity the bot displays.

Type: "Competing"

Available Types:

  • "Playing" - 🎮 Playing [activity]
  • "Competing" - 🏆 Competing in [activity]
  • "Watching" - 👀 Watching [activity]
  • "Listening" - 🎵 Listening to [activity]

Intervall​

Type: number | Required: Yes | Default: 5

How often (in seconds) the bot updates its activity status, cycling through the texts array.

Intervall: 5  # Updates every 5 seconds
Intervall: 30 # Updates every 30 seconds
Performance Note

Setting a very low interval (1-2 seconds) may cause rate limiting. We recommend 5-10 seconds for optimal performance.

Texts​

Type: array | Required: Yes

An array of status messages that the bot cycles through. Supports dynamic variables.

Texts:
  - "{total-products} - Total Products"
  - "{total-user} - Total Members"
  - "{total-licenses} - Total Licenses"
  - "{successful-requests} - Successful Requests"

Available Variables​

Use these variables in your status texts to display real-time information:

VariableDescriptionExample Value
{total-channels}Total channels in the server25
{total-members}Total members including bots150
{total-user}Total members excluding bots142
{total-products}Total products in system8
{total-licenses}Total licenses created1,234
{total-requests}Total API requests made45,678
{successful-requests}Successful API requests44,210
{rejected-requests}Rejected API requests1,468

Example Configurations​

Gaming Theme​

Presence:
  Status: "dnd"
  Activity:
    Enabled: true
    Type: "Playing"
    Intervall: 8
    Texts:
      - "with {total-licenses} licenses"
      - "Auth Guard v2.0"
      - "{successful-requests} successful auths"

Professional Theme​

Presence:
  Status: "online"
  Activity:
    Enabled: true
    Type: "Watching"
    Intervall: 10
    Texts:
      - "{total-products} products"
      - "{total-user} users"
      - "system status: ✅"
      - "{total-requests} total requests"

Competitive Theme​

Presence:
  Status: "idle"
  Activity:
    Enabled: true
    Type: "Competing"
    Intervall: 6
    Texts:
      - "License Authentication"
      - "{successful-requests} successful validations"
      - "TKI Auth Championship"
      - "{total-licenses} active licenses"

Minimal Setup​

Presence:
  Status: "online"
  Activity:
    Enabled: true
    Type: "Watching"
    Intervall: 15
    Texts:
      - "TKI Auth System"

Advanced Examples​

Multi-Language Status​

Texts:
  - "🇺🇸 {total-products} Products"
  - "🇩🇪 {total-licenses} Lizenzen" 
  - "🇫🇷 {total-user} Utilisateurs"
  - "🇪🇸 {successful-requests} Éxitos"

Emoji-Rich Status​

Texts:
  - "🔐 {total-licenses} Licenses Protected"
  - "⚡ {successful-requests} Fast Auths"
  - "🛡️ Security Level: Maximum"
  - "📊 {total-requests} Total Requests"
  - "👥 {total-user} Active Users"

Time-Based Status​

Texts:
  - "🌅 Morning Auth: {successful-requests}"
  - "☀️ {total-products} Products Online"
  - "🌙 Night Guard: {total-licenses}"
  - "⭐ {total-user} Stars Online"

Troubleshooting​

Activity Not Updating​

  • Check that Enabled is set to true
  • Verify the interval is reasonable (5+ seconds)
  • Ensure at least one text is provided in the array

Variables Not Working​

  • Double-check variable spelling and formatting
  • Make sure variables are wrapped in {}
  • Verify your database connection is working

Bot Appears Offline​

  • Check the Status setting
  • If using "invisible", the bot will appear offline
  • Verify the bot token and connection

Best Practices​

  1. Keep intervals reasonable - 5-15 seconds works well
  2. Limit text array size - 5-10 messages prevent repetition fatigue
  3. Use meaningful variables - Show relevant system statistics
  4. Test different types - Different activity types suit different bot purposes
  5. Consider your audience - Match the tone to your server's style