QuickShop-Hikari

QuickShop-Hikari - это мощный и удобный плагин для серверов Minecraft, который позволяет игрокам создавать магазины прямо у сундука без необходимости вводить сложные команды. Никаких /shop create или /trade - просто кликнул по сундуку с предметом в руке, написал цену в чат, и магазин готов. Идеально для выживания, экономических серверов и любых проектов, где нужна простая и быстрая торговля.

Плагин решает главную проблему ванильного Minecraft - отсутствие встроенной системы торговли между игроками. Вместо того чтобы договариваться в чате и кидать предметы друг другу, игроки могут просто выставить товар на продажу в сундуке, а другие - купить его в один клик. Администратору не нужно настраивать сложные экономические системы - всё работает из коробки.

Особенности QuickShop-Hikari

• Простота создания - кликни по сундуку с предметом, введи цену в чат. Готово.
• Поддержка NBT-данных - зачарованные предметы, зелья, яйца призыва, повреждённые инструменты - всё продаётся с сохранением свойств.
• Динамическая смена языка - плагин автоматически подстраивается под язык клиента игрока. Удобно для мультиязычных серверов.
• Магазины без лимита - можно создать сколько угодно торговых точек.
• Чёрный список предметов - запрети продажу определённых вещей, с возможностью выдачи разрешений для обхода.
• Двойные сундуки - один магазин может продавать, другой - покупать тот же предмет.
• Поддержка UUID - никаких проблем при смене ника игрока.
• Предпросмотр предмета - и в чате, и в GUI можно посмотреть, что именно ты покупаешь. Никакого скама.
• Панель управления магазином - все настройки через клик, без команд.
• Совместимость с плагинами защиты территорий - WorldGuard, GriefPrevention, Towny, Lands и другие. Есть отдельные модули совместимости.
• Виртуальный DisplayItem - на основе ProtocolLib или PacketEvents, для лучшей производительности.
• Мультивалютность - поддержка VaultUnlocked и Vault по умолчанию. Можно использовать разные валюты в разных магазинах.
• Налоги и комиссии - настрой налог с продажи или ежемесячную плату за магазин.
• Скрытие команд из помощи - если у игрока нет прав, команда не показывается.
• Цветные заголовки табличек - разные статусы магазина отображаются разными цветами.
• MiniMessage - создавай красивые сообщения с форматированием.
• Хранение данных - H2 (локально) или MySQL (удалённо).
• Продвинутый механизм транзакций - откат любых операций с инвентарём и экономикой при сбое, чтобы избежать дупликации предметов.
• API для разработчиков - InventoryWrapper, Event Bus, кастомные хуки.
• Быстрый кэш - без лагов даже при 1000+ магазинов (требуется ProtocolLib).
• Управление правами на каждый магазин - можно дать другому игроку полный доступ к твоему магазину или заблокировать конкретного покупателя.
• Бонусы для владельца и других игроков - настрой процент от продаж для персонала.

Дополнения (аддоны)

• ShopSearch - поиск предметов по всем магазинам сервера.
• DiscordSRV - уведомления о покупках в Discord.
• Plan - статистика активности магазинов.
• Discount - промокоды со скидками, с настройкой названия, размера скидки, срока действия и минимальной суммы.

Установка

QuickShop-Hikari требует Minecraft 1.20 и выше. Версии ниже не поддерживаются.

1. Установи Vault и любой плагин экономики, который его поддерживает (например, EssentialsX, CMI).
2. Если хочешь мультивалютность - нужен плагин с поддержкой VaultUnlocked.
3. Рекомендуется установить ProtocolLib или PacketEvents - это сильно повышает производительность.
4. Скачай QuickShop-Hikari и положи в папку plugins.
5. При необходимости скачай модули совместимости (только те, что реально нужны - в большинстве случаев Hikari сам справляется с защитой регионов).
6. Запусти сервер.

Команды

Большинство функций доступны через панель управления или взаимодействие с магазином, так что команды нужны редко. Но вот основные:

• /quickshop unlimited - сделать магазин безлимитным (или отключить).
• /quickshop setowner <игрок> - сменить владельца магазина.
• /quickshop buy - переключить магазин на покупку предметов.
• /quickshop sell - переключить магазин на продажу.
• /quickshop price <цена> - изменить цену.
• /quickshop clean - удалить все магазины без товара.
• /quickshop find <предмет> - найти ближайший магазин с нужным предметом (например, /quickshop find dia найдёт магазин с алмазами).
• /quickshop fetchmessage - вручную загрузить сообщения магазина из БД.
• /quickshop info - информация о плагине.
• /quickshop debug - включить/выключить режим отладки.
• /quickshop create <цена> [предмет] - создать магазин через команду (если чат конфликтует с другими плагинами).
• /quickshop currency <название валюты> - указать валюту для магазина (требуется поддержка мультивалютности).
• /quickshop supercreate - создать магазин в обход проверок защиты.
• /quickshop paste - собрать информацию о плагине и отправить на Pastebin.
• /quickshop staff - управление персоналом магазина.
• /quickshop cleanghost - удалить сломанные магазины.
• /quickshop export - экспорт всех данных в zip (только консоль).
• /quickshop recovery - восстановить магазины из файла (только консоль, может удалить существующие магазины - делай бекап!).
• /quickshop size - изменить размер партии (требуется allow-stacks в конфиге).
• /quickshop purge - очистить старые магазины (настройка в config.yml).
• /quickshop transfer - передать все магазины одного игрока другому.
• /quickshop item - изменить предмет магазина.
• /quickshop removeworld - удалить все магазины в определённом мире.
• /quickshop name - дать магазину имя или убрать его.
• /quickshop permission - управление правами на магазин.
• /quickshop database - просмотр и управление БД.
• /quickshop benefit - управление бонусами.

Псевдонимы: /shop, /qs, /chestshop, /cshop (настраиваются в config.yml).

Права доступа

Если не хочешь заморачиваться - выдай игроку quickshop.player. Это даст всё необходимое для создания и использования магазинов.

Для продвинутых администраторов есть детальная система прав:

Права игрока

• quickshop.use - базовое право на любые действия с магазинами.
• quickshop.create.sell - создание магазина в режиме продажи.
• quickshop.create.buy - создание магазина в режиме покупки.
• quickshop.create.stacks - продажа предметов пачками.
• quickshop.create.changeitem - смена предмета в магазине.
• quickshop.create.changeamount - изменение количества предметов за одну сделку.
• quickshop.create.changeprice - изменение цены.
• quickshop.create.double - создание магазина на двойном сундуке.
• quickshop.create.cmd - доступ к /quickshop create (может обходить защиту неподдерживаемых плагинов).
• quickshop.transfer - передача всех своих магазинов другому игроку.
• quickshop.find - поиск магазинов.
• quickshop.fetchmessage - ручная загрузка сообщений.
• quickshop.staff - управление персоналом.
• quickshop.preview - предпросмотр предмета в GUI.
• quickshop.currency - смена валюты.
• quickshop.shopnaming - именование магазина.
• quickshop.permission - управление правами на магазин.
• quickshop.benefit - управление бонусами.

Права администратора

• quickshop.unlimited - безлимитный магазин.
• quickshop.alwayscounting - всегда считать предметы.
• quickshop.setowner - смена владельца.
• quickshop.other.destroy - удаление чужих магазинов.
• quickshop.other.open - открытие чужих сундуков магазина.
• quickshop.other.price - изменение цены в чужом магазине.
• quickshop.transfer.other - передача всех магазинов другого игрока.
• quickshop.refill - пополнение магазина через команду (фактически бесконечные предметы).
• quickshop.empty - очистка инвентаря магазина.
• quickshop.clean - удаление магазинов без товара.
• quickshop.bypass.<ID предмета> - продажа запрещённых предметов (например, бедрока).
• quickshop.price.restriction.bypass.<правило> - обход ограничения цены.
• quickshop.alerts - получение уведомлений о возможном читерстве, предупреждениях и обновлениях.
• quickshop.info - информация о плагине.
• quickshop.debug - режим отладки.
• quickshop.paste - отправка данных на Pastebin.
• quickshop.purge - очистка старых магазинов.
• quickshop.create.admin - создание магазина в обход проверок защиты.
• quickshop.tax - освобождение от налога.
• quickshop.tax.bypassunlimited - освобождение от налога только для безлимитных магазинов.
• quickshop.cleanghost - удаление сломанных магазинов.
• quickshop.export - экспорт данных (только консоль).
• quickshop.recovery - восстановление магазинов (только консоль).
• quickshop.removeworld - удаление всех магазинов в мире.
• quickshop.other.changeitem - смена предмета в чужом магазине.
• quickshop.other.changeamount - смена количества в чужом магазине.
• quickshop.other.shopnaming - смена имени чужого магазина.
• quickshop.bypass.namefee - обход платы за именование.
• quickshop.database - управление БД.

Как создать магазин

Поставь сундук, возьми в руку предмет, который хочешь продавать (например, 16 алмазов), и кликни левой кнопкой по сундуку. В чате появится запрос - напиши цену. Готово! Над сундуком появится виртуальный предмет (можно отключить в конфиге), а сбоку - табличка с информацией.

Важно: Если на сервере используется глобальный чат-плагин (например, BungeeChat), создание магазина через клик может не сработать. В таком случае используй команду /quickshop create <цена> [предмет].

Как покупать и продавать

Просто кликни левой кнопкой по табличке магазина. В чате напиши количество предметов, которое хочешь купить или продать. Магазин сам определит, продаёт он или покупает - это видно на табличке.

Продвинутые функции

Предпросмотр предмета

Перед покупкой можно посмотреть, что именно ты покупаешь - защита от мошенничества.

Панель управления магазином

Все настройки магазина через один клик - никаких команд.

Персонал магазина

Владелец может добавить других игроков как персонал командой /quickshop staff add <игрок>. Они смогут пополнять запасы и управлять магазином.

Связь с Эндер-сундуком

Если установлен OpenInv и модуль совместимости, можно использовать /quickshop echest - магазин будет брать товары из твоего эндер-сундука.

Ограничение цен по правилам

Можно создать правила, которые ограничивают минимальную и максимальную цену для определённых предметов.

Автообновление переводов

QuickShop использует CrowdinOTA - переводы обновляются автоматически. Если хочешь изменить какое-то сообщение, используй систему override.

Очистка старых магазинов

Плагин может автоматически удалять магазины игроков, которые давно не заходили или были забанены. Модули совместимости также могут удалять магазины при выходе из команды/острова/земли.

Настройка взаимодействия

Через файл interaction.yml можно настроить любое поведение при клике - например, продавать или покупать 1 предмет или все сразу при шифт-клике.

Продажа пачками

Включи allow-stacks в config.yml, и игроки смогут создавать магазины, где продаётся сразу несколько предметов за одну сделку.

Управление правами на каждый магазин

Можно дать другому игроку полный доступ к твоему магазину или, наоборот, заблокировать конкретного покупателя.

Модули совместимости

QuickShop-Hikari официально поддерживает модули для:

• AdvancedRegionMarket - удаление магазинов при сбросе региона.
• BentoBox - удаление магазинов при выходе из команды.
• Clearlag - защита дисплеев от очистки (если не установлен ProtocolLib).
• GriefPrevention - удаление магазинов при снятии доверия, сбросе территории и т.д.
• Lands - удаление магазинов при выходе из земли.
• NoCheatPlus - совместимость с античитом.
• OpenInv - команда /quickshop echest для связи с эндер-сундуком.
• PlotSquared - удаление магазинов при снятии доверия.
• Towny - удаление магазинов при уходе жителя, налоги в банк города.
• Residence - контроль создания магазинов в регионах.
• WorldEdit - удаление магазинов при удалении блоков.
• WorldGuard - флаги для контроля торговли в регионах.
• SuperiorSkyblock - удаление магазинов при кике, снятии коопа, сбросе острова.
• EcoEnchants - отображение чар EcoEnchants.
• Reforges - отображение предметов Reforges в предпросмотре.

Известные несовместимости

• Плагины глобального чата для BungeeCord - решается установкой модуля Compat-BungeeCord.
• Плагины, перехватывающие BlockBreakEvent - администратор получит уведомление с инструкцией по настройке фильтра. Можно отключить проверки защиты, но тогда игроки смогут создавать магазины где угодно.
• ChatControl Pro/Red - используй /quickshop amount <количество> для установки цены.

Миграция с QuickShop-Reremake

QuickShop-Hikari несовместим с Reremake. Есть конвертер для переноса данных: https://quickshop-community.github.io/QuickShop-Hikari-Documents/docs/addon/reremake-migrator

Часто задаваемые вопросы

Можно ли создать магазин, который одновременно продаёт и покупает? Нет, один магазин работает только в одном режиме. Но можно поставить два магазина на двойной сундук - один на продажу, другой на покупку.

Можно ли использовать предметы как валюту (например, алмазы)? Нет, такой функции нет. Но можно выбрать плагин экономики, который поддерживает предметную валюту.

Плагин не реагирует при создании магазина. Что делать? Скорее всего, другой плагин отменяет создание. Чаще всего это плагины защиты. Можно отключить проверку защиты в config.yml.

Как создать магазин, продающий пачками? Включи allow-stacks: true в config.yml, выдай право quickshop.create.stacks, возьми в руку нужное количество предметов и создай магазин.

Можно ли продавать больше, чем стандартный стак? Да, включи custom-item-stacksize в config.yml и используй /quickshop stack <размер>.

Магазин сломался из-за плагина X. Почему? QuickShop создаёт фейковое событие BlockBreakEvent для проверки, можно ли строить в этом месте. Некоторые плагины отменяют это событие. Используй фильтр Protection Listener.

Как перенести данные с H2 на MySQL? Смотри документацию.

Ошибка NoDefClassFound/NoMethodFound в консоли. Это может быть из-за конфликта с другими плагинами или повреждённого jar-файла. Попробуй обновить плагин и протестировать только с QuickShop. Если проблема остаётся - сообщи на GitHub.

Как изменить или удалить сообщения? Отредактируй файл message.json. Чтобы удалить сообщение, замени его содержимое на пустую строку ("").

Добавите поддержку плагина X? Возможно. Открой issue на GitHub.

Не работает на версиях ниже 1.20. Плагин поддерживает только Minecraft 1.20 и выше.

Разработчикам

• Maven-репозиторий и QuickShopAPI.
• Примеры кода: поиск магазина, регистрация команды, InventoryWrapper API.
• Javadoc можно скачать через Maven.

Можно ли перепубликовать плагин на других сайтах?

Да, можно, при соблюдении двух условий:

• Сохрани ссылку на оригинальный ресурс и исходный код.
• Не удаляй имя автора и не выдавай себя за автора.

Для MineBBS: пока решение не принято, не публикуй без разрешения.

QuickShop-Hikari - это, пожалуй, лучший плагин для торговли на сервере Minecraft, если тебе нужна простота, производительность и гибкость. На слабом железе тоже работает отлично, особенно с ProtocolLib. Если собираешь экономический сервер - это must-have.