Платно - Плагин - hSeller [1.16.X-26.X] | PAPI, XSkull, Vault и много чего ещё поддерживается

Поддерживаемые версии

1.16
1.17
1.18
1.19
1.20
1.21

Ядра и Прокси

Bukkit
Spigot
Paper

Минимальная версия Java: 17

hSeller
Настраиваемый GUI-скупщик с автоскупкой, категориями, множителями и ивентами

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

hSeller — это настраиваемая система скупщика для Minecraft-серверов.

Плагин добавляет GUI-скупщика, где игроки могут складывать предметы в хранилище, продавать все подходящие предметы, просматривать категории товаров, включать автоскупку и прокачивать уровни множителя.

hSeller поддерживает Vault-экономику, SQLite или MySQL, категории предметов, цены для каждого предмета, очки прогрессии, бустеры, ивенты скупщика и гибкие actions.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

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

GUI-скупщик предметов.
Хранилище игрока внутри меню скупщика.
Кнопка продажи всех предметов.
Кнопка забрать всё.
Категории товаров.
Страницы категорий.
Цена продажи для каждого предмета.
Очки прогрессии для каждого предмета.
Глобальная автоскупка.
Автоскупка отдельных предметов.
Права для доступа к автоскупке.
Постоянная прокачка множителя.
Бустеры множителя через права.
Ивенты скупщика по расписанию.
Временный множитель ивента для выбранных предметов.
SQLite и MySQL.
Поддержка Vault-экономики.
Настраиваемые GUI-предметы и layout.
Настраиваемые сообщения и actions.
Поддержка HEX-цветов.
Кастомные головы через basehead-материалы.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Как работает

Игрок открывает скупщика командой:

Код:

/seller

В меню есть слоты хранилища, куда можно положить продаваемые предметы.

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

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

────────────────────────────────────────

Хранилище скупщика

В главном меню есть настраиваемые слоты хранилища.

Слоты настраиваются в:

Код:

plugins/hSeller/guis/main.yml

В хранилище можно помещать только предметы, которые настроены как продаваемые.

Плагин также может запрещать предметы с кастомными метаданными, если включена настройка rejectMetaItems.

Пример:

Код:

settings:
  rejectMetaItems: true
  dropOnClose: false

Если dropOnClose выключен, предметы остаются в хранилище скупщика после закрытия меню.

────────────────────────────────────────

Ручная продажа

Игрок может продать все подходящие предметы через кнопку продажи.

GUI-preview может показывать:

базовую цену
цену с учётом множителя
категорию предмета
очки прогрессии
прогресс множителя

Плейсхолдеры из стандартного preview:

Код:

{basePrice}
{totalPrice}
{categoryName}
{points}
{multiplierProgress}

────────────────────────────────────────

Автоскупка

hSeller включает систему автоскупки.

Глобальная автоскупка переключается командой:

Код:

/seller autosell

Автоскупка конкретного предмета переключается командой:

Код:

/seller autosell <item>

Доступ к автоскупке можно контролировать через права.

Примеры прав:

Код:

hseller.autoseller.all
hseller.autoseller.*
hseller.autoseller.<item>

Так можно выдать доступ ко всей автоскупке, ко всем предметам или только к конкретным предметам.

────────────────────────────────────────

Категории

Предметы распределяются по файлам категорий.

Меню категорий:

Код:

plugins/hSeller/guis/categories.yml

Стандартные файлы категорий:

Код:

plugins/hSeller/guis/categories/blocks.yml
plugins/hSeller/guis/categories/farming.yml
plugins/hSeller/guis/categories/food.yml
plugins/hSeller/guis/categories/mob_drops.yml
plugins/hSeller/guis/categories/ores.yml

Каждый продаваемый предмет может иметь:

материал
display name
real name
lore
цену за единицу
очки прогрессии
actions
состояния автоскупки

Меню категорий открывается командой:

Код:

/seller categories

Конкретная категория открывается командой:

Код:

/seller category <category> [page]

────────────────────────────────────────

Прокачка множителя

В hSeller есть система постоянной прокачки множителя.

Игрок получает очки прогрессии за настроенные предметы. Когда очков достаточно, уровень множителя может повышаться.

Пример структуры:

Код:

settings:
  progression:
    levels:
      1:
        multiplier: 1.0
        requiredProgress: 0
      2:
        multiplier: 1.1
        requiredProgress: 100

В GUI можно показывать:

постоянный множитель
общий множитель
прогресс
оставшиеся очки
заработанные деньги

────────────────────────────────────────

Бустеры

Бустеры настраиваются в config.yml и выбираются по правам.

Примеры стандартных бустеров:

Код:

settings:
  boosters:
    none: "#FDBE00Нет"
    lite:
      boost: 0.5
    plus:
      boost: 1.0
    pro:
      boost: 1.5

Формат прав:

Код:

hseller.boosters.<booster>
hseller.boosters.*

Лучший доступный бустер может применяться к общему множителю продажи игрока.

────────────────────────────────────────

Ивенты скупщика

В плагине есть ивенты скупщика по расписанию.

Настройки ивентов находятся в:

Код:

plugins/hSeller/event.yml

Ивент может настраивать:

часовой пояс
формат времени
время запуска
длительность
количество ивентовых предметов
множитель ивента
затронутые категории
отключённые предметы
lore для ивентовых предметов
actions при старте и завершении

Во время активного ивента выбранные предметы могут получать дополнительный множитель и специальное lore.

Пример настроек:

Код:

settings:
  enable: true
  zone: "Europe/Moscow"
  duration: "01:00"
  itemCount: 100
  multiplier: 2.0

Администратор может управлять ивентом вручную:

Код:

/hseller event start
/hseller event stop

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Настройка GUI

Главное меню настраивается в:

Код:

plugins/hSeller/guis/main.yml

Можно настроить:

title меню
размер меню
слоты хранилища
preview lore
кнопку продажи
кнопку забрать всё
кнопку категорий
информационную кнопку
кнопку закрытия
декоративные предметы
actions кнопок

Меню категорий и каждая страница категории также полностью настраиваются.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

База данных

hSeller сохраняет данные игроков в базу данных.

Поддерживаемые режимы:

SQLite
MySQL

Сохраняются:

предметы в хранилище скупщика
состояние автоскупки
настройки автоскупки по предметам
количество проданных предметов
заработанные деньги
прогресс множителя
уровень множителя

Стандартный режим базы данных:

Код:

settings:
  database:
    mode: "sqlite"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Actions

hSeller использует настраиваемые actions для сообщений, команд, звуков, title, actionbar, эффектов и Vault-операций.

Секции actions:

Код:

reloaded
adminUsage
usage
notSellable
storageFull
storageEmpty
storageWithdrawn
noItemsToSell
autoSellEnable
autoSellDisable
itemAutoSellEnable
itemAutoSellDisable
sellableItemNotFound
categoryNotFound
multiplierLevelUp

Actions ивента настраиваются отдельно в event.yml.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Команды

Код:

/seller
/seller sell
/seller autosell
/seller autosell <item>
/seller categories
/seller category <category> [page]
/hseller reload
/hseller event start
/hseller event stop

Алиасы основной команды:

Код:

/buyer
/autoseller
/autobuyer
/скупщик
/автоскупщик

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Права

Код:

hseller.admin              - доступ к /hseller reload и командам ивента
hseller.autoseller.all     - разрешает переключать глобальную автоскупку
hseller.autoseller.*       - разрешает автоскупку всех настроенных предметов
hseller.autoseller.<item>  - разрешает автоскупку конкретного предмета
hseller.boosters.*         - доступ ко всем настроенным бустерам
hseller.boosters.<booster> - доступ к конкретному бустеру

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Требования

Java 17 или новее.
Minecraft 1.16 или новее.
Spigot / Paper / совместимое ядро.
Vault.
Плагин экономики с поддержкой Vault.

Важно: Vault обязателен, так как выплаты игрокам выполняются через Vault-экономику.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Установка

Установите Vault и плагин экономики.
Поместите hSeller.jar в папку plugins.
Запустите или перезапустите сервер.
Откройте созданные конфигурационные файлы.
Настройте цены, категории, GUI, базу данных и ивенты.
Перезапустите сервер или используйте /hseller reload после изменения конфигов.

Файлы конфигурации:

Код:

plugins/hSeller/config.yml
plugins/hSeller/event.yml
plugins/hSeller/guis/main.yml
plugins/hSeller/guis/categories.yml
plugins/hSeller/guis/categories/*.yml

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Примечания

Продаваться могут только настроенные предметы.
Цены и очки прогрессии задаются отдельно для каждого предмета.
Автоскупка может работать глобально или по отдельным предметам.
Ивенты могут временно повышать цену выбранных предметов.
Прогресс скупщика сохраняется в базе данных.
Выплаты выполняются через Vault-экономику.

Зависимости: Vault (Обязательно), PlaceholderAPI (Необязательно)

Команды и права: Выше всё написано

Платно Плагин hSeller [1.16.X-26.X] | PAPI, XSkull, Vault и много чего ещё поддерживается v1.0

Другие ресурсы пользователя He3HaukaX

Поделиться ресурсом

Мы ценим вашу конфиденциальность