🛒 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, and native SkinStudio integration.

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

---

✨ Highlights

• 🛒 Category-based item shop
• ✦ Built-in BellCoins economy
• 💎 VIP Token premium currency
• 🎨 Automatic SkinStudio integration
• ⚡ In-game price editor
• 🌍 English & Polish translations
• 📄 YAML-driven configuration
• 🚀 Designed for Paper & Purpur 1.21+

---

Why BellMarket?

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

✔ Built-in economy system

✔ Native SkinStudio support

✔ No Vault dependency

✔ In-game price editing

✔ Unlimited categories and products

✔ Fast YAML configuration

✔ Modern GUI designed for current Minecraft versions

---

🛍 Shop GUI

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

---

💰 Dual Currency System

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 or administrator grants and cannot be purchased with BellCoins. This keeps premium progression separate from the regular economy.

---

👑 VIP Access System

• 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

---

🎨 Native SkinStudio Integration

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

Features

• Automatic tier detection
• Automatic skin discovery
• Tier-based shop categories
• Automatic tier color detection
• 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.

---

⚡ In-Game Price Editor

Adjust prices without editing YAML files.

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

Additional tools:

• Shift-click to restore tier default pricing
• Changes apply after /bm reload
• No server restart required

---

📂 Manual Categories

Need full control?

Create a category file inside:

plugins/BellMarket/categories/

Example:

category:
  name: "&aWeapons"
  order: 100
  icon:
    material: DIAMOND_SWORD

products:
  my_sword:
    type: COMMAND
    name: "&aCustom Sword"
    price: 1000
    commands:
      - "give {player} diamond_sword 1"

Compatible with virtually any plugin that can grant rewards using console commands.

---

🌍 Languages

Included by default:

• English
• Polish

Switch language instantly:

/bm lang en
/bm lang pl

All messages are fully customizable.

---

📋 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	View balance
/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	View balance
/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: ✦
  format: '{symbol}{amount}'
  starting-balance: 0

shop:
  title: '&8✦ &6BellMarket &8✦'
  featured-category-id: '09_vip'
  premium-url: ''

providers:
  skinstudio:
    enabled: true
    default-price: 500
    include-change-token: false

---

🔧 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

---

🚧 BellMarket Pro (Coming Soon)

Planned features:

• MythicMobs integration
• EliteMobs integration
• FreeMinecraftModels integration
• Custom GUI themes
• Auction House
• Sales statistics
• Flash sales
• Discord webhooks
• MySQL support
• BellCenter web dashboard

---

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

🛒 BellMarket — Plugin Sklepu dla Minecraft 1.21+

autor: Bellzeb · Edycja Community · Część BellSuite

---

Nowoczesny i konfigurowalny plugin sklepu z wbudowaną ekonomią, obsługą dwóch walut, produktami VIP oraz natywną integracją ze SkinStudio.

Bez baz danych. Bez skomplikowanej konfiguracji. Instalujesz i korzystasz.

---

✨ Najważniejsze funkcje

• 🛒 Sklep oparty o kategorie
• ✦ Wbudowana ekonomia BellCoins
• 💎 Premium waluta VIP Tokens
• 🎨 Automatyczna integracja ze SkinStudio
• ⚡ Edytor cen dostępny w grze
• 🌍 Język polski i angielski
• 📄 Konfiguracja oparta o YAML
• 🚀 Stworzony dla Paper i Purpur 1.21+

---

Dlaczego BellMarket?

W przeciwieństwie do wielu pluginów sklepowych BellMarket stawia na prostotę i automatyzację.

✔ Wbudowany system ekonomii

✔ Natywna integracja ze SkinStudio

✔ Brak zależności od Vault

✔ Edycja cen bezpośrednio w grze

✔ Nielimitowane kategorie i produkty

✔ Szybka konfiguracja YAML

✔ Nowoczesny interfejs dla aktualnych wersji Minecrafta

---

🛍 Interfejs sklepu

• GUI 54-slotowe
• Ekran potwierdzenia zakupu
• Obsługa wielu stron
• Nielimitowana liczba produktów
• Wyróżniona kategoria w górnym pasku
• Własne ikony, nazwy i opisy kategorii
• Wbudowana nawigacja

---

💰 System dwóch walut

BellCoins

Podstawowa waluta ekonomiczna serwera.

VIP Tokens

Oddzielna waluta premium przeznaczona dla ekskluzywnych produktów.

VIP Tokens mogą być przyznawane przez administrację lub zdobywane poprzez subskrypcje. Nie można ich kupić za BellCoins, dzięki czemu ekonomia premium pozostaje całkowicie oddzielona.

---

👑 System VIP

• Kategorie VIP są widoczne dla wszystkich graczy
• Zakupy mogą wykonywać tylko gracze z uprawnieniem bellmarket.vip
• Konfigurowalna wiadomość o braku dostępu
• Operatorzy mają dostęp automatycznie
• Obsługa skrótu do kategorii VIP

---

🎨 Natywna integracja ze SkinStudio

BellMarket automatycznie odczytuje konfigurację SkinStudio i tworzy kategorie na podstawie tierów skinów.

Funkcje

• Automatyczne wykrywanie tierów
• Automatyczne wykrywanie skinów
• Kategorie generowane z tierów
• Automatyczne wykrywanie kolorów
• Domyślne ceny dla tierów
• Indywidualne ceny dla skinów
• Wykluczanie wybranych skinów
• Włączanie i wyłączanie tierów

Bez ręcznego rejestrowania przedmiotów.

---

⚡ Edytor cen w grze

Zmieniaj ceny bez edytowania plików YAML.

/bm prices
→ wybierz tier
→ wybierz skina
→ kliknij cenę
→ wpisz nową wartość
→ zapisano

Dodatkowe funkcje:

• Shift + klik przywraca cenę domyślną
• Zmiany aktywują się po /bm reload
• Restart serwera nie jest wymagany

---

📂 Własne kategorie

Pełna kontrola nad ofertą sklepu.

Utwórz plik w:

plugins/BellMarket/categories/

a kategoria automatycznie pojawi się w sklepie.

Obsługiwane są produkty oparte na komendach konsoli, dzięki czemu BellMarket współpracuje z praktycznie każdym pluginem.

---

🌍 Języki

Dostępne od razu po instalacji:

• Polski
• Angielski

Zmiana języka:

/bm lang pl
/bm lang en

Wszystkie komunikaty można dowolnie modyfikować.

---

🔧 Wymagania

Element	Wymaganie
Serwer	Paper / Purpur 1.21+
Java	21+
LuckPerms	Zalecany
SkinStudio	Opcjonalny

---

📸 Zrzuty ekranu

• Główny sklep
• Nawigacja kategorii
• Sekcja VIP
• Kategorie SkinStudio
• Edytor cen
• Panel administratora

---

🚧 BellMarket Pro (w przygotowaniu)

Planowane funkcje:

• Integracja z MythicMobs
• Integracja z EliteMobs
• Integracja z FreeMinecraftModels
• Własne motywy GUI
• Dom aukcyjny
• Statystyki sprzedaży
• Promocje czasowe
• Webhooki Discord
• Obsługa MySQL
• Panel WWW BellCenter

---

Tworzony i rozwijany przez Bellzeb jako część ekosystemu BellSuite.