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

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.