PrimeSeller-Fork

PrimeSeller-Fork позволяет игрокам продавать предметы через удобное меню или автоматически по таймеру. Поддерживает динамическое ценообразование и интеграцию с экономическими плагинами.

PrimeSeller-Fork предоставляет мощный инструментарий для управления экономикой сервера, позволяя игрокам легко реализовывать товары через визуальные интерфейсы. Плагин поддерживает как ручную продажу через меню, так и полностью автоматизированную систему автопродаж с возможностью настройки интервалов и лимитов.

Основные возможности

Плагин предлагает несколько ключевых механик для создания живого рынка:

• Интерактивное GUI продавца: доступ к меню через команду /seller для продажи предметов по отдельности, стаками или всего инвентаря целиком.
• Умная система автопродаж: автоматическая реализация товаров из инвентаря по заданному таймеру с управлением через отдельное меню /autoseller.
• Динамическое ценообразование: поддержка категорий «Ограниченных» (Limited) предметов с суточными лимитами и «Неограниченных» (Unlimited) товаров, цены на которые могут снижаться при росте объема продаж для симуляции насыщения рынка.
• Мультиязычность: автоматическое определение и использование названий материалов на языке игрока.
• Интеграция с PlaceholderAPI: поддержка переменных для отображения статуса автопродаж, количества проданных товаров и времени до обновления цен.
• Гибкая настройка: глубокая конфигурация сообщений, меню, предметов, цен и прав доступа.

⚙️ Настройка и конфигурация

После первого запуска в папке plugins/PrimeSeller-Fork/ создается несколько файлов для настройки:

• config.yml — основные параметры: язык, экономика, интервалы автопродаж и механики снижения цен.
• messages.yml — все сообщения плагина, поддерживающие формат MiniMessage.
• menu.yml — полная настройка внешнего вида, макетов и предметов в меню продавца и автопродаж.
• items.yml — определение предметов в пулах Limited/Unlimited, их минимальных и максимальных цен, а также глобальных лимитов.
• translations/ — автоматически генерируемые файлы с локализованными названиями материалов.

Настройка экономики: по умолчанию плагин использует Vault. Для использования ExcellentEconomy необходимо активировать соответствующий ключ в config.yml:

economy:
  excellent-economy:
    enable: false  # If disabled, Vault will be used.
    currency: "money"

Команды и права доступа

Для управления функциями плагина используются следующие команды:

Добавление товаров

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

• Для ограниченных товаров: /primeseller addlimited <minPrice> <maxPrice>
• Для неограниченных товаров: /primeseller addunlimited <minPrice> <maxPrice>
• Плагин будет генерировать случайную цену в заданном диапазоне при каждом обновлении стока.

📖 Руководство по автопродажам

Система автопродаж работает по следующему алгоритму:

1. Игрок с правом primeseller.autoseller использует команду /autoseller.
2. В открывшемся GUI игрок выбирает предметы из нижнего инвентаря, чтобы добавить их в список автопродаж.
3. Предметы из верхнего меню GUI можно удалить из списка.
4. Игрок нажимает кнопку переключения (Toggle), чтобы включить или выключить функцию.
5. Плагин автоматически продает товары из инвентаря игрока, которые есть в списке, с интервалом из config.yml.

Лимиты слотов: Игроки начинают с 0 слотов автопродаж. Назначайте слоты через права доступа, например primeseller.autoseller.5 или primeseller.autoseller.20. Действует право с наибольшим значением.

PlaceholderAPI

При установленном PlaceholderAPI доступны следующие переменные:

• %primeseller_autoseller_status% — статус автопродаж (enabled / disabled)
• %primeseller_sold_items_number% — количество проданных Limited товаров за период
• %primeseller_limited_time% — время до обновления Limited товаров (raw)
• %primeseller_limited_time_formatted% — отформатированное время до обновления Limited товаров
• %primeseller_unlimited_time% — время до обновления Unlimited товаров (raw)
• %primeseller_unlimited_time_formatted% — отформатированное время до обновления Unlimited товаров