Discord Bot
Introduction
MohCitrus is a translation bot for Discord. It helps your global community community communicate easily by translating messages into over 100 languages directly in your server.
How it works:MohCitrus reads messages, detects the source language automatically, and replies with the translation. You can use slash commands, prefixes, or context menus to translate text.
Quick Start
Get the bot running in your server in a few simple steps.
1
Invite the Bot
Use the invite link on our home page. Make sure you give the bot permissions to Read Messages, Send Messages, and Embed Links. If you do not allow embedding links, the translations will not format properly.
2
Run Setup
Go to your main channel and type /setup. The bot will guide you through an interactive menu to select a channel and pick up to 3 languages for automatic translation.
3
Test it out
Type !es hello into the chat and hit enter. The bot will reply with the Spanish translation.
User App Installation
MohCitrus supports Discord's new User Install feature. This means you can add the bot directly to your personal Discord account rather than a server.
To do this, use our invite link and select "Add to My Apps" instead of selecting a server. Once installed, you can use commands like Explain with Gemini and /pronounce in any server or direct message you are in!
Core Translations
/translate
This is the standard translation command. Choose a target language, type your text, and the bot replies with the translation. You do not need to specify the source language because the bot detects it automatically.
| Parameter | Type | Description |
|---|---|---|
language | Required | The language to translate to. |
text | Required | The text to translate. |
language_2 | Optional | A second target language for the same text. |
language_3 | Optional | A third target language for the same text. |
private | Optional | Only show the result to you. |
/translate language:"Spanish" text:"Hello there, how are you?"Multi-Language Output
The /translate command can translate the same message into up to three target languages at once. This is useful for announcements, event posts, and mixed-language communities.
| Parameter | Type | Description |
|---|---|---|
language | Required | The first target language. |
language_2 | Optional | The second target language. |
language_3 | Optional | The third target language. |
private | Optional | Send the combined result privately. |
/translate language:"English" text:"Hello everyone" language_2:"Japanese" language_3:"Spanish"/translate-image
Use /translate-image when the text you need is inside a screenshot, poster, meme, or other image. MohCitrus extracts the visible text and returns the translation.
| Parameter | Type | Description |
|---|---|---|
language | Required | The language to translate the detected text into. |
image | Optional | Upload an image attachment. |
image_url | Optional | Paste a direct image URL instead of uploading a file. |
private | Optional | Only show the result to you. This is enabled by default. |
/translate-image language:"English" image:"screenshot.png"/detectlanguage
If you are not sure what language a message is written in, use /detectlanguage. Paste the text and MohCitrus identifies the language for you.
/detectlanguage text:"Bonjour tout le monde"Fast Prefix (!lang)
If you type fast, you can use a language code as a command prefix instead of opening the slash menu.
The bot supports normal abbreviations like !en, !es, !fr. For example, if you type !es hello, the bot replies with the Spanish translation.
Formatting rules
- Works:
!es Hello - Fails:
!esHello(There must be a space after the prefix)
Automation
Auto Translate Channels
You can link a specific channel to automatically translate every message sent there into a target language of your choice.
How to set it up:
- Run the command: Type
/autotranslateto open the configuration menu. - Action: Set this to
enable. - Select Languages: Enter your desired languages in the Primary and Secondary fields (e.g.,
ENandES). - Hit Submit. Every message sent in that channel will now be automatically translated between the selected languages.
Note: Free servers can keep up to 7 active auto-translation channels. Translation volume itself is unlimited; Premium removes the automation cap.
Forwarding to another channel
If you want translations to be sent cleanly to a completely different channel (instead of replying in the same chat), you can configure a Forwarding Channel. This currently must be configured through the Web Dashboard:
- Log into the Web Dashboard and select your server.
- Navigate to the Auto Channels tab.
- Add or Edit an existing auto-translate channel.
- Use the Forward To dropdown to select a different text channel for the translations to be routed to.
Bilingual Mirrors
Instead of just translating messages within the same channel, you can fully link two channels together. This creates a mirrored experience where English users type in their channel, and it appears in the Spanish channel, while Spanish users type in theirs and it appears in the English one seamlessly.
You can configure this via the Web Dashboard under the Automation tab, or by using the /channeltranslate command. Simply select two channels and their corresponding languages to link them.
Note: Free servers can create up to 5 bilingual mirror setups. Premium removes that cap.
Flag Reactions
If you see a message you do not understand, just react to it with a country flag emoji. The bot detects the flag and sends you the translation.
Important note about replies:
Usually, the bot tries to send you a private message. If your DMs are closed, it will reply in the channel and tag you. You can change this behavior in the Server Settings Premium.
Advanced Features
/glossary
If your server has gaming slang or specific words that normal translators mess up, you can add them to the glossary. This forces the bot to translate those specific words exactly how you want.
| Parameter | Description |
|---|---|
term | The original term to replace (e.g., "Tank"). |
language | The target language code (e.g., "ES"). |
translation | The replacement text (e.g., "Tanque"). |
/glossary add term:"Smurf" language:"ES" translation:"Cuenta Alternativa"You can also view and edit your glossary lists directly in the Web Dashboard.
Note: Free servers can save up to 25 glossary entries. Premium removes that cap entirely.
Translate My Draft
Use Translate My Draft from the Discord Apps menu when you want help writing a reply in another language. MohCitrus opens a private draft box, translates what you type, and gives you a result you can send with confidence.
- Right-click the message you want to reply to.
- Go to Apps.
- Click Translate My Draft.
- Write your draft and choose the target language in the private modal.
Explain with Gemini
Sometimes literal translations don't make sense if a user is using foreign slang, jokes, or idioms. You can use our Gemini AI integration to get a breakdown of the message's true cultural meaning directly in your native language.
- Right-click any Discord message.
- Go to the Apps section.
- Click Explain with Gemini.
Pronunciation Tools
If you're learning a new language and want to know how a specific word is pronounced, you can use the pronunciation tool. It pulls the phonetic spelling directly from the Merriam-Webster dictionary.
- Use the slash command:
/pronounce word:"hello" - Or right-click a word/message, go to Apps -> How do you say this?.
Voice Message Translations
When someone leaves a voice note, right-click the message, open Apps, and choose Translate Voice Message. MohCitrus privately asks whether you want a text translation or a spoken voice version.
Voice message translation works in servers and DMs. Voice clips can be up to 90 seconds. Premium servers have full access; free servers get 3 uses per user per day, and DMs get 10 uses per user per day.
Note: Voice results are private to the person who requested them. The bot does not auto-post voice transcripts into the channel.
Server Commands
MohCitrus also includes server management commands for admins and moderators.
/settingsopens advanced translation settings for the server./statusshows active auto-translation configuration./premiumshows Premium status, plan details, and upgrade links./invitegives you the bot invite link.
Bot Analytics
Curious about how much your server uses translations? Run the /statscommand to get a detailed breakdown of your server's total translated messages, active languages, and more.
Web Dashboard Instructions
Web Dashboard
Logging In
The Web Dashboard lets you configure the bot using a normal web interface instead of Discord commands. You can toggle settings, manage glossaries, and check usage limits here.
How to login
- Click the Dashboard button at the top right of this site.
- Login using your Discord account.
- Select a server from the list. You must have the
Manage Serverpermission to view settings. - You can now view and edit the settings for your server.
Managing Prefixes
If the fast prefixes conflict with other bots in your server, you can turn them off or rename them.
- Go to the General Settings tab in your dashboard.
- To disable a prefix: Click the cross icon on the language.
- To rename a prefix: Click the pencil icon and enter a new name, like
!hindiinstead of!hin.
Managing Auto-Channels
In the Automationtab on the dashboard, you can see a list of all active auto-translate channels in your server. You can click "Unlink" next to any channel to stop translations immediately.
Feature Limits
MohCitrus is fully usable on the free tier with no character limits per server. Some automation features are capped to prevent abuse. Premium removes those caps and upgrades the translation engine.
| Feature | Free | Premium |
|---|---|---|
| Translation Engine | Standard | Premium Pro |
| Auto-Channels | 10 per server | Unlimited |
| Bilingual Mirrors | 5 per server | Unlimited |
| Glossary Terms | 25 per server | Unlimited |
| Blacklisted Words | 25 per server | Unlimited |
| Voice in DMs | 10 per user daily | 10 per user daily |
| Voice in Free Servers | 3 per user daily | Included |
| Translation Styles | Reply, Embed, Webhook | Reply, Embed, Webhook |
Tickets & Support
The Tickets tab in the dashboard is the official support inbox for your server. Use it for bug reports, billing issues, feature requests, and account help.
How It Works
- Users can keep one active ticket at a time (
open,in_progress, orwaiting). - User ticket lists hide
resolvedandclosedby default for cleaner inboxes. - Developers can manage tickets globally from the developer ticket inbox.
Attachments & Media
- Attach up to 5 files per message (images, video, audio, or PDF).
- Image previews appear before sending so you can validate content quickly.
- Each selected file and preview has its own
Xremove action. - File selection is additive across multiple picker opens (up to the limit).
Email Notifications
- Ticket updates can send email alerts when notification variables are configured.
- Ticket users must have a verified Discord email to create/reply from dashboard flows.
- Notification subjects are ticket-based and user-friendly, without raw guild IDs.
Premium Guide
How to Upgrade
Upgrading your account takes less than two minutes.
- Log in to the Web Dashboard.
- Click on the Premium tab in the navigation menu.
- Select your plan and complete the checkout process. The selected Discord server upgrades instantly.
Reference Guide
Supported Languages
MohCitrus automatically routes translations to the best engine available. To translate, use standard ISO codes like EN, ES, FR, etc. Here are the specific engines and their supported coverage.
DeepL (Premium Default)
DeepL provides the highest contextual accuracy for the following core languages:
BG, CS, DA, DE, EL, EN, ES, ET, FI, FR, HU, ID, IT, JA, KO, LT, LV, NB, NL, PL, PT, RO, RU, SK, SL, SV, TR, UK, ZH
Azure Translator (Premium Fallback)
Azure acts as the premium fallback, providing enterprise-grade coverage for these and over 80 more regional variants:
AF, AM, AR, AZ, BG, BN, BS, CA, CS, CY, DA, DE, EL, EN, ES, ET, FA, FI, FIL, FR, GA, GU, HE, HI, HR, HU, HY, ID, IS, IT, JA, KA, KK, KM, KN, KO, KU, KY, LT, LV, MK, ML, MN, MR, MS, MT, MY, NB, NE, NL, PA, PL, PT, RO, RU, SD, SK, SL, SQ, SR, SV, SW, TA, TE, TH, TR, UK, UR, UZ, VI, ZH
Google Translate (Standard Default)
Google Translate powers the free tier and acts as the ultimate fallback, supporting almost all languages universally:
AF, AM, AR, AZ, BE, BG, BN, BS, CA, CEB, CO, CS, CY, DA, DE, EL, EN, ES, ET, FA, FI, FIL, FR, GA, GD, GL, GU, HA, HAW, HE, HI, HMN, HR, HT, HU, HY, ID, IG, IS, IT, JA, JW, KA, KK, KM, KN, KO, KU, KY, LA, LO, LT, LV, MI, MK, ML, MN, MR, MS, MT, MY, NB, NE, NL, NY, OR, PA, PL, PS, PT, RO, RU, SD, SI, SK, SL, SM, SN, SO, SQ, SR, ST, SU, SV, SW, TA, TE, TG, TH, TK, TL, TR, UK, UR, UZ, VI, XH, YI, YO, ZH, ZU
Preparing translated docs...