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.

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.

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.

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.

/translate language:"Spanish" text:"Hello there, how are you?"

/dualtranslate

This command splits the output into two different languages side-by-side. It is very useful for posting announcements in bilingual servers.

Parameter	Type	Description
`language1`	Required	The first language to translate into.
`language2`	Required	The second language to translate into.
`text`	Required	The text to translate.
`includeoriginal`	Optional	Include the original text in the response.

/dualtranslate language1:"English" language2:"Japanese" text:"Hello everyone" includeoriginal:True

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 /autotranslate to open the configuration menu.
Action: Set this to enable.
Select Languages: Enter your desired languages in the Primary and Secondary fields (e.g., EN and ES).
Hit Submit. Every message sent in that channel will now be automatically translated between the selected languages.

Note: Free servers can only have a limited amount of active auto-translation channels to prevent abuse. You can check your limits and upgrade early in the Web Dashboard.

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.

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 are limited to 10 glossary entries. You can bypass this limit entirely by upgrading to MohCitrus Premium!

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 -> Pronounce Language.

Voice Message Translations

When someone leaves a voice note in a channel, MohCitrus will automatically transcribe the audio in the original language and post a clean translation underneath it.

This allows the entire room to follow the conversation seamlessly, regardless of whether they prefer to read or listen.

Note: Voice message translation requires MohCitrus Premium.

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 Server permission 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 !hindi instead 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	5 per server	Unlimited
Bilingual Mirrors	2 per server	Unlimited
Glossary Terms	10 per server	Unlimited
Blacklisted Words	10 per server	Unlimited
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, or waiting).
User ticket lists hide resolved and closed by 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 X remove 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

MohCitrus Premium

Premium Benefits

The free version of MohCitrus provides unlimited translations. However, upgrading to Premium unlocks superior translation intelligence and removes all automation caps.

Premium Translation Engine: Upgrades your server from the standard engine to the premium intelligence engine (DeepL & Azure), which produces more natural and context-aware results.
Unlimited Automation: Removes the 5-channel Auto-Translate limit, the 2-mirror Channel Linking limit, the 10-term Glossary cap, and the 10-word Blacklist cap.
All Translation Styles Included Free: Reply, Embed, and Webhook modes are available on the free tier. Premium focuses on higher-quality engines and unlimited capacity.

Server-Based System

MohCitrus uses a Server-Based Premium model. This means your premium subscription is applied directly to a specific Discord server.

Once a server is upgraded, all members inside that community benefit from the unlocked features and higher-quality translations simultaneously.

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. Your Discord account 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