Sabotage

An among us monitoring bot that will automatically mute players during tasks and unmute them during discussions and lobby This project uses amonguscapture (the python rewrite) as a submodule for identifying the player through game memory.

Setup

• This bot needs to run on a Windows PC which is participating in the among us game.
• The bot has to be started while you are in the menu screen or in the lobby. (It cannot be started mid-game)
• This bot needs Python 3.6+ to run. Please install it here
• Clone this repository along with the submodule using the following command

$ git clone https://github.com/architdate/Sabotage.git --recursive

• Install the necessary libraries using the following command

$ pip install -r requirements.txt

• Create a role for your among us players.
• Create a voice channel in the server with permissions for @everyone role to NOT speak and make sure the among us players role can speak in that VC
• Follow this guide to create a discord bot and get the bot token and invite the bot: https://discordpy.readthedocs.io/en/latest/discord.html
• Make sure you give these permissions to the bot in the OAuth scope while using the guide above:
• Rename config.json.sample to config.json and fill up all the fields.
• Run the bot using python sabotage.py

Usage

To use the bot:

• First all players need to register their ingame name that they use. They can re-register if the name changes too, but this needs to be done only once and not for every game
• Register ingame names using the command /register <ingamename>
• If you want the bot to start monitoring your game, use the /monitor command (once the person running the bot has started their game). If you don't do this, the bot wont interfere with your mute state
• You can tell the bot to stop monitoring using the /stopmonitor command
• The person running the bot can also use /hook to ensure that the game is hooked

Features:

• During tasks, all players are server muted
• During lobby and menu, all players are server unmuted
• During meeting discussions, only the players who are alive are unmuted

Contributing

To contribute to the repository, you can submit a pull request to the repository. Try to follow a format similar to the current codebase. All contributions are greatly appreciated!

Credits:

• @denverquane for writing the original amonguscapture repository to read game state from process ram
• @hp3721 for porting the original amonguscapture repository over to python.