# 🛒✨ 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>
