❄️ ColdShop

The Modern, Dual-Economy GUI Shop for 1.20+

Native support for Vault & CoinsEngine (Shards).
Sell Blocks, Items, Potions, and Commands!

❓ Why ColdShop?

ColdShop is a lightweight, high-performance shop solution designed for modern Survival, Skyblock, and Lifesteal servers.

Most shop plugins only handle one currency. ColdShop bridges the gap. You can sell standard items (like Dirt or Diamonds) using Money and premium items (like Crate Keys, Ranks, or Spawners) using Shards/Coins.

It features a "Crash-Proof" hook system—if you don't have CoinsEngine installed, the plugin automatically detects it and runs in "Safe Mode" without errors.

✨ Key Features

💎 Dual Economy Architecture

• Vault: For standard economy transactions.
• CoinsEngine: For premium/secondary currency transactions (Shards).

🛡️ Safe-Hook Technology

• Advanced reflection ensures the plugin never crashes if CoinsEngine is missing. It simply disables the Shard Shop feature while keeping the Main Shop running perfectly.

🧪 Advanced Item Support

• Sell complex items easily via config:
  • Potions (Drinkable, Splash, Lingering)
  • Tipped Arrows
  • Define effects, Level (II), and Duration (Extended).

🛒 Smart Buying Interface

• A sleek GUI that calculates prices instantly.
• Buttons for: Add 1, Add 10, Remove 1, Set to Max.
• Built-in Inventory Space and Balance checks.

⚡ Command Execution

• The Shard Shop isn't just for items. It can execute Console Commands when a player buys something.
• Perfect for selling Ranks, Crate Keys, Permissions, or Spawners.

🎨 Modern Design

• Full support for Hex Colors (e.g., <#00a4fc>) in titles, items, lore, and messages.
• Configurable sounds for clicking, purchasing, and errors.

🛑 Purchase Limits

• Prevent economy abuse by limiting stack sizes.
• Force players to buy Totems 1 at a time, but allow Stone in stacks of 64.

📂 Configuration Preview

The config is designed to be human-readable and easy to edit.

# Example: Selling a Custom Potion
potions:
  items:
    SPEED_II:
      material: POTION
      potion-type: SPEED
      upgraded: true    # Makes it Speed II
      slot: 10
      price: 200

# Example: Selling a Crate Key for Shards
shard-shop:
  items:
    epic-key:
      material: TRIPWIRE_HOOK
      name: "<#A303F9>Epic Key"
      price: 1000  # Cost in Shards
      command: "crate give %player% epic 1"
      slot: 2

📜 Commands & Permissions

📥 Dependencies

1. Java 17 or higher.
2. Spigot / Paper 1.20 or higher.
3. Vault (Required for economy).
4. CoinsEngine (Optional - Only required if you want the Shard Shop).

🆘 Support

If you have questions, found a bug, or need help configuring the plugin, please ask in the Discussion tab or join our support server.