Coinz

Coinz is an open source Discord.js Bot. Coinz has a boatload of commands and features all related to the economy.

Features

All commands are slash commands.
Real stocks and crypto prices. (API key not included)
Create your own business inside discord.
Mine your own crypto.
Create a social media account.
Play more than 20 games inside discord.
Modern dashboard with audit logs.
Be a farmer and grow some crops.
Buy pets and level them up. (25+ unique pets)

Suggestions, bugs, feature requests

Want to contribute? Great, we love that! Please take your time on opening a new issue.

Usage

Invite the bot into your server
Run /help in your server and view all commands

If you need any more help, consider joining our Coinz support discord.

Support Coinz

If you really like this bot, consider donating to Coinz on Ko-fi.

If you can't/don't want to donate, that's fine. You can also support Coinz by starring or forking this repository. To make this bot even better consider opening a pull request or issue with a new feature.

Self-Hosting

We do not recommend self-hosting the bot and website, but it's always an option.

Self-host Discord bot

To selfhost the bot yourself, you need to have:

Node - confirmed working on v16.14.0
npm - comes with Node, the version shouldn't really matter
A Discord bot token, and having the bot in your server
An mongodb.com-database set up, as well as a user to it (with write access)
A clone of the source code, this can be found here and needs to be extracted to a folder.

We will have to do this once:

Do npm i inside the folder, and wait for it to finish.
Create a file .env in the root of the folder.
Change /src/config.json with your default values.

Example .env file: (Do not use "" or '')

TOKEN=YOUR_BOT_TOKEN_HERE
DATABASE_URI=mongodb://127.0.0.1:27017/

After all this, start the bot with npm run start.

Self-host Website

To selfhost the website yourself, you need to have:

Python - confirmed working on v3.9.10
pip - comes with Python, the version shouldn't really matter (at least 2.x)
OAuth2 Redirects setup (You can find the OAuth2 tab in your discord application)
All packages installed (List of all packages in /website/requirements.txt)
A clone of the source code, this can be found here and needs to be extracted to a folder.

We will have to do this once:

Rename example.config.py to config.py.
Change config.py with your default values.

OAuth2 Redirects: (For local testing change https://www.your-website-here.com to http://127.0.0.1:5000)

https://www.your-website-here.com/callback
https://www.your-website-here.com/dashboard

After all this, run python3 website/coinzbot.py.

⚠ Warning

There is literally no warranty if you self-host Coinz, and we will not help you set it up either. If you wish to set the bot and/or website up yourself, we expect you have well enough knowledge in Node.js, Python, mongodb, ... .

Disclamer

You are not allowed to upload this bot to any service such as discordbotlist or top.gg, you are only allowed to host this bot for your community. You can use small parts of this code in your public bot.

License

We use the GNU GPLv3-license. If you plan to use any part of this source code in your own bot, we would be grateful if you would include some form of credit somewhere.

You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions.

Fetched from TLDRLegal, please also read the license if you plan on using the source code. This is only a short summary. Please also take note of that we are not forced to help you, and we won't help you host it yourself as we do not recommend you doing so.

heyfolk/Coinz