BellMarket

!(https://cdn.modrinth.com/data/cached_images/009d56c2985dd43b73cd0c4ff1c7f6735d177cbc.jpeg)

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

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

```text /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:

```text /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

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

### BellCoins

| Command | Description | | ---------------------------- | --------------------- | | `/bc balance ` | View player's balance | | `/bc give ` | Give BellCoins | | `/bc take ` | Remove BellCoins | | `/bc set ` | Set balance