DirtCryptoStore Premium Documentation

DirtCryptoStore Premium is a multi-crypto Minecraft store plugin that allows players to purchase in-game products using cryptocurrency. Players can open the store with /cryptostore, choose a currency, select a product, scan a QR invoice, send payment, and receive rewards after confirmation.

Requirements

• Paper 1.21.x
• Java 21-25
• A crypto wallet address for each currency you enable
• Internet access for crypto price lookups and automatic BTC/LTC payment detection

Installation

1. Place the DirtCryptoStore Premium jar inside your server's plugins folder.
2. Start the server once to generate the config files.
3. Open plugins/DirtCryptoStorePremium/config.yml.
4. Configure your currencies, wallets, and products.
5. Restart the server or run /cryptostore reload.

Commands

• /cryptostore - Opens the crypto store
• /cstore - Alias for /cryptostore
• /cryptostore status - Shows the player's current pending invoice
• /cryptostore reload - Reloads the config
• /cryptostore review - Shows invoices that need manual review
• /cryptostore forceconfirm <invoiceId> - Manually confirms an invoice
• /cryptostore cancelinvoice <invoiceId> - Cancels an invoice

Permissions

• dirtcryptostore.use - Allows players to use the store. Default: true
• dirtcryptostore.admin - Allows admin commands. Default: op
• dirtcryptostore.bypass - Reserved for future use. Default: op

Payment Flow

1. Player runs /cryptostore.
2. Player chooses Bitcoin, Litecoin, or Monero.
3. Player selects a product.
4. The plugin creates an invoice.
5. A QR map is placed in the player's off-hand.
6. The player sends the exact crypto amount shown.
7. The plugin detects or reviews the payment.
8. After confirmation, the configured reward commands run.

Currency Setup

Each currency has its own wallets and products.

currencies:
  bitcoin:
    enabled: true
    display-name: "&6Bitcoin"
    symbol: "BTC"
    decimals: 8
    material: "GOLD_INGOT"
    slot: 11
    uri-scheme: "bitcoin"
    price-provider-id: "bitcoin"
    explorer-type: "BTC"
    payment-detection: "API"
    min-confirmations: 2
    default-wallet: "default"

Wallet Setup

Wallets are configured inside each currency.

wallets:
  default:
    enabled: true
    display-name: "&6Bitcoin Wallet"
    coin: "BTC"
    address: "YOUR_WALLET_ADDRESS"
    explorer-type: "BTC"
    min-confirmations: 2
    allow-products: ["vip", "mvp"]

Product Setup

Products are configured inside each currency.

products:
  vip:
    enabled: true
    display-name: "&aVIP Rank"
    material: "EMERALD"
    slot: 11
    wallet: "default"
    price-usd: 4.99
    base-amount: 15000
    permission-required: ""
    purchasable-once: false
    commands:
      - "lp user %player% parent add vip"
    lore:
      - "&7Buy VIP with %currency%."
      - "&7Price: &a$%price_usd%"
      - "&7Click to create an invoice."

Reward Command Placeholders

• %player% - Player name
• %uuid% - Player UUID
• %product% - Product ID
• %currency% - Currency ID
• %coin% - Currency ID
• %wallet% - Wallet ID
• %txid% - Transaction ID
• %confirmations% - Confirmation count

QR Map Behavior

• The QR invoice map is placed in the player's off-hand.
• If the player already has an off-hand item, it is moved into their inventory first.
• If their inventory is full, the player is told to make space.
• The QR map stays locked until the invoice is paid, cancelled, or expired.

Monero Automation

Monero uses manual review by default. Advanced server owners can optionally enable self-hosted XMR automation with monero-wallet-rpc.

automation:
  monero:
    enabled: false
    wallet-rpc:
      url: "http://127.0.0.1:18088/json_rpc"
      username: ""
      password: ""
      account-index: 0
    sweep:
      enabled: false
      destination-address: ""
      minimum-usd: 50.0

Colors

DirtCryptoStore Premium supports classic Minecraft color codes and hex colors.

&aGreen text
&6Gold text
#ff9900 Hex color
&#ff9900 Hex color
<#ff9900> Hex color

Storage

Invoices are stored using SQLite.

plugins/DirtCryptoStorePremium/dirtcryptostore-premium.db

Important Notes

• Players must send the exact amount shown on the invoice.
• Bitcoin and Litecoin support automatic API lookup.
• Monero is manual review by default.
• Use purchasable-once: true for one-time purchases.
• Use /cryptostore review to view invoices needing staff review.
• Use /cryptostore reload after editing the config.

End of documentation.