Minecraft: Java Edition
Tebex Store supports direct integration with your Minecraft: Java Edition server via our official plugins. Our Minecraft: Java Edition plugins support the following modding and server platforms:
You can download the plugin specific to the modding software you are using by going to the Plugin section of the control panel.
Our Minecraft Plugins are called Buycraft - this is our old brand name. Any mention of the word Buycraft in your server logs actually means the Tebex Plugin.
Download the Bukkit/Spigot plugin from the plugins section of the Tebex Store control panel.
Place the .jar file into the /plugins folder which is located in the root directory of your Minecraft server.
Start (Or restart) your Minecraft Server running Bukkit/Spigot.
Check the server logs to ensure the plugin is running properly.
Type the following command in the console (Replace the secret key with your secret key found in the servers section of the control panel. Click edit on your server to find the secret key):
/buycraft secret (Your Secret Key)
Once you have executed the above command, type the command /buycraft in game and you should see the information related to your store. You're all set!
Download the Sponge plugin from the plugins section of the Tebex Store control panel.
Place the .jar file into the /mods folder which is located in the root directory of your Minecraft Server.
Start (Or restart) your Minecraft Server running Sponge.
Check the server logs to ensure the plugin is running properly.
Type the following command in the console (Replace the secret key with your secret key found on the servers section of the control panel. Click edit on your server to find the secret key):
/buycraft secret (Your Secret Key)
Once you have executed the above command type the command /buycraft in game and you should see the information related to your store. You're ready to go!
Download the Bungeecord plugin from the plugins section of the Tebex Store control panel.
Place the .jar file into the /plugins folder which is located in the root directory of your Bungeecord Server.
Start (Or restart) your Bungeecord Server.
Check the server logs to ensure the plugin is running properly.
Type the following command in the console (Replace the secret key with your secret key found on the servers section of the control panel. Click edit on your server to find the secret key):
/buycraft secret (Your Secret Key)
Once you have executed the above command, enter the command /buycraft into the Bungeecord console to verify you have competed the setup process.
If you are running an offline or cracked Minecraft server the above installation steps will still work as expected, you just need to ensure that when you created your webstore you selected the game type of Minecraft: Offline. When this game type is selected we won't verify if the Minecraft username actually exists when someone attempts to login to your webstore.
You can also integrate your game server or website using our MySQL, RCON or Webhook integrations.
Using Tebex Store is perfectly fine even with the Minecraft EULA in force. We recommend reading this blog post for more information about how to comply with the EULA.
Push Commands allows for instant command execution on Spigot, BungeeCord and Sponge.
Remove the existing config.properties file within the BuycraftX plugin folder on your game server, if it exists.
Install the latest BuycraftX plugin which will contain the technology that powers Push Commands. If you have a Spigot server you will also need to install the ProtocolLib plugin.
Start your game server and let the new config.properties file generate, you will also need to execute /buycraft secret if you've not already.
Edit the config.properties file and set push-commands to true. If you are running a Sponge server, you need to set the push-commands option to an unused port number, 8084 for example.
Save the configuration file and start your game server. Please ensure there are no BuycraftX console errors when starting your server, if there are then please contact our support team.
Head to the Tebex Store control panel and click Edit on the server from the servers page.
In the fields shown below, enter your game server's IP address and port. If you are running a Sponge server, enter the port that you entered in the config.properties file.
Click the Connect button, then press the Update button. If your server fails to connect please see the troubleshooting steps below.
If Tebex Store is unable to connect to your game server, please check the following.
In config.properties, push-commands is set to true. This should be a port number if you're running a Sponge game server.
You have restarted your game server after editing the config.properties file.
There are no BuycraftX errors or warnings showing in the game server's console.
You have ProtocolLib installed if you're running a Spigot server.
The IP address and port that you have entered in the Tebex Store control panel is valid.
You don't have any firewall rules blocking direct access to the server. If this is the case, please whitelist our outbound IP addresses, these can be found on the server edit page.
If you'd like to let your players click a sign in game to be taken to the webstore to purchase a package, first place a sign and then enter the following text on the first line:
1: [tebex_buy]2:3:4:
A popup will appear once you close the sign allowing you to select which package the player will be directed to on your webstore upon clicking the sign.
To create a Recent Purchase sign that displays a recent purchase on your webstore, you'll need to create a sign and type the following:
1: [tebex_rp]2: 13:4:
The second line accepts a payment ordinal between 1 and 100, where 1 is the most recent payment.
You can place a player head above the sign before creating it to display the corresponding player's head, as shown below.
To create a coupon in game please use the following syntax. Please note that the coupon code will be automatically generated upon creation.
/tebex coupon create [percentage|value] <amount>
The <amount> argument represents a percentage or a fixed value discount depending on the preceding argument.
You may also pass additional arguments as required.
/tebex coupon create [percentage|value] <amount> [expires|limit] <expiry>
The <expiry> argument represents the number of times the coupon can be used if the previous argument is "limit". Otherwise if the preceding argument is "expires", <expiry> should be a time period in the format 2w3d1h42m (which represents 2 weeks, 3 days, 1 hour and 42 minutes).
/tebex coupon create [percentage|value] <amount> user_limit <limit>
The user_limit argument allows you to limit the number of times any one player can apply the coupon.
/tebex coupon create [percentage|value] <amount> min_value <minimum>
To only allow the coupon to be redeemed on baskets above a certain value, please use the min_value argument.
This example will discount your basket price by $/£/€10.10, can only be redeemed 100 times overall, will not let the basket price go below $/£/€5 and will only allow players to purchase using this coupon once.
/tebex coupon create value 10.10 limit 100 min_value 5 user_limit 1
Please use the following syntax to delete a coupon by its code.
/tebex coupon delete <code>
