Mivex — MV Shop

⚠️ No Vault or any economy plugins are required for this plugin to work.

A unique chest-based shop plugin that uses physical currency instead of virtual balances.

Mivex has no Vault, no economy plugins, and no /bal command. The currency is a real Minecraft item — Phantom Membrane — which players can carry with them, hand to other players, store in chests, or even lose.

Key Features

💰 Physical Currency

All calculations are done in Phantom Membranes. Currency is checked only by item type, not by its name.

Money can be:

• carried around;
• handed to other players;
• stored;
• lost, just like any other Minecraft item.

🛒 Sell and Buy Shops

Create:

• SELL shops (Selling)
• BUY shops (Buying) based on regular Minecraft chests.

Every shop has:

• its own stock of goods;
• its own supply of currency.

No virtual balances whatsoever.

📦 Double Chests

Mivex detects real double chests through the Minecraft API, not just "neighboring blocks." Place a second chest next to the shop — and it automatically becomes a DOUBLE SHOP with 54 slots instead of 27, no commands required. If a double chest later falls apart (one half broken, pushed by a piston, altered by a third-party plugin) — the shop safely switches to BROKEN status, and the contents of both halves are preserved without loss or duplication. Shops created before v1.5 continue to work as SINGLE SHOP and are never changed automatically in any way — the owner decides for themselves whether to recreate the shop to gain double chest support.

🔑 Physical Shop Key

Every shop is protected by a renamed Tripwire Hook.

The key (passphrase) is required for:

• editing the shop;
• restoring a BROKEN shop;
• deleting the shop.

Lost the key — lost access to the shop.

🟢 BROKEN Shop System

If a shop's chest is broken: the shop is not deleted; all goods are safely preserved; items don't drop on the ground; the shop switches to BROKEN status.

Restore it with the command: /cshop unbroken key[...]

🛡️ Safe Item Storage

Every BROKEN shop's inventory is automatically saved to a separate file.

This protects shops from:

• item duplication;
• accidental loss of goods;
• errors during restoration.

💾 Automatic Backups

Before every data save, Mivex automatically creates a backup copy (shops.backup.yml), so shop data can be recovered even if the main file gets corrupted.

📊 Shop Analytics

Owners can view full information about their shops.

• /cshop mylist

Shows: shop status; creation date; coordinates.

• /cshop stats

Shows: total earnings / spending; number of successful trades; last sale / purchase.

• /cshop history

Shows: history of successful operations; automatic merging of repeated purchases; item filtering support.

🔎 Item Filtering

Analytics commands support filtering.

Example: /cshop mylist OAK_DOOR

/cshop stats DIAMOND

/cshop history IRON_INGOT

⚡ Atomic Transactions

Every trade is fully validated before it's carried out.

If even one condition isn't met:

• not enough stock;
• not enough currency;
• no room in the inventory;
• the shop is in the wrong state; the entire operation is cancelled and nothing changes.

📋 Status System

Every shop has its own status.

Supported:

• ACTIVE
• BROKEN

You can check statuses with the command: /cshop mylist

⚙️ Configurable Blacklist

config.yml lets you easily block the use of any items.

For example:

• AIR
• BEDROCK
• Command Block
• and any other items.

👮 Admin Tools

Admins can:

• view all shops on the server;
• view a specific player's shops;
• manage shops as needed.

🎉 "First Trade" Event

When a player's shop completes its first real trade with another player (not with themselves), both the seller and the buyer receive a Phantom Membrane reward. The reward is tied to the player, not to an individual shop — so it's granted only once, no matter how many shops that player creates. If the owner is offline at the moment of the trade, the reward waits for them and is delivered automatically the next time they join the server. The event can be fully configured or disabled via config.yml, including the reward amount and a time-based limit.

✨ Improved Command Auto-Completion

All commands share a unified syntax and intelligent auto-completion. Players are only offered the arguments relevant to the current step of typing the command.

Commands:

• Create a sell shop:

/cshop sell key[TEXT] ITEM AMOUNT PRICE

• Create a buy shop:

/cshop buy key[TEXT] ITEM AMOUNT PRICE

• Edit a shop:

/cshop edit key[TEXT] sell|buy ITEM AMOUNT PRICE

• Delete an ACTIVE shop:

/cshop delete key[TEXT]

• Restore a BROKEN shop:

/cshop unbroken key[TEXT]

• View your shops:

/cshop mylist [ITEM]

• View shop statistics:

/cshop stats [ITEM]

• View trade history:

/cshop history [ITEM]

• View all shops (Admin):

/cshop list

• View a specific player's shops (Admin):

/cshop list

• Help:

/cshop help

• Plugin info:

/cshop about

Requirements:

Paper 1.19.4+

Java 17+

Philosophy

Mivex is built around real items, real inventories, and real risk. Instead of using virtual balances, the plugin leans as heavily as possible on Minecraft's own mechanics. Every membrane, every item, and every trade physically exists in the game world.

🗺️ Roadmap

The project is actively developed. Coming up next:

• 🌍 In-game message localization — all plugin messages (§c, §a, etc.) will support multiple languages: English, German, and French, selectable via config.yml
• 💎 Configurable currency — ability to switch the currency from Phantom Membrane to any other item via config.yml
• ⬆️ Paper 1.21.x support — extending compatibility to newer server versions

Got an idea or suggestion? Open an issue on GitHub — we're open to community feedback.

Mivex guarantees that all shop operations are safe, stable, and dupe-protected, while responsibility for keeping the key safe and securing one's own shop remains with the player.

ua Mivex — MV Shop

⚠️ Для роботи плагіна НЕ потрібні Vault або будь-які плагіни економіки.

Унікальний плагін магазинів на основі звичайних скринь, який використовує фізичну валюту замість віртуальних балансів.

У Mivex немає Vault, немає плагінів економіки і немає команди /bal. Валютою є реальний предмет Minecraft — Мембрана фантома, яку гравці можуть носити із собою, передавати іншим, зберігати у скринях або навіть втратити.

Основні можливості

💰 Фізична валюта

Усі розрахунки здійснюються Мембранами фантома. Валюта перевіряється лише за типом предмета, а не за його назвою.

Гроші можна:

• носити із собою;
• передавати іншим гравцям;
• зберігати;
• втрачати так само, як і будь-який інший предмет Minecraft.

🛒 Магазини продажу та покупки

Створюйте:

• SELL-магазини (Продаж)
• BUY-магазини (Покупка) на основі звичайних скринь Minecraft.

Кожен магазин має:

• власний запас товарів;
• власний запас валюти.

Жодних віртуальних балансів.

📦 Подвійні скрині (Double Chest)

Mivex розпізнає справжні подвійні скрині через API Minecraft, а не просто "сусідні блоки". Поставте другу скриню поруч із магазином — і він автоматично стане DOUBLE SHOP з 54 слотами замість 27, без жодних команд. Якщо подвійна скриня згодом розпадається (зламали одну половину, розсунули поршнем, змінили через сторонній плагін) — магазин безпечно переходить у статус BROKEN, а весь вміст обох половин зберігається без втрат чи дублювання. Старі магазини, створені до v1.5, продовжують працювати як SINGLE SHOP і жодним чином не змінюються автоматично — власник сам вирішує, чи перестворити магазин заради підтримки подвійних скринь.

🔑 Фізичний ключ магазину

Кожен магазин захищається перейменованим Tripwire Hook.

Ключ (кодове слово) потрібний для:

• редагування магазину;
• відновлення BROKEN-магазину;
• видалення магазину.

Втратили ключ — втратили доступ до магазину.

🟢 Система BROKEN-магазинів

Якщо скриню магазину зламали: магазин не видаляється; усі товари безпечно зберігаються; предмети не випадають на землю; магазин переходить у статус BROKEN.

Відновити його можна командою: /cshop unbroken key[...]

🛡️ Безпечне зберігання товарів

Інвентар кожного BROKEN-магазину автоматично зберігається в окремому файлі.

Це захищає магазини від:

• дублювання предметів;
• випадкової втрати товарів;
• помилок під час відновлення.

💾 Автоматичні резервні копії

Перед кожним збереженням даних Mivex автоматично створює резервну копію (shops.backup.yml), щоб дані магазинів можна було відновити навіть у разі пошкодження основного файлу.

📊 Аналітика магазинів

Власники можуть переглядати повну інформацію про свої магазини.

• /cshop mylist

Показує: статус магазину; дату створення; координати.

• /cshop stats

Показує: загальний заробіток / витрати; кількість успішних угод; останній продаж / покупку.

• /cshop history

Показує: історію успішних операцій; автоматичне об'єднання повторних покупок; підтримку фільтрації за предметом.

🔎 Фільтрація за предметом

Аналітичні команди підтримують фільтрацію.

Наприклад: /cshop mylist OAK_DOOR

/cshop stats DIAMOND

/cshop history IRON_INGOT

⚡ Атомарні транзакції

Кожна торгова операція повністю перевіряється перед виконанням.

Якщо хоча б одна умова не виконується:

• недостатньо товару;
• недостатньо валюти;
• немає місця в інвентарі;
• магазин перебуває у неправильному стані; операція повністю скасовується, а нічого не змінюється.

📋 Система статусів

Кожен магазин має власний статус.

Підтримуються:

• ACTIVE
• BROKEN

Переглянути статуси можна командою: /cshop mylist

⚙️ Налаштовуваний чорний список

Через config.yml можна легко заборонити використання будь-яких предметів.

Наприклад:

• AIR
• BEDROCK
• Command Block
• та будь-які інші предмети.

👮 Інструменти адміністратора

Адміністратори можуть:

• переглядати всі магазини сервера;
• переглядати магазини конкретного гравця;
• керувати магазинами за потреби.

🎉 Подія "Перша угода"

Коли магазин гравця вперше укладає реальну торгову угоду з іншим гравцем (не із самим собою), і продавець, і покупець отримують нагороду у Phantom Membrane. Нагорода прив'язана саме до гравця, а не до окремого магазину — тому вона видається лише один раз, скільки б магазинів гравець не створив. Якщо власник у момент угоди офлайн — нагорода чекає на нього і видається автоматично при наступному вході на сервер. Подію можна повністю налаштувати або вимкнути через config.yml, включно з розміром нагороди та обмеженням за часом дії.

✨ Покращене автодоповнення команд

Усі команди мають єдиний синтаксис та інтелектуальне автодоповнення. Гравцеві пропонуються лише ті аргументи, які потрібні на поточному етапі введення команди.

Команди:

• Створити магазин продажу :

/cshop sell key[TEXT] ITEM AMOUNT PRICE

• Створити магазин покупки :

/cshop buy key[TEXT] ITEM AMOUNT PRICE

• Редагувати магазин :

/cshop edit key[TEXT] sell|buy ITEM AMOUNT PRICE

• Видалити ACTIVE-магазин :

/cshop delete key[TEXT]

• Відновити BROKEN-магазин :

/cshop unbroken key[TEXT]

• Переглянути свої магазини :

/cshop mylist [ITEM]

• Переглянути статистику магазинів :

/cshop stats [ITEM]

• Переглянути історію операцій :

/cshop history [ITEM]

• Переглянути всі магазини (Адміністратор) :

/cshop list

• Переглянути магазини конкретного гравця (Адміністратор) :

/cshop list <гравець>

• Допомога :

/cshop help

• Інформація про плагін :

/cshop about

Вимоги:

Paper 1.19.4+

Java 17+

Філософія

Mivex побудований навколо реальних предметів, реальних інвентарів та реального ризику. Замість використання віртуальних балансів плагін максимально спирається на механіки Minecraft. Кожна мембрана, кожен предмет і кожна торгова операція фізично існують у світі гри.

🗺️ Плани на майбутнє

Проєкт активно розвивається. У найближчих планах:

• 🌍 Локалізація ігрових повідомлень — усі повідомлення плагіна (§c, §a тощо) стануть доступні кількома мовами: англійською, німецькою та французькою, з можливістю вибору мови сервера через config.yml
• 💎 Настроювана валюта — можливість змінити валюту з Phantom Membrane на будь-який інший предмет через config.yml
• ⬆️ Підтримка Paper 1.21.x — розширення сумісності на нові версії сервера

Маєш ідею чи пропозицію? Пиши issue на GitHub — ми відкриті до фідбеку від спільноти.

Mivex гарантує, що всі операції магазинів будуть безпечними, стабільними та захищеними від дюпів, тоді як відповідальність за збереження ключа та безпеку власного магазину залишається за самим гравцем.