XzHarvest (Иксз харвест)

Плагин для серверов Майнкрафт, который превращает фермерство в систему развития: редкие урожаи, опыт, продажа, контракты, события и таблицы лидеров. Использует ванильные предметы, поэтому ресурс-пак игрокам не нужен.

Возможности

• Поддерживает пшеницу, морковь, картофель, свёклу, какао-бобы, тыквы, арбузы и незерский нарост.
• При сборе зрелой культуры может выпасть редкий урожай четырёх категорий: хороший, золотой, зачарованный или гигантский. Для каждой культуры настраиваются шанс, название, описание, эффект блеска и участие в торговле, заказах и событиях.
• За урожай начисляется опыт; редкие находки дают дополнительный опыт. Множители опыта можно выдавать через права.
• /harvest merchant открывает торговца урожаем с динамическими ценами в заданных границах.
• На доске заказов игроки сдают урожай по контрактам. Контракты могут быть безопасными либо рискованными — со ставкой и сроком выполнения.
• Есть общие события по сбору урожая с целью для сервера, учётом личного вклада и наградами участникам.
• Таблицы лидеров показывают результаты по отдельной культуре или всем культурам за день, неделю либо всё время.

Команды

/harvest — псевдоним команды /xzharvest.

• /harvest — открыть справку; право: xzharvest.help.
• /harvest top [crop|all] [today|weekly|all] — таблица лидеров; право: xzharvest.top.
• /harvest merchant — открыть торговца; право: xzharvest.merchant.
• /harvest orders — открыть доску заказов.
• /harvest event — открыть окно активного события.
• /harvest event progress — показать прогресс события в чате.
• /harvest stats [crop|all] [today|weekly|all] — общая статистика; право: xzharvest.admin.stats.
• /xzharvest merchant reroll — обновить цены торговца; право: xzharvest.admin.prices.
• /xzharvest merchant set <crop> <price> — установить цену культуры; право: xzharvest.admin.prices.
• /xzharvest event start <id> — запустить настроенное событие; право: xzharvest.admin.event.
• /xzharvest event complete|fail|cancel — завершить, провалить или отменить событие; право: xzharvest.admin.event.
• /xzharvest event preview <id> — посмотреть событие без запуска; право: xzharvest.admin.event.
• /xzharvest reload — перезагрузить поддерживаемые настройки; право: xzharvest.admin.reload.
• /xzharvest give <player> [crop] <rarity> [amount] — выдать образец редкого урожая; право: xzharvest.admin.give.
• /xzharvest iteminfo — проверить идентификатор предмета в руке; право: xzharvest.admin.iteminfo.
• /xzharvest data — проверить хранилище; право: xzharvest.admin.data.

Права

xzharvest.admin выдаётся операторам и даёт все административные права плагина. Права xzharvest.help, xzharvest.top и xzharvest.merchant доступны игрокам по умолчанию.

Настройка

Основные файлы находятся в plugins/XzHarvest/.

• config.yml — разрешённые миры, режим отладки и отслеживание поставленных игроком тыкв и арбузов.
• crops/*.yml — параметры каждой из поддерживаемых культур, редкости и участие в механиках.
• xp.yml — опыт, бонусы редких урожаев, лечение зачарованием «Починка» и множители по правам.
• merchant.yml и shop.yml — цены и меню торговца.
• modules/orders/orders.yml — контракты, награды, ставки, сроки и оформление доски.
• events.yml — цели, длительность и награды событий.
• leaderboard.yml — периоды, количество результатов и меню таблицы лидеров.
• modules.yml — включение модулей после перезапуска сервера.

При установленном PlaceholderAPI доступны числовые плейсхолдеры вида %xzharvest_points_<crop|all>_<today|weekly|all>%.

Требования

Работает на Paper и Purpur, требует Java 21 и XzCore. Для выплат торговца и денежных наград по контрактам нужны Vault и совместимый плагин экономики, включая XzBank. PlaceholderAPI добавляет плейсхолдеры, ajLeaderboards может выводить их во внешней таблице лидеров, а PhoenixCratesLite нужен для стандартных наград события ключами.