Utility Commands¶

General purpose utility commands for server enhancement and information display.

Quick Reference¶

Command	Description	Permission Required
`&avatar [user]`	Get user's avatar	None
`&banner [user]`	Get user's banner	None
`&userinfo [member]`	Detailed user information	None
`&serverinfo`	Detailed server information	None
`&member_count`	Show server member count	None
`&botinfo`	Bot statistics and information	None
`&ping`	Check bot latency	None
`&uptime`	How long the bot has been running	None
`&embed`	Create custom embed messages	Manage Messages
`&tts <message>`	Convert text to speech	None
`&translate`	Translate text between languages	None

Overview¶

Utility commands provide essential tools for:

User Information - Avatars, banners, and profile details
Server Information - Statistics, member counts, and server details
Bot Information - Status, performance, and statistics
Communication Tools - Embeds, translation, and text-to-speech
Fun Features - Coin flips, personality descriptions

No Permissions Required

Most utility commands can be used by anyone in the server, making them perfect for general community interaction.

User Information¶

`&avatar`¶

Get a user's avatar in high quality with download links.

&avatar [@user]

Aliases: &av, &pfp

Parameters: - user (optional) - User to get avatar for (default: command author)

Examples:

&avatar                                      # Your own avatar
&avatar @alice                               # Alice's avatar
&av @bob                                     # Using alias

Features: - 🖼️ High Resolution - Shows largest available size - 🎭 Animated GIFs - Supports animated avatars - 🔗 Download Links - JPG, PNG, and GIF formats - 📱 Mobile Friendly - Optimized display for all devices

Avatar Display

Getting someone's avatar:

&avatar @alice

Bot Response:

🖼️ Alice's Avatar

[Download as JPG] [Download as PNG] [Download as GIF]

Shows large avatar image with download buttons

`&banner`¶

Get a user's profile banner if they have one.

&banner [@user]

Aliases: &bnr

Parameters: - user (optional) - User to get banner for (default: command author)

Examples:

&banner                                      # Your own banner
&banner @alice                               # Alice's banner
&bnr @bob                                    # Using alias

Features: - 🎨 High Quality - Full resolution banners - 🎭 Animated Support - GIF banners if available - 📱 Fallback Message - Clear message if no banner exists

`&userinfo`¶

Display comprehensive information about a user.

&userinfo [@member]

Aliases: &ui

Parameters: - member (optional) - Member to get information for (default: command author)

Examples:

&userinfo                                    # Your own info
&userinfo @alice                             # Alice's info
&ui @bob                                     # Using alias

Information Displayed:

Basic InfoRoles & StatusAdditional Details

Username and discriminator
User ID
Nickname (if set)
Account creation date
Server join date

All roles (up to 15 shown)
Highest role and color
Online status
Custom status (if set)

Bot status (if applicable)
Server booster status
Avatar and banner links
Time since joining

User Information Display

Getting user details:

&userinfo @alice

Bot Response:

👤 Alice Information

📛 Username: alice#1234
🆔 ID: 123456789012345678
📅 Created: January 1, 2020
📥 Joined: March 15, 2024

🎭 Roles (5): @VIP @Members @Gamers @Active @Verified
🎨 Color: #ff6b6b (from @VIP)

💬 Status: Online
🎮 Activity: Playing Discord

Server Information¶

`&serverinfo`¶

Display comprehensive server statistics and information.

&serverinfo

Aliases: &si

No parameters required

Information Displayed:

Basic DetailsMember StatisticsServer Features

Server name and ID
Server owner
Creation date
Server region
Verification level

Total members
Human vs bot count
Online member count
Member growth trends

Boost level and count
Channel counts (text, voice, categories)
Role count
Emoji and sticker counts
Server features (if any)

`&member_count`¶

Quick display of server member statistics.

&member_count

Aliases: &mc

Features: - 👥 Total Members - All server members - 🤖 Bot Count - Number of bots - 🧑 Human Count - Human members only - 📊 Visual Chart - Member distribution

Bot Information¶

`&botinfo`¶

Display Spruce Bot statistics and performance information.

&botinfo

Aliases: &bi, &stats, &about

Information Shown:

PerformanceStatisticsSystem Info

Current latency (ping)
Commands executed
Memory usage
CPU usage
Uptime

Total servers
Total users
Commands available
Version information

Python version
discord.py version
Operating system
Hosting information

`&ping`¶

Check bot responsiveness and latency.

&ping

No parameters required

Metrics Displayed: - 🏓 Bot Latency - Command response time - 💓 WebSocket Latency - Discord connection quality - 📡 API Latency - Discord API response time

`&uptime`¶

Show how long the bot has been online.

&uptime

Features: - ⏰ Total Uptime - Days, hours, minutes, seconds - 📈 Uptime Percentage - Reliability metric - 🔄 Last Restart - When bot was last restarted

Communication Tools¶

`&embed`¶

Create custom embed messages with advanced formatting.

&embed <title> <description> [color] [footer] [thumbnail] [image] [channel]

Parameters: - title - Embed title - description - Main content/description - color (optional) - Embed color (red, blue, green, hex code) - footer (optional) - Footer text - thumbnail (optional) - Small image URL - image (optional) - Large image URL - channel (optional) - Channel to send to

Examples:

&embed "Welcome" "Welcome to our server!" blue
&embed "Rules" "Please read our rules carefully" red "Important Notice"
&embed "Event" "Join our tournament!" green "See you there!" thumbnail_url image_url #events

Bot Permissions Required: - Send Messages - Embed Links

User Permissions Required: - Manage Messages

Color Options: - Named colors: red, blue, green, yellow, purple, orange, pink, cyan - Hex codes: #ff6b6b, #4ecdc4, #45b7d1 - Random: random for random color

`&embed_img`¶

Quick embed creation with image.

&embed_img <image_url> <message>

Aliases: &em

Parameters: - image_url - URL of image to embed - message - Text to display with image

Examples:

&embed_img https://example.com/image.png "Check out this cool image!"
&em https://i.imgur.com/example.jpg "Today's meme of the day"

`&tts`¶

Convert text to speech and send as audio file.

&tts <message>

Parameters: - message - Text to convert to speech (max 150 words)

Examples:

&tts Hello everyone, welcome to our server!
&tts "This is a test of the text to speech feature"

Features: - 🔒 Profanity Filter - Automatically filters inappropriate content - 🗣️ Natural Voice - English with Indian accent - 📁 Audio File - Sends as downloadable MP3 - ⏱️ Quick Processing - Fast conversion

Limitations: - Maximum 150 words per message - English language only - Rate limited to prevent spam

`&translate`¶

Translate text between different languages.

&translate <from_lang> <to_lang> <message>

Parameters: - from_lang - Source language (e.g., English, Spanish, French) - to_lang - Target language - message - Text to translate

Examples:

&translate English Spanish "Hello, how are you?"
&translate French English "Bonjour, comment allez-vous?"
&translate Auto German "Automatic language detection"

Features: - 🌍 50+ Languages - Wide language support - 🤖 Auto-Detection - Use "Auto" for automatic source detection - 🔄 Bidirectional - Translate between any supported languages - 📝 Context Preservation - Maintains meaning and context

Rate Limits: - 2 translations per 50 seconds per user - Prevents API abuse

Fun Commands¶

`&toss`¶

Flip a virtual coin.

&toss

No parameters required

Features: - 🪙 Random Result - True 50/50 chance - 🎭 Animated Display - Coin flip animation - 📊 Fair Algorithm - Cryptographically secure randomness

`&whoiss`¶

Get a random personality description for yourself or another user.

&whoiss [@user]

Parameters: - user (optional) - User to describe (default: command author)

Examples:

&whoiss                                      # Describe yourself
&whoiss @alice                               # Describe Alice

Features: - 🎲 Random Traits - Unique descriptions every time - 😄 Fun Content - Entertaining personality traits - 👥 Social Feature - Great for community interaction

Server Management Utilities¶

`&nick`¶

Change a user's nickname.

&nick <@user> <nickname>

Parameters: - user - User to change nickname for - nickname - New nickname (use "reset" to remove)

Examples:

&nick @alice "Alice the Great"               # Set nickname
&nick @bob reset                             # Remove nickname

Bot Permissions Required: - Manage Nicknames

User Permissions Required: - Manage Nicknames

`&addemoji`¶

Add a custom emoji to the server.

&addemoji <emoji>

Parameters: - emoji - Custom emoji from another server or image URL

Examples:

&addemoji :custom_emoji:                     # Add emoji from another server
&addemoji https://example.com/emoji.png      # Add from image URL

Bot Permissions Required: - Manage Emojis

User Permissions Required: - Manage Emojis

Administrative Utilities¶

`&prefix`¶

Show the bot's current prefix.

&prefix

User Permissions Required: - Administrator

`&sync`¶

Sync slash commands to the server.

&sync

User Permissions Required: - Administrator

When to Use: - Slash commands not appearing - After bot updates - Permission issues with slash commands

`&invite`¶

Get bot invite link and related links.

&invite

No parameters required

Provides: - 🤖 Bot invite link with proper permissions - 🆘 Support server link - 🗳️ Voting links - 📚 Documentation link

Support System¶

`&setup_ticket`¶

Create a ticket support system for your server.

&setup_ticket

Bot Permissions Required: - Manage Channels - Manage Roles

User Permissions Required: - Manage Channels - Manage Roles

What It Creates: - 🎫 Ticket category - 📝 Ticket creation channel with button - 🎛️ Interactive ticket management - 🔒 Proper permissions setup

Performance & Reliability¶

Response Times¶

Command Type	Expected Response
Simple Info	< 1 second
User Data	< 2 seconds
Server Stats	< 3 seconds
File Generation	< 5 seconds
Complex Operations	< 10 seconds

Error Handling¶

All utility commands include comprehensive error handling:

Clear error messages for user mistakes
Graceful fallbacks when data unavailable
Rate limit protection to prevent spam
Permission checks before execution

Troubleshooting¶

Common Issues¶

Avatar/Banner Not LoadingTranslation ErrorsTTS Not Working

Issue: Images not displaying properly

Solutions: - Check if user has avatar/banner set - Verify bot has embed permissions - Try again if Discord CDN is slow

Issue: Translation command fails

Solutions: - Check language names (use full names) - Verify message isn't too long - Wait if rate limited

Issue: Text-to-speech fails

Solutions: - Keep message under 150 words - Avoid special characters - Check for profanity filter triggers

AutoRole System - Works with user information
Moderation Tools - Enhanced with utility data
Role Management - User info for role decisions

Support¶

Need help with utility commands?

📚 Troubleshooting Guide - Common issues and solutions
💬 Support Server - Get help from our community
📧 Email: support@nexinlabs.com

Next: Learn about Tournament Commands →

Utility Commands¶

Quick Reference¶

Overview¶

User Information¶

&avatar¶

&banner¶

&userinfo¶

Server Information¶

&serverinfo¶

&member_count¶

Bot Information¶

&botinfo¶

&ping¶

&uptime¶

Communication Tools¶

&embed¶

&embed_img¶

&tts¶

&translate¶

Fun Commands¶

&toss¶

&whoiss¶

Server Management Utilities¶

&nick¶

&addemoji¶

Administrative Utilities¶

&prefix¶

&sync¶

&invite¶

Support System¶

&setup_ticket¶

Performance & Reliability¶

Response Times¶

Error Handling¶

Troubleshooting¶

Common Issues¶

Related Features¶

Support¶

`&avatar`¶

`&banner`¶

`&userinfo`¶

`&serverinfo`¶

`&member_count`¶

`&botinfo`¶

`&ping`¶

`&uptime`¶

`&embed`¶

`&embed_img`¶

`&tts`¶

`&translate`¶

`&toss`¶

`&whoiss`¶

`&nick`¶

`&addemoji`¶

`&prefix`¶

`&sync`¶

`&invite`¶

`&setup_ticket`¶