/terabotest

Primary LanguageJavaScriptISC LicenseISC

tera-discord-relay

Chat relay between a Discord channel and TERA /guild chat.

Warning: This app is due for a major revamp. Expect minimal support until that's done.

Setup

You'll need:

Discord

Bot Account

  1. Create a new Discord app.
  2. After app creation, click "Create a Bot User" on the application's setting screen. Make note of the bot ID and the token.
  3. Invite the bot to your server by going to this link: https://discordapp.com/api/oauth2/authorize?client_id={{BOT_ID}}&scope=bot&permissions=0 (but replace {{BOT_ID}} with your bot's ID).

User Account

Note: This really isn't recommended. Also, I'm going to assume you're already on the Discord you want to run the bot on.

  1. Log into Discord with the user account.
  2. Hit Ctrl+Shift+I.
  3. Open the "Application" tab. You may need to click on the "»" to find it if the window is too small.
  4. Open "Local Storage" and click on "https://discordapp.com". (This will be different for PTB and Canary.)
  5. Look for "token" on the left side. Your token is the value on the right side.

TERA

  • Join the desired guild on the desired character to use as the bot relay.
  • Turn off account armor.

Installation

Open up a terminal window and go to a place where you want to put the bot files. Then run:

git clone https://github.com/meishuu/tera-discord-relay.git
cd tera-discord-relay
npm install

Configuration

You'll need to make two JSON configuration files: one for Discord and one for TERA. You can see an example for each in the config/config-sample.json of their respective directories. It is strongly recommended that you make a new file instead of changing the sample file.

Discord

  • socket-name can be anything as long as it matches what you put in the TERA config.
  • token is the token you got from the setup section above.
  • server-id can be obtained by right-clicking on the Discord server and clicking on "Copy ID". If you don't see it, open Discord settings, head down to "Appearance", and tick on "Developer Mode".
  • channels:
    • gchat channel ID can be obtained by right-clicking on the desired channel and clicking on "Copy ID".

TERA

  • host and port will come from your region's server list. You can get links to the server lists on the tera-proxy-sls README.

Also, TERA has a few version numbers you might need to change for big patches. Open up tera/index.js and look for these:

  • patchVersion is usually the major and minor patch number put together. For instance, if you launch TERA, go to server select, and see "56.03.02 EN2" at the bottom, try setting patchVersion to 5603. If that doesn't work, try 9901.
  • setProtocolVersion is not so easy to check, but if you run tera-proxy it'll display the protocol version when you connect to it.

Running

You'll need to start up two terminals.

One for Discord:

cd path/to/tera-discord-relay/discord
node . config/your-config-file.json

And one for TERA:

cd path/to/tera-discord-relay/tera
node . config/your-config-file.json

It's recommended to run these on an infinite loop because failure conditions terminate the program. However, do note that the auth server will start rejecting logins if too many are performed in a short span of time.

Updating

To pull general updates for the Discord relay app:

cd path/to/tera-discord-relay
git pull
npm install

Every major version patch, TERA has some versioning info that needs changing. See the section above on TERA configuration for more info. To update tera-data, simply run:

npm install meishuu/tera-data