Translation bot built using discord.js and Google Translate API.

1. Features
2. Usage
3. New Bot (RECOMMENDED)
4. Existing Bot Migration (EXPERIMENTAL)
5. Heroku Database Support
6. Troubleshooting
7. Commands
8. Credits & License
9. Design Team

• Translate custom messages
• Translate messages by reacting with flag emoji
• Translate last message(s) in channel
• Translate to multiple languages at once
• Automatic translation of channels with option to forward translations to users or seperate channels.
• Supports 100+ languages

• Cerate your own with the instructions below.
• Write !translate help or !t help for a list of commands.

If you are looking to set up a New Bot then follow the instruction below, If you already have a Heroku Bot Using C-3P0 then Scroll down for instruction on how to migrate your translation settings.

To deploy a free translation bot that you can add to your discord server, follow these easy steps.

• If you don't yet have a github account, create one! It's free and easy.
• Use the button in the upper righthand side of this page to fork the repo so that it will be associated with your github account.

• Give app a friendly name and click the Create App button
  • I like the name C-3PO, but feel free to pick something different if you fear George Lucas's wrath. Maybe C-4PO
• Take note of the app CLIENT ID, you will need it later
• Scroll down to the Bot section
• Click the Create a Bot User button
• Click the Yes, do it! button
• Copy the bot's TOKEN, you will need it later

• Create a new app. It's name must be unique and composed of all lowercase letters and dashes. Something like yourname-discordbot is fine
• Under Deployment Method select Github. Connect to your Github account and search for this repo by name.
• Scroll down to the manual deploy section, and select the 1.1.5 branch. Click deploy branch, and wait for the successfully deployed message.
• Go to the Resources tab and look for the addons section. Search 'Postgres', and add a 'Hobby Dev - Free' version of Heroku Postgres. This will be automatically attached as your bot's database.
• Go to the Settings tab. Click to reveal Config Variables, then add a new one. The key will be DISCORD_TOKEN, and the value will be your discord bot's token that you copied earlier.
• Go to the Overview tab and click configure dynos. Turn off the default web npm start dyno and turn on the worker node src/bot.js dyno. Your bot will now be up and running!

• Replace the CLIENTID string in the following url with your own apps client id: https://discordapp.com/oauth2/authorize?&client_id=CLIENTID&scope=bot&permissions=8
• Visit the resulting url and add your bot to any server where you have admin privileges.
• Once added, your bot should show up more or less instantaneously. Type !t help within the discord chat for more details on how to use it. Happy translating!

If you already have a Heroku Bot Using C-3P0

• Make sure you have completed the following steps before attempting to migrate translation settings.

1. You have an already up and running C-3P0 Bot.
2. You are using Heroku to run the old version.
3. Make sure you do not disable, reset or delete your database (preferably Postgres from Heroku)

• Go to Heroku and click your app of C-3PO, once you have direct yourself to the deploy section. Once at the deploy section fork this project ( https://github.com/ZyC0R3/Rita ) and name it whatever you like.
• Go back to the deploy section in Heroku and scroll down until you see the current fork your C-3PO bot is running off of, next to it there should be a button saying "Disconnect" click that and then click search on repositories.
• Click your fork of this project and wait for it to load. Once that is completed you need to deploy the '1.1.5' version of the bot.
• Wait for it to finish deploying and you should be good to go. Turn on your worker dyno (if it was not already) and make sure your DISCORD_TOKEN is connected in the variables section in Settings. All data from your previous C-3PO bot should be saved in the database of Postgres as long as you do not delete it and will connect to all the previous channel translation connections. Happy Translating!

Sometimes you need to edit the Database manually, This is not something you should be playing around with unless you really know what you are doing.

1. Know that you are doing, if you don't then don't touch the DB. Simple.
2. Download and Install Postgres Admin 4, This guide will be for Windows, but it shouldn't be much different for any other OS.
3. Locate your credentials for you Heroku Database, Log in to Heroku > Select your App > Click Resources > Click Heroku Postgres > Click Settings > Click View Credentials (Note: Heroku rotates credentials periodically and updates applications where this database is attached.)

For a fresh install of pgAdmin, the dashboard likely contains only one server. This is your local server, Ignore this.

1. Right click server(s) > create > server …
2. Fill out the following:

• Name: This is solely for you. Name it whatever you want, I chose ‘Heroku-Run — On’

Under the connection tab:

• Hostname/Address: This is the host credential you located in Step 3. It should look like **-**-**...amazonaws.com
• Port: Keep the port at 5432, unless your credentials list otherwise
• Maintenance databaseL This is the database field located in Step 3.
• Username: This is the user field in the credentials
• Password: The password field located in Step 3. I highly advise checking save password so that you don’t have to copypasta this every time you want to connect.
• In the SSL Tab, mark SSL mode as require

At this point, if we were to hit ‘save’ (please don’t), something very strange would happen. You’d see hundreds if not thousands of databases appear in pgAdmin. This has to do with how Heroku configures their servers. You’ll still only have access to your specific database, not those of others. In order to avoid parsing so many databases, we have to white list only those databases we care about.

3. Go to the Advanced tab and under db restriction copy the database name (it’s the same value as the Maintenance Database field filled earlier).
4. Click Save/Connect and you are done. Edit away.

• You can set up debugging Webhooks using the following steps
  1. Create a new channel on your server to receive the Webhooks, let's say #Webhooks.
  2. Go to Server Settings -> Webhooks -> Create Webhook. Select the #Webhooks channel, then copy the Webhook's URL. It will look something like https://discordapp.com/api/webhooks/012345678901234567/VCj9yOOtJF9VCm-BU2F9xrbnoWD5gBZZ-UU1mZHcxi5VLgr3bPb9NanRJM8YD9cpBisL
  3. In the Settings tab of your Heroku app add the following Config Variables (values extracted from your URL):
     • DISCORD_DEBUG_WEBHOOK_ID : 012345678901234567
     • DISCORD_DEBUG_WEBHOOK_TOKEN : VCj9yOOtJF9VCm-BU2F9xrbnoWD5gBZZ-UU1mZHcxi5VLgr3bPb9NanRJM8YD9cpBisL
  4. Restart your app's worker node src/bot.js dyno, and you will begin to receive debugging messages in your #Webhooks channel.
• If your bot in unresponsive, the first thing to check is Heroku. Log in and manually restart the worker node src/bot.js dyno.
• For further troubleshooting, it's helpful to install the Heroku command line interface. Once installed you can login from a terminal with heroku login and check your apps logs with heroku logs --tail -a <your-app-name>
• If you are unable to solve a problem yourself, report it with as much detail as possible in this repo's issue tracker.

• Translate Custom Text
• Translate by Reaction
• Translate Last Message
• Translate Channel
• Settings
• Misc. Commands

This project was originally released by Aziz under the MIT license. He chose to take the project private/commercial at version 0.4.2 Beta. Bobby Johnson forked the project and renamed it Louie after his dog. AlooAkbar forked Louie and added the necessary modifications for simple and free deployment of the bot using Heroku. ZyC0R3 Picked up the fork and as part of a team fixed over 200 errors and brought it in to the modern age, All would like to thank Aziz for his hard work and making these early versions OSS so that others may learn and build on his hard work to share with the community.

• Zycore / ZyC0R3
• Artanis / ArtanisTheOne
• Balthazar / Jshep89
• Z3US / cyberlooper
• Maddious / MadIndex
• defqon.1 / wdaniel1985

Released under MIT license.