Skip to content

ThirdEye, Two way chat between discord and minecraft along with logs for anticheats.

License

Notifications You must be signed in to change notification settings

SeaLeopard35302/ThirdEye

 
 

Repository files navigation

ThirdEye

ThirdEye is a tool that enables two-way chat between Discord and Minecraft, along with logs for anticheats. It has integration with Paradox anticheat but is also compatible with other anticheats or no anticheat at all. It supports both BDS and Realms, and the configuration is done in the config.json file. To use ThirdEye, Node.js needs to be installed on the host machine.

ThirdEye requires Node.js. It can run on various devices, such as a Raspberry Pi, an old Windows PC or Mac, or an old PC running a Linux distro like Ubuntu.


Main features

• Two-way chat between Discord and Minecraft

• Full support for Paradox, allowing you to run all commands via Discord as you would in the game

• Support for other anticheats that use chat commands

• Player join messages, including the device they are connecting with

• Player leave messages

• Device blacklist/whitelist

• Support for BDS and Realms

• Players can create in game private voice channels without leaving the game, this is a automated process invite commands and well as creation commands


Installing ThirdEye

This has been broken down into three parts:

1. Creating the bot application

2. Configuring the client script

3. Installing Node.js 18.16.0 LTS

Creating the bot application

1. Head over to the Discord Developer Portal: https://discord.com/developers/applications

2. Click on "Create a new application"

3. Give the bot a name (e.g., ThirdEye), check the checkbox, and click the "Create" button

4. Click on "Bot" in the left-hand menu, scroll down until you see "Message Content Intent", and make sure it's enabled using the toggle switch (as seen in the image). Under bot permissions, enable "Administrator". Then press "Save Changes"

5. Next, head over to "OAuth" and click on "URL Generator" as we now need to invite the bot to the Discord server

6. In the list of options, select "Bot" and "Administrator" (as seen in the image below)

Finally, copy the URL and paste it into your web browser to invite your bot to the Discord server. This URL is located at the bottom of the page

At this point, you should have the bot as a member in your Discord server. Once this has been completed, proceed to the next step

7. The next step is to configure the script to communicate with your bot on Discord. For this, we need to go to the bot page in the Discord Developer Portal. Click on your application and then click on "Bot" from the left-hand menu

Click on the button called "Reset Token". This should provide you with a new token. Copy this token and paste it into the "config.json" file within the ThirdEye folder

At this point, the bot is now configured. The next part is to configure the client script

Configuring the script.

Now you should have the Discord application set up and joined to your Discord server. We can go ahead and get the rest of the client script configured.


1. In the release folder, open up the config.json file and make sure you have the bot token in the correct place.

2. You will need a Microsoft account with an Xbox Live profile. Make sure this has been done. Click here to go to the login page. Once your account has been created and is ready to go, put the email address in as seen in the image below.

If you are having issues with creating a new Microsoft Account please see the video here

3. Now, if you're running a realm, set "isRealm" to true and enter the invite code. If you have a hosted Bedrock Dedicated Server, keep this set to false and follow step 4.

4. For BDS servers, you need to enter the IP address and port number so the script can connect. For example:

5. "Guild" is the ID of the Discord server. You can find this by right-clicking on the server in Discord and clicking on "Copy ID". Paste this into the "guild" field in the config file.

6. "Channel" is the main channel to be used with the chat relay between Discord and Minecraft. Simply grab the ID by right-clicking on the channel in Discord and clicking on "Copy ID". Paste this into the file under "channel" as you have done before.

7. Next, set up a second channel for logging the anticheat. While this is focused on Paradox, it will have basic support for others. As the project is open source, you can fork the repository and add anything that is required. To log the anticheat to a separate channel, set "ParadoxEnabled" to true.

8. "CmdPrefix" is designed for Paradox, as you can change the command prefix in-game. The default is set to "!", which will allow you to run commands like "!ban Pete9xi was spamming chat". This can be changed to use with other anti-cheats that support chat commands in-game.

9. The "on join player message" is handled via a packet that will grab the relevant information. This will include the player's name as well as the device they are connecting with. In the event that a server fails to broadcast this as a backup, you can enable "useSystemPlayerJoinMessage". This will use the yellow message in-game when a player joins and will send this back to Discord.

10. Embeds: the script is designed to send embeds back to Discord. If enabled, you can set the name as well as the color via the settings below. To enable them, make sure you have "useEmbed" set to true. An example can be seen below. The color values are Red, Green, Blue (RGB). For example, Red = 255,0,0.

12. "Admins" control who can run commands via Discord. When you send a command like "!version", it will check to make sure the user ID is on the list in config.json. If so, it will allow the command to be sent to the server/realm. If not, it will be blocked. Right-click your username and click on "Copy ID". You can add multiple accounts. See the example below. Leave "authType" set to false at all times; this means it will authenticate with Microsoft only.

Installing Node.js

ThirdEye can be run on any device that supports Node.js. This can be a Linux machine, Windows PC, or even a Raspberry Pi.


1. Head over to the Node.js website and download the latest LTS release. Once this has downloaded, run the installer and follow the instructions.

2. If you are running this on Windows, included in the release folder is a batch file to install the required Node.js modules. Just run the file, and the modules will be installed. If you are running this on another OS, the npm commands are `npm i bedrock-protocol` and `npm i discord.js`.

3. For Windows, there is an included batch file to start the script. If you are using another OS, you will need to launch the script. For example, `node start.js`.

Note: You will need to grant the client account server OP status, as well as Paradox OP. This is so messages from Discord can be broadcasted to chat and the Paradox logs can be sent back. Also, make sure cheat notifications are enabled by running `!notify`.


Get Support

Head over to the discord server for support or post an issue on github.

Credits

Graphics created by Kvr#7119

About

ThirdEye, Two way chat between discord and minecraft along with logs for anticheats.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 98.8%
  • Other 1.2%