Shop Plugin

Shop Plugin - это мощный и гибкий плагин для серверов Minecraft, который позволяет создавать неограниченное количество магазинов с индивидуальными названиями, цветными отображениями и продвинутыми настройками торговли. Если на вашем сервере не хватает удобной экономики или вы хотите дать игрокам возможность покупать предметы с особыми свойствами (зачарованные вещи, зелья с эффектами), этот плагин станет отличным решением.

Возможности

• Гибкое создание магазинов - создавайте сколько угодно торговых точек с уникальными именами.
• Настраиваемые отображаемые названия - используйте цветовые коды для красивых названий.
• Поддержка NBT - предметы с кастомными именами и зачарованиями.
• Система зелий - легко добавляйте сделки с любыми эффектами зелий.
• Автоматическое пополнение - после заданного времени товары снова становятся доступными.
• Права доступа - контролируйте, кто может управлять магазинами и пользоваться ими.
• Постоянное хранение - все магазины автоматически сохраняются.
• Автодополнение команд - полная подсказка для всех команд.

Установка

1. Скачайте файл shopplugin-*.jar.
2. Поместите его в папку plugins/ вашего сервера.
3. Перезапустите сервер.
4. Плагин автоматически создаст папку plugins/ShopPlugin/shops/.

Команды

Базовые команды (для всех игроков)

/shop <название_магазина>           - Открыть магазин
/shop list                          - Показать все доступные магазины
/shop info                          - Информация о плагине

Админские команды (требуется право shopplugin.admin)

/shop create <название> [отображаемое_имя]                    - Создать новый магазин
/shop addtrade <магазин> <вход> <кол-во> <выход> <кол-во> [макс_использований]  - Добавить сделку
/shop addpotion <магазин> <вход> <кол-во> <тип_зелья> [макс_использований]     - Добавить сделку с зельем
/shop addtradeadvanced <магазин> <вход> <кол-во> <выход> <кол-во> [макс_использований] [имя_входа] [имя_выхода] [чары_входа] [чары_выхода] [зелье_входа] [зелье_выхода]  - Продвинутое создание сделки
/shop removetrade <магазин> <индекс_сделки>                - Удалить сделку
/shop rename <магазин> <новое_отображаемое_имя>                - Изменить отображаемое имя
/shop trades <магазин>                                   - Показать все сделки магазина
/shop remove <магазин>                                   - Удалить магазин
/shop potions                                             - Показать все доступные типы зелий
/shop restock <магазин> [часы]                          - Установить интервал пополнения

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

shopplugin.admin: true     # Полный доступ ко всем функциям управления магазинами
shopplugin.use.*: true     # Доступ ко всем магазинам
shopplugin.use.<название_магазина>: true  # Доступ к конкретному магазину

Примеры

Создать простой магазин

/shop create general "§6General Shop"

Добавить базовую сделку

/shop addtrade general DIAMOND 1 DIAMOND_SWORD 1 10

Добавить сделку с зельем

/shop addpotion general EMERALD 2 HEALING 5
/shop addpotion general GOLD_INGOT 1 HEALING:UPGRADED 3
/shop addpotion general DIAMOND 1 REGENERATION:EXTENDED 1

Продвинутая сделка с NBT

/shop addtradeadvanced general DIAMOND 1 DIAMOND_SWORD 1 10 "&bMagical Diamond" "&cFire Sword" "" "FIRE_ASPECT:2,SHARPNESS:5"

Установить интервал пополнения

/shop restock general 12    # Каждые 12 часов
/shop restock vip 6         # Каждые 6 часов

Типы зелий

Доступные базовые зелья:

• HEALING - мгновенное здоровье
• HARMING - мгновенный урон
• REGENERATION - регенерация
• POISON - отравление
• STRENGTH - сила
• WEAKNESS - слабость
• SPEED - скорость
• SLOWNESS - замедление
• JUMP - прыгучесть
• FIRE_RESISTANCE - огнестойкость
• WATER_BREATHING - подводное дыхание
• INVISIBILITY - невидимость
• NIGHT_VISION - ночное зрение

Модификаторы:

• :EXTENDED - увеличенная длительность
• :UPGRADED - усиленный эффект (II уровень)

Примеры:

• HEALING:UPGRADED - Исцеление II
• SPEED:EXTENDED - Скорость с увеличенной длительностью
• REGENERATION:UPGRADED - Регенерация II

Зачарования

Зачарования указываются в формате ЗАЧАРОВАНИЕ:УРОВЕНЬ, несколько разделяются запятыми:

"SHARPNESS:5,FIRE_ASPECT:2,UNBREAKING:3"

Распространённые зачарования:

• SHARPNESS - острота
• FIRE_ASPECT - заговор огня
• UNBREAKING - прочность
• EFFICIENCY - эффективность
• FORTUNE - удача
• SILK_TOUCH - шелковое касание
• PROTECTION - защита
• THORNS - шипы

Система пополнения

Плагин включает автоматическое пополнение товаров:

• Интервал по умолчанию: 24 часа.
• Настраиваемый: можно задать индивидуально для каждого магазина.
• Автоматически: сделки проверяются и пополняются при открытии магазина.
• Постоянное хранение: время пополнения сохраняется даже после перезапуска сервера.

Как это работает:

1. Когда сделка достигает максимального числа использований, она помечается как "распродано".
2. После истечения настроенного времени пополнения сделка снова становится доступной.
3. Проверка происходит каждый раз, когда игрок открывает магазин.

Конфигурация

Магазины автоматически сохраняются в папке plugins/ShopPlugin/shops/ в виде YAML-файлов. Каждый магазин имеет свой файл со следующей структурой:

display-name: "§6My Shop"
restock-hours: 24
trades:
  - input-material: DIAMOND
    input-amount: 1
    output-material: DIAMOND_SWORD
    output-amount: 1
    max-uses: 10
    output-display-name: "&cFire Sword"
    output-enchantments: "FIRE_ASPECT:2,SHARPNESS:5"
restock-times:
  0: 1640995200000

Решение проблем

Магазин не открывается

• Проверьте право shopplugin.use.<название_магазина> или shopplugin.use.*.
• Убедитесь, что магазин существует командой /shop list.

Сделки не работают

• Проверьте названия материалов (должны быть точными).
• Используйте /shop trades <название_магазина>, чтобы увидеть все сделки.

Зелья не имеют эффектов

• Убедитесь, что вы используете POTION, SPLASH_POTION или LINGERING_POTION как материал.
• Проверьте тип зелья командой /shop potions.

Если возникли другие вопросы - проверьте логи сервера на наличие ошибок и убедитесь, что все права настроены корректно.