Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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

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.