https://github.com/pedrofracassi/amongcord

Among Us Discord Bot | Discord bot for controlling voice channels during Among Us matches
https://github.com/pedrofracassi/amongcord

among-us amongus bot discord discord-bot docker

Last synced: about 2 months ago
JSON representation

Among Us Discord Bot | Discord bot for controlling voice channels during Among Us matches

• Host: GitHub
• URL: https://github.com/pedrofracassi/amongcord
• Owner: pedrofracassi
• License: mit
• Created: 2020-09-10T22:12:26.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-02-12T03:55:06.000Z (almost 2 years ago)
• Last Synced: 2024-10-13T02:44:11.371Z (2 months ago)
• Topics: among-us, amongus, bot, discord, discord-bot, docker
• Language: JavaScript
• Homepage: https://add.amongcord.xyz/
• Size: 949 KB
• Stars: 135
• Watchers: 10
• Forks: 29
• Open Issues: 24
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        


  

  
Discord bot for controlling voice channels during Among Us matches

  Click here to add Amongcord to your server



---

## Commands

| Command | Aliases | Description |

|-|-|-|

| `,add` | `,invite` | Shows the bot's invite link |

| `,alive ` | `,a` | Marks a player as alive |

| `,dead ` | `,d` |  Marks a player as dead. Dead players are kept muted during the discussion stage. |

| `,discussion` | `,ds` | Sets the stage to discussion, unmutes everyone who is alive |

| `,endgame` | `,eg` | Ends the current game |

| `,forcejoin  <@mention>` | `,fj` | Forcibly adds someone to the current game |

| `,github` | `,gh` | Links to the bot's GitHub page |

| `,help` | `,h` | Lists all of the bot's commands |

| `,host` |  | Sets you as the game host so only you can control the bot |

| `,join ` | `,j` | Joins the current game as a color |

| `,joinall` | `,ja` | Adds everyone in the voice channel to the game as a random color. |

| `,kick ` | `,k` | Removes a player from the game |

| `,leave` | `,l` | Leaves the current game |

| `,lobby` | `,lb` | Sets the stage to Lobby, marks everyone as alive and unmutes them |

| `,newgame` | `,ng` | Starts a new game |

| `,players` | `,p` | Lists all players in the current game |

| `,setcolor  <@mention>` | `,sc`,`,changecolor`,`,cc` | Set the color of a player in your game |

| `,sync` | `,s` | Lets you control the bot through your phone |

| `,tasks` | `,ts` | Sets the stage to tasks and mutes everyone |

| `,unhost` |  | Exits "host mode" and frees you from being the host |

###### **\*** aliases have not been implemented yet.

## Support server



  

    

  



## Self-hosting

If you prefer you run the bot yourself instead of using the [hosted instance](https://amongcord.pedrofracassi.me/add), you can either use **Docker** or **clone the repository directly**. For both methods, you'll need a  [bot token](https://github.com/reactiflux/discord-irc/wiki/Creating-a-discord-bot-&-getting-a-token) and the ID of a server that has the [emojis the bot needs](https://github.com/pedrofracassi/amongcord/tree/master/emojis) (the bot needs to be in the server).

### Docker

Images are automatically built and pushed to [Docker Hub](https://hub.docker.com/r/pedrofracassi/amongcord) whenever the source code changes. You can run your own instance of the bot with the command below:

```bash

$ docker run -e DISCORD_TOKEN= GUILD_ID= -d pedrofracassi/amongcord

```

### Cloning directly

Although not recommended for production, cloning the repository should work just fine for experimental purposes. If you want to, you can use a process manager like [pm2](https://pm2.keymetrics.io/) to keep the node process running, but bear in mind that **I don't run the bot this way and probably won't be able to help you out.**

1. Clone the repository

   > `git clone https://github.com/pedrofracassi/amongcord`

2. Enter the directory you just cloned into

   > `cd amongcord`

3. Install the dependencies

   > `npm install`

4. Set the **DISCORD_TOKEN** and **GUILD_ID** environment variables

5. Run the bot

   > `node src/.`

## Similar projects

- [AmongUsBot](https://github.com/alpharaoh/AmongUsBot) - automatically detects tasks/discussion stages with OCR instead of using commands, but needs to be installed on someone's computer.

- [amongusdiscord](https://github.com/denverquane/amongusdiscord) - same as above, but written in Go. Easier to install as prebuilt executables are provided.