!BellMarket

---

🛒 BellMarket

Shop Plugin for Minecraft 1.21+

by Bellzeb · Community Edition · Part of BellSuite

---

A modern, configurable shop plugin with built-in economy, dual-currency support, VIP-exclusive products, automatic SkinStudio integration, and a powerful Provider API.

No databases. No complicated setup. Just drop it in and start selling.

---

💬 Community

Need help, want to report a bug or suggest a feature?

Discord: https://discord.gg/3V5beq8eAF

---

✨ Highlights

• 🛒 Category-based item shop
• 💰 Dual Currency (BellCoins + VIP Tokens)
• ⚡ In-Game Price Editor (No YAML Editing)
• 🎨 Auto-Detection of SkinStudio Skins & Tiers
• 🌍 EN/PL Localization with MERGE Updates
• 🔌 Provider API for External Plugins
• 🚫 No Vault Dependency
• 🆓 Free Core + Planned Pro Addon
• 🚀 Designed for Paper & Purpur 1.21+

---

Why BellMarket?

Unlike most shop plugins, BellMarket focuses on simplicity, automation, and extensibility.

✔ Built-in economy system

✔ Dual-currency support

✔ Native SkinStudio integration

✔ No Vault dependency

✔ In-game price editing

✔ Unlimited categories and products

✔ Provider API for custom integrations

✔ Localization that survives updates

✔ Modern GUI designed for current Minecraft versions

---

🛍 Shop

• 54-slot inventory interface
• Purchase confirmation screen
• Multi-page category support
• Unlimited products per category
• Featured category shortcut
• Custom icons, names and lore
• Built-in navigation controls

The featured category can be pinned directly to the top bar, making premium or seasonal content easily accessible.

---

💰 Currencies

BellCoins

The primary server currency used for standard purchases.

VIP Tokens

A separate premium currency intended for exclusive content.

VIP Tokens are earned through subscriptions, donations, external services, or administrator grants and remain completely separate from the regular economy.

Currency	Purpose
BellCoins	Standard purchases
VIP Tokens	Premium & VIP content

---

👑 VIP

• VIP categories remain visible to all players
• Only players with bellmarket.vip may purchase VIP products
• Configurable access-denied message
• Operators always have access
• Featured VIP shortcut supported
• Separate premium economy using VIP Tokens

---

🎨 SkinStudio

BellMarket automatically reads your SkinStudio configuration and creates shop categories from skin tiers.

Features

• Automatic tier detection
• Automatic skin discovery
• Automatic tier color detection
• Automatic display-name detection
• Tier-based shop categories
• Default tier pricing
• Per-skin price overrides
• Skin exclusions
• Tier enable/disable support

No manual item registration required.

Simply install BellMarket, generate categories, and your SkinStudio content is ready to sell.

---

⚡ Price Editor

Adjust prices without editing YAML files.

/bm prices
→ select tier
→ select skin
→ click current price
→ enter new value
→ saved

Additional tools:

• Edit SkinStudio tier pricing
• Edit individual skin pricing
• Edit manual category products
• Supports BellCoins and VIP Tokens
• Shift-click to restore tier default pricing
• Changes apply after /bm reload
• No server restart required

---

🔌 Provider API

BellMarket can be extended by external plugins.

Register custom providers and automatically generate shop categories from your own content.

Included

• BellMarketAPI
• ProductProvider
• ProductProviderRegistry
• Purchase Events
• Reload Events
• VIP Token Events

Perfect for custom ecosystems, RPG servers, premium content packs, and server networks.

---

🌍 Localization

Included by default:

• English
• Polish

Switch language instantly:

/bm lang en
/bm lang pl

BellMarket uses a MERGE localization system.

When updating the plugin, new translations are automatically added while preserving all custom modifications.

No more overwritten language files.

---

📋 Commands

Shop

Command	Description
/bm	Open shop
/bm admin	Open admin panel
/bm reload	Reload configuration
/bm prices	Open price editor
/bm lang <en|pl>	Change language
/bm generate	Re-scan SkinStudio content

BellCoins

Command	Description
/bc balance [player]	View player's balance
/bc give <player> <amount>	Give BellCoins
/bc take <player> <amount>	Remove BellCoins
/bc set <player> <amount>	Set balance
/bc top	View leaderboard

VIP Tokens

Command	Description
/vt balance [player]	View player's balance
/vt give <player> <amount>	Grant VIP Tokens
/vt take <player> <amount>	Remove VIP Tokens
/vt set <player> <amount>	Set balance
/vt top	View leaderboard

---

🔐 Permissions

bellmarket.shop
bellmarket.admin
bellmarket.vip

bellmarket.coins.balance
bellmarket.coins.balance.others
bellmarket.coins.give
bellmarket.coins.take
bellmarket.coins.set
bellmarket.coins.top

bellmarket.viptoken.balance
bellmarket.viptoken.balance.others
bellmarket.viptoken.admin
bellmarket.viptoken.top

---

⚙ Configuration

language: en

currency:
  name: BellCoins
  symbol: ✦

shop:
  featured-category-id: "01_vip"

providers:
  skinstudio:
    enabled: true
    default-price: 500

---

🔧 Requirements

Component	Requirement
Server	Paper / Purpur 1.21+
Java	21+
LuckPerms	Recommended
SkinStudio	Optional

---

📸 Screenshots

• Main Shop
• Category Navigation
• VIP Section
• SkinStudio Categories
• Price Editor
• Admin Panel

---

🚧 Pro Addon

BellMarket Core will remain free.

Advanced functionality will be released through a separate BellMarket Pro addon.

Planned features:

• Auction House
• Sales Statistics
• Flash Sales
• Discord Webhooks
• Wishlists
• Price Alerts
• MySQL Replication
• Multi-Server Support
• Advanced Analytics
• BellCenter Web Dashboard

---

💬 Support

Discord: https://discord.gg/3V5beq8eAF

---

Developed and maintained by Bellzeb as part of the BellSuite ecosystem.

---