Merelybot is an extended feature-set framework for Disnake bots. Adding features like configuration-defined bots, hot-reloading of code, a feature rich help command, translation support, authorization, security, error handling, and paywalled commands.

You can test these implementations on my official Discord server.

• Merely is an example implementation of the framework. Merely uses the default config included with this code so you can run it yourself.
• ConfessionBot is an anonymous messaging system for Discord. ConfessionBot uses the help command, translation support, and module reloading features to speed up development and shares improvements to the framework back here.

Seven languages are now supported! English, German, French, Polish, Brazilian Portugese, Tagalog, and Chinese are all available to choose with /language set today, but most are incomplete. MerelyBot now also follows your user and server language preferences by default.

See live translation stats and contribute >

MerelyBot v1.2.0 has launched! This update marks the completed migration to slash commands, which comes with countless performance and usability improvements. Some highlights are the newly-polished /poll and ReactRoles now catch up after any interruptions.

See the roadmap for future updates >

• Clone the project to a folder
• Install python >= 3.10
• Install required python packages with python3 -m pip install -r requirements.txt
• Create a discord bot in the Discord Developer Portal, you will need the token to continue
• Give MerelyBot the token by setting it in the [main] section of the config
• Run MerelyBot with python3 merelybot.py
• Add your instance of merely to your server
• optional: create a log channel on your server and copy the id to merely_data/config.ini > logchannel. - you can also do the same with a channel for feedback and a channel for moderators.

The first run generates a config.ini file, you can modify it from there to enable features.

The best way to contribute is to create your own discord bot using this framework, and send any improvements to the framework my way in the form of a pull request!

I have built a website which makes it easier to translate my projects, including Merely-Framework. Babel Translator.

Merely-Framework is written in Python with the help of the disnake API wrapper (like discord.py). Refer to the Project roadmap for future features we'd like to implement. All contributions are welcome and support can be given in the Discord server.

Merely is a highly customizable and extensible framework for discord bots. through the config file, people can enable and disable extensions, change the bot name, and configure extensions. Developers can even write their own extensions to further extend the Merely Framework.

Extensions should operate entirely independant of each other and should rarely need to communicate with each other. Extensions must inherit from the disnake.ext.commands.Cog class and bind themselves on import. Effort should be made to avoid clashes with existing commands. extensions/example.py should demonstrate all of this.

If you would like to make a bot that changes functionality of existing commands or strings, you may want to use an overlay. Create a folder named 'overlay' in this directory, refer to the source code for ConfessionBot to see an example of how an overlay is structured. Note that babel is given a language file prefix so Merely Language files can still be inherited from.

This overlay system allows for improvements to the framework to be easily shared upstream and downstream.

As the Babel language framework is being used, there's no need to provide strings for your code. Myself and the volunteer translators can add strings later. In place of strings, simply invent a meaningful key, for example;

self.bot.babel('example', 'echo', content=userinput)
# Appears like the following until a string is written:
"<ECHO: content={content}>"
# An example of a written string:
"You said: \"{content}\"."

If you wish to provide strings, add them to babel/en.ini.

• Core plugins are stored in the top directory, these elements cannot be reloaded or disabled. Reloading babel or config refreshes the data, but not the code.
• Extensions are placed in the extensions folder, from there, they will be added to the config and can be enabled.
• Config and config history will be found in the config folder.
• Translation data is stored in the babel folder.
• Error and usage logs are stored in the logs folder.

• * = must be imported for minimal functionality
• ** = must be imported, or replaced with a compatible replacement