Skip to main content

Auto Setup Feature

Auto Setup (formerly known as "Mirror") is HephBot's most powerful feature for creating multilingual server sections. It automatically replicates entire categories and channels across different languages with real-time content synchronization.

🎯 What is Auto Setup?​

Auto Setup creates complete language-specific versions of your server sections. When you set up an auto setup:

  1. The bot creates new categories with translated names
  2. All channels in the source category are replicated with translated names
  3. Messages sent in any language version are automatically translated and posted in all other versions
  4. Everything stays synchronized in real-time

[Photo of mirror setup in dashboard here]

✨ Key Features​

Automatic Category & Channel Creation​

  • Creates mirrored categories with translated names
  • Replicates all channels with translated names
  • Supports all channel types (text, voice, stage, forum, announcement)

Real-Time Synchronization​

  • Messages are instantly translated and mirrored
  • Attachments and files are preserved across all mirrors
  • Embeds and rich content are maintained
  • Reactions are synchronized
  • Threads are mirrored automatically

Smart Management​

  • Repair Function: Automatically recreate missing channels
  • Channel Exclusion: Exclude specific channels from mirroring
  • Custom Naming: Customize how mirrored channels are named
  • Auto-Maintenance: Bot monitors and maintains mirror integrity

πŸš€ Getting Started​

Prerequisites​

  • Premium Tier: Server Boost - Groq Powered ($9.99/month)
  • Bot Permissions: Manage Channels, Manage Webhooks, Send Messages
  • Admin Access: Server administrator permissions

Setup Steps​

  1. Navigate to Dashboard

  2. Access Auto Setup Manager

    • Click on the "Auto-Setup" card
    • Click "New Mirror" button
  3. Configure Auto Setup

    • Source Category: Select the category you want to mirror
    • Source Language: Choose the language of your source category
    • Target Languages: Select up to 6 target languages
    • Naming Scheme: Customize channel naming (optional)
    • Excluded Channels: Select channels to exclude (optional)
  4. Create Auto Setup

    • Click "Create Mirror"
    • The bot will automatically create all mirrored categories and channels

[Video of mirror creation process here]

Managing Auto Setup​

View All Auto Setups​

  • See all active auto setups in the dashboard
  • View auto setup status, languages, and channel counts

Repair Auto Setup​

  • If channels are missing (e.g., after bot downtime or accidental deletion)
  • Click the "Repair" button on any auto setup
  • The bot will check for missing channels and recreate them

[GIF of repair process here]

Delete Auto Setup​

  • Click "Delete" on an auto setup
  • Confirms deletion and cleans up all mirrored channels
  • Warning: This action cannot be undone!

🎨 Naming Schemes​

Customize how mirrored channels are named using placeholders:

Available Placeholders​

  • {Translated_Name} - The translated name of the original channel

Default Scheme​

{Translated_Name} - [HB]

Examples​

Original Channel: general-chat

  • Spanish: chat-general - [HB]
  • French: chat-gΓ©nΓ©ral - [HB]
  • German: allgemeiner-chat - [HB]

Custom Schemes​

You can use any pattern you like:

  • {Translated_Name} - General
  • [ES] {Translated_Name}
  • {Translated_Name} - Mirror
  • πŸ‡ͺπŸ‡Έ {Translated_Name}

[Photo showing naming scheme examples here]

πŸ“‹ Supported Channel Types​

Auto Setup supports all major Discord channel types:

Channel TypeSupport
Text Channelsβœ… Full message synchronization
Voice Channelsβœ… Channel creation (no audio streaming)
Stage Channelsβœ… Channel creation (no audio streaming)
Forum Channelsβœ… Channel creation with tags
Announcement Channelsβœ… Channel creation

πŸ”„ Content Synchronization​

What Gets Mirrored​

βœ… Text Messages: Automatically translated to target languages
βœ… Attachments: Files are preserved and shared across all mirrors
βœ… Embeds: Rich content (links, images, videos) is maintained
βœ… Reactions: Emoji reactions are synchronized
βœ… Threads: Thread creation and messages are mirrored
βœ… Message Edits: Edits are synchronized across mirrors
βœ… Message Deletions: Deletions are synchronized across mirrors

What Doesn't Get Mirrored​

❌ Voice/Video Content: Audio/video streams are not mirrored
❌ Bot Commands: Slash commands and bot interactions
❌ System Messages: Discord system notifications
❌ Excluded Channels: Channels marked for exclusion

βš™οΈ Advanced Configuration​

Channel Exclusion​

Exclude specific channels from mirroring:

  • Bot command channels
  • Admin-only channels
  • High-volume channels (optional)
  • Channels with sensitive content

Naming Customization​

Create consistent naming patterns:

  • Language prefixes: [ES] Channel Name
  • Suffixes: Channel Name - Spanish
  • Emoji indicators: πŸ‡ͺπŸ‡Έ Channel Name
  • Custom patterns: ES-Channel-Name

πŸ”§ Troubleshooting​

Auto Setup Not Working​

Check:

  • Premium tier status (requires Server Boost)
  • Bot permissions (Manage Channels, Manage Webhooks)
  • Category and channel accessibility
  • Auto setup status in dashboard

Solution:

  • Verify premium subscription
  • Check bot permissions
  • Use repair function if channels are missing

Translation Failures​

Check:

  • Translation engine configuration
  • API key status (for BYOK tiers)
  • Error logs in dashboard

Solution:

  • Verify translation engine settings
  • Check API key configuration
  • Review error logs for specific issues

Performance Issues​

Optimization Tips:

  • Reduce number of target languages (fewer = faster)
  • Exclude high-volume channels
  • Monitor Discord API rate limits
  • Use repair function to clean up issues

πŸ’‘ Best Practices​

Server Organization​

  1. Clear Naming: Use descriptive names for source categories
  2. Logical Grouping: Auto setup related categories together
  3. Language Planning: Consider which languages your community needs
  4. Channel Exclusion: Exclude channels that shouldn't be mirrored

Performance​

  1. Limit Languages: More languages = more processing (max 6 recommended)
  2. Monitor Usage: Check feature usage statistics in dashboard
  3. Regular Maintenance: Use repair function periodically
  4. Exclude High-Volume: Consider excluding very active channels

Content Management​

  1. Translation Quality: Premium Groq engine provides high-quality translations
  2. Cultural Sensitivity: Be mindful of cultural differences
  3. Moderation: Set up moderation in all language versions
  4. Community Guidelines: Ensure guidelines are available in all languages

πŸŽ“ Examples​

Example 1: Multilingual Gaming Server​

Setup:

  • Source: "General Discussion" category (English)
  • Targets: Spanish, French, German
  • Result: Three mirrored categories with all channels translated

Use Case: Players can discuss in their preferred language while seeing all conversations

Example 2: International Community​

Setup:

  • Source: "Announcements" category (English)
  • Targets: Spanish, Portuguese, Japanese, Korean, Chinese
  • Result: Five mirrored announcement categories

Use Case: Important announcements reach all language groups simultaneously

[Photo of example server structure here]

πŸ“Š Statistics & Monitoring​

View auto setup statistics in the dashboard:

  • Messages mirrored per day
  • Translation success rate
  • Channel counts
  • Error rates

πŸ” Premium Requirements​

Auto Setup requires Server Boost - Groq Powered tier ($9.99/month).

Why Premium Only?​

  • High API Usage: Requires significant Discord API calls
  • Translation Costs: Uses premium Groq translation services
  • Storage Requirements: Maintains extensive mirror configurations
  • Processing Power: Real-time content synchronization

πŸ†˜ Support​

Need help with Auto Setup?

  • Dashboard Help: Use the help system in the web dashboard
  • Documentation: Check this page and the main documentation
  • Support Server: Join our Discord support server
  • Error Logs: Review error logs in the dashboard

Ready to set up Auto Setup? Visit the Dashboard and click on "Auto-Setup"!