Complete and configurable music, currency and games multipurpose Discord bot
Using the Official Mantaro Bot
Just one click and you can add Mantaro to your own server and enjoy its full feature set!
You can see more information about the bot itself by reading the summary on here. This is the file we use to publish our bots on bot lists, too. You're welcome to use it as a guide for your own.
Building your own Mantaro
⚠ Read before attempting
The owners of Mantaro do not recommend compiling Mantaro as it is not documented and most builds here will be extremely unstable and (probably) untested, probably including unfinished features. There's no stable branch, all of the features are immediately added to upstream.
You will however sometimes see a legacy branch, a branch we create before publishing larger update containing working code, it is highly recommended to base your building process from the legacy branch, as the master branch will very likely contain broken and non-working code, at least in a case where a legay branch exist.
We will not provide any support whatsoever in selfhosting or building the bot by yourself. The reason for this is because not only can the builds in here be highly unstable, but also there are very few people who could actually help with questions regarding this, most of which are busy and not available to answer said questions.
Building the Bot
You will need the following to utilize all of Mantaro's features (items marked with a star are optional):
- And IDE supporting Lombok (if you edit code)*
- osu! API*
- AniList API*
- OpenWeatherMap API*
- Wolke's Weeb API (For most of the action commands)*
- Other unmentioned API keys*
We will not provide any support whatsoever in obtaining any of the above.
Note: The bot does not necessarily need these keys to function, but some functionality might be limited by the lack of them (ex. without Wolke's API keys, you can't use the action commands). Due to the closed nature of that API, we encourage you to submit a patch that would allow custom images to be used on self-hosted instances if you'd like (ex. by pushing your own -local- API server), but keep them in line with the rest of the code.
If you are going to edit code, make sure your IDE supports Lombok and enable Annotation Processing!
Mantaro isn't a modular bot (sadly), but removing features is fairly easy. You can just remove the respective command or the Module file on the commands directory and everything -should- still work. The exception are some Modules that are required by other Modules. Make sure you pay close attention to the License as you will be required to disclose your source as well as state any changes made.
Steps for building:
Please do note that you will not receive any help whatsoever while trying to build your own Mantaro.
- Make sure you have the prerequisites installed and running.
- Make sure your Java version is 11 or later.
- Clone this repository (you can also fork this repo and clone your fork).
- Open a Terminal in the root folder.
- Grab the
- Create the
mantarodatabase with the following tables: mantaro, players, users, guilds, keys, commands, seasonalplayers
- Run it and prepare yourself to start filling in configs (open the jar on the command line using java -jar name.jar and wait for it to crash, then it'll generate the config.json file for you to fill).
- In config.json, set the value needApi to false. (Or clone and run https://github.com/Kodehawa/mantaro-api)
Tools and Contributors
Tools Mantaro uses
- JDA by DV8FromTheWorld and MinnDevelopment
- Lavaplayer by sedmelluq
- Lavalink by Frederikam
- RethinkDB by the RethinkDB team
- Redis by the redis team.
- imageboard-api by Kodehawa
- And a lot more!
Many thanks to
- @natanbc - A lot of backend improvements and developing. Active.
- @mrlar - Basically made all of the user-facing documentation.
- @adriantodt - Backend development on the early stages of the bot. Was crucial to the development and thanks to him this bot is what it is now. Inactive.
And a lot more people. Check the Contributors tab!
Want to contribute? Join our server and ask in the support channel for what we need help with (you may need to wait with receiving an answer.).
Alternatively send us a Pull Request with what you see fit/think we need. However this process may end in a rejected PR more easily.
Using our code
Give credit where credit is due. If you wish to use our code in a project, please credit us, and take your time to read our full license. We don't mind you using Mantaro code, as it is open-source for a reason, as long as you don't blatantly copy it or refrain from crediting us.
Why is your code of conduct non-existant / stupid / it offends me
We shall bring no politics into OSS. Of course I pledge for everyone to treat themselves with respect and I expect them to do so. We'll take appropiate action if someone is actually being mean, but we don't care about politics and am not bringing them here. Please enjoy the code, contribute if you want and have a nice day.
Copyright (C) 2016-2019 David Rubio Escares / Kodehawa
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/