Mekolaos / Aternos-On-Discord

A Discord Bot to manage a minecraft server on Aternos.
GNU General Public License v3.0
100 stars 92 forks source link

Aternos On Discord

Build Status

A simple tool to serve your own discord bot, so you can manage an Aternos server from discord.

Getting Started

Windows/Mac/Linux (x64)

  1. Git clone this repository
  2. Install it using either:
    • Copy, paste and execute this command inside the project folder: pip install -r requirements.txt
    • Alternatively you can create a virtual environment using python -m venv venv and then source venv/bin/activate to finally pip install -r requirements.txt
  3. Setup a Bot Account
    • You'll need the Bot Token for setting up the Bot
  4. Execute using this command inside the project folder : python3 Bot.py

Note: When running Bot.py for the first time, you'll be prompted to enter your Aternos account and bot token. You'll need to run python3 Bot.py again after you finish setting your information.

Raspberry Pi (ARM)

Before following the instructions, make sure you have the following installed:

  1. Git clone this repository
  2. Install it using pip3 install -r requirements.txt inside the folder
    • NOTE: This may take a while even on higher end Pi's
  3. Setup a Bot Account
    • You'll need the Bot Token for setting up the Bot
  4. If you don't have a GUI:
    • Create a .env file in the following format:
      BOT_TOKEN= DISCORD_BOT_TOKEN
      USERNAME_C= ATERNOS_USERNAME
      PASSWORD_C= ATERNOS_PASSWORD
  5. Setup Chromium
    1. sudo apt-get install chromium-browser
    2. sudo apt-get install chromium-chromedriver
    3. In connect_and_launch.py, change driver executable path to '/usr/lib/chromium-browser/chromedriver'
  6. Run the bot with python3 Bot.py

Prerequisites

Discord Commands

Cloud Hosting Note

Cloud hosting this bot would require some workarounds as Aternos recognizes you are connecting from a data center and prompts for a captcha test.