Setup project locally

Overview

This tutorial shows how to download, setup and start the TJ-Bot project locally on your machine.

Prerequisites

• latest version of Java installed
• your favorite Java IDE or text editor, e.g. IntelliJ or Eclipse
• git installed (or any GUI or IDE plugin)
• gradle installed (or any GUI or IDE plugin)
• your own Discord-Bot, tied to a server (see Create Discord server and bot)
  • a token of that bot

What you will learn

• use git to download the project
• use gradle to download dependencies
• use gradle to build the project
• connect your bot to the program
• use gradle to start the bot
• interact with the bot from your server

Tutorial

Clone repository

First of all, you have to download the project to your machine. Visit the projects GitHub website and copy the .git link, which is this

https://github.com/Together-Java/TJ-Bot.git

IntelliJ git plugin

IntelliJ comes by default with a git plugin. You can easily clone repositories to your disk by clicking a few buttons.

1. open your IntelliJ and select Get from VSC.
2. select Git, enter the .git link and select a directory for the project; smack that Clone button
3. IntelliJ will now open the project

Manual usage of git

To download the project, use the following command:

git clone https://github.com/Together-Java/TJ-Bot.git TJ-Bot

You now have the project and all its data locally.

Gradle

Next up, you have to download all the dependencies, generate the database and build the project.

IntelliJ Gradle plugin

IntelliJ comes by default with a gradle plugin. If not started already automatically, you can command it to do all of above by clicking a bunch of buttons.

1. open the Gradle view
2. expand the view and click on TJ-Bot > Tasks > build > build, or just click on the elephant icon and enter gradle build

Manual usage of gradle

You can also just execute Gradle from the command line.

1. open a command line in the root directory of the project
2. execute gradle build

Start the bot

Last but not least, you want to start the bot with your bot token and let it connect to your private bot with which you can interact from one of your servers.

For this step, you need to hold your bot token ready, you can find it at the Discord Developer Portal.

See the following guide if you still have to create a server and a bot first:

• Create Discord server and bot

IntelliJ

1. in the Gradle view, right click the run task and hit Modify run configuration...
2. in the Run section, enter the command run --args='<your_token_here> db/database.db'
   2.1. replace <your_token_here> with your bot token
   2.2. the second argument is the path to where you want to create the database at, db/database.db is fine
3. select the run configuration you just created and click on the run button

Command line, runnable jar

1. build a runnable jar of the project by executing gradle shadowJar
   1.1. the jar can now be found at TJ-Bot\application\build\libs
2. run java -jar TJ-Bot.jar "<your_token_here>" "../../../build/database.db"
   2.1. replace <your_token_here> with your bot token
   2.2. the second argument is the path to where the database was generated at; by default this is at TJ-Bot\build\database.db, so you need ../../../build/database.db

Have fun

The bot is now running and connected to your server, hurray 🎉

You can now execute commands and see the bot do its magic: