# MineCommerce<\/p>\n
**Tebex-like self-hosted shop plugin for Paper 1.21** \u2014 sell ranks, items, and packages directly through your **WooCommerce** or **Shopify** store with **Stripe** payments, without high fees or third-party lock-in.<\/p>\n
MineCommerce connects your store and your Minecraft server:<\/p>\n
* Players buy on your store (WooCommerce\/Shopify + Stripe).
\n* Webhooks trigger fulfillment in-game.
\n* Deliverables: items, ranks (LuckPerms), currency (Vault), or custom commands.<\/p>\n
—<\/p>\n
## Features<\/p>\n
* **WooCommerce + Shopify support** ---<\/p>\n ## Installation<\/p>\n 1. Download the latest **MineCommerce.jar**. * `config.yml` ---<\/p>\n ## Configuration<\/p>\n ### `config.yml`<\/p>\n ```yaml delivery: link: security: database: woocommerce: shopify: sync: ---<\/p>\n ### `mappings.yml`<\/p>\n Link SKUs from WooCommerce\/Shopify \u2192 in-game actions.<\/p>\n ```yaml categories: Actions supported: `command`, `permission_group`, `currency`, `item`. ---<\/p>\n ## Sync & Webhooks<\/p>\n ### Manual Sync<\/p>\n ``` * Fetches products & categories ### Scheduled Sync<\/p>\n Configured via:<\/p>\n ```yaml ### Webhooks<\/p>\n * Endpoint: `POST http:\/\/ ---<\/p>\n ### Shopify Delta<\/p>\n * Endpoint: `\/api\/v1\/webhooks\/shopify` ```json ### WooCommerce Delta<\/p>\n * Endpoint: `\/api\/v1\/webhooks\/woocommerce` ```json ---<\/p>\n ## Commands<\/p>\n | Command | Permission | Description | ---<\/p>\n ## Security<\/p>\n * HMAC-signed webhook verification ---<\/p>\n ## Example Flow<\/p>\n 1. Player buys **VIP (30 days)** on WooCommerce\/Shopify. * Add LuckPerms group `vip` (30d expiry). ---<\/p>\n ## Troubleshooting<\/p>\n * **No products found:** check API credentials and published products. ---<\/p>\n ## Roadmap<\/p>\n * [x] SQLite support ---<\/p>\n ## Soft Dependencies<\/p>\n * **LuckPerms** \u2014 ranks\/permissions ---<\/p>\n ## Support<\/p>\n * Issues & feature requests: GitHub tracker WooCommerce & Shopify Integration for Minecraft Servers<\/p>\n","protected":false},"featured_media":101567,"template":"","meta":{"_minecraft_slug":"minecommerce","_minecraft_project_id":"sMTWuf35","_minecraft_author":"Bobcat","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":80,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"minecommerce.zip","_minecraft_size_bytes":19854557,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:12:07.640890Z","_minecraft_date_created":"2025-09-04T01:21:42.929249Z","_minecraft_date_modified":"2025-09-01T18:13:39.152079Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/minecommerce","_minecraft_icon_attachment_id":101567,"_minecraft_imported_at":"2026-06-05T20:06:30+00:00","_minecraft_import_hash":"75ff7d13a19857ba234ca71845f507ad","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,873,126,127,92],"mod_loader":[132],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-101566","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-library","mod_category-management","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n* **SQLite (default), MySQL, Postgres** database support
\n* **Account linking** (`\/minecommerce link `)
\n* **Order fulfillment** (commands, items, ranks, currency)
\n* **Refunds & revokes** with audit logging
\n* **Retry queue** with persistence across restarts
\n* **Bedrock UI support** (via Floodgate + Geyser)
\n* **Store GUI** with categories and product images
\n* **Scheduled sync** or **real-time webhooks**
\n* **Configurable mappings** (`mappings.yml`)
\n* **JSON logs + REST API** for monitoring
\n* **Secure webhook verification** (HMAC)<\/p>\n
\n2. Drop into your server\u2019s `plugins\/` folder.
\n3. Restart the server to generate configs:<\/p>\n
\n * `mappings.yml`
\n * `minecommerce.db` (if SQLite)<\/p>\n
\nserver:
\n http_enabled: true
\n http_port: 8443
\n webhook_secret: \"CHANGE_ME\"
\n store_url: \"https:\/\/example.com\/store\"
\n platform: woocommerce # generic|woocommerce|shopify
\n link_template: \"\"<\/p>\n
\n retry_attempts: 5
\n retry_backoff_seconds: 60<\/p>\n
\n code_length: 6
\n code_ttl_seconds: 900<\/p>\n
\n verify_ssl: true
\n max_webhook_age_seconds: 600<\/p>\n
\n type: sqlite
\n sqlite:
\n path: minecommerce.db
\n mysql:
\n host: 127.0.0.1
\n port: 3306
\n user: minecommerce
\n password: secret_password
\n database: minecommerce
\n ssl: true
\n postgres:
\n host: 127.0.0.1
\n port: 5432
\n user: minecommerce
\n password: secret_password
\n database: minecommerce
\n ssl: true<\/p>\n
\n base_url: \"https:\/\/yourstore.example\"
\n consumer_key: \"ck_...\"
\n consumer_secret: \"cs_...\"<\/p>\n
\n shop: \"your-shop\"
\n api_version: \"2024-07\"
\n access_token: \"shpat_...\"<\/p>\n
\n enabled: true
\n schedule_minutes: 60
\n mode: write_mappings
\n image_as_button: true
\n```<\/p>\n
\nproducts:
\n vip_30d:
\n name: \"VIP Rank (30 days)\"
\n icon: \"EMERALD\"
\n price: 9.99
\n description: \"30 days of VIP access\"
\n product_id: \"123\" # WooCommerce product ID
\n variant_id: \"45678901\" # Shopify variant ID
\n actions:
\n - type: permission_group
\n group: vip
\n duration_days: 30
\n - type: command
\n command: \"say {player} is now a VIP!\"
\n - type: currency
\n amount: 1000<\/p>\n
\n featured:
\n name: \"Featured\"
\n icon: \"GOLD_INGOT\"
\n description: \"Top picks\"
\n skus:
\n - vip_30d
\n```<\/p>\n
\nPlaceholders: `{player}`, `{uuid}`, `{order_id}`, `{sku}`.<\/p>\n
\n\/minecommerce admin sync
\n```<\/p>\n
\n* Rewrites `mappings.yml`
\n* Updates images, SKUs, variants<\/p>\n
\nsync:
\n enabled: true
\n schedule_minutes: 60
\n```<\/p>\n
\n* Secure via `X-Timestamp` + `X-Signature` (HMAC SHA256 with `webhook_secret`)<\/p>\n
\n* Example payload:<\/p>\n
\n{ \"id\": 9876543210 }
\n```<\/p>\n
\n* Example payload:<\/p>\n
\n{ \"resource\": \"product\", \"id\": 12345 }
\n```<\/p>\n
\n| ---------------------------------- | -------------------- | ---------------------------------------- |
\n| `\/store` | `minecommerce.store` | Open in-game store GUI \/ send store link |
\n| `\/minecommerce link ` | \u2014 | Link player to store account |
\n| `\/minecommerce status` | \u2014 | Check order status |
\n| `\/minecommerce admin sync` | `minecommerce.admin` | Run manual sync |
\n| `\/minecommerce admin deliver
\n| `\/minecommerce admin revoke
\n| `\/minecommerce admin reload` | `minecommerce.admin` | Reload config |<\/p>\n
\n* Timestamp validation (`max_webhook_age_seconds`)
\n* Idempotent deliveries (no duplication)
\n* No card data stored (handled by Stripe)<\/p>\n
\n2. Store \u2192 Stripe \u2192 order completed.
\n3. Webhook \u2192 MineCommerce plugin.
\n4. Plugin looks up SKU \u2192 runs mapped actions:<\/p>\n
\n * Give 1000 Vault currency.
\n * Run custom server command.
\n5. Delivery logged; retries if failure.<\/p>\n
\n* **Images not showing:** enable `image_as_button: true` and confirm product has images.
\n* **Webhook 401 errors:** re-check signature generation and webhook secret.
\n* **SQLite locking:** migrate to MySQL\/Postgres for production.<\/p>\n
\n* [x] MySQL\/Postgres support
\n* [x] LuckPerms & Vault integration
\n* [x] REST API (`\/api\/v1\/orders`, `\/api\/v1\/refunds`, `\/api\/v1\/health`)
\n* [x] Refunds\/revokes<\/p>\n
\n* **Vault** \u2014 economy integration
\n* **Floodgate + Geyser** \u2014 Bedrock UI with images<\/p>\n
\n* Logs: `plugins\/MineCommerce\/logs\/`
\n* Configs: `config.yml`, `mappings.yml` (remove secrets)<\/p>\n","protected":false},"excerpt":{"rendered":"