The store module in our Discord bot provides an extensive feature set for both server managers and community members. Server managers can customize the Store UI embed, add new items to the store, delete existing items, and edit item details as needed. Community members can purchase items from the store, view detailed information about specific items, and browse through all available store items using a convenient Store UI as shown below. View the full list of commands below:
๐ฎ๐ปโโ๏ธ Server Manager Commands
Click each command to expand for more information on how to use it.
/store-ui - Set Store UI embed.
Server managers can use this command to set up an embed UI for the store in a specific channel. The Store UI will allow users to navigate through the module without the need of using any commands. This is completely optional as users can always use the commands to view the /store and /buy-item.
This command allows the following customizations:
channel - The channel you'd like to post the Store UI embed .
store_image_url - [Optional] URL of a custom image/gif you'd like to place on the Store UI's embed to personalize it for your server.
store_embed_text - [Optional] Custom text you'd like to add to the Store UI's embed.
/add-item - Add a store item.
Server managers can use this command to add a new item into store which can be purchased by users. This command has the following customization parameters:
item_name - The name of the item.
item_price - The price of the item.
role_to_give - The role to be given to users who purchased the item.
role_to_have - [Optional] The role a user requires to buy the item.
item_description - [Optional] The description of the item.
item_stock - [Optional] The stock of the item (Default value: unlimited).
item_image_url - [Optional] URL of a custom image or GIF to be placed on the item embed
For example, using the command above will add a new item called Juice that costs 100. The role @Juice will be given to those who have purchased this item.
IMPORTANT: If user tries to add an item with the same name as an already existing item in store, the following message will be prompted instead:
/delete-item - Delete an item from the store.
Server managers can use this command to delete an existing item from the store. Once the item is deleted, it will be permanently removed from the store and is no longer purchasable. This command has the following mandatory parameter:
item_name - The name of the item.
For example, using the command above will delete the item called Juice from the store.
IMPORTANT: If user misspells the item name or tries to delete a non-existing item, the following message will be prompted instead:
/edit-item - Edit an item in the store.
Server managers can use this command to edit an existing item in the store. This command has the following customization parameters:
item_name - The name of the item.
item_price - [Optional] The price of the item.
item_description - [Optional] The description of the item.
item_stock - [Optional] The stock of the item (Default value: unlimited).
item_role_to_give - [Optional] The role to be given to users who purchased the item.
item_role_to_have - [Optional] The role a user requires to buy the item.
item_image_url - [Optional] URL of a custom image or GIF to be placed on the item embed
For example, using the command above will edit the price of Juice to become 500 (from 100) and the stock to become 10 (from unlimited).
IMPORTANT: If user attempts to edit an item without editing one of the optional item parameters, the following error message will be prompted:
/logs-channel - View/Set logs channel for tracking store sales
Use this command to set a channel where are store sales will be posted.
๐ค Community Member Commands
Click each command to expand for more information on how to use it.
/buy-item - Buy an item from the store.
Community members can use this command to directly buy an item from the store without having to navigate the store UI. This command has the following mandatory parameter:
item_name - The name of the item.
For example, using the command above will purchase the item called Juice.
IMPORTANT: If user misspells the item name or tries to purchase a non-existing item, the following message will be prompted instead:
/item-info - View item details.
Community members can use this command to view the details of a specific item without having to navigate the store UI. This command has the following mandatory parameter:
item_name - The name of the item.
For example, using the command above will display the item information of Juice such as item name, description, stock, role to give, role to have and price.
IMPORTANT: If user misspells the item name or tries to view the info of a non-existing item, the following message will be prompted instead:
/store - Show all store items.
Community members can use this command to view all the items in store without having to navigate the store UI.
