Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dxbang/bangbot
Bang Discord Bot
https://github.com/dxbang/bangbot
assetto assetto-corsa-competizione assetto-corsa-competizione-server chat discord-bot discord-py event leaderboard race-results sim-racing simracing
Last synced: about 1 month ago
JSON representation
Bang Discord Bot
- Host: GitHub
- URL: https://github.com/dxbang/bangbot
- Owner: DxBang
- License: gpl-3.0
- Created: 2024-02-15T04:44:28.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-03-30T11:05:46.000Z (9 months ago)
- Last Synced: 2024-03-31T08:36:20.157Z (9 months ago)
- Topics: assetto, assetto-corsa-competizione, assetto-corsa-competizione-server, chat, discord-bot, discord-py, event, leaderboard, race-results, sim-racing, simracing
- Language: Python
- Homepage:
- Size: 1.8 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bang Bot
_Discord Race Bot for Assetto Corsa Competizione_
## Installation
1. Install Python 3.10 or higher
2. Setup the virtual environment using `python -m venv .venv`
3. Activate the virtual enviroment using `source .venv/bin/activate` or `.venv\Scripts\Activate.ps1`
4. Install the required packages using `pip install -r requirements.txt`
5. Create a `.env` file in the root directory and add the following:
```.env
DISCORD_TOKEN=
```
### Install on Linux as Service
1. Modified `bangbot.service` to match your installation.
2. cp `bangbot.service` to `/etc/systemd/system`
3. run `sudo systemctl daemon-reload`
4. run `sudo systemctl enable bangbot.service`
5. run `service bangbot restart`
## Configuration
The bot is configured using the `config.json` file. The file is structured as follows:
```json
{
"prefix": [
"!",
"."
]
}
```
Enable the extensions by adding the file name to the `extensions` list in the `config.json` file. _(Hint: added ! before the extension name to indicate that it is disabled without removing it from the config.)_
```json
{
"extensions": [
"bang.systems",
"bang.acc-race",
"bang.event",
"bang.help",
"!bang.poll"
]
}
```
### Guild Configuration
Copy the `_default_.json` from `guild` and rename it to the guild id of the server. Modify the settings as you please.
## Usage
Run the bot using (on Linux):
```shell
source .venv/bin/activate
py bot.py
deactivate
```
and on Windows:
```shell
.venv\Scripts\Activate.ps1
py bot.py
deactivate
```
## Features
Besides the basic (ping, welcome message etc.) features, the bot has the following features:
### Assetto Corsa Competizione @ G-Portal or Nitrado.
`/practice [date]` - Get the practice results with the lap times and laps of the session.
`/qualify [date]` - Get the qualify results with the lap times and laps of the session.
`/race [date]` - Get the race results of the session and the final standings as well as the fastest lap and penalties.
### Event with Signup
```txt
/event Title of the event
Lots of text for the description of the event.
```
This will create an embed with 3 colums for Going, Maybe, & Decline where people can click on the reaction emojies to place their choice.