Discord Bot to scrape Among Us on-screen data, and automatically mute/unmute players during the course of the game!
Works in conjunction with amonguscapture
This program is in Beta. While we are confident about the basic functionality, there will still be issues or pecularities with how the program functions! We are actively working to resolve these issues!
Have any questions, concerns, bug reports, or just want to chat? Join the discord at https://discord.gg/ZkqZSWF!
- This program must be run on a Windows PC. The program CANNOT be run directly on mobile phones.
- You need a minimum of 12 open emoji slots on your server. The bot uses player emojis to link discord users to in-game player colors; it will add them automatically, but you need at least 12 slots (25 recommended).
- You must run the discord bot, and the capture portion (See Easiest installation below) at the same time, and on the same PC (for now).
Made by Wolfhound905 for the pre-release! :)
If you followed all the steps in the video above, you're done with the installation and can start using the bot, or see the Usage/Commands sections below! If you prefer text instructions over videos, follow all the instructions below instead.
- Create an Application and Bot account for your Discord Server (requires Admin privileges on the Server in question).
- Follow the instructions HERE
Now follow either the Easiest
install, or the Install From Source
:
- Download the latest release executable (
.exe
) andfinal.txt
for this discord bot. - Paste the Bot Token you obtained in the pre-installation into the
final.txt
file, after the=
sign. - Run the executable from step 1, either by double-clicking or using
./amongusdiscord.exe
in a terminal window. - Download the latest
amonguscapture.exe
. If you are running the Discord bot remotely, you can add ahost.txt
file in the same folder with the contentshttp://<host>:<port>
to point to that instance, but this is totally optional. - If Among Us is already running, then start the capture executable you downloaded in the previous step. Otherwise, start the game and then start the capture.
Congrats, if you followed the instructions correctly, the bot should now be running! See the Sample Usage section below for details.
- Install Go 1.15.2, but any version of Go 1.12+ should work.
- Clone the repository using
git clone https://github.com/denverquane/amongusdiscord
. - Navigate to the directory with
cd amongusdiscord
, and then build the executable usinggo build -o amongusdiscord.exe main.go
. - Proceed to steps 2-3 of the
Easiest
install section above.
You can also run the discord portion using docker if you prefer, it simply needs the port 8123
exposed, and you should provide your DISCORD_BOT_TOKEN
as an env variable.
Example:
docker run -p 8123:8123 -e DISCORD_BOT_TOKEN=<YourTokenHere> denverquane/amongusdiscord
To start the bot in the current channel, type the following .au
commands in Discord:
.au new ABCD eu
# Starts a game, and allows users to add emojis to link to their in-game players
.au t <voice channel name>
# (Optional) This specifically marks the channel you want users automute within. Users in other voice channels will be ignored.
Get Playing!
If you need to add more players to the tracking list, they can be added using the reaction emojis once back in the lobby. Or, manually using .au link @player color
. If all else fails, you can start a new game with .au new
.
The Discord Bot uses the .au
prefix for any commands
Command | Alias | Arguments | Description | Example |
---|---|---|---|---|
.au help |
.au h |
None | Print help info and command usage | |
.au new |
.au n |
None | Start a new game in the current text channel. Optionally accepts the room code and region | .au n CODE eu |
.au track |
.au t |
VC Name | Tell Bot to use a single voice channel for mute/unmute, and ignore any other channels | .au t Test Voice |
.au link |
.au l |
@name color | Manually link a discord user to their in-game color | .au l @Soup cyan |
.au end |
.au e |
None | End the game entirely, and stop tracking players. Unmutes all and resets state | |
.au unlink |
.au u |
@name | Manually unlink a player | .au u @player |
.au force |
.au f |
stage | Force a transition to a stage if you encounter a problem in the state | .au f task or .au f d (discuss) |
-
AmongUsBot. Without their original Python program with a lot of the OCR/Discord functionality, I never would have even thought of this idea! Not currently maintained
-
amongcord great program for tracking player status and auto mute/unmute in Among Us. Their project works like a traditional Discord bot; very easy installation!