Skip to content

4. Commands Reference

Jump to bottom Edit New page
ad1107 edited this page May 24, 2025 · 4 revisions

Commands Reference

Complete reference for all UtilsBot+ slash commands with examples and usage guidelines.

Command Categories

AI Commands

/ask

Ask questions to Google Gemini AI for intelligent responses.

Usage:

/ask question:"What is machine learning?" [ephemeral:true]

Parameters:

  • question (required): Your question or prompt
  • ephemeral (optional): Whether the response should be private (default: false)

Examples:

/ask question:"Explain quantum computing in simple terms"
/ask question:"Write a Python function to calculate fibonacci" ephemeral:true
/ask question:"What's the weather like today?"

Features:

  • Context-aware responses using Gemini 1.5 Flash
  • Response truncation for Discord's character limits (3800 chars)
  • Rate limiting: 3 questions per minute per user
  • Usage tracking and statistics

Rate Limits:

  • 3 requests per 60 seconds per user
  • Free tier: 15 requests per minute globally

/chat

Start an interactive chat session with AI through a modal interface.

Usage:

/chat

Features:

  • Interactive modal for longer conversations
  • Continue/End buttons for extended chats
  • Context preservation within the session
  • Private ephemeral responses

How it works:

  1. Use /chat to open the chat modal
  2. Type your message in the text area
  3. Click "Send" to get AI response
  4. Use "Continue" for follow-up questions
  5. Use "End Chat" to close the session

Games

/wordle

Play the classic Wordle word-guessing game.

Usage:

/wordle

Game Rules:

  • Guess the 5-letter word in 6 attempts
  • Color-coded feedback:
    • 🟩 Green: Correct letter in correct position
    • 🟨 Yellow: Correct letter in wrong position
    • ⬛ Black: Letter not in the word

Features:

  • Full Wordle game implementation
  • Interactive UI with guess input modals
  • Statistics tracking (games played, won, best scores)
  • One active game per user at a time
  • 2000+ valid word database

Example Game Flow:

  1. Use /wordle to start a new game
  2. Enter your 5-letter guess in the modal
  3. Receive color-coded feedback
  4. Continue guessing until you solve it or run out of attempts
  5. View your statistics and start a new game

Network Tools

/screenshot

Capture screenshots of websites with customizable options.

Usage:

/screenshot url:"https://example.com" [full_page:true] [width:1920] [height:1080]

Parameters:

  • url (required): Website URL to capture
  • full_page (optional): Capture full page vs viewport (default: false)
  • width (optional): Viewport width in pixels (default: 1920)
  • height (optional): Viewport height in pixels (default: 1080)

Examples:

/screenshot url:"https://github.com"
/screenshot url:"https://example.com" full_page:true
/screenshot url:"https://mobile-site.com" width:375 height:667

Features:

  • High-quality PNG screenshots
  • Ad blocking enabled by default
  • Timeout protection (30 seconds)
  • URL validation and security checks
  • Private IP protection

Requirements:

  • Bot needs "Attach Files" permission
  • ScreenshotOne API key for enhanced features (optional)

/ip

Get detailed information about IP addresses or domains.

Usage:

/ip address:"8.8.8.8"
/ip address:"google.com"

Parameters:

  • address (required): IP address or domain name

Examples:

/ip address:"1.1.1.1"
/ip address:"github.com"
/ip address:"192.168.1.1"

Information Provided:

  • Country, region, city
  • ISP and organization
  • Coordinates (latitude/longitude)
  • Timezone
  • Country flag emoji
  • Private IP detection

Features:

  • Support for both IPv4 addresses and domain names
  • Automatic domain resolution
  • Rate limiting protection
  • Private IP range detection

/unshorten

Expand shortened URLs and check their safety.

Usage:

/unshorten url:"https://bit.ly/example"

Parameters:

  • url (required): Shortened URL to expand

Examples:

/unshorten url:"https://tinyurl.com/example"
/unshorten url:"https://bit.ly/3xyz123"
/unshorten url:"https://t.co/abcd1234"

Features:

  • Follows redirect chains safely
  • Suspicious domain detection
  • Redirect limit protection (max 10 redirects)
  • Final URL validation
  • Safety warnings for potentially harmful sites

Supported Services:

  • bit.ly, tinyurl.com, t.co, goo.gl
  • Custom shorteners and redirect services
  • Most URL shortening services

Security Tools

/totp

Generate Time-based One-Time Passwords (TOTP) for 2FA authentication.

Usage:

/totp secret:"YOUR2FASECRET" [ephemeral:true]

Parameters:

  • secret (required): Your 2FA secret key (base32 encoded)
  • ephemeral (optional): Private response (recommended: true)

Examples:

/totp secret:"JBSWY3DPEHPK3PXP" ephemeral:true
/totp secret:"GEZDGNBVGY3TQOJQGEZDGNBVGY3TQOJQ"

Features:

  • Standard TOTP algorithm (RFC 6238)
  • 30-second time windows
  • Time remaining indicator
  • Base32 secret validation
  • Ephemeral responses for security

Security Notes:

  • Always use ephemeral:true to keep codes private
  • Secrets are not stored by the bot
  • Codes expire every 30 seconds

/qr

Generate QR codes for text, URLs, or other data.

Usage:

/qr text:"Hello World" [size:"medium"]

Parameters:

  • text (required): Text to encode (max 2000 characters)
  • size (optional): QR code size - "small", "medium", "large" (default: medium)

Examples:

/qr text:"https://github.com/ad1107/utils-bot-plus"
/qr text:"WiFi:T:WPA;S:NetworkName;P:password;;" size:"large"
/qr text:"My contact info: John Doe, john@example.com" size:"small"

Size Options:

  • Small: 200x200 pixels
  • Medium: 400x400 pixels (default)
  • Large: 600x600 pixels

Features:

  • High-quality PNG output
  • Error correction level M
  • Support for various data types (URLs, WiFi, contact info, plain text)
  • Automatic optimization for readability

/base64

Encode or decode text using Base64 encoding.

Usage:

/base64 text:"Hello World" operation:"encode"
/base64 text:"SGVsbG8gV29ybGQ=" operation:"decode"

Parameters:

  • text (required): Text to encode or decode
  • operation (required): "encode" or "decode"

Examples:

/base64 text:"Secret message" operation:"encode"
/base64 text:"U2VjcmV0IG1lc3NhZ2U=" operation:"decode"
/base64 text:"https://example.com" operation:"encode"

Features:

  • Standard Base64 encoding/decoding
  • UTF-8 text support
  • Input validation
  • Error handling for invalid Base64 strings

/hash

Generate cryptographic hashes for text input.

Usage:

/hash text:"password123" algorithm:"sha256"

Parameters:

  • text (required): Text to hash
  • algorithm (required): Hash algorithm - "md5", "sha1", "sha256", "sha512"

Examples:

/hash text:"hello world" algorithm:"sha256"
/hash text:"password123" algorithm:"md5"
/hash text:"important data" algorithm:"sha512"

Supported Algorithms:

  • MD5: 128-bit hash (deprecated for security)
  • SHA1: 160-bit hash (deprecated for security)
  • SHA256: 256-bit hash (recommended)
  • SHA512: 512-bit hash (most secure)

Features:

  • Hexadecimal output format
  • All major hash algorithms supported
  • Consistent hashing results

/password

Generate cryptographically secure random passwords.

Usage:

/password [length:16] [include_symbols:true] [ephemeral:true]

Parameters:

  • length (optional): Password length 8-128 characters (default: 16)
  • include_symbols (optional): Include special characters (default: true)
  • ephemeral (optional): Private response (recommended: true)

Examples:

/password
/password length:24 include_symbols:false ephemeral:true
/password length:12 include_symbols:true

Character Sets:

  • Letters: a-z, A-Z
  • Numbers: 0-9
  • Symbols: !@#$%^&*()_+-=[]{}|;:,.<>?

Features:

  • Cryptographically secure random generation
  • Customizable length and character sets
  • No password storage or logging
  • Ephemeral responses for security

Information Commands

/info

Display comprehensive bot statistics and system information.

Usage:

/info

Information Displayed:

  • Bot version and uptime
  • Server and user counts
  • System resources (CPU, memory usage)
  • Database statistics
  • Feature toggle status
  • Performance metrics
  • Discord API latency

Example Output:

📊 UtilsBot+ Statistics
Version: 2.0.0 | Uptime: 2d 3h 45m
Servers: 150 | Users: 12,543
Memory: 125MB | CPU: 2.3%
Commands: 1,234 total | Latency: 45ms

/ping

Test bot responsiveness and latency.

Usage:

/ping

Metrics Displayed:

  • Response time (command processing)
  • WebSocket latency (Discord connection)
  • Round-trip time measurement

Example Output:

🏓 Pong!
Response Time: 123ms
WebSocket Latency: 45ms

/version

Show bot version information and changelog.

Usage:

/version

Information Displayed:

  • Current bot version
  • Build date and commit hash
  • Recent changelog entries
  • Update notifications

/help

Interactive help system with category filtering.

Usage:

/help [category:"AI"]

Parameters:

  • category (optional): Filter by command category

Categories:

  • Information, AI, Games, Tools, Network, System

Features:

  • Autocomplete for categories
  • Command descriptions and usage examples
  • Interactive navigation
  • Context-sensitive help

Developer Commands

Restriction: These commands are only available to users listed in DEV_IDS environment variable.

/sync

Synchronize slash commands with Discord.

Usage:

/sync [scope:"global"]

Parameters:

  • scope (optional): "global", "guild", or specific guild ID

Sync Options:

  • Global: Updates commands for all servers (takes up to 1 hour)
  • Guild: Updates commands for current server only (immediate)
  • Specific: Updates commands for a specific guild ID

When to Use:

  • After adding new commands
  • When commands don't appear
  • After modifying command parameters

/eval

Execute Python code in a secure environment.

Usage:

/eval code:"print('Hello World')"

Parameters:

  • code (required): Python code to execute

Available Context:

  • bot: Bot instance
  • interaction: Current interaction
  • discord: Discord.py module
  • Standard Python libraries

Security Features:

  • Limited execution scope
  • Output capture and formatting
  • Error handling and traceback
  • No dangerous module access

Examples:

/eval code:"len(bot.guilds)"
/eval code:"interaction.user.display_name"
/eval code:"import math; math.pi"

/reload

Hot reload bot cogs without restarting.

Usage:

/reload cog:"ai"

Parameters:

  • cog (required): Name of cog to reload

Available Cogs:

  • ai, games, info, network, system, tools

Benefits:

  • No bot downtime
  • Instant code updates
  • Development efficiency

/load / /unload

Dynamically load or unload cogs.

Usage:

/load cog:"new_feature"
/unload cog:"maintenance_feature"

Features:

  • Dynamic feature management
  • No restart required
  • Safe unloading with cleanup

Admin Commands

Restriction: These commands are only available to developers for user management.

/whitelist add

Add users to the beta whitelist.

Usage:

/whitelist add user:@username

/whitelist remove

Remove users from the beta whitelist.

Usage:

/whitelist remove user:@username

/whitelist list

View all whitelisted users.

Usage:

/whitelist list

/whitelist check

Check if a user is whitelisted.

Usage:

/whitelist check user:@username

Usage Tips

Command Permissions

  • Most commands work in any server where the bot has permissions
  • Developer commands require DEV_IDS configuration
  • Some commands may require specific bot permissions (e.g., "Attach Files" for screenshots)

Rate Limiting

  • AI commands: 3 requests per minute per user
  • Other commands: Standard Discord rate limits apply
  • Rate limits prevent spam and ensure fair usage

Privacy Options

  • Use ephemeral:true for sensitive commands (TOTP, passwords)
  • AI responses can be made private with the ephemeral parameter
  • Most commands support both public and private responses

Error Handling

  • Commands provide clear error messages
  • Check bot permissions if commands fail
  • Review logs for detailed error information

Navigation: ← Getting Started | Configuration Guide →

Related Pages: API Integrations | Troubleshooting | Security Guide

Add a custom footer
Add a custom sidebar
Clone this wiki locally