thedescend / elevatorbot

Interacting with the Destiny 2 API via Discord

---

ElevatorBot

---

Invite to Discord | Visit the Website | View the Documentation

---

@ElevatorBot#7635 is a modern and open source discord bot that can be used to interact with the Destiny 2 API. He was originally created at the start of 2018 because of a desire to access information not provided by the existing Destiny 2 bot, Charlemange. He has greatly expanded in scope since then.

ElevatorBot is mostly written in Python using N.A.F.F, FastApi and PostgreSQL. The website is written in JavaScript using Next.js and tailwindcss. He has explicit support for modern discord features such as slash commands, components, context menus and modals.

Features

-[x] Clan Management (Invite / Kick) -[x] LFG System with calendar integration -[x] LFG supportive features like a context menu to receive bungie names -[x] Deeply customisable achievement roles -[x] Over 30 Destiny 2 commands ranging from stats for all weapons and activities to clan rankings -[x] Much, much more...

Contributing

Contributors are always welcome! If you have any question and don't know where to start, don't hesitate to contact us on GitHub or discord (Kigstn#9278).

Self-Hosting Guide

Everyone can host this bot for themselves. To set him up, follow this quick installation guide.

Note: It is recommended to simply invite the official discord bot.

1. Download and extract the latest release
2. Install docker
3. Install docker-compose
4. Rename rename_to_settings.toml to settings.toml
5. Fill out settings.toml
6. Run docker-compose up --build

Optional: ElevatorBot sometimes uses discord emojis. Since you are not in the server where the emojis are from, these will display as IDs for you. If you want to change that, you need to change the IDs in /ElevatorBot/static/emojis.py.

Security

Make sure to change the default passwords in settings.toml. If you decide to add ports to the docker-compose.yml be aware that docker will try to publish them externally, whether your firewall allows it or not.

elevatorbot's Issues

Put functions into different files and those into a function folder

Make sure Elevator can run in multiple guilds

• Remove hardcoding
• Add command to setup bot (admin roles, lfg channel, bot-command channel etc)
• Create Database Table to save configurations per guild
• Link guild to destiny clan
• Decide which functions should be accessbile where

Match discord users to clan-users

Remove discord pending implementation

Setup github actions

• Auto docker deploy on release
• auto tests for all microservices (if changed)

Make sync all commands a config option

Implement an actual versioning system that we update

Refactor all existing functions

• Remove no longer needed api request
• Use DB functions

Specific functions:

• /rank
• /day1race

parse pings correctly

Change discord lib to dis-snek

Remove no longer needed functions

new spreadsheet for new requirements

Fix clan join button

Add DB for caching

remove 'normal' roles once master rank is earned

Automatic Tests

Multithreading for assignAllRoles

role-assignment via command

automate further down the line on a weekly? cycle

Licence

Giveaway feature

Replacing the !rollraction command for (Nitro) giveaways.

• Slash command to create a giveaway message
• Enter the time range for when it ends
• Specify the emote to react with
• Make the bot auto-draw when the time ends (default roll: 1)
• Make requirements (that admins can possibly adapt?): role(s), clan activity, discord activity (default: @Descend role, at least 10 messages in the past month on Discord (excl. #bot-spam), have done at least one activity with any other clan member)

update registered usernames via admin-command

Assign clan-role based on membership

Save / generate metrics

Some examples include:

• command usage
• network request
• database request
• most active guild

etc.

• Maybe a web dashboard?

Raid.Report independence

Change Elevators structure to use microservices

Using docker and then an APIs using FastApi:

• Discord Bot
• Web Server
• Pgsql DB
• Background Events
• Functions

Look into using a document database for specific storage scenarios

update clanDB on_user_update and every 12 hours

before: no descend role
after: has descend role

send message whether destinyID was matched or not

Basis Backend Auth

Update Readme(s)

requirement inheritance

Update .gitignore

timerbased role-update

Command to get good weapon rolls

Look into if it would work in discord and how

number of activities in friends.py seems inaccurate

Literally 0 idea why, gotta look into it

add raider and achievement roles once at least one of them is achieved

Add a testing environment

Adventskalender

Generate private docs for all functions

edit dict via bot-commands

Automatically highlight Roles in Excelsheet

either find them in the pandas
or count the fields from dict

Move Database-Accesses and bungie-parsing to Backend

I suggest FastApi

Commands for stats

https://stats.bungie.net/Platform/Destiny2/3/Account/4611686018468695677/Stats/

Dockerise Elevator

test

Full typing

Fix /stat

get Spreadsheet via command

Document what infos are needed in which file to run the bot

Generate automatic public docs for commands

Revamp everything concerning roles

• roles get added /edited / removed via a Web Inferface
• roles get linked to discord roles by id / name - verification that the role exists would be cool (maybe db table which has all roles in every guild and updated them on change)
• need Auth for that
• roles get saved in a per guild basis
• roles get looked up only on role edit / add / new member
• daily role check gets updated to only check not earned roles daily