OnlinePing

A Red Discord Bot cog that alerts when tracked members change Discord status.

Overview

A Discord bot cog for Red Bot that monitors member presence changes and sends notifications when tracked users come online or change status. Supports per-guild configuration with customizable notification modes and cooldowns.

Features

• Status Tracking - Monitor when members come online
• Multiple Targets - Track multiple users per guild
• Notification Modes - online_only or all status changes
• Channel Selection - Choose where to post alerts
• Cooldown Support - Prevent notification spam

Requires Discord Privileged Gateway Intents: Guild Presences and Guild Members.

Tech Stack

Component	Technology
Language	Python 3.8+
Framework	Red Discord Bot v3.5+
API	discord.py
Storage	Red Bot Config

Project Structure

online-ping-cog/
└── onlineping/
    ├── onlineping.py    # Main cog implementation
    ├── __init__.py      # Package initialization
    └── info.json        # Cog metadata

Installation

Via Downloader (Recommended)

.load downloader
.repo add onlineping https://github.com/Kevin-Mok/online-ping-cog
.cog install onlineping onlineping
.load onlineping

Manual Installation

# Clone to Red Bot cogs directory
git clone https://github.com/Kevin-Mok/online-ping-cog.git
cd online-ping-cog
# Copy onlineping folder to Red Bot cogs directory

Commands

Command	Description
[p]onlineping track @user	Start tracking a user
[p]onlineping untrack @user	Stop tracking a user
[p]onlineping mode [online_only/all]	Set notification mode
[p]onlineping channel #channel	Set notification channel
[p]onlineping list	Show tracked users

Requirements

• Red Discord Bot v3.5+
• Guild Presences and Guild Members intents enabled
• Bot permission to Send Messages in target channel

If your bot is in ≥100 servers, Discord may require intent approval.

Why This Project is Interesting

Technical Highlights

1. Discord API Integration

   • Privileged Gateway Intents
   • Presence update events
   • Guild member caching

2. Bot Development

   • Red Bot cog architecture
   • Per-guild configuration
   • Command system integration

3. Event Handling

   • Presence change detection
   • Status emoji mapping
   • Cooldown management

Skills Demonstrated

• Python: Async/await, discord.py
• Bot Development: Red Bot framework, cog design
• Discord API: Intents, presence updates
• Configuration: Per-guild settings, data persistence

Author

Kevin Mok