shulker

Connects Discord and Minecraft Servers by sending messages back and forth without any mods or plugins.

In Action

Installation and usage

In your Minecraft server.properties, make sure you have:

enable-rcon=true
rcon.password=<your password>
rcon.port=<1-65535>

Run the following on your server hosting (in a screen, and make sure to replace your URL and your log directory location):

tail -F /PATH_TO_MINECRAFT_INSTALL/logs/latest.log | grep --line-buffered ": <" | while read x ; do echo -ne $x | curl -X POST -d @- https://YOUR_URL/minecraft/hook ; done

Clone repository onto a server, edit config.json (see below for more info) and change any options, and then, in the repository folder:

$ npm install
$ npm start

You can also easily Deploy to Heroku or Bluemix.

Configuration

{
    "PORT": 8000, /* Port you want to run the webserver for the hook on */
    "DISCORD_TOKEN": "TOKEN_HERE", /* discord token */
    "DISCORD_CHANNEL": "general", /* channel for discord bot */
    "MINECRAFT_SERVER_RCON_IP": "example.com", /* minecraft server ip (make sure you have enabled rcon) */
    "MINECRAFT_SERVER_RCON_PORT": <1-65535>, /* minecraft server rcon port */
    "MINECRAFT_SERVER_RCON_PASSWORD": "<your password>", /* minecraft server rcon password */
    "WEBHOOK": "/minecraft/hook", /* web hook, where to send the log to */
    "REGEX_MATCH_CHAT_MC": "\\[Server thread/INFO\\]: <(.*)> (.*)", /* what to match for chat (best to leave as default) */
    "REGEX_IGNORED_CHAT": "packets too frequently", /* what to ignore, you can put any regex for swear words for example and it will  be ignored */
    "DEBUG": false /* dev debugging */
}

Application token

Head over to the applications page and create a new application
Give your bot a name and hit "Create application"
Click "Create a Bot User"
After that, head over to https://discordapp.com/oauth2/authorize?&client_id=CLIENT_ID&scope=bot replacing CLIENT_ID with Client/Application ID under "App Details"
Add your bot to a server and go back to the applications page
Click "Reveal token" and copy the token to your config.json file

Tests

Run the tests with:

$ npm test

Upcoming

A "merge accounts" function to allow Minecraft players to associate their Discord accounts with their Minecraft accounts so that usernames are accurate
Ability to post messages to Discord on behalf of Discord users, rather than using a bot user (hopefully after the official API is released)

Suggestions

If you have any suggestions or feature requests, feel free to add an issue and I will take a look and possibly add it to the "Upcoming" section!

Thanks

hydrabolt for discord.js
qrush for the idea of this (wither)
SecretOnline for Rcon reconnecting and for making it only send messages in specified channel

License

ISC. See LICENSE.

Autom3 / shulker