Skip to main content
Utility commands provide general bot information and system health checks.

/help

Interactive help system with command categories.

Command Signature

/help

Features

Opens an interactive panel with categorized commands: Categories:
  • πŸ“‹ Status & Info - View raids, stats, changelog
  • πŸ“… Availability - Set/view availability times
  • βš”οΈ Raid Management (Admin) - Create & manage raids
  • βš™οΈ Server Setup (Admin) - Channels, settings, templates
  • πŸ”„ Recurring Raids (Admin) - Automatic scheduling
  • πŸ“Š Stats & Analytics (Admin) - Server-wide data
  • πŸ“ Polling (Admin) - Time slot polls
Navigation:
  • Click category buttons to view detailed command help
  • Each category shows:
    • Command signatures
    • Descriptions
    • Usage tips
    • Examples
  • ”← Back to Overview” returns to main menu
  • Buttons expire after 5 minutes
Permission-aware:
  • Shows admin categories only if you have admin access
  • Shows privileged commands if you have specific role permissions
  • Adapts to your access level

Example Output

IOP Raids Command Reference

You have full admin access. Click a category for detailed help.

πŸ“‹ Status & Info
View raids, stats, changelog

πŸ“… Availability
Set/view availability times

βš”οΈ Raid Management
Create & manage raids

βš™οΈ Server Setup
Channels, settings, templates

πŸ”„ Recurring Raids
Automatic scheduling

πŸ“Š Stats & Analytics
Server-wide data

πŸ“ Polling
Time slot polls

Buttons expire after 5 minutes

/ping

Check bot health and response time.

Command Signature

/ping

Output

Shows:
  • Roundtrip latency - Time from command to response
  • WebSocket latency - Connection to Discord
  • Uptime - How long the bot has been running
  • Active Raids - Open and closed raid counts

Example Output

πŸ“ Pong!
β€’ Roundtrip: 142ms
β€’ WebSocket: 38ms
β€’ Uptime: 2d 14h 32m
β€’ Active Raids: 8 open, 3 closed

Interpreting Latency

Good:
  • Roundtrip < 200ms
  • WebSocket < 100ms
Moderate:
  • Roundtrip 200-500ms
  • WebSocket 100-200ms
Poor:
  • Roundtrip > 500ms
  • WebSocket > 200ms
If latency is high:
  • May be temporary Discord issues
  • May be bot server load
  • Contact admin if persistent

/changelog

View recent bot updates and new features.

Command Signature

/changelog

Current Release: 13

New in Release 13: πŸ“œ Raid History
  • /raidinfo action:history - View past raids
  • Shows raid type, role played, and date
  • Admins can view history for other users
❌ No-Show Tracking
  • Mark no-shows via /raid panel
  • No-show count shown in /stats user
  • β€œReliable” achievement for perfect attendance
πŸ” Smart Substitute Finder
  • β€œFind Sub” button in /raid panel
  • Finds users with experience in needed role
  • Prioritizes users available at raid time
  • Shows top 5 candidates
πŸ† Leaderboards & Achievements
  • /leaderboard top - Top raiders
  • /leaderboard role <name> - Top for specific role
  • /leaderboard achievements - View achievements
  • 11 achievements to unlock
Previous (Release 12):
  • Performance monitoring
  • DM-based alerts
  • /testalert command

Example Output

Release 13 Changelog

Raid history, no-show tracking, smart substitute finder,
and leaderboards!

πŸ“œ Raid History
β€’ /raidinfo action:history [user] [limit] β€” View past
  raids you participated in
β€’ Shows raid type, role played, and date
β€’ Admins can view history for other users

❌ No-Show Tracking
β€’ Mark no-shows via the /raid panel after a raid closes
β€’ No-show count shown in /stats user
β€’ "Reliable" achievement for perfect attendance

πŸ” Smart Substitute Finder
β€’ "Find Sub" button in /raid panel
β€’ Finds users with experience in the needed role
β€’ Prioritizes users who are available at raid time
β€’ Shows top 5 candidates ranked by fit

πŸ† Leaderboards & Achievements
β€’ /leaderboard top β€” Top raiders by total raids
β€’ /leaderboard role <name> β€” Top players for a specific role
β€’ /leaderboard achievements β€” View unlocked achievements
β€’ 11 achievements to unlock (Rookie Raider β†’ Raid Master)

Previous (Release 12):
Performance monitoring, DM-based alerts, /testalert command

/testalert

Send a test alert to the bot owner.
Requires Manage Server permission or configured admin role.

Command Signature

/testalert

Purpose

Verifies the DM-based alert system is working.

Requirements

Environment variable:
BOT_OWNER_ID=123456789012345678
Must be set to:
  • Your Discord user ID
  • Bot must be able to DM you

What It Does

  1. Sends a test alert DM to the bot owner
  2. Confirms delivery in ephemeral response
  3. If delivery fails, reports error

Alert System

Once configured, the bot sends DM alerts for: Performance Issues:
  • High latency (>500ms for 5+ consecutive minutes)
  • Memory issues
  • Circuit breaker triggered
Operational Events:
  • DM delivery failures
  • Critical errors
  • Daily health summary (9 AM)
Debug Channel: If a debug channel is configured via /setchannel, alerts are also posted there.

Example Output

Success:
βœ… Test alert sent to bot owner. Check your DMs to verify
the alert system is working.
Failure:
❌ Failed to send test alert. Make sure BOT_OWNER_ID is
configured correctly.

Test Alert DM

πŸ”” Test Alert

This is a test alert from RaidBot.

If you're seeing this, the alert system is working correctly!

You'll receive alerts for:
β€’ High latency (>500ms sustained)
β€’ Memory issues
β€’ DM delivery failures
β€’ Daily health summaries (9 AM)

Time: [timestamp]

Troubleshooting

Alert not received:
  1. Verify BOT_OWNER_ID is set correctly
  2. Check that you can receive DMs from the bot
  3. Try /ping to verify bot is responding
  4. Check debug channel (if configured) for error logs
DMs disabled:
  1. Enable DMs in Privacy Settings
  2. Or configure a debug channel instead

Build docs developers (and LLMs) love