# Discord Bot Setup

1. Installing certificates
   1. Go to finder -> applications -> python 3.x
   2. Double click on "Install Certificates.command" and let it run
   3. Close terminal afterwards

2. Creating a discord bot

   1. Go to [Discord Applications](https://discord.com/developers/applications)
   2. Click on “New Application” (top right)

   <figure><img src="https://3050604334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGiG0hj8wajfaGRRlWcvt%2Fuploads%2FNJZ7YI00w1Ts76RiWdQ2%2Fimage.png?alt=media&#x26;token=d17fdc92-c734-48aa-8573-075664b71f15" alt=""><figcaption></figcaption></figure>

3. Put in a name, tick the checkbox and create

<figure><img src="https://3050604334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGiG0hj8wajfaGRRlWcvt%2Fuploads%2FlxeYdDIGzRbRz0lND0QL%2Fimage.png?alt=media&#x26;token=4c8089a5-09fe-4920-af1c-0eb4a5c2bea0" alt=""><figcaption></figcaption></figure>

4. Copy the application id (it is required later)

<figure><img src="https://3050604334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGiG0hj8wajfaGRRlWcvt%2Fuploads%2F5hhIkpLMtpwopLbcbrP7%2Fimage.png?alt=media&#x26;token=d2aeefd6-ab00-4094-b85d-775d0f1a8a39" alt=""><figcaption></figcaption></figure>

5. In the “settings” sidebar, click on bot

<figure><img src="https://3050604334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGiG0hj8wajfaGRRlWcvt%2Fuploads%2FFJLbi02YnPJu7hRyYIxZ%2Fimage.png?alt=media&#x26;token=53739712-7c4e-4e28-8cb7-d33fadc364d7" alt=""><figcaption></figcaption></figure>

6. Scroll down to “Privileged Gateway Intents”, check all of them, and save changes

<figure><img src="https://3050604334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGiG0hj8wajfaGRRlWcvt%2Fuploads%2Fz1NXLnbMRJVdqJpFNDWE%2Fimage.png?alt=media&#x26;token=bb9ae07d-6989-4d7b-8c88-754cc2a6a5fd" alt=""><figcaption></figcaption></figure>

7. Edit and copy in the following link into a web browser:

<https://discord.com/oauth2/authorize?client\\_id=\\><application id>\&permissions=68608\&scope=bot\
For example, if my application id from step 4 is 1238906, then my link would be:\
<https://discord.com/oauth2/authorize?client_id=1238906&permissions=68608&scope=bot>

7. Add your bot to the server and ensure that it has permissions to view the channels you want to use it in
8. Returning back to the application page, reset the bot's token and copy it

<figure><img src="https://3050604334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGiG0hj8wajfaGRRlWcvt%2Fuploads%2F8rlCm6rTQ4XuoquyzVet%2Fimage.png?alt=media&#x26;token=f05b8087-fba9-4bf6-8fa9-0f291a1a587a" alt=""><figcaption></figcaption></figure>

10. Launch the macro and copy the token into the 'Discord Bot Token' setting (config -> discord -> Discord Bot)

<figure><img src="https://3050604334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGiG0hj8wajfaGRRlWcvt%2Fuploads%2FEyoaLGGwzMrVgk08Yqbc%2FScreenshot%202025-07-20%20at%2012.16.56%E2%80%AFPM.png?alt=media&#x26;token=f56f5076-5751-451d-a3d0-52f2cb8c05bd" alt=""><figcaption></figcaption></figure>

Discord Bot Commands&#x20;

{% hint style="warning" %}
Note: It may take up to 30mins for the commands to show up (this will only happen once)
{% endhint %}

```
/start -> starts the macro
/stop -> stops the macro
/ping -> returns a message from the bot. Used to check if the bot is online
/screenshot -> sends a screenshot of your screen
/amulet <keep/replace> -> choose to keep/replace an amulet. Only for stump snail
/battery -> displays your mac's battery status
/rejoin -> rejoins the game
```
