WooStoreLink Plugin

Simple WooCommerce integration for your Minecraft server

Minecraft and Worpress Plugin

THIS IS A BETA RELEASE. PLEASE EXPECT SOME BUGS.

🛒 WooStoreLink – Seamless Integration Between WooCommerce and Minecraft

WooStoreLink is the easiest way to connect your WordPress WooCommerce store to your Minecraft server, enabling secure, automated delivery of in-game items or commands after each purchase.

No more manual item distribution. No more complicated setups. Just plug and play.

Buy Me A Coffee

[ ] SHORTCODES

We use the following shortcodes for the WordPress Plugin

				
					[ minecraftstorelink_account_sync ] - display current Minecraft link status.
				
			
Remove the space between the brackets [ ] so that it executes on your WP Site.

❗ Common Issues & Troubleshooting

ProblemSolution
Nothing gets deliveredCheck that the item name in WooCommerce matches the one in products:
Players get duplicated deliveriesUse the built-in duplicate cleaner and ensure no table corruption
API returns old ordersUse the Flush Cache button in the admin panel
JSON always returns old entriesRecreate the pending_deliveries table with the Reset Table tool
Still broken?Check that your REST endpoint is accessible and your token is valid
				
					Pro tip: Use the in-game logs and WordPress logs to trace delivery behavior!
				
			

🛡️ Security Notice

  • The API is locked behind your secret token.

  • Deliveries marked as “delivered” are never sent again.

  • Everything is logged both in WordPress and Minecraft logs (per-day .log files).

🔖 Legal & Licensing

  • GPLv2 or later

  • Created with ❤️ by MrDinoCarlos for NoctiCraft

  • Join our Discord Community for support

🛠 Maintenance & Troubleshooting Guide

To ensure WooStoreLink runs smoothly and securely, follow these maintenance steps regularly:

🔁 1. Regenerate API Token (Optional)

If you suspect your token has been leaked or want to cycle it:

  • Go to WordPress Admin > MinecraftStoreLink > Settings

  • Click Regenerate Token

  • Update the new token in your Minecraft server’s config

				
					⚠ Make sure to restart the Minecraft server or reload the plugin after updating the token.
				
			

🧹 2. Flush WordPress Cache

If outdated delivery data (JSON) keeps being returned:

  • Go to Settings > MinecraftStoreLink

  • Click 🧹 Flush WordPress Cache

  • This clears any old JSON cached by your caching plugin (like LiteSpeed, WP Super Cache, etc.)

♻ 3. Rebuild the Delivery Table

If delivery data appears corrupted or you experience phantom/duplicate deliveries:

  • Click ♻ Rebuild Table

  • This deletes and recreates the pending_deliveries table with a clean structure.

⚠ Warning: This permanently deletes all current deliveries in the queue. Use only if strictly needed.

🔐 4. Check Table Structure

To ensure compatibility with the Minecraft plugin:

  • Click 🔍 View Table Structure

  • Confirm columns: id, order_id, player, item, amount, delivered, timestamp

🚫 Cache Plugin Compatibility

WooStoreLink uses the REST API to communicate between WordPress and your Minecraft server.

Some caching plugins may store outdated JSON results, causing repeated deliveries. To prevent this:

✅ Recommended: Exclude JSON Routes from Caching

In your caching plugin (e.g., LiteSpeed Cache, WP Rocket, WP Fastest Cache):

  1. Go to Page Optimization / Excludes / Do Not Cache URLs

  2. Add the following path to exclusions:

				
					/wp-json/minecraftstorelink/v1/*

				
			

This ensures delivery data is always fresh and not cached.

❓ Frequently Asked Questions (FAQ)

💬 Is WooStoreLink safe to use?

Yes! All communication is authenticated via secure API tokens. No credentials are exposed.


🎮 Does the plugin connect directly to Minecraft?

No. Minecraft connects to WordPress, requesting deliveries through the secure REST API.


📦 Why are deliveries duplicated or infinite?

This usually happens due to one of the following:

  • The delivery wasn’t marked as delivered (possibly a database issue).

  • Cached JSON responses (use Flush Cache).

  • Incorrect table structure (use Rebuild Table).


🔧 I see “delivered = 1” but items are still being given

Make sure the WordPress REST API is returning only undelivered data. Use the View JSON or test with /wp-json/minecraftstorelink/v1/pending?... in the browser and confirm only valid entries are returned.


🚨 Can I manually reset everything?

Yes:

  • Use Rebuild Table to reset the delivery database

  • Flush Cache to reset JSON output

  • Optionally Regenerate Token for a fresh API key

⚠️ Disclaimer

WooStoreLink is an independent plugin developed by MrDino for NoctiCraft and is not affiliated, endorsed, or associated with Mojang Studios, Microsoft, WooCommerce, or Automattic in any way.

All trademarks, brand names, and logos are the property of their respective owners.

This plugin is provided as-is, without warranty of any kind. We are not responsible for any misuse, abuse, or unintended consequences arising from the use of this plugin on your Minecraft server or WordPress site.

It is the server owner’s sole responsibility to ensure compliance with:

By using this plugin, you agree that NoctiCraft, the developers, and contributors shall not be held liable for any loss, data corruption, or actions taken against your platform due to improper configuration or usage.

Resumen de privacidad

Esta web utiliza cookies para que podamos ofrecerte la mejor experiencia de usuario posible. La información de las cookies se almacena en tu navegador y realiza funciones tales como reconocerte cuando vuelves a nuestra web o ayudar a nuestro equipo a comprender qué secciones de la web encuentras más interesantes y útiles.