Mivex

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 на цей момент.

Вона робить систему магазинів:

безпечнішою; надійнішою; зрозумілішою; простішою у використанні; більш підготовленою до майбутніх оновлень.