https://github.com/xnul/among-us-discord-bot
Hands-free, Rust Discord bot to help people in your Discord server play Among Us. Your users manage the game, the Among Us Discord Bot helps them play.
https://github.com/xnul/among-us-discord-bot
among-us amongus bot discord discord-bot rust rust-lang
Last synced: 3 months ago
JSON representation
Hands-free, Rust Discord bot to help people in your Discord server play Among Us. Your users manage the game, the Among Us Discord Bot helps them play.
- Host: GitHub
- URL: https://github.com/xnul/among-us-discord-bot
- Owner: xNul
- License: mit
- Created: 2020-09-13T15:49:13.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2020-10-16T03:36:58.000Z (almost 5 years ago)
- Last Synced: 2025-04-05T14:22:10.918Z (6 months ago)
- Topics: among-us, amongus, bot, discord, discord-bot, rust, rust-lang
- Language: Rust
- Homepage:
- Size: 26.4 KB
- Stars: 5
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Among Us Discord Bot
Hands-free Discord bot to help people in your Discord server play Among Us. Your users manage the game, the Among Us Discord Bot helps them play.
## Features
- Mutes players while not discussing and while dead.
- A single player manages each game, automatically selected.
- A game per voice channel. Dozens of games running simultaneously.
- Safe server muting. Leaving any game will automatically unmute you.
- Simple and intuitive commands built for the game.
- Asynchronous and built in Rust for the best performance.
- Only requires three permissions to operate.
- Basic error handling and logging
- Guild-specific prefixes
## My Bot Invite
Want to invite my AmongUsBot to your Discord server? [Here's the link!](https://discord.com/api/oauth2/authorize?client_id=754473493201944586&permissions=4197376&scope=bot) Use `!help` to get started.
## Planned Features
- Reaction controls
- Predefined text channel for each voice channel
- Retain mutes given as punishment
- DMing commands
- Document/revise codebase
- Command Atomicity
- Go back and drop Ctx as early as possible for better async
- Game instance voice channel list (so that games cannot be started on all channels and still retain safe server unmute)
- No permission handling
## Building
Before you are able to build the bot, you must create a bot application with Discord and grab the token. Once you have the it, create a file called `config.rs` and add this code to it:
```rust
pub static TOKEN: &'static str = "";
```
Afterwards, place the `config.rs` under the `src` folder.
Now you use Cargo, the Rust package manager, to build the executable. Once you have installed Cargo, clone this repository, add your `config.rs`, and run:
```
cargo build --release
```
the resulting executable will be under `target/release/`.