Everything you need, right here: Moderation, Administration, Configuration...
Butler George is a complex Discord bot including not only all commonly used functions of popular Discord bots, but also everything else you will ever need.
Combined neatly into one single bot, so no one can ever complain about too many bots on your server!
The newest version of Butler George will feature:
- Hosting:
- GUI for easier access and controlling of the bot
- Support for AutoStart and AutoFill for the bot token
and the database connection details - Additional commands for fixing issues on the spot
- Development:
- Custom EventAwaiter for more options regarding user interaction
- API interface and HTTPS RequestHandler
- Completely reworked configuration load and save system
- Frontend features:
- Reworked configuration commands for server admins (
/configure
) - Reworked ModMail, now usable on multiple guilds (
/modmail
) - Reworked music interface
- Context Menu options for moderators for e.g. (temp-)muting
- Reduced message spam (Both server and private side)
- Private messages are no longer embedded
- Reworked configuration commands for server admins (
In Juli 2021 Nevar by @1887Jonas, the bot we used since the creation of our community was shutdown. And as auto role assignment was really important for the security of the server back then, we needed to find a replacement real quick. And as there was also a need for automated actions resulting from this autorole mess, we decided to start our own bot: Butler George was born!
On the 29th of August 2021 Butler George was finally ready to completey replace all previously used functions of Nevar. Since then he was developed into a huge tool for administration, moderation and server configuration, implementing all commonly used functions on big servers: Join2Create channels, level and experience system, ModMail, reaction roles and much more.
ℹ️ We're assuming you are familiar with using GitHub and have already cloned this GitHub repository!
If you aren't familiar with GitHub: Reach out to us we're grateful to help!
-
We currently have 5 languages to choose from: English (
en
), German (de
), Spanish (es
), French (fr
) and Dutch (nl
).
To start translating, please copy the defaulten
folder insrc/main/resources/languages
and rename it to either one of the already supported abbreviations or to the two letter abbreviation of a new language.
Please note: A new language will not be available as soon as the folder is created, as we have add it to the bots internal list! -
Butler George uses keywords for obtaining message content. You will therefore notice the following structure in all files:
keyword=a_lot_of_text_here
For everything to work correctly: DO NOT CHANGE the keyword and the=
. Only translate what is written behind the=
!Please note: The bot will only read the text BEHIND the keyword, not the text in a following line (v.i.)!
-
Butler George usually replies with a two-part message: The first part describes the type of the event the bot replies to (i.e. when a command was successfully executed), the second part then goes into more detail. Because of this division, it needed a separation symbol.
We utilize;
for this and let Butler George search for it. You'll notice them not far behind the=
.
You may translate everything before and behind the;
. DO NOT CHANGE the;
itself, as well as the space behind it! -
In some instances Butler George has to variate the message, depending on who is responsible for an event (i.e. when a user joins a server).
For that we choose the format{variable}
, wherevariable
would be the name of the variable. This name is choosen in correlation to what the variable will be replaced with (i.e. a variating user would have the variable{user}
).
You may translate everything before and behind the variable. DO NOT CHANGE the variables name! -
As Butler George is dependent on the keyword-value structure and therefore searches every line of a file for this structure, you can't create a new line in the final message by just pressing
Enter
, but have to use the regex notation.
Explaining this would be way beyond the scope of this text, but for the purpose of translating the replies of this bot you only need to know\n
, which would be the regex expression for a new line.
For the english version I used\n
sometimes, when the line got too long, or the topic changed drastically.
You may use\n
at your own discretion! -
As you probably already know, Discord uses not Unicode but Markdown expressions for displaying emojis.
ℹ️ Unicode is the internationally used standard for en- and decoding text/symbols/emojis on computers.
Emoji code looks like this:U+2764
ℹ️ Markdown is a readable language for the creation of formatted text or simple websites, replacing complex code.
Emoji code looks like this::sweat_smile:
To now use emojis in the text, we have to just write the respective expression in the text and it'll be replaced automatically. You'll see those expressions used in nearly every message and recognize them in the files as well.For Butler George we decided to establish a simple system:
keyword=message title; :emoji_expression: | message_description
We're hereby asking you to keep this system so the responses of Butler George stay clean and tidy.Quick tip: It looks way better, if you not only use the system
:emoji: | text
at the start of the messsages description, but also whenever you're creating a new line using\n
(v.s.)! -
To make it simpler in the developement phase, Butler George relies, when finding the language files for a certain instance, on the language files being ordered in the exact same way, as the program is setup.
So... DO NOT CHANGE THE FOLDER STRUCTURE!!! -
To finally commit your changes, you have three options: You may either open a pull request, send the changed files directly to a developement team member (contact details are on their profiles) or use one of the contact options to hand over the files.
If you want to get credit for the translations you made, please tell us when commiting the changes as well as who to credit. This may be a Discord user, a GitHub organization or a private person.
If you are considering to translate: Thank you very much ❤️! We're looking forward to working with you!
-
All emojis used by Butler George are provided by Discord, or publicly available and are not under any copyright!
The table below shows all the emojis available to Butler George! -
If you want to use the emojis for yourself (Considering you have Discord Nitro) or make them available for your own Discord bot:
Join these servers:You may send an invitation for your bot into
#📥-invite-your-bot
(A command for automation will be added soon), so we can invite your bot and therefore make the emojis available. -
Icons from Emojis - Icons
Badges from Emojis - Badges
Logos from Emojis - Logos
Miscellaneous from Emojis - Misc
You may contact us...
- via our Discord server
- by opening a new issue here
- by starting a new discussion here
- in urgent cases via E-mail
ReadMe Statistics by @anuraghazra
Blog Post Workflow by @gautamkrishnar
Metrics by @lowlighter
Shields by shields.io
Activity recorded by wakatime.com