Getting Started

• Installation
• Configuration
• Updating

Plugins

• Officially Supported Plugins
• Community Plugins
• Installing Plugins
• Write your own plugin

Commands

Contributing

Authors

License

A fully modular bot for Discord built on top of Discord4J which can be found here

Features include:

• Fully configurable, Lightweight server
• Plugin system (configuration, persistence, middleware, web-views) (🚧)
• Variable parser (using ${var} in response messages)
• Persistent data for plugins (🚧)
• Web client (🚧)
• Automatic updates (for minor and patch updates)
• Announcement System (Notify users through discord)
• Fully featured help system

NOTE: The emoji "🚧" means that the current features are under heavy development and are experimental

• Java 11
• Discord bot token (Unsure? Follow this guide)
• Ensure your bot is on your server

• Download the latest release from: Releases
• Extract the archive anywhere on your machine
• Open up the bin folder if you are on Windows run ./Babblebot.bat; Linux run ./Babblebot
• On your first run a folder called config will be created please add your Discord bot token to config/config.json
• Run the application again, then your bot should be online (Any issues? please create a discussion here)

Please look at this configuration guide here

Steps to update manually:

• Download the latest release from: Releases
• Extract the archive anywhere on your machine
• Replace the lib folder and replace Babblebot and Babblebot.bat

NOTE: if you don't care about keeping the same folder you can copy over the folders `config` and `plugins` and your database file if you have one

Babblebot has a system in place to automatically update itself when a new release is made to turn this off under the config there is system.autoUpdate change this to false

The system will only update when there is a minor or patch update which would be only Y and Z in this example X.Y.Z

NOTE: you can update to a major version by using --updateMajor when running babblebot it is not recommended as plugins may not support this version use with caution

Plugins are what give power to Babblebot. Without them Babblebot will be a strong server for just 3 commands

Plugins Offer:

• More Commands
• Middleware for the command dispatcher
• More variables (🚧)

If you wish to have your plugin displayed here please create a discussion here

Steps to install a plugin:

• Locate and download the latest version of a plugin it should be a .jar file
• If not already created, create a plugins folder inside the bin folder
• Create a new folder for your plugin it needs to be the same name as the .jar file
• Place your jar file inside that folder
• Open up your config/config.json file and add inside

    // Old
    "plugins": []
    // New
    "plugins": [{ "pluginLocation": "<!-- use folder name you used earlier -->" }]

  For additional plugins add a , between objects e.g.

    // Old
    "plugins": [{ "pluginLocation": "plg1" }]
    // New
    "plugins": [{ "pluginLocation": "plg1" }, { "pluginLocation": "plg2" }]

• Save & Restart your server

If you wish to write your own plugin please follow this guide here

Babblebot has a core plugin which by is installed by default it cannot be disabled it has 3 commands that every server will have:

Firstly, Thank you for taking the time to contribute to Babblebot if you wish to contribute please read the contributing guide here

• Ben Davies - Lead Developer - Github

Currently, there is only me working on Babblebot, but it's always open for new ideas and contributions!

See also the list of contributors who participated in this project.

This project is licensed under the MIT Licence - see the LICENSE.md file for details