https://github.com/nwrenger/doenermann-bot
A repository with the Dönermann Bot used in a private Discord server of mine.
https://github.com/nwrenger/doenermann-bot
archive birthday-reminder bot discord discord-api discord-bot python rust
Last synced: 29 days ago
JSON representation
A repository with the Dönermann Bot used in a private Discord server of mine.
- Host: GitHub
- URL: https://github.com/nwrenger/doenermann-bot
- Owner: nwrenger
- License: gpl-3.0
- Created: 2023-01-06T19:17:56.000Z (over 3 years ago)
- Default Branch: Rust
- Last Pushed: 2026-05-22T19:04:53.000Z (about 1 month ago)
- Last Synced: 2026-05-22T22:25:58.691Z (about 1 month ago)
- Topics: archive, birthday-reminder, bot, discord, discord-api, discord-bot, python, rust
- Language: Rust
- Homepage:
- Size: 188 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Dönermann-Bot
A repository with the Dönermann Bot used in a private Discord server of mine. It's using the `serenity` crate and is available under the **GPLv3 License**.
## Features
- Copy message of a citations channel to the database
- Show with a command how many were copied: `/citations`
- A normal ping command: `/döner`
- Manage birthdays with `/birthday set`, `/birthday delete`, and `/birthday next`
- Roll, claim, browse, delete, and rank waifus with `/waifu roll`, `/waifu collection`, and `/waifu leaderboard`
- Give a user a role when the user joins the server
## Commands
- `/citations`: Shows the latest recorded citation messages from the configured citations channel.
- `/döner`: Sends a Döner helper link.
- `/birthday set birth:`: Saves your birthday using the configured `date_format`.
- `/birthday delete user:`: Deletes your own birthday, or another user's birthday if you are listed as an admin.
- `/birthday next`: Shows the next upcoming birthdays.
- `/waifu roll`: Rolls a random MyAnimeList character from Jikan and adds a Claim button.
- `/waifu collection`: Shows your claimed waifus with Previous, Delete, and Next buttons.
- `/waifu leaderboard`: Ranks players by their total Goon Credits across claimed waifus.
## Set Up
- Add an Application in the **[Discord Developer Portal](https://discord.com/developers/applications)** and create a bot.
- Paste your bot token in `config.toml` and enable these Privileged Gateway Intents in the Discord Developer Portal:
- Server Members Intent
- Message Content Intent
- Add the guild (i.e. the server) id, the citations channel id, the id of the join role, ids of the admins, and verify paths and date formatting.
- Start the bot by running the binary file provided in the release, make sure to give it the right permissions and that the `config.toml` is in the same directory as the binary.
- Otherwise, a default `config.toml` will be generated on the first run, which you can then edit as described above and restart the bot.
## Default `config.toml`
```toml
[bot]
# The Bot Token
token = ""
# A date format used for displaying dates inside the bot messages, default is `%d.%m.%Y`
date_format = "%d.%m.%Y"
# A timestamp format used for displaying timestamps inside the bot messages, default is `%d.%m.%Y %H:%M:%S`
timestamp_format = "%d.%m.%Y %H:%M:%S"
[paths]
# Path to the database file
database = "db.json"
[server]
# Id of the server
guild = ""
# Id of the citations channel
citations_channel = ""
# Id of the role which should be added on join
role_on_join = ""
# Id of the bot's admins, can be multiple
admins = [ "" ]
```
## Building Example (Cross)
```sh
cross build -r --target aarch64-unknown-linux-gnu
```