EnguerranVidal / ShulkerPi

This repository contains a small Discord bot called ShulkerPi. It allows the management of a Minecraft Server based on a Raspberry Pi computer.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

ShulkerPi

License: MIT GitHub watchers GitHub stars GitHub commits GitHub branches wakatime made-with-python

ABOUT THE PROJECT


This repository contains a Discord Bot whose goal is to manage a Minecraft server hosted from a Raspberry Pi computer in your living room. This bot can start, stop and reset the server using Bash scripts as well as provide useful information to its users by displaying the world seed, the server ip or even playing statistics.

Distributed under the MIT License. See LICENSE for more information.

GETTING STARTED


CREATING A BOT

  1. You first need to create a Discord application and Bot with administrator permissions. You should follow the Discord documentation and then invite it to your Discord server through the OAuth2 panel on the developer portal.
  2. You must copy the app token on a clipboard

INSTALLATION

This process must be done on the Raspberry Pi containing the Minecraft server. You can do these commands from your home directory.

  1. Cloning the Github Repository
git clone https://github.com/EnguerranVidal/ShulkerPi.git
  1. Going in the Repository Directory
cd ShulkerPi
  1. Creating Conda Environment
conda create --name discordbot python=3.10
conda activate discordbot
  1. Installing ShulkerPi Requirements
pip install -r requirements.txt

RUNNING AT BOOT - CRONTAB

If you want your bot to run at boot from your Raspberry Pi, you must set the botStart.sh.

  1. Firstly, open the crontab file :
sudo crontab -e
  1. You can now add the following line at the end of the file with SHULKER_REPO being the directory of the ShulkerPi bot :
@reboot sudo /bin/bash SHULKER_REPO/scripts/botStart.sh

About

This repository contains a small Discord bot called ShulkerPi. It allows the management of a Minecraft Server based on a Raspberry Pi computer.

License:MIT License


Languages

Language:Python 89.9%Language:Shell 10.1%