ВЕРСИИ (7)

## Mivex v1.5 — Double Chest Support ### New - Full support for double chests (DOUBLE SHOP, 54 slots) - Automatic expansion SINGLE → DOUBLE when installing a second chest (only for new shops) - True Double Chest validation via Paper API, not "neighboring block" - Backwards compatibility with old shops (format-version), one-time warning about deprecated format - "First Trade" event — reward for first trade is tied to the player, not to a specific shop, with a queue for offline owners ### Critical fixes (audit) - Fixed possible duplication/loss of items when going to BROKEN - BROKEN is now atomic: container is cleared only after a confirmed save file - Fixed inventory size discrepancy (27 vs 54) when restoring SINGLE-shops - Added checking for free space in the shop before transaction - Currency/goods removal now happens strictly by Material, not by item similarity (isSimilar) - /cshop unbroken now correctly finds shop through any half of Double Chest ****ua**## Mivex v1.5 — Double Chest Support** ### Нове - Повна підтримка подвійних скринь (DOUBLE SHOP, 54 слоти) - Автоматичне розширення SINGLE → DOUBLE при встановленні другої скрині (тільки для нових магазинів) - Справжня перевірка Double Chest через Paper API, а не "сусідній блок" - Зворотна сумісність зі старими магазинами (format-version), одноразове попередження про застарілий формат - Подія "Перша угода" — нагорода за першу торгівлю прив'язана до гравця, а не до конкретного магазину, з чергою для офлайн-власників ### Критичні виправлення (аудит) - Усунено можливе дублювання/втрату предметів при переході в BROKEN - BROKEN тепер атомарний: контейнер очищається лише після підтвердженого збереження файлу - Виправлено невідповідність розміру інвентарю (27 vs 54) при відновленні SINGLE-магазинів - Додано перевірку вільного місця в магазині перед транзакцією - Видалення валюти/товару тепер відбувається строго за Material, а не за схожістю предметів (isSimilar) - /cshop unbroken тепер коректно знаходить магазин через будь-яку половину Double Chest

## Event System Mivex now supports server events. The first available event is **First Trade**. ### First Trade When a player creates their first shop and successfully sells an item to **another player**, both players receive a configurable Phantom Membrane reward. The event can be fully configured: - Enable or disable the event. - Configure the reward amount. - Set a duration in hours. - Disable the time limit by setting `duration-hours: 0`. Events automatically stop after the configured duration has expired. This update introduces the foundation for future Mivex events. **Setup instructions**: ```yaml events: enabled: true duration-hours: 0 first-trade: enabled: true reward: 5 ``` ### Configuration - `enabled` — Enables or disables the entire event system. - `duration-hours` — Sets how long events remain active. #### `duration-hours` - `0` = No time limit. The event will remain active until `enabled` is set to `false`. - Any value greater than `0` = The event will automatically end after the specified number of hours **from the first plugin startup**, regardless of the `enabled` value. Example: ```yaml duration-hours: 72 ``` The event will automatically end **72 hours after the plugin is started for the first time**. **ua**Українською ## Система подій Mivex тепер підтримує події сервера. Перша доступна подія - **Перша торгівля**. ### Перша торгівля Коли гравець створює свій перший магазин та успішно продає предмет **іншому гравцеві**, обидва гравці отримують налаштовану винагороду у вигляді Фантомної мембрани. Подію можна повністю налаштувати: - Увімкнути або вимкнути подію. - Налаштувати суму винагороди. - Встановити тривалість у годинах. - Вимкнути обмеження часу, встановивши `duration-hours: 0`. Події автоматично зупиняються після закінчення налаштованої тривалості. Це оновлення закладає основу для майбутніх подій Mivex. **Інструкції з налаштування**: ```yaml events: enabled: true duration-hours: 0 first-trade: enabled: true reward: 5 ``` ### Конфігурація - `enabled` — Вмикає або вимикає всю систему подій. - `duration-hours` — Встановлює, як довго події залишаються активними. #### `duration-hours` - `0` = Без обмежень за часом. Подія залишатиметься активною, доки для `enabled` не буде встановлено значення `false`. - Будь-яке значення більше за `0` = Подія автоматично завершиться через зазначену кількість годин **з моменту першого запуску плагіна**, незалежно від значення `enabled`. Приклад: ```yaml duration-hours: 72 ``` Подія автоматично завершиться **через **72 години після першого запуску плагіна**.

📊 Mivex v1.4 — Shop Analytics Version 1.4 introduces a complete shop analytics system, giving shop owners detailed insights into their businesses without changing the existing trading mechanics. 📋 Improved /cshop mylist The shop list is now much more informative. Each shop displays: Shop status (ACTIVE / BROKEN) Creation date Coordinates The command also supports item filtering: /cshop mylist [ITEM] 📊 New /cshop stats A brand-new statistics command has been added. For SELL shops, it displays: Total earnings Total completed sales Last sale For BUY shops, it displays: Total spent Total completed purchases Last purchase Item filtering is also supported: /cshop stats [ITEM] 📜 New /cshop history A complete transaction history has been added. Only successful purchases and sales are recorded. Example: 26.07 18:42 Mivish bought 64 Oak Doors for 8 Membranes Repeated consecutive transactions are automatically grouped: Mivish bought 64 Oak Doors for 8 Membranes ×3 History also supports item filtering: /cshop history [ITEM] 🔎 Unified Command Syntax All analytics commands now use the same structure: /cshop mylist [ITEM] /cshop stats [ITEM] /cshop history [ITEM] If no item is specified, information for all of your shops will be displayed. 📁 Dedicated History Storage Each shop now stores its own transaction history separately. The maximum number of stored records can be configured in config.yml, allowing server owners to choose how much history to keep. ⚡ Optimized Performance The analytics system is designed to remain lightweight. Shop history and statistics are loaded only when a related command is executed, avoiding unnecessary memory usage and keeping the plugin fast even on servers with many shops. 🎯 Result Version 1.4 makes managing large numbers of shops significantly easier by providing clear statistics and transaction history while staying true to Mivex's core philosophy: Lightweight Reliable High performance Physical item-based economy No Vault dependency **ua**📊 Mivex v1.4 — Shop Analytics Версія v1.4 додає повноцінну систему аналітики магазинів, яка допомагає власникам відстежувати роботу своїх торгових точок без зміни існуючої механіки торгівлі. 📋 Покращена команда /cshop mylist Команда стала значно інформативнішою. Для кожного магазину тепер відображаються: Статус магазину (ACTIVE / BROKEN) Дата створення Координати Також підтримується фільтрація за предметом: /cshop mylist [ITEM] 📊 Нова команда /cshop stats Додано нову команду статистики магазинів. Для SELL-магазинів відображається: Загальний заробіток Кількість успішних продажів Час останнього продажу Для BUY-магазинів: Загальна кількість витрачених мембран Кількість успішних покупок Час останньої покупки Також підтримується фільтрація за предметом: /cshop stats [ITEM] 📜 Нова команда /cshop history Додано журнал торгових операцій. У ньому зберігаються лише успішні покупки та продажі. Приклад: 26.07 18:42 Mivish купив 64 Oak Door за 8 мембран Повторні однакові операції автоматично об'єднуються: Mivish купив 64 Oak Door за 8 мембран ×3 Також підтримується фільтрація: /cshop history [ITEM] 🔎 Єдиний синтаксис команд Усі аналітичні команди використовують однакову структуру: /cshop mylist [ITEM] /cshop stats [ITEM] /cshop history [ITEM] Якщо предмет не вказано — відображається інформація про всі ваші магазини. 📁 Окреме зберігання історії Історія кожного магазину тепер зберігається окремо. Максимальна кількість записів налаштовується через config.yml, що дозволяє адміністраторам серверів самостійно визначати розмір журналу. ⚡ Оптимізована продуктивність Система аналітики не навантажує сервер. Історія та статистика завантажуються лише під час виконання відповідної команди, без постійного використання оперативної пам'яті. 🎯 Результат Версія v1.4 значно спрощує керування великою кількістю магазинів та надає власникам повну інформацію про їхню діяльність, залишаючись при цьому легкою, швидкою та повністю сумісною з основною концепцією Mivex — фізичною економікою без Vault.

Mivex v1.3 — Broken Shop System & Command Update ✨ Highlights Version 1.3 is the biggest update since Mivex was created. This release introduces a completely redesigned Broken Shop System, greatly improves inventory safety, and unifies the syntax of every command for a cleaner and more intuitive experience. 🛠️ New Broken Shop System The old system has been completely replaced. When a shop chest is destroyed: the shop is not deleted; its status changes to BROKEN; items no longer drop on the ground; the entire inventory is safely stored in a file; the shop can later be fully restored. New Workflow ACTIVE ↓ Chest Broken ↓ Inventory Saved ↓ BROKEN ↓ Place New Chest ↓ /cshop unbroken key[...] ↓ Inventory Restored ↓ ACTIVE 📦 Separate Inventory Storage Shop inventories are no longer stored together with shop information. A new directory has been introduced: plugins/Mivex/inventories/ Each shop now has its own inventory file: inventories/ 4dc7d6e2.yml ab73f191.yml f12c8a77.yml Each file belongs to exactly one shop. 🗃️ Updated shops.yml The shops.yml file now stores only shop information: UUID Owner Location Item Amount Price Buy/Sell Mode Status Key The actual chest inventory is now stored separately. 🔒 Improved Item Protection The new system was designed to eliminate item loss whenever possible. Protection has been added against: item duplication; accidental item drops; restoring the same inventory twice; restoring a shop at the wrong location; restoring into a non-empty chest; missing or corrupted inventory files. ⚙️ Atomic Save Operations To maximize reliability, all inventory operations are now atomic. A shop changes to BROKEN only after the inventory has been successfully saved. Likewise, the inventory file is deleted only after every item has been successfully restored. This significantly reduces the risk of data loss. 🔨 New Unbroken Command A new command has been added: /cshop unbroken key[...] This command restores a broken shop. After a successful restoration: all items are returned to the new chest; the shop becomes ACTIVE again; the temporary inventory file is automatically removed. 🚫 New Restrictions While a shop is in the BROKEN state: trading is disabled; editing is disabled; creating another shop at the same location is not allowed; deleting the shop is not allowed. The shop must be restored before it can be deleted. 📋 MyList Improvements The command /cshop mylist now displays the current status of every shop: ACTIVE BROKEN ⌨️ Unified Command Syntax All commands now follow a consistent structure. Old Syntax /cshop OAK_DOOR 32 5 sell key[MV] New Syntax /cshop sell key[MV] OAK_DOOR 32 5 Updated Commands Create Sell Shop /cshop sell key[...] ITEM AMOUNT PRICE Create Buy Shop /cshop buy key[...] ITEM AMOUNT PRICE Edit Shop /cshop edit key[...] sell ITEM AMOUNT PRICE Delete Shop /cshop delete key[...] Restore Shop /cshop unbroken key[...] 💡 Improved Tab Completion Tab Completion has been completely redesigned. Typing: /cshop now shows only available actions: about buy delete edit help list mylist sell unbroken Minecraft items are suggested only after selecting the desired action, making command usage much cleaner and easier. ⚡ Summary Version 1.3 is the largest update in Mivex so far. It makes the shop system: safer; more reliable; easier to use; more consistent; better prepared for future features. uaУкраїнською Mivex v1.3 — Broken Shop System & Command Update ✨ Основні зміни Версія 1.3 приносить найбільше оновлення з моменту створення Mivex. Повністю перероблено механіку втрати магазинів, значно покращено безпеку зберігання товарів та оновлено синтаксис усіх команд для більшої зручності використання. 🛠️ Нова система Broken Стара система була повністю замінена. Тепер при руйнуванні магазину: магазин не видаляється; він переходить у стан BROKEN; товари не випадають на землю; увесь інвентар автоматично переноситься у файл; магазин можна безпечно відновити. Нова логіка ACTIVE ↓ Chest Broken ↓ Inventory Saved ↓ BROKEN ↓ Place New Chest ↓ /cshop unbroken key[...] ↓ Inventory Restored ↓ ACTIVE 📦 Зберігання інвентарю Інвентар магазину більше не зберігається разом із інформацією про магазин. Тепер: plugins/Mivex/inventories/ містить окремий файл для кожного магазину. Приклад: inventories/ 4dc7d6e2.yml ab73f191.yml f12c8a77.yml Кожен файл відповідає лише одному магазину. 🗃️ Оновлення shops.yml Файл shops.yml тепер містить лише інформацію про магазин: UUID Owner Location Item Amount Price Buy/Sell Status Key Фактичний інвентар магазину винесено в окремі файли. 🔒 Захист від втрати предметів Нова система була розроблена таким чином, щоб максимально виключити можливість втрати товарів. Реалізовано захист від: дублювання предметів; випадкового випадання предметів; повторного відновлення одного магазину; відновлення магазину не на своєму місці; відновлення у непорожню скриню; пошкоджених або відсутніх файлів інвентарю. ⚙️ Атомарне збереження Для максимальної надійності додано атомарну логіку роботи. Статус магазину змінюється на BROKEN лише після успішного збереження інвентарю. Під час відновлення файл інвентарю видаляється лише після повного повернення всіх предметів. Це мінімізує ризик втрати даних навіть у випадку помилок. 🔨 Команда Unbroken Додано нову команду: /cshop unbroken key[...] Вона дозволяє відновити магазин після його руйнування. Після успішного виконання: інвентар повертається у нову скриню; магазин знову отримує статус ACTIVE; файл тимчасового інвентарю автоматично видаляється. 🚫 Нові обмеження Поки магазин має статус BROKEN: торгівля недоступна; редагування недоступне; створення нового магазину на цьому місці заборонене; видалення магазину заборонене. Спочатку магазин необхідно відновити. 📋 Оновлення MyList Команда /cshop mylist тепер показує поточний стан кожного магазину: ACTIVE BROKEN ⌨️ Повністю оновлений синтаксис команд Усі команди тепер побудовані за єдиним принципом. Старий формат /cshop OAK_DOOR 32 5 sell key[MV] Новий формат /cshop sell key[MV] OAK_DOOR 32 5 Оновлені команди Створення магазину продажу /cshop sell key[...] ITEM AMOUNT PRICE Створення магазину покупки /cshop buy key[...] ITEM AMOUNT PRICE Редагування /cshop edit key[...] sell ITEM AMOUNT PRICE Видалення /cshop delete key[...] Відновлення /cshop unbroken key[...] 💡 Покращений Tab Completion Tab Completion був повністю перероблений. Тепер після введення /cshop відображаються лише доступні дії: about buy delete edit help list mylist sell unbroken Лише після вибору необхідної дії починають пропонуватися предмети Minecraft. Це робить використання команд значно зручнішим. ⚡ Загальний результат Версія 1.3 стала найбільшим оновленням Mivex на цей момент. Вона робить систему магазинів: безпечнішою; надійнішою; зрозумілішою; простішою у використанні; більш підготовленою до майбутніх оновлень.

## ✨ New - Added Broken shop state - Added `/cshop unbroken` ## 🔄 Changed - Completely removed the old Restore system - Simplified shop recovery - Improved delete command ## 🛠 Fixed - Various internal improvements - Cleaner shop management **Українською** ## ✨ Нове - Додано стан «Зламаний магазин» - Додано `/cshop unbroken` ## 🔄 Змінено - Повністю видалено стару систему відновлення - Спрощено відновлення магазину - Покращено команду видалення ## 🛠 Виправлено - Різні внутрішні покращення - Чистіше управління магазином

# Mivex — MV Shop Власна система магазинів без жодної цифрової валюти. Гроші — це реальний предмет (**Phantom Membrane**), який гравці носять в інвентарі, передають один одному, зберігають у скринях чи втрачають, якщо не вберегли. Ніякого Vault, ніякого `/bal`. ## Основні можливості - **Фізична валюта** — Phantom Membrane. Перевіряється строго за матеріалом предмета, не за назвою. - **SELL та BUY магазини** на звичайних скринях (CHEST). Кожен магазин має реальний склад товару та реальний запас валюти прямо в скрині. - **Ключ-предмет** — доступ до редагування та поповнення магазину дає перейменований Tripwire Hook. Загубив ключ — втратив контроль над магазином. - **Атомарні транзакції** — жодних дюпів. Якщо якась умова не виконана (немає товару, немає місця, немає грошей) — операція повністю скасовується. - **LOST/restore система** — якщо скриню зламано, магазин не зникає назавжди, а переходить у стан LOST. Власник відновлює його командою `/cshop restore` на новій скрині. - **Попередження про подвійні скрині** — плагін чесно попереджає власника про наслідки, замість того щоб мовчки ламати логіку. - **Список заборонених товарів** (AIR, BEDROCK, командні блоки тощо) — редагується прямо в `config.yml` під потреби вашого сервера. - **Повна адмін-панель** — перегляд усіх магазинів, магазинів конкретного гравця, очищення втрачених магазинів. - **Tab-автодоповнення** для всіх команд, включно з підказками товарів, кількості, ціни та кодів власних магазинів. ## Команди /cshop ITEM amXX prYY sell/buy key[TEXT] — створити магазин /cshop edit KEY ITEM amXX prYY sell/buy — редагувати /cshop mylist — свої активні магазини /cshop restore — список втрачених магазинів /cshop restore КОД key[KEY] — відновити магазин /cshop delete КОД key[KEY] — видалити магазин назавжди /cshop list [player] — перегляд магазинів (адмін) /cshop about ## Вимоги - Paper 1.19.4 - Java 17 ## Philosophy Mivex не захищає гравця від його власних рішень. Плагін відповідає лише за відсутність багів, коректність транзакцій і збереження даних — все інше (простий ключ, роздача ключа іншим тощо) залишається відповідальністю власника магазину.

# Mivex Mivex is a lightweight chest shop plugin for Paper servers. ## Features - 🔒 Secure chest shops - 📦 Buy & Sell shops - 🗝 Restore codes - 💾 Automatic saving - 📋 Shop listing - ⚠ Double chest warnings - 🚫 Blocked items - 🔧 Lightweight ## Commands /cshop /cshop edit /cshop mylist /cshop list ## Requirements Paper 1.19+ ## GitHub https://github.com/Mivish-MVCoR/Mivex