Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/simeononsecurity/discord-backdoors-and-breaches
A Discord Bot for Backdoors and Breaches. Pre-Alpha State Is Not Fully Functional
https://github.com/simeononsecurity/discord-backdoors-and-breaches
backdoors-and-breaches bot cybersecurity cybersecurity-awareness cybersecurity-education discord discord-bot game roleplaying tabletop
Last synced: 7 days ago
JSON representation
A Discord Bot for Backdoors and Breaches. Pre-Alpha State Is Not Fully Functional
- Host: GitHub
- URL: https://github.com/simeononsecurity/discord-backdoors-and-breaches
- Owner: simeononsecurity
- License: mit
- Created: 2023-03-10T19:49:34.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-07-26T23:00:22.000Z (4 months ago)
- Last Synced: 2024-07-27T00:19:37.144Z (4 months ago)
- Topics: backdoors-and-breaches, bot, cybersecurity, cybersecurity-awareness, cybersecurity-education, discord, discord-bot, game, roleplaying, tabletop
- Language: Python
- Homepage: https://cybersentinels.org/discord/
- Size: 1.09 MB
- Stars: 8
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Discord Backdoors and Breaches Bot - Pre Alpha
[](https://github.com/sponsors/simeononsecurity) [](https://github.com/simeononsecurity/discord-backdoors-and-breaches/actions/workflows/docker-image.yml)
[DockerHub](https://hub.docker.com/r/simeononsecurity/discord-backdoors-and-breaches)
A Discord bot for Backdoors and Breaches, a turn-based strategy game by [BHIS](https://www.blackhillsinfosec.com/projects/backdoorsandbreaches/).
[See the bot in action!](https://discord.gg/CYVe2CyrXk)
## Available Commands
- `setup-game`: Creates a game id and sets all the needed variables.
- `start-game`: Starts a new game should be run my incident master only after `setup-game`
- `join-game`: Allows players to join the game by assigning them the "Player" role and granting them access to the game channel.
- `play-procedure`: Starts the Procedure phase of the game, where players must complete a series of challenges to progress.
- `play-incident-master`: Starts the Incident Master phase of the game, where players take turns being the Incident Master and directing the other players on how to respond to a simulated incident.
- `play-c2`: Starts the Command and Control phase of the game, where players take turns being the C2 team and must coordinate with the other players to complete a series of tasks.
- `play-persistence`: Starts the Persistence phase of the game, where players must find and eliminate a hidden backdoor in the system.
- `play-pivot`: Starts the Pivot phase of the game, where players must pivot to a different part of the system and continue their investigation.
- `end-game`: Ends the current game and deletes the game channel and associated roles.
To run a command, type `!` or `/` followed by the command name in the game channel. For example, to start a new game, type `!start-game`. Note that some commands may only be available during certain phases of the game.
## Setting up the Bot
### Using Python
1. Clone this repository using `git clone https://github.com/simeononsecurity/discord-backdoors-and-breaches.git`.
2. Install the required dependencies using `pip install -r requirements.txt`.
3. Create a `config.ini` file in the root directory of the project with the following content:
```ini
[SETTINGS]
discordtoken = put_discord_bot_token_here
channel_id = put_game_channel_id_here
```
4. Replace `put_discord_bot_token_here` with your Discord bot token and `put_game_channel_id_here` with the ID of the channel where you want the game to be played.
5. Run the bot using `python main.py`.
### Using Docker
1. Clone the repository and navigate to the directory:
```
git clone https://github.com/simeononsecurity/discord-backdoors-and-breaches.git
cd discord-backdoors-and-breaches
```
2. Create an `.env` file in the root directory of the project and add the following environment variables with their corresponding values:
```env
BOT_TOKEN=
CHANNEL_ID=
```
3. Build the Docker image using the provided Dockerfile:
```bash
docker build -t discord-backdoors-and-breaches .
```
4. Run the Docker container, passing in the environment variables from the `.env` file:
```bash
docker run --env-file .env discord-backdoors-and-breaches
```
Alternatively, you can set the environment variables directly during the `docker run` command:
```bash
docker run -td --name bnbbot -e BOT_TOKEN= -e CHANNEL_ID= discord-backdoors-and-breaches
```
or pull straight from the image on [dockerhub](https://hub.docker.com/r/simeononsecurity/discord-backdoors-and-breaches)
```bash
docker run -td --name bnbbot -e BOT_TOKEN= -e CHANNEL_ID= simeononsecurity/discord-backdoors-and-breaches:latest
```
Explore the World of Cybersecurity
### Links:
- #### [github.com/simeononsecurity](https://github.com/simeononsecurity)
- #### [simeononsecurity.com](https://simeononsecurity.com)