# Introduction

The official documentation for the translation features available on JakeBot.

{% hint style="warning" %}
**Important:** This documentation is a work in progress, so if you see anything that needs to be changed or something that's missing. Please tell us on our [support server](https://discord.com/invite/8JZwx82).
{% endhint %}

## Have a Question?

Try the AI search engine, go to search in the top right. Enter your question as you would ask a person and tap enter or the "Search Lens" button. It may be able to answer your question quickly and effectively! Otherwise,[ join the support server](https://discord.com/invite/8JZwx82), also available at the top or under "View Links".

## Who is JakeBot?

JakeBot is perfect for a highly multilingual server, with its **advanced and super easy-to-use automatic translation systems**. You can modify almost everything to your needs, including diverting results to different channels, what style results are in, what roles/members are affected by the translation and more!

You can get up to 800 free characters per upvote with several upvoting websites available. The free tier offers **6000 characters per month**

Discord Message Commands also allow any user to **privately translate** a message into a language of their choice. Or premium subscribers can enable a **reaction-based translation** system that will translate a message into the language spoken by the country whose flag was reacted.

## Get Started

We've put together some helpful guides for you to get set up quickly.

{% content-ref url="/pages/lWqKybxNpBkqTPT3fbWA" %}
[Create your first Automatic Translation setup](/basic-usage-and-setup/create-your-first-automatic-translation-setup)
{% endcontent-ref %}

{% content-ref url="/pages/P5cecSafJ3ReyuIChu07" %}
[Troubleshooting Tips](/troubleshooting-tips)
{% endcontent-ref %}

{% content-ref url="/pages/E1U9i1blTfo1ATYu17un" %}
[Setting up Premium in my Server](/premium-setup-and-features/setting-up-premium-in-my-server)
{% endcontent-ref %}


# Quick Command Reference

Just want to know what all the commands do in less detail, this is your page!

## Automatic Translation Setups

### New Setup

`/settings automatic_translation new [name] [language_from] [language_to]`\
This command allows you to quickly and easily create a new Automatic Translation setup.

### Edit Setup

`/settings automatic_translation edit [setup]`\
Edit any detail of the translations you have already created! Run without any options to edit everything.

### View Setup

`/settings automatic_translation view [name]`\
View details on a specific Auto Translation setup

### List All

`/settings automatic_translation list`\
View basic details on all existing Auto Translation setups

## Automatic Translation Settings

### Character Limit

`/settings automatic_translation character_limit [limit]`\
Set the maximum number of characters to be automatically translated. Any messages longer than this will be cut off with an ellipsis.

### Translator

`/settings translator [choice]`\
Select whether you want to use Google Translate, Microsoft Translate or DeepL. Google Translate and DeepL are only available to premium users.

## Patreon

### Dashboard

`/patreon dashboard`\
This shows you all the information regarding your Patreon tier.

### Upgrade Server

`/patreon upgrade [server]`\
This can be used to upgrade a server you want to have your premium tier. You can specify the server (ID Recommend, listed in the dashboard) but running it in a server will upgrade it.

### Downgrade Server

`/patreon downgrade [server]`\
This can be used to downgrade a server you no longer want to have your premium tier. You can specify the server (ID Recommend, listed in the dashboard) but running it in an upgraded server will downgrade that server.

### Reassign

`/patreon reassign`\
This will send a new unique link to allow you to change the Patreon profile that's attached to your JakeBot profile, for example, if you don't use your old Patreon account anymore.

## Upvoting & Bonus Characters

### Dashboard

`/reward dashboard`\
View details regarding your upvote status, upvote tokens and bonus characters.

### Redeem Upvote Tokens

`/reward redeem_upvotes [token_amount]`\
Redeem 1 or more Upvote Tokens for a reward. Specify "all" to redeem all of them, this is the default

### Allocate Characters

`/reward allocate [amount] [server]`\
Allocate 1 or more of your bonus characters to a server of your choosing! Specify "all" to allocate all of them, this is the default. Run the command in the server you want to send them to, to quickly send characters.

## Global Blacklist

### List All

`/settings global_blacklist list`\
View all the words on the global blacklist

### Add Words

`/settings global_blacklist add [word]`\
Add a new phrase to the global blacklist, items in this list will only avoid translation when sent on their own

### Remove Words

`/settings global_blacklist remove [word]`\
Remove a word from the global blacklist, a suggestion list of the words in the blacklist is provided.

## Style

### View Options

`/settings2 style view_options`\
View the various style options, or view them [here](https://jakebot.co.uk/translation).

### Set Automatic Style

`/settings2 style automatic_set [option]`\
Update the style of the results from an automatic translation

### Set Command Style

`/settings2 style command_set [option]`\
Update the style of the results from a command translation

### Set Reaction Style

`/settings2 style reaction_set [option]`\
Update the style of the results from a reaction translation

### Match Styles

`/settings2 style match_styles [this] [with_this] [and_this]`\
Match one style with another, or both.

## Extras

### View Options

`/settings2 extras view_options`\
View all the extra features available

### Enable Extra

`/settings2 extras enable [feature]`\
Enable an extra feature from the list

### Disable Extra

`/settings2 extras disable [feature]`\
Disable a feature from the list

## Message Commands

See [here ](/basic-usage-and-setup/message-commands-really-cool)for information on these.

### Quick Translate

This allows you to quickly translate to any language of your choosing, running it will open a menu where you can enter a language code or language name to quickly get the resulting translation!

### To English

As the name implies, it will instantly and privately translate the message interacted with into English!

### To Spanish

Similar to "To English" it will instantly and privately translate the message interacted with into Spanish!

### To Your Language

Set whatever language you would like with `/your_language`. This button will then translate to it, once again privately.

## Miscellaneous&#x20;

### Set Your Language

`/your_language [language]`\
Use this to tell Jake what your chosen spoken language is, this can then be instantly translated to using `To Your Language`.

### Translate

`/translate [Language] [Text to Translate]`\
This allows you to quickly translate text into a different language.

### Languages

`/languages`\
View all the languages the bot can translate written in both the native language and English. It also shows the international language code for quick reference.

### Translation Usage

`/translation_usage`\
This shows you how many characters your server has used this month, as well as estimated character usage for the entire month, among several other useful bits of info.

### Settings Help

`/settings help`\
This gives you a breakdown of the entire Automatic Translation system's commands, useful as a quick reference.

### Old Settings

`/old_settings`\
The old entirely button-based settings menu that was retired on 16/07/2023 in favour of the new slash-based system.


# Troubleshooting Tips

Is your auto translation setup not working quite how you expected? See if you can fix it using the advice here!

<details>

<summary>Check you haven't run out of characters</summary>

Run `/translation_usage` to see! Either upvote the bot, buy an upgrade pack, a tier on Patreon or wait for next month to get more characters.

</details>

<details>

<summary>Check the bot has the right permissions</summary>

It needs to be able to send messages, view channels and view message history in all the channels it's running in. If you're using style 8 or 9, it also needs to be able to create webhooks. If your messages are being reacted to with a warning shield, it normally means JakeBot has a permission issue.

</details>

<details>

<summary>Check the FROM language is part of your selected Translator</summary>

In your setup, make sure the language being translated from (you can translate TO any of the languages) is available in your selected translator with `/languages`. Not all languages are available with all Translators. Change your Translator, if you have premium, with `/settings translator [option]`.

</details>

<details>

<summary>Check the old settings menu (old_settings) isn't open</summary>

If the old entirely button based setup system menu `/old_settings` or `J!translation_settings` is open in a channel translations will not commence in that channel until it has been closed.

</details>

<details>

<summary>Check it isn't disabled</summary>

Run `/settings automatic_translation view [setup]` to see if it's been disabled or not.

</details>

<details>

<summary>Check the channel is correct</summary>

Run `/settings automatic_translation view [setup]` to make sure the channels are all correct

</details>

<details>

<summary>Check you have any special roles that may be required</summary>

Run `/settings automatic_translation view [setup]` to see if it's been setup with a requirement to have a certain role for it to translate you.

</details>

<details>

<summary>Is it diverting somewhere?</summary>

Run `/settings automatic_translation view [setup]` to see if it's diverting to a channel you haven't noticed.

</details>

<details>

<summary>Check both blacklists</summary>

Run `/settings automatic_translation view [setup]` and `/settings global_blacklist list` to see if your trying to translate a message that's being blacklisted.&#x20;

</details>

<details>

<summary>Are you trying to translate between one and three words?</summary>

Then run`/settings2 extras view_options` and see if "Single Word Translation" and "Three Word Translation" are allowed.

</details>

<details>

<summary>Are you trying to translate a message that looks like a bot command?</summary>

Then run`/settings2 extras view_options` and see if "CMD Activation Messages" are allowed.

</details>

Are you still struggling to get your setup working? [Join our support server here](https://discord.com/invite/8JZwx82) and make a post in the help forum!


# Basic Slash Commands

The basic translation commands broken down.

<details>

<summary>/translate [Language] [Text to Translate]</summary>

This allows you to quickly translate text into a different language, there is a list of suggested languages based on what you type for you to pick from to help reduce issues with incorrect languages. Noteworthy is that no matter if you are using Google Translate or Microsoft Translate, this command can access every single one of the 150+ languages the bot can translate, for free!

</details>

<details>

<summary>/settings automatic_translation new [name] [language_from] [language_to]</summary>

We'll get into this more in [a later section](/basic-usage-and-setup/create-your-first-automatic-translation-setup). But this command allows you to quickly and easily create a new Automatic Translation setup

</details>

<details>

<summary>/languages</summary>

View all the languages the bot can translate written in both the native language and English. It also shows the international language code for quick reference. As well as what languages are only available with Google (premium). By default, the response from this is only visible to you.

</details>

<details>

<summary>/your_language [language]</summary>

Use this to tell Jake what your chosen spoken language is, this can then be instantly translated to using `To Your Language` in the[ Message Command Menu](/basic-usage-and-setup/message-commands-really-cool) (see the next page for more details)

</details>

<details>

<summary>/settings help</summary>

This gives you a breakdown of the entire Automatic Translation system's commands, useful for a quick reference in a more digestible form than Discord's slash command interface.

</details>

<details>

<summary>/translation_usage</summary>

This shows you how many characters your server has used this month, as well as estimated character usage for the entire month, among several other useful bits of info. By default, the response from this is only visible to you.

</details>


# Message Commands (Really Cool)

All the power at your fingertips (or right mouse button)

## Overview

{% hint style="success" %}
**Fun Fact:** None of the translations done using this menu count towards the server's total character usage, so they can be used wherever, forever!
{% endhint %}

A while back Discord introduced the ability to run commands directly on a message you interacted with, either by pressing and holding on mobile, or right-clicking on desktop.

With this comes a lot more power as you can translate into whatever language you want right from that menu!

From that menu simply go to "Apps" and then there are 5 JakeBot commands, 4 of which are for translation!

<figure><img src="https://2311948898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwTYJfIMlu3oKXK45dqN%2Fuploads%2FO9XOLeC9B1hzo2cgtTKf%2Fmessage%20cmds.png?alt=media&amp;token=05d50a43-66a2-4887-82b0-319f10925977" alt=""><figcaption></figcaption></figure>

## Commands

<details>

<summary>Quick Translate</summary>

This allows you to one off quickly translate to any language of your choosing, running it will open a menu where you can enter a language code or language name to quickly get the resulting translation!

</details>

<details>

<summary>To English</summary>

As the name implies, it will instantly and privately (so only you can see the result) translate the message interacted with into English!

</details>

<details>

<summary>To Spanish</summary>

Similar to "To English"; it will instantly and privately (so only you can see the result) translate the message interacted with into Spanish!

</details>

<details>

<summary>To Your Language</summary>

This is the fun one, you can set whatever language you would like with `/your_language`. This button will then translate to it, once again privately so only you can see the result.

</details>


# Create your first Automatic Translation setup

Tired of constantly typing out the translate command? Get Jake to do all the work for you with just 1 simple command.

## Base Command

{% hint style="warning" %}
**Warning:** Make sure you have the "Manage Server" permission, otherwise you won't be able to see any of the commands! (Required permissions can be changed in the Discord settings)
{% endhint %}

`/settings automatic_translation new [name] [language_from] [language_to]`

First, you will need to enter the name for this translation setup, think something like "To Spanish in General", or "All to EN in General" and make sure it's less than 32 characters!

{% hint style="info" %}
**Hint:** The bot can automatically translate TO any of the 150+ languages in the list, however, make sure the language you are translating FROM is part of the Translator you are using with `/languages`
{% endhint %}

Then specify what language messages have to be in to get translated, you can specify "all" here if desired

Then specify what language you'd like those messages to be translated to, you cannot specify "all" here I'm afraid.

This is all you are required to enter, it will translate everything in the language you specified sent in the channel you ran the command in. But a lot of people may want to customise things a bit more than that!

<figure><img src="https://2311948898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwTYJfIMlu3oKXK45dqN%2Fuploads%2FectX6Kxp2sdK9BSi0fPF%2Fnew%20example%201.png?alt=media&amp;token=8489c960-ed54-418e-9184-49c2ff630d9f" alt=""><figcaption></figcaption></figure>

## Extra Customizability

You may notice that there are a lot more options available beyond the required 3, 18 more in fact! But not to worry, a lot of them are duplicates so it's not as complicated as it first may seem.

The first option, `affects_all_channels` will make the setup translate messages sent to every single channel in the server, this is further customisable as is discussed later in advanced features. Beyond that there are options for channels 1-8, if you don't want this setup to just function in the channel you ran the command in you can specify up to 8 channels or categories for it to run in here.

{% hint style="info" %}
**Hint:** If you need to add more than 8 channels, you can add them in the [edit menu](/basic-usage-and-setup/editing-your-setups) afterwards.
{% endhint %}

`to_channel1-4` is used to redirect the results from this setup to a different channel. If you'd like to add more than 4 redirections you can do so from the [edit menu](/basic-usage-and-setup/editing-your-setups#diversions).

`permitted_role1-5` is used to specify roles that are affected by this setup, for example, if you had a role called "Spanish" and selected this role on this setup, only people with that role would get their messages translated. It can help to reduce accidental translations.

`word_blacklist` is a list of words that if detected would result in the entire message not getting translated. For example, if you entered "lol", a message such as "that's so funny lol" would not get translated.

`create_pair`creates an identical setup with `language_to` and `language_from` reversed, so if you had Spanish to English, and enabled this setting, a second setup with English to Spanish would be created with everything else the same, and when editing you can choose for any changes made to one to impact the other.

![](https://2311948898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwTYJfIMlu3oKXK45dqN%2Fuploads%2FKWn3GYY4ztGTtCQfa2bd%2Fnew%20example%202.png?alt=media\&token=22e1e612-7159-47df-add7-19cbab633641)

## Send the Command!

Once everything is as you'd like, it's as simple as pressing enter. Your new setup shall be created and should start working instantly!

<figure><img src="https://2311948898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwTYJfIMlu3oKXK45dqN%2Fuploads%2FIu4EfXYDNeJY1Pi4KGcX%2Fnew%203.png?alt=media&amp;token=21e01684-18d9-4548-b0be-1baf31d23458" alt=""><figcaption></figcaption></figure>


# Viewing, deleting and disabling.

See above.

<details>

<summary>View all setups</summary>

`/settings automatic_translation list`

Running this will display a multipage embed with a brief overview of all the setups you have created

</details>

<details>

<summary>View Complete Details on One Setup</summary>

`/settings automatic_translation view [setup]`

Use this to view one setup in a lot more detail. This shows you all the channels it's running in, any diversions, blacklisted words etcetera.

</details>

<details>

<summary>Delete (or disable) a Setup</summary>

`/settings automatic_translation delete [setup] (action)`

Using this you can delete or disable a setup, by default it will delete whatever setup you select. But under extra options, there is an `action` selection, and in that, you can select "Disable" to simply disable the specified setup. You can also tell it to delete the other half of a paired setup.

</details>

<details>

<summary>Alternate way to disable a setup</summary>

`/settings automatic_translation edit [setup] (status)`

This is simply an alternate way to disable a setup, we will go into more detail on the edit menu in the [next section](/basic-usage-and-setup/editing-your-setups).

</details>


# Editing your Setups

Situations changed or you made a mistake? Well luckily its quick and easily to change everything on whatever setup you choose.

## Initial Command

{% hint style="info" %}
**Hint:** If you'd like to skip the prompt that asks whether you'd like your edits to affect the setups pair, you can specify your decision with "affect\_pair" before you send the command.
{% endhint %}

<figure><img src="https://2311948898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwTYJfIMlu3oKXK45dqN%2Fuploads%2FXU3E4KOJD3cHoEbaQ4mM%2Fedit%201.png?alt=media&amp;token=dcc65612-eb93-4e45-9646-18c86401f2bc" alt=""><figcaption></figcaption></figure>

`/settings automatic_translation edit [name]`

From the command you can quickly change a select few settings without having to go into the button menu itself, these are:

* The Name (Max 32 Characters)
* From Language (What language messages have to be in to get translated)
* To Language (The languages messages get translated into)
* Status (Whether the setup is enabled or disabled)

Everything else has to be edited in the button menu. Which can be accessed by ignoring the quick options and just sending the command.

## Button Menu

<figure><img src="https://2311948898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwTYJfIMlu3oKXK45dqN%2Fuploads%2FrfN1kU80fTL6rhfTFZiU%2Fedit%202.png?alt=media&amp;token=386bcd27-3fce-42ec-99ed-6efbb5bc12b7" alt=""><figcaption></figcaption></figure>

This menu is relatively straightforward to use, simply click the button of the corresponding item you'd like to modify and follow the instructions, although I shall break down the process for each item here.

{% hint style="warning" %}
**Important:** Try not to take too long in any of the menus, whether you are expected to type something or press a button as they will all eventually time out.
{% endhint %}

<details>

<summary>Name</summary>

Upon clicking the button you will be prompted to enter a new title, simply send a new message and if it's below 32 characters it shall be accepted and you will be kicked back to the previous menu.

</details>

<details>

<summary>Language</summary>

Upon clicking you will be greeted with 3 more buttons, "From Language", "To Language" and Back. Simply select whichever button corresponds to the language you'd like to change. After that, you will be prompted to enter the new language.

</details>

<details>

<summary>Enable/Disable</summary>

Clicking that does not bring up a menu as it instantly does what it says on the button (the button will show enable when the setup is disabled and disable when it is enabled). This is the third and final way of disabling a setup. See the other 2 methods on the [previous page](#enable-disable).

</details>

<details>

<summary>Channels</summary>

This will ask you whether or not you would like to Add or Remove channels. Upon selecting one you will need to specify the channels you would like to add or remove. Do this by typing them separating each one with a comma. Eg #general, #commands, #notices. To add or remove all channels, specify "all" in the channel dialogue. View advanced features.

</details>

<details>

<summary>Whitelist</summary>

Upon entering the menu, it will ask whether or not you'd like to add or remove from the whitelist. The same as the Channels menu. Upon selecting an option simply specify the roles, separated by commas, to add/remove. (Members can also be specified if desired).

</details>

<details>

<summary>Words</summary>

Almost identical to the last 2 options, you are first asked if you want to add or remove. After which you specify the words of your choice to be added to the blacklist separated by commas. [View this page](/basic-usage-and-setup/create-your-first-automatic-translation-setup#step-2-create-post) to find out what this blacklist does.

</details>

<details>

<summary>Diversions</summary>

Diversions will be explained more in the advanced section. But were you to add any, they'd be done through this menu which operates identically to the [Channels menu](#channels).

</details>

Press exit when you are done to remove the messages.


# Styling Results

Not happy with the default style? Shake things up a bit with these easy commands!

{% hint style="warning" %}
**Warning:** [Message commands](/basic-usage-and-setup/message-commands-really-cool) cannot be styled at this time.
{% endhint %}

<details>

<summary>View Style Options</summary>

`/settings2 style view_options`

View all the different styles available, with examples provided. You can also [view all the styles here!](https://jakebot.co.uk/translation)

</details>

<details>

<summary>Match Styles</summary>

`/settings2 style match_styles [this] [with_this] (and_this)`

Use this to quickly match two or all of the styles together! Put the style you'd like to match the other ones to in the first selection (this), then either one or both the other styles into "with\_this" and "and\_this" to set them to the same as the style in "this".&#x20;

</details>

<details>

<summary>Set Automatic Translation Style</summary>

`/settings2 style automatic_set [option]`

Set the style for all translations done automatically.

</details>

<details>

<summary>Set Command Translation Style</summary>

`/settings2 style command_set`

Set the style for all translations done via the [translation command](/basic-usage-and-setup/basic-slash-commands#translate-language-text-to-translate).

</details>

<details>

<summary>Set Reaction Translation Style</summary>

`/settings2 style reaction_set`

Set the style for all translations done via reaction.

</details>


# Global Blacklist

Are some messages being translated that you'd rather not be? This is your solution!

## Overview

Not to be confused with the other blacklist system which works per setup and is designed to block messages from being translated if they contain a word in the system. This is designed to prevent words or phrases from being translated only if they show up alone.

So for example if you put the phrase "this is a test" into the system. The message "This is a test to show x and y" would still get translated, but the message "This is a test" would not.

## Commands

<details>

<summary>List Everything in the Blacklist</summary>

`/settings global_blacklist list`

This shows you all the words and phrases previously appended to the blacklist

</details>

<details>

<summary>Add a word to the Blacklist</summary>

`/settings global_blacklist add [word]`

This can be used to add a new word or phrase to the blacklist

</details>

<details>

<summary>Remove a word from the Blacklist</summary>

`/settings global_blacklist remove [word]`

This can be used to remove a word from the blacklist, a list of everything currently in the blacklist will be shown.

</details>


# Extra Options

Cool extras features that you may not realise you needed!

## Extra Features

There are currently 6 extra features that you can enable, with the only one requiring premium being the reaction translation feature.

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>React to Translate</strong></td><td>Allows the translation of a message by reacting to it with a countries flag.</td></tr><tr><td><strong>CMD Activation Message</strong></td><td>Will attempt to prevent command activation messages from being translated. Eg, Starting with <code>?</code>, <code>!</code>, <code>&#x26;</code>.</td></tr><tr><td><strong>Other Bot Translation</strong></td><td>Will translate messages send by other discord bots. (Not Embed)</td></tr><tr><td><strong>Single Word Translation</strong></td><td>Will prevent the translation of messages that contain only 1 word.</td></tr><tr><td><strong>Three Word Translation</strong></td><td>Will prevent the translation of messages that contain 3 words or less.</td></tr><tr><td><strong>Divert All Messages</strong></td><td>Will divert all messages to other channels, whether something was translated or not.</td></tr></tbody></table>

## Commands

<details>

<summary>View Extra Options</summary>

`/settings2 extras view_options`

This shows you all the extra options available with descriptions similar to those above, and whether or not they are enabled or disabled.

</details>

<details>

<summary>Enable an Option</summary>

`/settings2 extras enable [feature]`

Allows you to enable an extra option from the provided list.

</details>

<details>

<summary>View Extra Options</summary>

`/settings2 extras disable [feature]`

Allows you to disable an extra option from the provided list.

</details>


# Diverting Results and "All Except" System

Want to translate in all channel except a couple, or you want translations in one channel to be sent to another? This is how!

## Diverting Results

{% hint style="warning" %}
**Important:** You cannot create more than 6 diversions.
{% endhint %}

Diverting results are set up through the edit menu, or the new setup command, [as shown previously](/basic-usage-and-setup/editing-your-setups#diversions). Diversions work by taking the results from one setup in a channel and sending them to a different channel. If you have several languages going into one channel they will be combined into one message. [Any styles applied](/slightly-more-advanced-settings/styling-results#set-automatic-translation-style) for automatic translation will also apply to diversions.

Currently, if you wanted to divert results somewhere and also send them into the original channel, you would have to create two setups.

## All Channels Except

If you wanted to translate in all channels except a certain few, then that is also possible!

When[ creating a translation](/basic-usage-and-setup/basic-slash-commands) if you set "affects\_all" to true, the remaining 10 channel fields serve a different use. Any channels entered into those fields will be the "exception" to the translate in all channels rule. So if you set "affects\_all" to true but entered "#general" into "channel1", messages would get translated in every channel EXCEPT #general.

[In the edit menu](/basic-usage-and-setup/editing-your-setups#channels), it works a bit differently as it's message-based inputs. You can specify "all" to make a translation affect all channels, and then you specify any channels you'd like to be an exception after that, separating with commas. Eg, "all, #general" would result in messages getting translated in every channel except general again.


# Command Permissions

Want to change the permissions required to change Auto Translation settings? This is how!

## Overview

With the change to slash commands, all permissions are now handled within Discord. You can view their official article [here](https://support.discord.com/hc/en-us/articles/4644915651095-Command-Permissions).

Because of the way the translation commands are organised, and Discord's current restrictions. You are not able to set different permissions for each sub-command, eg. Manage Channels for Creating new setups, but Read Channel to view a setup.

## Examples

The settings commands are in 2 groups under "settings" and "settings2", this is for a technical reason, so when changing permissions make sure you change both if that is what you want. "settings2" has style and extra options under it.

<figure><img src="https://2311948898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwTYJfIMlu3oKXK45dqN%2Fuploads%2Fzx7M5k43r8aw03M45tNy%2Fpermission%201.png?alt=media&amp;token=16e6e7ea-348f-4931-8fb8-cf074b140e36" alt=""><figcaption></figcaption></figure>

All the standalone commands, such as /translate and /translation-usage, can have their permissions set separately.

<figure><img src="https://2311948898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwTYJfIMlu3oKXK45dqN%2Fuploads%2FYYU1f51HVHt88VzrLRNl%2Fimage.png?alt=media&amp;token=566f6508-9263-4fdd-9ab1-1ed328ee2485" alt=""><figcaption></figcaption></figure>


# Bonus Characters, from Purchase or Upvoting

Need more translation characters? Or have you bought some and are not sure how to use them?

## The Dashboard

`/reward dashboard`

This is where you can view all your upvote tokens and the current number of bonus characters in your account. As well as a reminder of the commands you need to use with the system. I will go over the two ways of getting bonus characters below

## Via Upvoting

You can get up to 800 characters per upvote, depending on the website you upvote on. Top.gg or Discord Bot List. Each time you upvote you gain 1 upvote token, you can redeem these using `/reward redeem_upvotes`, each time you redeem a token you will get a random amount of characters between 300 and 800.

## Via Purchase

You are able to buy bonus characters via the store within Discord. Accessible via the bot's profile (doesn't always show on mobile).

All you have to do is buy the relevant package. The characters will be added to your account automatically, you can view them with the aforementioned dashboard command. Once added please allocate them, as shown below.

{% hint style="warning" %}
Any issues with the characters you've bought please [join the support server](https://discord.com/invite/8JZwx82) as soon as possible!
{% endhint %}

## Allocation

`/reward allocate [amount] [server]`

Once you've got all your bonus characters you just need to allocate them with the command above, if you don't specify any options it will automatically allocate all characters to the server you are typing the command in. Please be aware that once characters are allocated in most cases we are unable to remove them from the server and give them back to you. So be careful!


# What's the Benefit of Premium?

Is premium right for you? If so, what tier?

## Overview

The main benefit of premium is an increased monthly character limit, by default, you get 6000 characters per month. This can be increased all the way up to 5000000 if that is so required!

You get a few other benefits such as access to Google Translate, Deepl Translation, React to Translate, and increased Wordcloud limits.

## What Tier? There are so many!

At first glance, it may look like there are 24 separate tiers, and whilst there technically are. In practise it's 8 tiers, with each tier having 1, 3, and 6 server options.

Which tier you need depends entirely on how many characters you need per month. If you run the `/translation-usage` command, this will show you a monthly prediction at the bottom, although be aware it isn't always super accurate, especially not early in the month.

The best thing to do is start with what you think will be enough, as you can always upgrade later on and you only have to pay the difference.

{% embed url="<https://www.patreon.com/jakebotdiscord>" %}
Buy a tier here!
{% endembed %}


# Setting up Premium in my Server

So you've got your brand new tier, now how to start using it?

## It starts with a command

First run `/patreon dashboard`. This will either pop up with an embed showing you lots of information (if it does you can move on to the next step), or most likely a message will appear asking you to allow Jake to view some account details with a custom link. This is needed so Jake can check what tier you have. Simply click on that link and follow the instructions within 5 minutes and you should be greeted with a screen on JakeBot's website, if it isn't a success screen it should tell you what the issue is. If it is, you are ready to move on!

<figure><img src="https://2311948898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfwTYJfIMlu3oKXK45dqN%2Fuploads%2FmysfZfbNPo3M16Q5aMEH%2FPremium%20Dashboard.png?alt=media&amp;token=9d37a52f-8068-4808-9c15-224a4b80bdea" alt=""><figcaption></figcaption></figure>

## Telling Jake what server(s) to upgrade

Now you've got that embed, you can see it shows you what tier you have and various information regarding that. It will also show you how many server upgrades you have remaining, and the servers you have already upgraded, which is probably none.

All you have to do is run `/patreon upgrade [server]`. To upgrade the server of your choice, whilst you can specify the server using its ID or name, I'd recommend you simply run the command in the server you'd like to upgrade as it will upgrade that server. You can then repeat this for as many servers in the tier.

## Help!

There are sometimes issues with these systems as they rely on a lot of different "moving" parts. So if you can't get your upgrade working correctly, please [join the support server](https://discord.com/invite/8JZwx82) as soon as possible and we can help you.

Unless you're requesting a refund I ask you **not to send messages on Patreon** as they rarely get checked, and are quite inconvenient.


# Translator Engine Overview

What exactly is the difference between Google, Microsoft and DeepL?

## Google

The most famous translation engine, it has the most available languages and most people consider it to be more accurate than Microsoft, although there is more nuance to this, as in my experience Microsoft often ends up being more accurate (Russian for example)

Google Translate is the fastest translator available.

## Microsoft

Quite a bit less well-known, and has a reputation for not being great. As mentioned prior, I think Microsoft is often more accurate than Google, although for certain languages I imagine Google is more accurate, if you have access to both it's probably worth trying each one out for a few days and seeing which works better for your language needs.

Microsoft Translate is also slower than Google.

## DeepL

The newest addition to the block. DeepL has a very limited selection of languages, basically just the main ones, however, its translation quality is far higher than either of the other available services. If you have access to it, and the languages you are translating to and from are part of its repertoire. I'd recommend using it.

It is however even slower than Microsoft Translate.

## Conclusion

If you need accuracy, go for DeepL.\
If you need speed, and lots of languages go for Google.\
If you need a mix of both, go for Microsoft.


# Other Premium Commands

There's only a couple, but they can be important!

<details>

<summary>/patreon downgrade [server]</summary>

This can be used to downgrade a server you no longer want to have your premium tier. You can specify the server (ID Recommend, listed in the dashboard) but running it in an upgraded server will downgrade that server.

</details>

<details>

<summary>/patreon reassign</summary>

This will send a new unique link to allow you to change the Patreon profile that's attached to your JakeBot profile, for example, if you don't use your old Patreon account anymore.

</details>


