Screenshot 542
Screenshot 542
Screenshot 542 1
 

Discord Pop Bot+

(1 customer review)

$5.00

This is a script capable of controlling multiple bots from one program and a single config file without ever connecting to your server over RCON.

Sold By: Neko

Description

This is a script capable of controlling multiple bots from one program and with a single config file without ever connecting to your server over RCON.

You may need Administrator privileges on the system to setup & run this script depending on your server’s setup.

Feature List

  • Run multiple bots from the one script
  • Change your config using the included “Config Editor & Generator” – no JSON knowledge needed!
  • Lowest possible performance impact – there are no new RCON connections ever made to your server.
  • Show players, max players, queued players, AND joining players!
  • Threshold message – when your pop falls below XX%, show a different message such as your wipe schedule.
  • Special variables that are replaced in your strings, allowing you to have any variable in any part of your pop bot’s message.
  • Global pop bots – add up the total players across your servers and show it on a dedicated bot!
  • Detailed logging – always know what went on whilst you were gone.

How does it work?

This script works by querying the BattleMetrics API – even if you don’t have a purchased RCON subscription! If you do, you’ll be able to display the amount of players joining.

 

Install (Windows)

Your server will need to have Microsoft Visual C++ Redistributable Package installed, simply click the link to download the 64 bit variant.

Method 1 – Installer, Windows Dedicated Server
  1. Download the Multi Pop Bot Installer ZIP file.
  2. Extract the ZIP file anywhere on your system
  3. Run the included .MSI, which is a Windows Installer File. You’ll be able to choose where to install the script when you run this.
Method 2 – No Installer, Windows Dedicated Server
  1. Download the Multi Pop Bot (Raw Files, No Installer) ZIP file.
  2. Extract the ZIP file anywhere on your system
  3. Run the file run.bat
Method 3 – No Installer, Alternative System
  1. Install Python 3.8, using the Recommended Installation and ticking Add Python to PATH.
  2. Download the Multi Pop Bot (Raw Files, No Installer) ZIP file.
  3. Extract the ZIP file anywhere on your system
  4. Install necessary modules with pip install -U discord.py aiohttp websockets in console (cmd)
  5. Run python run_windows.py in console (cmd)

Install (Linux)

You will always require the raw files for Linux installs.

Since Linux is a very broad term for OSes, it is possible that there is not yet any compiled code ready for your architecture. If the following instructions do not work for your architecture, please get in touch so I can compile them for your system & add them to the download.

Method 1 – Generic Linux System
  1. Install Python3.8 on your system (you will have to search how to do this, as it is different for Ubuntu, Debian, Installs, Gentoo, etc)
  2. Install necessary packages using one of the following commands.  If  you are unsure which is the right command, you may have to try all of them or do a little read up on your installation.
    • pip install -U discord.py aiohttp websockets
    • pip3 install -U discord.py aiohttp websockets
    • python3 -m pip install -U discord.py aiohttp websockets
    • python3.8 -m pip install -U discord.py aiohttp websockets
  3. Run one of the following commands, depending on your system
    • python run_linux.py
    • python3 run_linux.py
    • python3.8 run_linux.py
  4. Now that you have figured out which command runs the code, make yourself a new file called run.sh
  5. Using your favourite text editor (nano of course), you want to edit this file and setup an infinite loop to run the command you previously used to run the script. How to setup an infinite loop in a .sh file
  6. Run your .sh file
Method 2 – Hosting Platforms

All hosting platforms do things differently. You will need to use run_linux.py and make sure that it automatically restarts the script when it closes! This is needed because Discord occasionally kills the connection between themselves and your server, which causes the bot to no longer function. When this happens, the script will detect it and close itself automatically, allowing whatever is handling the execution of the code to start the script again.

If you are asked which packages are required you need discord.py, aiohttp, websockets

For Pterodactyl users, you will need to use a Discord bot egg which you can find with a quick search. The startup command will typically be python run_linux.py.

For Pebble users, you can simply use run_linux.py with Python3.8 and the appropriate packages.

The Config

Once you’ve installed the code, you should now be able to see in your selected directory that there is a “Config Editor & Generator” file. Run this and it will walk you through editing the configuration file. I strongly recommend you select “Create a New Config” when installing for the first time, so that you can select whether or not you want logging enabled, and add your own bots from scratch.

When you are specifying the messages that will be displayed, you will be told that {{players}}, {{maxplayers}}, {{queue}}, {{joining}} will all be replaced on the bot. What this means is that if you want your bot’s message to look like >150/150 (71 Queued)< you would need to enter >{{players}}/{{maxplayers}} ({{queue}} Queued)<. You can use this feature to customise your pop bots however you like.

If you feel you are a bit more tech savvy than others, there is a folder examples that contains sample configs for you to read over, one even including a full description of each JSON key + value.

 

Update Intervals

During the creation of your pop bots, you may be asked what “Update Interval” you would like. If you are running more than 4 bots, it is recommended you increase your update interval appropriately so that you do not spam Discord’s API – a quick way to get your server banned that a lot of Discord-related Rust scripts do not account for. Additionally, Discord will attempt to kill the connection a few times before banning you, which could result in crashes! Not to worry though, this script has been built to be as reliable as possible and will automatically restart itself if you follow the steps under “Running the Script”.

 

Thresholds

The threshold feature will wait for your pop to fall under a set percentage (referred to as threshold in the config), and display an alternative message so that you do not have to display potentially embarassingly low pop to your Discord members. If this is something you are not worried by, simply set the threshold to 0 and it will never trigger. It is important to remember that the threshold is a percentage not a set value! A threshold of 10 and a max player count of 100 will only show the threshold when there are less than 10 players online.

The message shown can be changed by altering threshold_msg in the config, or you will be asked to enter the text you wish to display when using the config editor.

 

Joining Players

If you would like to show the amount of players joining, it is absolutely necessary that you have a BattleMetrics RCON subscription purchased. You will be asked by the config generator if you would to create a Pop Bot with BM Token or Pop Bot without a BM Token – if you wish to display the players currently joining your server, choose the former. If you do not wish to show this or do not have a BM subscription, use the latter.

 

Obtaining a Discord Bot Token

First, head over to https://discord.com/developers/applications and create yourself an application. It’ll most likely need your server logo, the name of the server, and any other information you wish for people to see appear.
Once that’s done, select the “Bots” tab and press create a bot. You’ll be presented with “Click to reveal a token” and a button that reads “Copy”. You can just press Copy and it’s on your clipboard ready to insert into your config file.

 

Obtaining a BattleMetrics API Token

If you have purchased a BM RCON subscription, this is for you.
Head over to https://www.battlemetrics.com/developers. You want to select “New Token”.
Fill in the identifier with something such as “Pop Bots” and ensure it has the “Execute any RCON command” permission. The rest aren’t used at all, so whether or not you grant them or not are completely your choice.
You’ll have only one chance to copy this token somewhere safe (such as the config.json file:D), so make sure you do. Luckily for you, this one token will work with all of your pop bots, so don’t worry about generating a new one for each bot (unless you really want to keep things nice and tidy).

 

Running the Script

At last, your configuration file is complete! You have probably noticed that there are 2 .bat files included. If you have NSSM installed you can use nssm.bat and run the pop bots as a service, then simply forget about them.

If not, you can just double click run.bat and the bot will always restart itself no matter what issues it encounters.

1 review for Discord Pop Bot+

  1. Kaden Newman (verified owner)

    These bots work amazing!
    Never had an issue with them so far.

Only logged in customers who have purchased this product may leave a review.