A configurable and flexible bot that can be used to make a unique bot with! What seperates two bots using this project is nothing more than some configuration files.
The primary implementation of this bot is known as FLD-Bot, which has been added to the following discord channels:
- Filipino learning and discussion
- Tagalog.com
And more!
To use to this project, the only required software is a working go environment. For installation instructions, see this page.
This project includes third party dependencies, so be sure to run go get -d -v ./..
to install those dependencies.
This repository contains additional scripts and files that can be used to aid testing or running a bot. This includes a python3 script, and dockerfiles (which can be loaded by using the python3 scripts). These aren't essential, but can help with ensuring that your contributions work outside your own environment.
To understand how to run the bot, first build it using go build src/main
, then run the program to receive more instructions and examples on how to run the bot.
For properly understanding configuration files, make sure to view the files:
Any of these files can be ignored by replacing its contents with []
.
Feel free to send a message if you are having issues running the bot. Unfortunately, this isn't an easy bot to configure.
A pull request must have the following:
- New unit tests that are relavent to the commit
- No failing unit tests
- Documentation for everything with public scope
It would be desirable if your commit had the following:
- golint returns no issues.
- Tests coverage includes new and modified code. This repository is aiming for as high code coverage as possible, excluding the folders "service/discordservice" (because this code is coupled to a 3rd party library, making testing difficult), "utils" and "main" (because they include side effects).
To add your bot to a discord server with all the necesssary permissions, use the following URL template:
https://discord.com/oauth2/authorize?client_id=<client_id>&permissions=0&scope=applications.commands%20bot
TODOs and issues are tracked using github's issue tracker.