Skip to content
DiSky

🚀 This new wiki is in beta! Please double-check for any issue and report them on the GitHub

Presence & Status

Your bot can display custom presence activities and online status, just like regular Discord users. This guide shows you how to customize both.

Understanding the Difference

Section titled “Understanding the Difference”
  • Presence: The activity text shown in your bot’s profile (e.g., “Playing Minecraft”)
  • Status: The colored indicator next to your bot’s avatar (🟢 Online, 🟡 Idle, etc.)

Presence Activities

Section titled “Presence Activities”

Your bot can display what it’s currently doing. Discord supports several activity types:

Activity Types

Section titled “Activity Types”

Shows as “Playing [text]”

set presence of bot named "MyBot" to playing "Minecraft"

Result: Playing Minecraft

Online Status

Section titled “Online Status”

The status indicator appears as a colored circle at the bottom-right of your bot’s avatar.

Available Statuses

Section titled “Available Statuses”
StatusIndicatorDescription
online🟢 GreenBot is online and active
idle🟡 YellowBot is idle/away
do not disturb🔴 RedBot should not be disturbed
offline⚪ GrayBot appears offline (won’t be shown in member list)
invisibleNoneBot is online but appears offline

Setting Status

Section titled “Setting Status”
set online status of bot named "MyBot" to online

Your bot appears online with a green indicator 🟢

Complete Examples

Section titled “Complete Examples”

Dynamic Presence in on ready

Section titled “Dynamic Presence in on ready”
define new bot named "MyBot":
    token: "YOUR_TOKEN"
    intents: default intents


    on ready:
        # Set online status
        set online status of event-bot to online


        # Set presence
        set presence of event-bot to playing "on %size of guilds of event-bot% servers"


        send "&aBot is ready!" to console

Cycling Presences

Section titled “Cycling Presences”
every 30 seconds:
    set {_random} to random integer between 1 and 3


    if {_random} is 1:
        set presence of bot named "MyBot" to playing "Minecraft"
    else if {_random} is 2:
        set presence of bot named "MyBot" to watching "the server"
    else:
        set presence of bot named "MyBot" to listening "commands"

Status Based on Activity

Section titled “Status Based on Activity”
command /maintenance [<text>]:
    trigger:
        if arg-1 is "on":
            set online status of bot named "MyBot" to do not disturb
            set presence of bot named "MyBot" to playing "Maintenance Mode"
            send "Bot is now in maintenance mode"
        else:
            set online status of bot named "MyBot" to online
            set presence of bot named "MyBot" to playing "Minecraft"
            send "Bot is back online"

Member Count Presence

Section titled “Member Count Presence”
define new bot named "MyBot":
    token: "YOUR_TOKEN"
    intents: guild members, default intents


    on ready:
        set {_totalMembers} to 0
        loop guilds of event-bot:
            add size of members of loop-value to {_totalMembers}


        set presence of event-bot to watching "%{_totalMembers}% members"

Best Practices

Section titled “Best Practices”

Presence

Section titled “Presence”
  1. Keep it relevant - Show what your bot actually does
  2. Keep it short - Long presence texts get truncated
  3. Update dynamically - Show live stats like server/member count
  4. Don’t spam updates - Limit updates to once every 30+ seconds

Status

Section titled “Status”
  1. Use online for normal operation - Default status
  2. Use do not disturb for maintenance - Signals downtime
  3. Use idle sparingly - Better for scheduled tasks
  4. Avoid offline/invisible - Users might think the bot is broken

Common Patterns

Section titled “Common Patterns”

Server Count

Section titled “Server Count”
set presence of bot named "MyBot" to playing "on %size of guilds of event-bot% servers"

Help Command

Section titled “Help Command”
set presence of bot named "MyBot" to listening "/help for commands"
Section titled “Website Link”
set presence of bot named "MyBot" to playing "Visit bot.example.com"

Version Information

Section titled “Version Information”
set presence of bot named "MyBot" to playing "v2.0.0 | /help"

Troubleshooting

Section titled “Troubleshooting”

Presence Not Updating

Section titled “Presence Not Updating”

Possible causes:

  • Bot not fully loaded yet
  • Discord API rate limits
  • Network issues

Solution: Set presence in the on ready section and avoid rapid updates.

Streaming Status Not Purple

Section titled “Streaming Status Not Purple”

The URL must be from YouTube or Twitch:

# ✅ Correct
set presence of bot "MyBot" to streaming "coding" with url "https://twitch.tv/user"


# ❌ Wrong - won't show purple indicator
set presence of bot "MyBot" to streaming "coding" with url "https://example.com"

Status Doesn’t Change

Section titled “Status Doesn’t Change”

Make sure you’re using the correct syntax:

# ✅ Correct
set online status of bot named "MyBot" to idle


# ❌ Wrong
set status of bot named "MyBot" to "idle"
Section titled “Examples Gallery”

Music Bot

Section titled “Music Bot”
# When music starts
set presence of bot named "MusicBot" to listening "🎵 %song name%"
set online status of bot named "MusicBot" to online


# When music stops
set presence of bot named "MusicBot" to listening "/play to start"
set online status of bot named "MusicBot" to idle

Moderation Bot

Section titled “Moderation Bot”
set presence of bot named "ModBot" to watching "for rule breakers"
set online status of bot named "ModBot" to online

Status Bot

Section titled “Status Bot”
set presence of bot named "StatusBot" to watching "server status"
set online status of bot named "StatusBot" to online

Next Steps

Section titled “Next Steps”