# Create Minecraft Products
In this section, you will learn how to create a minecraft product. It is very easy and quick ! From here we will assume that you've already correctly setup your server. If not, check this page.
A minecraft product is a product that is directly connected to your minecraft server through the ShopBot Plugin (spigot and bungeecord server are currently supported). You can send up to 5 custom commands to your minecraft product that will be executed once that someone buys your product.
# Connect your Minecraft Server
First thing, you need to connect your minecraft server to your product. To do that, you need to download the plugin and install it on your server. Here are the links:
For the Spigot plugin click HERE (opens new window)
For the Bungeecord plugin click HERE (opens new window)
Once that your plugin is on your plugin folder, you MUST restart your server.
# Configure the plugin
Once you server has successfully been restarted, for spigot you will see a ShopBot folder in your plugin folder, for bungeecord you should see a ShopBot config file.
Open the config file (for spigot go in the ShopBot folder and open the config file). Here are the different options:
| Option Name | Description |
|---|---|
| Port | This will be your connection port to your minecraft server through the ShopBot plugin, the port that is set here MUST BE OPENED on your minecraft server !!! |
| Password | It will be your server password for every communication with the ShopBot infrastructure. You must setup a strong server password. |
| security_info | If it is set to true a log will be created each time someone tries to connect to your minecraft server through your custom ShopBot port, his IP address will be displayed. If set to false, nothing will happen. |
Once that you have followed the instructions, you need to RESTART your server.
# Test you Configuration
To know if you have correctly configured ShopBot on your minecraft server you can type /testminecraftconnection SERVERIP:YOURPORT PASSWORD the serverIP needs to be your minecraft server IP : YOUR CUTSOM SHOPBOT PORT that is in your config file. If you have setup a proxy, you don't need to put the port (only if you know what you are doing). The password needs to be the password that you have setup in your ShopBot config.
# Create Your product
Now that you have successfully setup your server, let's create your product.
# Step One - Go on the Dashboard
First thing, you need to go on the ShopBot dashboard (opens new window). You will need to connect with your Discord account.
Then go to Products -> Create a Product.
Here, you will need to choose your product type. You then need to select a minecraft product.
# Setp Two - Product Informations
😎 Stands for not required, so do it only if you want it. ⚠️ Stands for required, so please fill it correctly or you will not be able to pass to the next step !
| Option Name | Description |
|---|---|
| Product Name ⚠️ | It will be you product name. It will be displayed as the title of your product on the checkout and on the product embed |
| Product Description ⚠️ | It will be your product description, it will be set as a description in your product embed |
| Product Color 😎 | This s a hex code for the color want want your product embed to have. It is only avalable to ShopBot Plus and Premium users. If you don't put anything, the color will be green by default. |
| Product Stock 😎 | If set to Limited, this will limit the number of products that your customers can buy, you can add more stock whenever you want by editing the product after its creation. If there is no more stock, your customers won't be able to purchase your product. |
| Purchase Limit | If set to Limited, this will limit the number of products that your customers can buy for a lifetime. If for example your product can only be bought once, then set the limit to 1 |
| Product Image 😎 | It will be your product main image, it will be set as the image of your product embed. BUT if you want to put an image it MUST be a link to an image or it will be rejected by Discord (ex: https://shopbot.site/images/ShopBot-big-logo.png ) you CAN use link shorters ! |
| Product Thumbnail 😎 | It will be your product thumbnail, it will be displayed as the thumbnail of your product on the product embed. BUT if you want to put an image it MUST be a link to an image or it will be rejected by Discord (ex: https://shopbot.site/images/ShopBot-big-logo.png ) you CAN use link shorters ! |
# Setp Three - Payment Information
Here, you will need to put your product payment information to be able to be paid each time somone buys your product. Your platformID depends on the choice you make through the payment provider dropdown. (you don't need a platformid for ShopBot as a payment provider)
# Payment Provider / ShopBot
For ShopBot you will need to select the server that the product will be linked to. And that's all !
# Payment Provider / PlatformID - Paypal
For Paypal, you only need to put your VALID Paypal email address that is linked to your account. If you populate a wrong email, no one will be able to have a checkout link.
(Once your product is created and generated, I strongly recommand that you click on "buy" on your product to see if a checkout link is created. If not, modify your product Paypal email address in Products -> Product List -> Select your product and click on "edit" -> Sensible Informations -> PlatofromID)
# Payment Provider / PlatformID - Stripe
For Stripe, it is a bit harder but it is worth it!
You need to have a stripe connected account . Once you have that, then head to your profile here (opens new window), go to the bottom of that page and copy your account id (see image below) and paste it in the platformID input.
# Price / Currency
Now, you need to put your product price and currency. I recommend you to choose your currency first. Note that if you choose Paypal as a platform, the minimum price is 7.5€ (or equivalent in other currencies) for a product. Whereas for Stripe, it is 5€ and you will have LESS fees applied to your payment.
# Payment Type
# One Time
If you select the One Time payment type, evry purshace of your product will be unique. The commands that you will set up will be executed every time that somone buys your product and claim it.
# Subscription
If you select the Subscription payment type, you will be able to put a frequency that matchs your price. ATTENTION the frequency is also the frequency at which the commands will be executed on your server.
Example: If you put a Daily frequency and that somone buys your product, the commands that you've setup for your product will be executed once a day (at 1pm or 1am depending on the time at which the product has been bought). If the user wants to keep the command execution, he will need to buy the product again and it will add one more day to his subscription (because in this example your product has a daily base product frequency). Note that a user can also put a custom frequency, example:
You have a price of 10€ for a product that has a daily frequency, if a user chose to take a week of your product he will pay 70€ for his product (10x7). And he will need to buy the product again 7 days latter rather than 1. (and the commands will still be executed everyday since you have a daily base frequency.)
WARNING
⚠️ All the subscription dead lines are rounded to mid day or mid night !
# Step Four - Product Automatic Actions
You can activate or deactivate the automatic actions you want. If you don't know what they are, please check this page.
# Step Five
One more step and you are DONE !
😎 Stands for not required, so do it only if you want it. ⚠️ Stands for required so please populate it correctly or you will not be able to pass to the next step !
TIP
If you put
{{player}}
in your command it will be replaced by the buyers minecraft nickname
| Option Name | Description |
|---|---|
| Server IP ⚠️ | This is your minecraft server IP : YOUR CUTSOM SHOPBOT PORT that is in your config file. If you have setup a proxy you don't need to put the port (only if you know what you are doing). And as a reminder, your ShopBot custom port needs to be OPENED. So for example if my server ip is 1.1.1.1 and my port 4734, then I will put 1.1.1.1:4734 as a serverIP |
| Server Password ⚠️ | This is the password that you have setup in your ShopBot config. |
| Player Online ⚠️ | This will determine if the buyers needs to be connected to your minecraft server while beeing connected to your minecraft server. ShopBot will ensure that the buyer is connected on your server before allowing him to claim his product. |
| Command1 ⚠️ | It will be the first command that will be executed when the buyer claims his product. This first command is required but the other commands are not (BUT if for example you set a command3 and not a command2 then the command 2 and 3 won't be executed on your server. |
| Command2 😎 | Second command that will be executed on your server |
| Command3 😎 | Third command that will be executed on your server |
| Command4 😎 | Fourth command that will be executed on your server |
| Command5 😎 | Fifth command that will be executed on your server |
And you are DONE! All you need to do now is to submit your product and generate it !
# Generate your Product
First, you need to have your product ID. To find it, go to Products -> Product List and you should see your products and its ID right under its image (if you dont see it, simply refresh the product list by clicking the refresh button)
Once that you have your product ID, go to your Discord server and go in the channel where you want the product embed to be generated.
Then type /generateproduct YOUR-PRODUCTID I think that you guessed that you need to put your product ID instead of YOUR-PRODUCTID. Hit enter and let the magic happen, if all is correct, your product embed should be created. You can delete the first information message that says Product Created ! If you want to modify your product go on the shopbot dashboard and regenerate your product embed again !.
If you modify your product you will obviously need to regenerate it the same way you did here.
And you have finished ! There is nothing more for you to do, the product is fully working.
# Test your product / Offer it
Once that your product is created, you can test it (this also works if you want to offer your product to someone).
Type /testminecraftproduct on your Discord server. Instead of the productid parameter, you will need to put your product ID that you can find in the product list page of the ShopBot Dashboard. Instead of the minecraft_nickname, you will need to put the minecraft nickname of the person to whom you want to offer the product to (if it's just a test, you can simply put yours), this will replace all the player parameters of your command.
# Quick Fixs
Here is a list of known issues and a way to fix it
| ❌ Issue | ✅ Fix |
|---|---|
| Only seeing a Buy Button | This issue is caused by the embeds being disabled on your server, please activate this option in your server settings |
| Need a ShopAdmin Role | You did not correctly setup your server please see this page |
| I do not own the product I want to generate | Only the person who created the product on the dashboard can generate it |