deltafall-bot

also known as Deltaballin

A general purpose silly bot used by the Deltafall discord server.

How do I run this bot?

Requirements

• Python 3.13+
• FFmpeg
• Discord Bot Token

How do I obtain the discord bot token?

• if you don't have a discord bot account, you can follow this documentation.
• you can also use the existing token from your existing discord bot if you already got one.

Setup

clone the github repository

git clone https://github.com/Deltafall-Community/deltafall-bot/

installing all the required dependencies

cd deltafall-bot
python -m venv env
source env/bin/activate
pip install -r requirement.txt

configuring the config file

Important

a bot token is required to run this.

start by running the main.py for the first time

python main.py

a config file will be created in the working directory.

edit the config.json file

^{you can use whatever text editor you like in this case we will be using nano}

nano config.json

{
    "token": "",
    "sqlitecloud-quote": "",
    "sqlitecloud-club": ""
}

for the minimum requirement for the bot to run, you need to put your bot token in the "token": "<INSERT TOKEN HERE>" it will look something like:

{
    "token": "MTIDJ8jn239jA299jda9DKaasdv.DJKLa48jDDJ3LJE2",
    "sqlitecloud-quote": "",
    "sqlitecloud-club": ""
}

running the bot

python main.py

Features

Command		Description	Usage
add_quote		Adds a quote for random-quote to use.	quote: The main body of the text you want to add by: Who it should be displayed as by
club	announce	Sends an announcement pinging all members of your club.	-
	create	Creates a club, if you have none.	-
	disband	Disbands a club, if you have none.	-
	edit	Allows you to edit your club.	Description: Description to be displayed Icon: URL of icon image you wish to use, should be square Banner: URL of banner image you wish to use, should be wide
	info	Allows you to see information about a given club.	search: Name of club to search for leader: The user who owns the club
	join	Allows you to join someone else's club.	search: Name of club to search for leader: The user who owns the club
	joined_list	Lists clubs you've joined.	search: Name of club to search for leader: The user who owns the club
	leave	Allows you to leave someone else's club.	search: Name of club to search for leader: The user who owns the club
	list	Lists clubs in the server.	-
	ping	Pings all members of your club.	-
make_baby		Uses algorithms to decide what name is most likely to come from two names.	first_person: The first name you want to compare second_person: The second name you want to compare
manga	random	Gets a random manga from MangaDex.	-
	random_page	Gets a random page of a random manga from MangaDex.	-
music	current_playing	Displays the currently playing music.	-
	pause	Pauses music.	-
	play	Adds a song from YouTube or from an audio file to the queue.	search: The name of the video on YouTube, or a URL to the video file: An audio file
	queue	Lists all songs on the music queue.	-
	resume	Unpauses music.	-
	skip	Skips the current song.	-
	stop	Stops all music and clears the queue.	-
	transition	Allows you to modify the crossfade transitions between songs.	enabled: Whether or not to have transitions between songs duration: The duration of each transition strength: The strength of the crossfade
	volume	Sets the volume of the song.	volume: Volume of the song from 0-100%
petpet		Petpet.	user: User to have the petpet applied to custom_image: Image to have the petpet applied to
random_quote		Gets a random quote.	-
remind	create	Creates a reminder.	on: Datetime to set reminder to message: Message to be displayed with the reminder
	delete	Deletes a reminder.	search: Name of the reminder to delete id: ID of the reminder
	list	Lists your set reminders.	-
settings	server	Allows you to modify server settings, if you have the permissions.	-
	user	Allows you to modify your settings.	-
speechbubble		Adds a reaction transparent speech bubble to an image.	image: The image you want to add the speech bubble to
textbox		Creates a highly customizable Undertale/Deltarune style textbox.	text: The body text of the textbox name: The displayed name on the textbox asterisk: Adds an asterisk to the start of the textbox, makes it more authentic to some UT characters portrait: Allows you to pick between a collection of UT/DR characters for the textbox animated: Animates the textbox into a GIF to replicate a UT/DR textbox custom_portrait: Allows you to add a custom image to the textbox
wiki		(deprecated) Pulls a given article from the Deltafall Wiki	search: Article to display