Translation
Communicate in your multilingual server with ease!
Last updated
Communicate in your multilingual server with ease!
Last updated
This module is only available to users with a Premium Subscription.
The Translation module allows you to translate texts via a Custom Command, quick-translations by reacting with a specified emoji, daily translation limits, and more!
The Translation module requires you to add your own DeepL API key in order to handle translations, allowing you to select the account tier and the daily translations limit.
To create an API key, follow the steps below.
Create an account or log in the official DeepL website.
Select the tier you wish to use for your translations, whether it is the Free Tier or Paid Tiers. If you wish to have the free tier, please select 'Sign up for free'.
Fulfill the following details. This is used to avoid potential misuses of their free API. DeepL will not charge you unless you manually upgrade your current subscription to a paid one.
Once you have successfully fulfilled all the details, accept DeepL's Terms & Conditions and press 'Sign up for free'.
A similar page will appear upon signing up for free, click on 'Account management' to go to your account settings. If this page does not appear, please go to your account settings.
Get the Authentication Key for DeepL in your account summary settings located in the bottom right corner.
Once copied, paste it in the 'DeepL API Key' field in BotGhost.
This section is where you input the API Key found from Credentials and also change other account settings.
Paste your DeepL API Key here. Learn how to get one in the Credentialssection. Make sure to not share it with anyone!
Set the account tier you selected when getting your API key. Remember to select the correct one as DeepL handles different API domains for free and paid tiers.
Define the maximum amount of translations that can be executed per day. Setting this to 0 will disable this limit.
The following parameters allow you to react with a specific emoji to automatically translate the content of the message, select the channels for quick translations, the required roles, the target language, and toggle if you wish to delete the original message upon successful translation.
Select up to 10 different emojis to trigger the quick-translations.
Choose the channels you wish to allow for quick-translation. If none is chosen, this feature will be available across all channels.
Select the roles that will require users with these roles to be the ones to use the quick translation.
Define which language should the messages be translated to when triggering the quick-translations.
Enable or disable to delete the original message after a successful quick-translation.
Define the allowed roles and the default DeepL language when using the /translate custom command.
Select the roles that users must have to run the /translation custom command.
Choose the language to translate messages to when using the custom command.
Customize the reply in the /translate custom command. You can use {original_message} and {translated_message} to return the content of the original message and the translated content, respectively. All variables can be used. You can also toggle the embed to a plain text response using the switch in the top right.
Define the maximum amount of characters the command should allow to translate.
Find the command for the Translation module and modify them. This will allow you to fine-tune the command's logic to your liking.
Explore the events within the Translation module and customize them to your preferences. This allows you to change the events' logic according to your liking and needs.
It's advised that you do not edit the commands and events unless you have a good understanding of BotGhost and its Command Builder. If you encounter any issues, you might want to reset the module for it to work again as intended.
Additionally, a copy of the edited commands / events will be created if you update the module.
