I created a cool bot for you !
Let me introduce you ShopBot, this bot aims at helping to you create your own shops and currencies to fit the needs of your community, your RP server, or anything you need.
(See screenshots)
This bot uses the power of Slash Commands to let you interact with it with the best UI as possible (Embeds, Buttons, Select Menu). So you will not have to worry about remembering complex commands, the bot does everything for you, and prevents you from accidentally making errors.
You can create currencies, then use them in shops you created, in which you can add products, with a name, a description and a price.
Of course, you can manage these currencies, shops and products. You can delete and edit them, if you want to change their name, description.. or get rid of them !
Admins can give and take money to users and even empty an account, they can also see the account and inventory of anyone. They can see logs (for purchase, give and take) by setting a log channel on your server.
Users can see their own account and inventory, and buy in shops.
Thanks to Discord's features, you can customize the permissions for each command in the settings of your server.
You can check screenshots of the bot's commands to see how cool it is :D
If you love the bot, feel free to support me:
And don't forget to leave a ⭐ Star
It's now time to configure the bot !
This repo is the bot's source code, not a bot itself.
To use it, you must host it yourself. There are several methods to do this, some are free, some are paid (Be careful that your hosting solution allows file editing, sometimes called local database, otherwise all the bot's data will be lost if the server restarts).
Once you found the hoster for your bot, here are the steps to follow:
- Go on Discord Developer Portal and login
- Click New Application, give your bot a name, accept the ToS and developer policy
- In the Installation tab, untick User Install, and in Install Link select None
- Copy the Application ID from the General Information tab, save it for later.
- Select tab Bot, click Reset Token, copy the token, save it for later.
- Cutomize the bot as you want (Profile picture, banner, name...). Below Authorization Flow, untick Public Bot, tick Server Members Intent
- Save changes.
- In the OAuth2 tab, in Scopes, select bot and application.commands, then tick the following permissions:
- Read Messages/View Channels
- Send Messages
- Use Slash Commands
- Select Guild Install and copy the generated URL
- Follow this URL and add the bot to the server you want, accept everything, the bot should be added to your server !
Now, we'll link the code to the bot, and upload it on the server.
- You need to have Node.js installed on the machine where you want to host the bot.
- Download the code from the latest release and extract it from the ZIP file, open the folder where it's located, and open a terminal from here.
- Execute the following command
npm run setup
- Follow the instructions in the terminal (it will ask for your bot's token and Application ID)
- When it asks : reset data ?, answer yes (y) if you don't want the placeholder shops, currencies and products that I used to test the bot
- You can now run your bot by executing the following command
npm run serve
(Depending on your hosting solution, you may need to use a tool like screen (Linux) to keep the bot running in the background)
(You can also create a routine such that this command is executed from the bot's folder each time the server is restarted)
All done ! You did it, your bot should be working perfectly ! If you have any problem with it, feel free to message me on Discord, or open an issue on Github
As mentionned earlier, this bot enables you to create and manage shops, currencies and products.
The shops have a name, an optionnal description and emoji. They also have an assigned currency. Shops can be reserved for a certain role. All of these can be edited after the Shop has been created.
You can also create discount codes for the shops.
/shops-manage
| create <name> <description> <emoji> <reserved-to-role?>
| edit <name/description/emoji/reserved-to-role> <new-value>
| reorder
| remove
| create-discount-code <code> <amount>
| remove-discount-code
The currencies have a name and an emoji. All of these can be edited after the Currency has been created.
/currencies-manage
| create <name> <emoji>
| edit <name/emoji> <new-value>
| remove
The products have a name, a price, an optionnal description and emoji. All of these can be edited after the Product has been created. A product is assigned to a specific shop.
You can create 'Action Products', these are products that will trigger an action when bought. It can be used to give money to a user, give the user a role. (That's all for now but I'm willing to add more in the future, feel free to give your suggestions in the Issues)
/products-manage
| add <name> <price> <description> <emoji> <action?>
| edit <name/price/description/emoji> <new-value>
| remove
The users have an account and an inventory, initially empty. In addition to being able to view their account and inventory, you can give or take money to users, and empty their account.
/accounts-manage
| view-account <target>
| give <target> <amount>
| bulk-give <role> <amount>
| take <target> <amount>
/settings
Commands that require selecting a specific Shop or Currency will prompt you to do so with a drop-down list after you executed the command.
For example, when creating a shop (/shops-manage create <name>) you select the currency after sending the command, and then the shop is created.
When you give some amount of any currency to a user, you first specify the amount and then select the currency.
When deleting any shop or currency, you also do select it after sending the command.
This for you not to have to remember the name of each currency and shop to manage them.
The use of those command is made as intuitive as possible using Discord's slash-commands and message components. If you encounter any issue with a command, you can open an issue.
-
Show user's account:
/account -
Display the shops:
/shop
And you can do many more things... Create discount codes, add products, give currency to users, use the bot to discover the interfaces !
The screenshots come from the tests I'm doing for the bot. (latest images update: 06.04.2025)
I plan to refactor the whole code base to migrate it to typescript and make it easier to update. I will after that add the following features, some of which have been suggested by users :
- ✅ Inventory system
- ✅ Discount codes
- ✅ Pagination system in shops
- ✅ emojis for products, currencies and products
- ✅ New commands system, for easier use
- ✅ Editable shops, products and currencies
- ❓ API to automate actions like: filling accounts; managing currencies, shops and products
- ✅ Automatic action products (e.g. give a certain amount of currency to a user, give a role to a user, if you have more suggestions feel free to give them here)
- ✅ Shops reserved for specific roles
The roadmap is now visible here.
- Create a release, a precompiled version of the bot, with an easier way of installing it.
All those changes will be made on this branch.
If you have a feature idea you think will fit this bot, feel free to suggest it here.
This project is licensed under the GNU General Public License v3.0.
This software is provided "as is", without warranty of any kind, express or implied. The authors and contributors of this project assume no responsibility or liability for any misuse of this bot, including but not limited to, using it to conduct or facilitate illegal activities or transactions.
By using this software, you agree that:
- You are solely responsible for complying with all applicable laws and regulations in your jurisdiction.
- The authors are not liable for any direct, indirect, or consequential damages arising from the use of this software.
- This project is intended solely for lawful and ethical use.
If you do not agree with these terms, do not use this software.
By submitting a pull request, you agree that your contributions will be licensed under the same GPL-3.0 License as the rest of the project.
This project is not affiliated with, endorsed by, or associated with Discord Inc. All trademarks and copyrights related to Discord are owned by Discord Inc.
Don't forget to leave a star, it helps a lot !
If something is missing in this document, please open an issue.