XzHarvest

XzHarvest

XzHarvest is a Paper/Purpur farming plugin that adds rare crop drops, harvest leaderboards, a Vault-backed harvest shop, and audit-safe farming progression for SMP servers.

It is designed for survival and economy servers that want farming to feel more rewarding without relying on custom resource packs or unsafe item-name checks.

What XzHarvest Adds

XzHarvest adds a rare-drop system to vanilla crop farming. When players harvest supported crops, they can receive special rare harvest items with configurable names, lore, glint, and rarity.

Supported crops:

• Pumpkin
• Wheat
• Carrot
• Melon
• Potato
• Beetroot
• Nether Wart
• Cocoa

Default rarity tiers:

• Fine
• Golden
• Enchanted
• Giant

Each crop can be configured separately, including whether it is enabled, what material it uses, whether player-placed blocks are tracked, and what rare drops can roll.

Why Use XzHarvest?

XzHarvest gives farming a stronger purpose on SMP servers.

Players get:

• Rare crop drops while farming
• Leaderboards for daily, weekly, and all-time farming competition
• A harvest shop for selling crops and rare harvest items
• Clear feedback when rare drops are found

Server owners get:

• Configurable crop drop chances
• Secure rare item identity using PersistentDataContainer
• Player-placed pumpkin and melon tracking to reduce farming abuse
• Async audit logs for rare drops, harvest totals, shop sales, and daily stats
• Storage diagnostics through admin commands
• Safe config update and reload commands

Harvest Shop

XzHarvest includes a Vault-backed shop for selling supported vanilla crops and rare harvest items.

The shop can be configured through shop.yml, including:

• Menu title
• Item layout
• Filler items
• Button templates
• Vanilla crop prices
• Rare harvest item prices

Vault and an economy provider are required for shop features.

Leaderboards And Stats

XzHarvest tracks harvest activity and exposes leaderboard and stats commands.

Players can view:

• Top farmers
• Crop-specific rankings
• Daily rankings
• Weekly rankings
• All-time rankings
• Aggregate crop stats

PlaceholderAPI support is included for scoreboard integrations, including ajLeaderboards-compatible placeholders.

Configuration

On first startup, XzHarvest creates:

plugins/XzHarvest/
|-- config.yml
|-- messages.yml
|-- shop.yml
|-- leaderboard.yml
`-- crops/
    |-- beetroot.yml
    |-- carrot.yml
    |-- cocoa.yml
    |-- melon.yml
    |-- nether_wart.yml
    |-- potato.yml
    |-- pumpkin.yml
    `-- wheat.yml

Main configuration areas:

• config.yml controls worlds, messages, leaderboard points, audit settings, and performance settings.
• crops/*.yml controls each crop and its rare drops.
• shop.yml controls the harvest shop.
• leaderboard.yml controls leaderboard menu layout and display templates.
• messages.yml controls player-facing messages.

Requirements

• Java 21
• Paper or Purpur 1.21.11
• XzCore 0.2.0 or newer
• Vault plus an economy provider for shop features
• PlaceholderAPI optional
• ajLeaderboards optional

Commands

/harvest
Opens the default harvest command flow.

/harvest top [crop/all] [today/weekly/all]
View harvest leaderboards.

/harvest stats [crop/all] [today/weekly/all]
View harvest stats.

/harvest shop
Open the harvest shop.

/harvest version
View plugin and database status.

/xzharvest reload
Reload config, crop, message, shop, and leaderboard files.

/xzharvest give <player> [crop] <rarity> [amount]
Give rare harvest items.

/xzharvest iteminfo
Inspect the held XzHarvest item identity.

/xzharvest update [confirm]
Check or apply safe config migrations.

/xzharvest data
View storage diagnostics and table row counts.

Permissions

PlaceholderAPI

When PlaceholderAPI is installed, XzHarvest registers numeric placeholders:

%xzharvest_points_<crop|all>_<today|weekly|all>%

Examples:

%xzharvest_points_all_weekly%
%xzharvest_points_pumpkin_all%
%xzharvest_points_wheat_today%
%xzharvest_points_carrot_weekly%