🛒 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.

👑 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

BellCoins

VIP Tokens

🔐 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

📸 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.