🦺Support & Utilities
Help when needed!
📋 Overview
The Support & Utilities module provides essential server management and support features that enhance user experience and safety. The system includes a comprehensive feedback submission system with categorization (suggestions, bug reports, general feedback, urgent issues), emergency safeword system with three severity levels and automatic isolation, voting system with direct platform links, help command displaying all bot commands by category, and word definition lookup using Urban Dictionary API. These tools support both server administration and member wellbeing while providing helpful utilities for everyday use.
⚙️ How It Works
Feedback System: Administrators can submit feedback directly to the bot developers through an interactive categorized form. The system uses a dropdown menu to select feedback type, presents tailored instructions for each category, collects detailed information through a modal form (summary, description, optional context), generates server invites automatically, and sends formatted reports to the bot's feedback channel with server information. This creates a direct communication line between server admins and developers.
Safeword System: An emergency response system with three severity levels designed for member safety:
Green (Check-in):
Simple notification to moderators
Logs check-in status
No additional actions taken
Low-priority alert
Yellow (Support Needed):
Alerts safeword role members
Indicates support request
Medium-priority response
Moderators notified immediately
Red (Emergency):
Highest priority alert
Automatic 1-hour isolation applied
Creates/assigns isolation role
Hides all channels from user
Moderators receive urgent notification
Early release button for moderators
DM sent to affected user
Voting System: Provides easy access to voting platforms with clickable buttons. Members can support the bot on Top.gg and Discords.com through one-click links. Includes decorative embed with voting banner image.
Help Command: Auto-generates comprehensive command list from all registered slash commands. Organizes commands by cog (category), displays command names with descriptions, handles long category lists by splitting fields, and provides complete bot functionality overview.
Definition Lookup: Searches Urban Dictionary API for word definitions and slang terms. Displays top 10 results with paginated navigation, shows definitions with examples, includes upvote/downvote statistics, and handles API errors gracefully.
🔑 Key Commands
/utility feedback
/utility feedbackDescription: Submit feedback, suggestions, or bug reports (Admins only) Access: Administrator permission required Cooldown: 60 seconds Function: Opens interactive feedback submission system with four categories.
Feedback Categories:
💡 Feature Suggestion:
For new feature ideas or improvements
Asks for: Feature description, benefit explanation, examples
🐛 Bug Report:
For technical issues or errors
Asks for: Problem description, reproduction steps, expected vs actual behavior, error messages
💬 General Feedback:
For thoughts, experiences, and suggestions
Asks for: Likes, improvements, community suggestions, general comments
⚠️ Urgent Issue:
For critical problems requiring immediate attention
Asks for: Urgent problem description, server impact, occurrence timing, attempted workarounds
Form Fields:
Summary: Brief title
Detailed Description: Full explanation
Additional Context: Extra information
Automated Information:
Server name and invite link
User mention and ID
Server member count
Submission timestamp
Server icon (if available)
Developer Notification:
Sent to feedback channel in bot support server
Contains all form information
Includes server details for context
Categorized by type for routing
User Confirmation:
Success message after submission
Explains next steps
Sets response expectations (24 hours for urgent)
/safeword <severity> 👑
/safeword <severity> 👑Description: Activate emergency safeword system with severity levels Access: All members Cooldown: 10 seconds Options:
Green: Check-in notification
Yellow: Support needed
Red: Emergency situation
Requirements: Safeword channel and roles must be configured via /manage setup
Function by Severity:
Green Safeword:
Logs check-in to safeword channel
Mentions configured safeword roles
Sends confirmation to user
No additional actions
Yellow Safeword:
Alerts moderators immediately
Indicates support needed
Sends DM to user confirming notification
Mentions safeword roles
Red Safeword:
EMERGENCY PROTOCOL ACTIVATED
Immediately alerts moderators with urgent notification
Automatically applies 1-hour isolation
Creates "🔇 Isolated" role if doesn't exist
Hides all channels from user
Sets channel permissions: view_channel=False
Sends DM explaining isolation
Provides moderator button to end isolation early
Isolation Role Features:
Name: 🔇 Isolated
Automatically hides all channels
Cached for performance
Persists across bot restarts
Removable by moderators early
Early Isolation Release:
Button appears on Red safeword notification
Only safeword role members can click
Removes isolation role immediately
Announces who ended isolation
Button disables after use
1-hour timeout on button
Privacy Features:
All responses ephemeral (private)
DM sent to user when possible
Fallback to ephemeral message if DM fails
Moderators notified in private channel
/vote
/voteDescription: Support the bot through voting platforms Access: All members Cooldown: 30 seconds Function: Displays voting links with interactive buttons for one-click access.
Voting Platforms:
Top.gg: Link to bot page with vote button
Discords.com: Link to bot page with vote button
Features:
Interactive link buttons (no navigation away)
Decorative voting banner image (Vote.jpg)
Encouragement message
Clean embed formatting
Permanent buttons (no timeout)
/help
/helpDescription: View all available bot commands Access: All members Cooldown: None Function: Auto-generates comprehensive command list organized by category (cog).
Features:
Groups commands by their cog/module
Shows command name with description
Alphabetically sorted within categories
Alphabetically sorted category names
Automatic field splitting if category too long
Shows all registered slash commands
Display Format:
Category Name
• /command_name - Description
• /command_name2 - Description
...Categories Include: All loaded cogs plus "Uncategorized" for commands without cogs
/define <word>
/define <word>Description: Search for word definitions and slang terms Access: All members Cooldown: None Parameters:
word: The word or phrase to define (required)
Function: Searches Urban Dictionary API for definitions with paginated results.
Features:
Top 10 definitions shown
Paginated navigation with arrows
Shows definition text
Includes usage examples
Displays upvote/downvote counts
Links to Urban Dictionary page
Author attribution
Result Display:
Title: Word being defined
Definition: Full text
Example: Usage in context
Stats: 👍 Upvotes | 👎 Downvotes
Author: Definition contributor
Link: View on Urban Dictionary
Navigation: ◀️ Previous | ▶️ Next
Error Handling:
No results: Clear message suggesting alternative
API error: Explains service unavailable
Connection error: Indicates connectivity issue
Graceful fallbacks for all failures
👥 Who It's For
Feedback System:
Administrators: Submit suggestions, bugs, feedback, urgent issues to developers
Safeword System:
All Members: Can use any severity level
Safeword Role Members: Receive notifications
Moderators/Admins: Can end isolation early
Voting System:
All Members: Support bot through votes
Help Command:
All Members: Learn available commands
New Members: Discover bot features
Definition Lookup:
All Members: Learn word meanings and slang
💡 Why This Feature
Feedback System: Creates direct developer communication. Categorization ensures appropriate routing. Detailed forms provide complete context. Automatic server info saves time. Structured submission prevents confusion. Urgent category for critical issues.
Safeword System: Prioritizes member safety and wellbeing. Three levels accommodate different needs. Automatic isolation protects users in crisis. Moderator alerts ensure quick response. Early release option provides flexibility. DM notifications ensure user awareness.
Voting System: Increases bot visibility on platforms. One-click access removes friction. Visual appeal encourages participation. Supports bot growth and development. Shows appreciation for users.
Help Command: Reduces support questions. Auto-generation stays updated. Category organization aids discovery. Complete command visibility. Easy reference for all members.
Definition Lookup: Educational resource for slang. Reduces misunderstandings. Entertainment value. Community learning tool. Real-world usage examples.
Made by DIVINITY • Pleasure Corner
Last updated
Was this helpful?