Installation

A complete guide on how to install Minebot for both beginners and experienced users.

Video Guide

Follow along with our step-by-step video tutorial to quickly install and run Minebot:

1. Download Bot

2. Install MinebotConnector

🔌

Connect Your Bot to Minecraft

To integrate Minebot with your Minecraft server, follow these steps:

1

Move the MinebotConnector jar

Copy the MinebotConnector-X.jar file into your Minecraft server's plugins folder.

2

Restart Your Minecraft Server

Restart your Minecraft server to load the MinebotConnector plugin.

3

Configure WebSocket Port

Open the file plugins/MinebotConnector/settings.yml on your Minecraft server and set the websocket.port to match the port specified in your Minebot's configuration/settings.yml under server.uri.

Make sure to edit the server.uri parameter to match the IP address of your Minecraft server.

Warning

Ensure the WebSocket port you configured is allowed through your firewall. If you're unsure or using a hosting provider, contact your hosting support to confirm which ports are available for use.

3. Setup A Discord Application

Create a new bot on Discord's developer portal using the instructions below.

Danger

Before proceeding, enable Discord Developer Mode by navigating to Settings -> Advanced -> Developer Mode.

Anyone with access to this token has full access to your bot's account, you should ensure that nobody has access to this token but you. Treat it like a username/password combination, but for bots.

1

Create A New Application

Head over to Discord's Developer Portal and create a new application.

2

Copy Application Id

In the General Information tab, copy the application ID for the next step.

3

Invite Bot To Server

Visit this website, ensure "Administrator" and "Use Application Commands" are checked and paste your Client ID from step 2 into "Client ID". Do not change any other options. Then click the "Link".

Invite the bot to your server and in the final screen, check all boxes to grant all of the permissions we've selected previously.

4

Adjust Role & Permissions

Drag the "bot" role to the top (it can be below other administrator roles) and ensure it's got the Administrator permission.

5

Navigate To The Bot Tab

Access the bot settings in this tab.

6

Create A New Token

Generate a new token for your bot and keep it private.

7

Paste Your Token

Write your token to your configuration/settings.yml file.

8

Give Bot Privileged Intents

Adjust 3 Privileged Gateway Intents as per the image above.

9

Copy Guild Id

Copy the Discord server id (guild id) that you plan to use with Minebot.

10

Paste Guild Id

Paste the Discord server guild ID that you copied in the same config file where you set the bot token in step 8.

4. Run The Bot

Congratulations, you've successfully completed the installation steps! To start your bot, please follow the instructions in the Running Guide.