Mivex — MV Shop
⚠️ 本插件无需 Vault 或任何经济插件即可运行。
一款独特的基于箱子的商店插件,使用实体货币而非虚拟余额。
Mivex 没有 Vault、没有经济插件,也没有 /bal 命令。其货币是真正的 Minecraft 物品——幻翼膜(Phantom Membrane)——玩家可以随身携带、交给其他玩家、存放在箱子中,甚至可能会丢失。
主要功能
? 实体货币
所有计算均以幻翼膜为单位进行。
货币仅通过物品类型进行检查,而不检查其名称。
货币可以:
- 随身携带;
- 交给其他玩家;
- 存放起来;
- 像任何其他 Minecraft 物品一样丢失。
? 出售与购买商店
创建:
- SELL 商店(出售)
- BUY 商店(购买)
基于普通的 Minecraft 箱子。
每个商店拥有:
完全不存在虚拟余额。
? 双层箱子支持
Mivex 通过 Minecraft API 检测真实的双层箱子,而不仅仅是“相邻的方块”。
在商店旁放置第二个箱子——它会自动成为拥有 54 个槽位的双层商店(DOUBLE SHOP),无需任何命令。
如果双层箱子后来解体(一半被破坏、被活塞推动、或被第三方插件修改)——商店会安全地切换至 BROKEN(损坏)状态,且两半箱子的内容均会被完整保留,不会丢失或重复。
v1.5 之前创建的商店将继续作为 SINGLE SHOP(单层商店)工作,并且永远不会自动以任何方式更改——是否重新创建商店以获得双层箱子支持由所有者自行决定。
? 实体商店钥匙
每个商店都由一个重命名的绊线钩(Tripwire Hook)保护。
钥匙(通行证)用于:
- 编辑商店;
- 恢复 BROKEN 商店;
- 删除商店。
丢失钥匙即意味着失去对商店的访问权限。
? BROKEN(损坏)商店系统
如果商店的箱子被破坏:
商店不会被删除;
所有商品均安全保留;
物品不会掉落在地面上;
商店切换至 BROKEN 状态。
使用以下命令恢复:
/cshop unbroken key[...]
?️ 安全的物品存储
每个 BROKEN 商店的物品栏都会自动保存到单独的文件中。
这可防止商店出现以下问题:
- 物品复制;
- 商品意外丢失;
- 恢复过程中出现的错误。
? 自动备份
每次保存数据前,Mivex 会自动创建备份副本(shops.backup.yml),以便在主文件损坏时仍能恢复商店数据。
? 商店分析
所有者可以查看其商店的完整信息。
显示:
商店状态;
创建日期;
坐标。
显示:
总收益/支出;
成功交易次数;
上次销售/购买记录。
显示:
成功操作的历史记录;
重复购买的自动合并;
支持物品过滤。
? 物品过滤
分析命令支持过滤功能。
示例:
/cshop mylist OAK_DOOR
/cshop stats DIAMOND
/cshop history IRON_INGOT
⚡ 原子事务
每笔交易在执行前都会经过完全验证。
如果有任何一个条件未满足:
- 库存不足;
- 货币不足;
- 背包中没有空位;
- 商店处于错误的状态;
整个操作将被取消,且不会发生任何变化。
? 状态系统
每个商店都有各自的状态。
支持以下状态:
你可以使用以下命令检查状态:
/cshop mylist
⚙️ 可配置的黑名单
通过 config.yml,你可以轻松阻止使用任何物品。
例如:
- AIR(空气)
- BEDROCK(基岩)
- Command Block(命令方块)
- 以及任何其他物品。
? 管理员工具
管理员可以:
- 查看服务器上的所有商店;
- 查看特定玩家的商店;
- 根据需要管理商店。
? “首次交易”活动
当玩家的商店完成与另一位玩家(而非自己)的第一次真实交易时,卖家和买家都将获得一张幻翼膜作为奖励。
该奖励绑定于玩家身份,而非单个商店——因此无论该玩家创建了多少家商店,奖励仅发放一次。
如果在交易发生时店主不在线,奖励会等待他们,并在下次加入服务器时自动发放。
此活动可通过 config.yml 完全配置或禁用,包括奖励数量和基于时间的限制。
✨ 改进的命令自动补全
所有命令共享统一的语法和智能自动补全功能。
系统只会提供与当前输入步骤相关的参数选项。
命令列表:
/cshop sell key[文本] ITEM 数量 价格
/cshop buy key[文本] ITEM 数量 价格
/cshop edit key[文本] sell|buy ITEM 数量 价格
/cshop delete key[文本]
/cshop unbroken key[文本]
/cshop mylist [ITEM]
/cshop stats [ITEM]
/cshop history [ITEM]
/cshop list
/cshop list <player>
/cshop help
/cshop about
依赖要求:
Paper 1.19.4+
Java 17+
设计理念
Mivex 围绕真实物品、真实背包以及真实风险构建。
本插件不使用虚拟余额,而是尽可能深度利用 Minecraft 自身的机制。每一张膜、每一件物品以及每一次交易都在游戏世界中物理存在。
?️ 开发路线图
本项目正在积极开发中。即将推出的功能包括:
- ? 游戏内消息本地化 —— 所有插件消息(§c, §a 等颜色代码)将支持多种语言:英语、德语和法语,可通过 config.yml 进行选择
- ? 可配置货币 —— 允许通过 config.yml 将货币从幻翼膜更改为其他任意物品
- ⬆️ Paper 1.21.x 支持 —— 扩展兼容性以支持更新的服务器版本
有想法或建议?请在 GitHub 上提交 Issue —— 我们欢迎来自社区的反馈。
Mivex 保证所有商店操作安全、稳定且具有防复制保护,同时确保密钥安全及保护自身商店的责任仍由玩家自行承担。
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
⚡ Атомарные транзакции
Каждая торговая операция полностью проверяется перед выполнением.
Если хотя бы одно условие не выполняется:
- недостаточно товара;
- недостаточно валюты;
- нет места в инвентаре;
- магазин находится в неправильном состоянии;
операция полностью отменяется, и ничего не меняется.
? Система статусов
Каждый магазин имеет собственный статус.
Поддерживаются:
Просмотреть статусы можно командой:
/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
/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 选择服务器语言
- ? 自定义货币 —— 允许通过 config.yml 将默认货币 Phantom Membrane 替换为任意其他物品
- ⬆️ 支持 Paper 1.21.x —— 扩展对新版服务器的兼容性
有想法或建议?请在 GitHub 提交 issue —— 我们欢迎社区反馈。
Mivex 保证所有商店操作的安全性与稳定性,并防止重复利用漏洞;而钥匙的保管及自家商店的安全性则由玩家自行负责。
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.
Shows:
shop status;
creation date;
coordinates.
Shows:
total earnings / spending;
number of successful trades;
last sale / purchase.
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:
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:
/cshop sell key[TEXT] ITEM AMOUNT PRICE
/cshop buy key[TEXT] ITEM AMOUNT PRICE
/cshop edit key[TEXT] sell|buy ITEM AMOUNT PRICE
/cshop delete key[TEXT]
/cshop unbroken key[TEXT]
/cshop mylist [ITEM]
/cshop stats [ITEM]
/cshop history [ITEM]
/cshop list
- View a specific player's shops (Admin):
/cshop list <player>
/cshop help
/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
⚡ Атомарні транзакції
Кожна торгова операція повністю перевіряється перед виконанням.
Якщо хоча б одна умова не виконується:
- недостатньо товару;
- недостатньо валюти;
- немає місця в інвентарі;
- магазин перебуває у неправильному стані;
операція повністю скасовується, а нічого не змінюється.
? Система статусів
Кожен магазин має власний статус.
Підтримуються:
Переглянути статуси можна командою:
/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 гарантує, що всі операції магазинів будуть безпечними, стабільними та захищеними від дюпів, тоді як відповідальність за збереження ключа та безпеку власного магазину залишається за самим гравцем.
评论 0
登录后参与评分
还没有评论,来抢沙发吧