Complete and configurable music, currency and games multipurpose Discord 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.
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 legacy 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.
You will need the following to utilize all of Mantaro's features (items marked with a star are optional):
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, and they won't register). 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.
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.
Please do note that you will not receive any help whatsoever while trying to build your own Mantaro.
mantarodatabase with the following tables: mantaro, players, marriages, playerstats, users, guilds, keys, commands, seasonalplayers
This are java arguments that Mantaro parses outside of config.json and that can be dynamically adjusted using a script or similar:
-Dmantaro.node-number=x- Specify the number of this node (important if you use more than once instance)
-Dmantaro.shard-count=x- Specify the amount of shards Mantaro will be starting up. (for all nodes, see below for subsets)
-Dmantaro.from-shard=x- Start Shard Manager from shard X. (inclusive)
-Dmantaro.to-shard=y- Start Shard Manager up to shard Y. (exclusive)
-Dmantaro.verbose- Log all the things.
-Dmantaro.verbose_shard_logs- Show all shard status changes.
-Dmantaro.debug- Start Mantaro with two shards and some extra logging, regardless of the settings above.
-Dmantaro.debug_logs- Use debug logs.
-Dmantaro.trace_logs- Spam your logs.
-Dmantaro.log_db_access- Log all db access. (spams your logs aswell)
-Dmantaro.disable-non-allocating-buffer- Disable LP's non-allocating buffer.
The above options can also be used as environment variables by removing
-D, and replacing
_, for example,
-Dmantaro.node-number=x becomes environment variable
Many thanks to
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.
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.
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-2020 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/