minebot/README.md

Minebot

Discord bot for controlling a Heavynode minecraft server.

Currently implemented commands:

• !add - adds a player to the whitelist
• !remove - removes a player from the whitelist

Developing

This bot is built on discord.py, a Python library for Discord bots. Discord.py makes heavy use of asynchronous Python (via the asyncio module). It's worth a look if you've never experimented with that side of Python.

Running

To run the bot, first install its dependencies:

pip install discord.py 'python-socketio>=4.0,<5.0'

It also expects the following environment variables:

• DISCORD_TOKEN: Discord API token
• DISCORD_SERVER_ID (Optional, may be excluded if the bot is only joined to one server)
• HEAVYNODE_TOKEN: Heavynode API token
• HEAVYNODE_COOKIE_NAME: Name of Heavynode remember_web cookie
• HEAVYNODE_COOKIE_VALUE: Value of Heavynode remember_web cookie

Any of these items may be read from a file instead of the environment, by appending _FILE to the environment variable and setting its value to the path of the file. E.g. export DISCORD_TOKEN_FILE=/path/to/token/file

You can then run the bot directly:

python bot.py