Skip to content

SimpleWebhooks 1.0

Latest
Compare
Choose a tag to compare
@Kade-N Kade-N released this 10 Oct 05:23

Initial release. All core functionality is working. Please see the config.yml file for instructions.

Tested with Minecraft 1.12.2 and 1.14.4, using Spigot. Should also work on a wide variety of other Minecraft versions, on any Bukkit-compatible server (CraftBukkit, Spigot, Paper).

There are some extra features included as well, however they are not complete, and therefore may have bugs.

Discord Chat Sync

One of the main purposes of this plugin is for syncing game chat into a Discord server. I have added an extra feature to send messages from Discord, to the game chat. This lets you have two-way conversations between the game and Discord. However, it is unfinished, and therefore it is a bit complicated to set up.

This uses a Bot in Discord to “read” the messages (in all channels that the bot can access), and sends them to the plugin, so they appear on the server.

If you are interested, here are the instructions:

  1. Go to https://discordapp.com/developers/applications/ and sign-in with your Discord account
  2. Click “Create an application”
  3. Set the Name, to whatever you want your bot to be called
  4. Go to the Bot tab, and click Add Bot
  5. Under Token, click Copy
  6. Open your server plugins folder, open the SimpleWebhooks folder, and open the config.yml file
  7. Add the end of the file, add a line that simply says “discord: “ (make sure there are no spaces in front)
  8. Paste your bot token after this (so it should be something like “discord: jfajgfjhugsdgdsfgh”), save and close the file
  9. Go back to the Discord applications website, and go to the General Information tab for your bot application
  10. Copy the Client ID
  11. Open this link: https://discordapp.com/oauth2/authorize?scope=bot&client_id= but paste the Client ID at the end (so you get a link like https://discordapp.com/oauth2/authorize?scope=bot&client_id=425846674686385047)
  12. Follow the instructions to add the bot to your server
  13. Restart your Minecraft server, and the chat should now be syncing. Be warned, it places a large amount of extra text in the console/logs. You can ignore this.

Translator

To better serve multilingual servers, I have also added an automatic, real-time translation feature to the plugin. This uses an online service, Yandex Translator, to translate chat messages.

EDIT: Translator no longer works as the Yandex service has been discontinued.

An API key is required to use the translator. A key can be obtained for free from Yandex. Place the key at the bottom of config.yml (make sure there are no spaces in front), in the form "translator: YOUR_API_KEY". You must restart your server after adding the key.

Once the translator is set up, all chat messages will be sent to the online service for translation. Non-English messages will automatically be translated into English.

Non-English members of your server can use the command "/translate -set LANGUAGE_CODE" to set their own language. This will cause all messages to be automatically translated into their language. Click here for the list of language codes - use the two-letter code in the command. For example, a French player should type "/translate -set fr" to have all messages translated into French. The automatic translation feature will be turned off when the player leaves the server.