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.

Our webpage is hosted in Github Pages. If you want to help us make a webpage, you can poke us.

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 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.

Building the Bot

Prerequisite:

You will need the following to utilize all of Mantaro's features (items marked with a star are optional):

RethinkDB
JDK
Redis
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, 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.}

Editing 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.

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 14 or later.
Clone this repository (you can also fork this repo and clone your fork).
Open a Terminal in the root folder.
Run gradlew shadowJar
Grab the jar from build/libs
Install rethinkdb and redis
Create the mantaro database with the following tables: mantaro, players, marriages, playerstats, users, guilds, keys, commands, seasonalplayers
Run it and prepare yourself to start filling in some config values (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)

Extra runtime options:

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 . with _, for example, -Dmantaro.node-number=x becomes environment variable MANTARO_NODE_NUMBER=x

Tools and Contributors

Tools Mantaro uses

Important Contributors

Many thanks to

@natanbc - A lot of backend improvements and developing. Active.
@mrlar - Wrote most of the user-facing documentation (no longer maintaining it). Responsible for maintaining/running the Support-Server.
@haxiz - Responsible for maintaining 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.

Legal Stuff

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.

License

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/

The full license can be found here.

xDp64xG/MantaroBot