# 🛒 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. ```text /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: ```text plugins/BellMarket/categories/ ``` Example: ```yaml 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: ```text /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 ```yaml 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 ```yaml 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. ```text /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: ```text 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: ```text /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.