Hello
Bonjour
こんにちは
Hola
Привет
مرحبا
Documentation Support Privacy Terms

Langualy Documentation

Learn how to set up and use Langualy, the Discord translator bot that breaks language barriers in your server.

Table of Contents

Overview

Langualy is a powerful Discord bot that translates messages in real-time, helping you communicate across language barriers. The bot offers multiple translation methods and management features:

1. Reaction Translations: Users can react to any message with a flag emoji to get an instant translation to that language.

2. Role-Based Auto Translation: Automatically translate messages for users with specific roles to their preferred languages.

3. Translation Groups: Create groups of channels where messages are automatically translated between different languages.

4. Auto-Delete Translations: Configure automatic deletion of translation messages after a specified time to keep channels clean.

Translation Reactions

To translate any message in your server:

  1. React to the message with a flag emoji (e.g., 🇺🇸 for English, 🇪🇸 for Spanish)
  2. The bot will immediately translate the message to the selected language
  3. The translation will appear as an embedded message in the same channel

This method is perfect for on-demand translations when you need to understand a specific message.

Role-Based Auto Translation

Role-based auto translation allows you to automatically translate messages for users with specific roles to their preferred languages. This feature is perfect for international communities where certain members need automatic translations.

How it works:

  1. Assign translation roles to users who need automatic translations
  2. Configure each role to translate messages to a specific target language
  3. When a message is sent in any channel, users with translation roles will automatically receive a translated copy
  4. The translation appears as an embedded message with the original user's information preserved
Setting Up Role Translations
1
2
3
4
1. Create a role for users who need translations (e.g., "Spanish Speakers") 2. Use admin commands to configure the role for auto-translation 3. Assign the role to users who need automatic translations 4. Messages will now be automatically translated for those users

Key Features:

  • Automatic Detection: The bot automatically detects the source language and translates accordingly
  • Efficient Performance: Role translations are optimized to check only user-specific roles, not all server roles
  • Preserve Context: Original message author and formatting are preserved in the translation
  • Channel Flexibility: Works in any channel where the bot has permissions
  • Multiple Roles: Users can have multiple translation roles for different languages

This feature is particularly useful for:

  • International gaming communities
  • Educational servers with foreign language learners
  • Business servers with multilingual teams
  • Support channels for global communities

Translation Groups

Translation groups allow you to connect multiple channels where each channel is dedicated to a specific language. When a message is sent in any channel in the group, it is automatically translated and sent to all other channels in the appropriate language.

How it works:

  1. Create a translation group using the /group_create command
  2. Add channels to the group, each with a designated language
  3. When a message is sent in any channel in the group, it is automatically translated and forwarded to all other channels in their respective languages

This is ideal for multilingual communities where members can chat in their preferred language while still understanding everyone else.

Auto-Delete Translations

Keep your channels clean by automatically deleting translation messages after a specified time. This feature is perfect for busy channels where translations can accumulate quickly.

Key Features

  • Configure deletion time from 1 minute to 24 hours
  • Enable/disable for specific translation types (flag reactions, role translations, auto translations)
  • Channel-specific settings - each channel can have its own auto-delete configuration
  • Automatic cleanup runs in the background

How to Set Up

  1. Use /auto_delete_setup to configure auto-deletion for a channel
  2. Choose whether to enable or disable the feature
  3. Set the deletion time (1-1440 minutes)
  4. Select which translation types should be auto-deleted

Translation Types

Flag Translations: Messages created when users react with flag emojis

Role Translations: Automatic translations for users with translation roles

Auto Translations: Messages translated through translation groups

Note: Only users with "Manage Messages" permission can configure auto-deletion settings for channels.

Subscription Tiers

Langualy offers two subscription tiers:

Free Tier
1
2
3
4
• Up to 3 translation groups • Maximum 10 channels per group • Up to 3 role-based auto translations • Unlimited reaction translations
Premium Tier
1
2
3
4
5
6
• Unlimited translation groups • Unlimited channels per group • Up to 20 role-based auto translations • Unlimited reaction translations • High-quality DeepL translations • Priority support

Check your server's current subscription status with the /subscription command.

Technical Features & Reliability

Langualy is built with advanced features to ensure reliable, high-quality translations:

Multi-Service Translation
1
2
3
4
5
• Primary: Microsoft Azure Translator for enterprise-grade quality and speed • Secondary: Lingva API for fast, reliable translations • Backup: MyMemory API for additional reliability • Backup: Google Translate API for maximum uptime • Premium: DeepL API for highest quality translations
Smart Language Detection
1
2
3
4
• Automatic source language detection • Enhanced Japanese/Chinese character recognition • Fallback detection for edge cases • Optimized for multilingual content
Performance Optimizations
1
2
3
4
5
• Intelligent caching system for repeated translations • Asynchronous processing for faster response times • Optimized database queries for role translations • Efficient attachment handling and processing • Rate limiting and cooldown management
Security & Privacy
1
2
3
4
• No message storage - translations are not logged • Mention sanitization prevents privilege escalation • Secure webhook handling for group translations • Privacy-focused design with minimal data collection

These features ensure that Langualy provides consistent, fast, and secure translation services for your Discord community.

Bot Commands

Langualy offers the following slash commands:

Help Command
1
/help - Shows information about available bot commands
Manual Translation
1
2
3
/translate text language - Translate text to a specific language ├─ text: The text you want to translate (up to 2000 characters) └─ language: Target language code (e.g., en, es, fr, ja, zh-TW)
Group Creation
1
2
/group_create group_name - Creates a new translation group └─ group_name: Name for the new translation group
Add Channel to Group
1
2
3
4
5
/group_add channel group_name language - Adds a channel to a translation group ├─ channel: The channel to add to the group ├─ group_name: Name of the translation group └─ language: Language code for this channel (e.g., en, es, fr) Note: The dropdown only shows 25 common languages due to Discord limits, but you can manually type any supported language code.
Delete Group
1
2
/group_delete group_name - Deletes a translation group and removes all its channel links └─ group_name: Name of the translation group to delete
Remove Channel from Group
1
2
/group_remove channel - Removes a channel from its translation group └─ channel: The channel to remove from its group
List Groups
1
/groups - Lists all translation groups in this server
Group Information
1
2
/group_info group_name - Shows details of a translation group └─ group_name: Name of the translation group
Role Translation - Create
1
2
3
/role_translate_create role_name target_language - Create a role-based translation rule ├─ role_name: The name of the role to create a translation rule for └─ target_language: The language to translate messages TO for users with this role
Role Translation - Delete
1
2
/role_translate_delete role_name - Delete a role-based translation rule └─ role_name: The name of the role to delete the translation rule for
Role Translation - List
1
/role_translate_list - List all role-based translation rules in this server
Auto-Delete Setup
1
2
3
4
5
6
/auto_delete_setup enabled minutes flag_translations role_translations auto_translations - Configure auto-deletion for this channel ├─ enabled: Enable or disable auto-deletion ├─ minutes: Minutes before deletion (1-1440, default: 60) ├─ flag_translations: Auto-delete flag reaction translations ├─ role_translations: Auto-delete role-based translations └─ auto_translations: Auto-delete automatic translations
Auto-Delete Status
1
/auto_delete_status - Check auto-deletion settings for this channel
Auto-Delete Enable
1
2
/auto_delete_enable minutes - Quickly enable auto-deletion with default settings └─ minutes: Minutes before deletion (1-1440, default: 60)
Auto-Delete Disable
1
/auto_delete_disable - Quickly disable auto-deletion for this channel
Auto-Delete List
1
/auto_delete_list - List all channels with auto-deletion enabled in this server
Subscription Status
1
/subscription - Checks your server's subscription status

Supported Languages

Langualy supports over 100 languages, organized by region:

Major Languages

🇺🇸 English (US)
🇬🇧 English (UK)
🇦🇺 English (Australia)
🇨🇦 English (Canada)
🇮🇪 English (Ireland)
🇳🇿 English (New Zealand)
🇿🇦 English (South Africa)
🇪🇸 Spanish (Spain)
🇲🇽 Spanish (Mexico)
🇦🇷 Spanish (Argentina)
🇨🇴 Spanish (Colombia)
🇨🇱 Spanish (Chile)
🇵🇪 Spanish (Peru)
🇻🇪 Spanish (Venezuela)
🇫🇷 French
🇨🇦 French (Canada)
🇧🇪 French (Belgium)
🇨🇭 French (Switzerland)
🇩🇪 German
🇦🇹 German (Austria)
🇨🇭 German (Switzerland)
🇮🇹 Italian
🇨🇭 Italian (Switzerland)
🇯🇵 Japanese
🇰🇷 Korean
🇨🇳 Chinese (Simplified)
🇹🇼 Chinese (Traditional)
🇭🇰 Chinese (Hong Kong)
🇵🇹 Portuguese
🇧🇷 Portuguese (Brazil)
🇷🇺 Russian

European Languages

🇦🇱 Albanian
🇧🇦 Bosnian
🇧🇬 Bulgarian
🇭🇷 Croatian
🇨🇿 Czech
🇩🇰 Danish
🇳🇱 Dutch
🇧🇪 Dutch (Belgium)
🇪🇪 Estonian
🇫🇮 Finnish
🇬🇷 Greek
🇭🇺 Hungarian
🇮🇸 Icelandic
🇮🇪 Irish
🇱🇻 Latvian
🇱🇹 Lithuanian
🇱🇺 Luxembourgish
🇲🇰 Macedonian
🇲🇹 Maltese
🇲🇪 Montenegrin
🇳🇴 Norwegian
🇵🇱 Polish
🇷🇴 Romanian
🇷🇸 Serbian
🇸🇰 Slovak
🇸🇮 Slovenian
🇸🇪 Swedish
🇺🇦 Ukrainian
🏴󠁧󠁢󠁷󠁬󠁳󠁿 Welsh
🏴󠁧󠁢󠁳󠁣󠁴󠁿 Scottish Gaelic

Asian Languages

🇧🇩 Bengali
🇲🇲 Burmese
🇰🇭 Cambodian/Khmer
🇮🇳 Hindi
🇮🇩 Indonesian
🇰🇿 Kazakh
🇱🇦 Lao
🇲🇾 Malay
🇲🇻 Maldivian/Dhivehi
🇲🇳 Mongolian
🇳🇵 Nepali
🇵🇰 Urdu
🇵🇭 Filipino/Tagalog
🇸🇬 Singaporean Malay
🇱🇰 Sinhala
🇹🇭 Thai
🇹🇯 Tajik
🇹🇲 Turkmen
🇺🇿 Uzbek
🇻🇳 Vietnamese

Middle Eastern Languages

🇦🇪 Arabic
🇧🇭 Arabic (Bahrain)
🇪🇬 Arabic (Egypt)
🇮🇶 Arabic (Iraq)
🇯🇴 Arabic (Jordan)
🇰🇼 Arabic (Kuwait)
🇱🇧 Arabic (Lebanon)
🇱🇾 Arabic (Libya)
🇲🇦 Arabic (Morocco)
🇴🇲 Arabic (Oman)
🇶🇦 Arabic (Qatar)
🇸🇦 Arabic (Saudi Arabia)
🇸🇾 Arabic (Syria)
🇹🇳 Arabic (Tunisia)
🇦🇪 Arabic (UAE)
🇾🇪 Arabic (Yemen)
🇦🇲 Armenian
🇦🇿 Azerbaijani
🇮🇷 Persian/Farsi
🇮🇱 Hebrew
🇬🇪 Georgian
🇹🇷 Turkish

African Languages

🇿🇦 Afrikaans
🇪🇹 Amharic
🇨🇩 Lingala
🇬🇭 Ewe
🇰🇪 Swahili
🇲🇬 Malagasy
🇲🇱 Bambara
🇳🇬 Igbo
🇳🇬 Hausa
🇳🇬 Yoruba
🇷🇼 Kinyarwanda
🇸🇴 Somali
🇿🇦 Zulu
🇿🇦 Xhosa
🇿🇦 Sesotho
🇿🇦 Setswana

Oceanian & Other Languages

🇫🇯 Fijian
🇭🇹 Haitian Creole
🇵🇬 Hiri Motu
🇵🇬 Tok Pisin
🇼🇸 Samoan
🇹🇴 Tongan
🇲🇽 Nahuatl
🇵🇪 Quechua
🇧🇴 Aymara
🇵🇾 Guarani
🇬🇱 Greenlandic
🌍 Esperanto

You can use these languages in both reaction translations and translation groups.