BellMarket

# 🛒✨ BellMarket — Admin-Powered Server Shop

### *A polished, dual-currency server store that puts admins in full control.*


---

## 📖 Overview

**BellMarket** is a server-side shop system where administrators define exactly what's available for purchase. Unlike player-driven markets, BellMarket gives you complete control over your server's economy with a professionally designed storefront.

Featuring dual currency support (in-game money + premium tokens), categorized product browsing, and an extensible provider system — BellMarket is everything you need for a clean, controlled server shop.

---

## ✨ Features

🏪 **Admin-Defined Product Catalog**
- Full control over what's sold and at what price
- Create, edit, and remove products through commands or GUI
- Organize products into categories for easy browsing

💎 **Dual Currency System**
- Regular in-game money via Vault
- Premium token currency for exclusive items
- Mix and match — some items can cost both currencies

🖥️ **Categorized GUI Browser**
- Clean, intuitive category-based shop interface
- Players browse categories and click to purchase
- Purchase confirmation with item preview

🧩 **Extensible Provider System**
- Custom product providers for non-standard items
- Supports commands, items, permissions, and more
- API for developers to add custom product types

📦 **Stock & Limit Control**
- Set stock limits per product
- Per-player purchase limits (daily/weekly/total)
- Automatic restocking on configurable intervals

🔒 **Permission-Based Visibility**
- Show/hide products based on player permissions
- Create VIP-exclusive shop sections
- Group-based pricing tiers (via BellLP)

🔌 **Pro Extension Points**
- `setProFeatures` and `setTitleTransformer` hooks
- Designed for seamless BellMarket-Pro integration
- Clean API for addon development

🌍 **Multi-Language**
- Built-in English and Polish translations
- Fully customizable message files

---

## 📋 Dependencies

| Plugin | Type | Notes |
|--------|------|-------|
| **Vault** | ⚠️ Required | Economy API bridge |
| Economy Plugin | ⚠️ Required | e.g. EssentialsX Economy |
| BellLP | 📌 Optional | Group-based pricing and access |

---

## 💻 Commands

| Command | Description |
|---------|-------------|
| `/shop` | Open the server shop GUI |
| `/buy <product> [amount]` | Quick-buy a product by name |
| `/bellmarket admin` | Open admin product management |
| `/bellmarket reload` | Reload plugin configuration |
| `/bellmarket create` | Create a new product |
| `/bellmarket delete <id>` | Remove a product |
| `/bellmarket setprice <id> <price>` | Set product price |
| `/bellmarket setstock <id> <amount>` | Set product stock |

---

## 🔐 Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| `bellmarket.shop` | Access the server shop | `true` |
| `bellmarket.buy` | Purchase items from the shop | `true` |
| `bellmarket.admin` | Admin management commands | `op` |
| `bellmarket.manage` | Product creation and editing | `op` |
| `bellmarket.bypass.cost` | Bypass costs (free purchases) | `op` |
| `bellmarket.category.<name>` | Access specific categories | `true` |
| `bellmarket.product.<id>` | Access specific products | `true` |

> **~14 total permissions** provide granular control over every aspect of the shop system.

---

## ⚙️ Configuration Highlights

```yaml
# config.yml — Key settings

shop:
  title: "&6&lServer Shop"
  rows: 6
  currency:
    primary: vault
    premium:
      enabled: true
      name: "Tokens"
      symbol: "⛃"

products:
  confirm-purchase: true
  show-price-in-lore: true

stock:
  auto-restock: true
  restock-interval: 24h

language: en
```

> Products are defined in a separate `products.yml` file with full support for categories, pricing, stock, and display customization.

---

## 📦 Product Definition Example

```yaml
products:
  diamond_kit:
    display-name: "&b💎 Diamond Starter Kit"
    material: DIAMOND
    category: kits
    price:
      vault: 5000
      tokens: 0
    stock: -1
    limit-per-player: 1
    permission: ""
    commands:
      - "give %player% diamond 16"
      - "give %player% diamond_pickaxe 1"
```

---

## 🚀 BellMarket-Pro — Premium Addon

Supercharge your server shop with **BellMarket-Pro**:

https://bellforge.pl/en/pluginy/bellmarket-pro/

| Feature | Description |
|---------|-------------|
| 🏷️ **Pro Product Providers** | Enhanced product types with advanced options and custom behaviors |
| ⚡ **Flash Sale System** | Timed discounts that create urgency and drive purchases |
| 📊 **Purchase Statistics** | Track what sells, when, and to whom — full analytics dashboard |
| 🎨 **Custom GUI Backgrounds** | Branded shop interfaces with custom textures and layouts |
| 🔔 **Discord Notifications** | Automatic Discord webhooks on purchases and stock events |

> *BellMarket-Pro is a separate premium addon. Drop it alongside BellMarket — automatic detection, zero extra setup.*

---

## 📸 Screenshots

*Coming soon — shop GUI, category browser, admin panel, and purchase confirmation.*

---

## 🔧 Installation

1. Download **BellMarket** and place it in your `plugins/` folder
2. Ensure **Vault** and an economy plugin are installed
3. Restart your server
4. Configure products in `plugins/BellMarket/products.yml`
5. Customize settings in `plugins/BellMarket/config.yml`
6. `/bellmarket reload` — your shop is live!

---

## 🆘 Support

- **Issues & Bugs:** [GitHub Issues](#)
- **Discord:** [https://discord.gg/6q7bnSYaR](#)
- **Wiki:** [Documentation](#)

---

## 📜 Changelog

See [CHANGELOG.md](#) for full version history.

---

<p align="center">
  <b>BellMarket</b> — Your server. Your shop. Your rules.<br>
  <i>Made with ❤️ for the Minecraft community.</i>
</p>