Platform Features
Server Presence & Online Status
The Presence API allows you to track whether users are currently online or offline across the ModVC platform.
How Presence Works
ModVC uses a heartbeat system. Active clients ping the /api/presence endpoint every 30 seconds. If a user fails to send a heartbeat within 45 seconds, they are considered offline.
Fetching Online Users
You can fetch the real-time presence state of users. This endpoint returns a list of all currently active users globally.
GET /api/presence
Authorization: Bot YOUR_BOT_TOKEN
{
"user_123": {
"state": "online",
"displayName": "John",
"photoURL": "https://..."
}
}
Bot Presence
Bots do not automatically show as online. If you want your bot to have an online indicator, your server code must explicitly send POST heartbeat requests to the presence endpoint.