XzHarvest
让每一次收获都更有价值。
XzHarvest 将普通的农业活动转化为一个完整的 SMP(单人多人服务器)进度循环。玩家可发现稀有作物,赚取农业经验值,通过动态商人出售收成,完成配送合约,在排行榜上竞争,并参与社区丰收活动。
它使用原版物品和 PersistentDataContainer 标识,因此无需资源包,且稀有收成的判定绝不单纯依赖显示名称或描述文本。
玩家可执行的操作
发现稀有收成
默认作物套装包括小麦、胡萝卜、马铃薯、甜菜根、可可豆、南瓜、西瓜和下界疣。每种作物均可产出四种稀有等级:
| 等级 |
每次合格收成的默认概率 |
默认额外经验值 |
| Fine (优质) |
8% |
1 |
| Golden (金色) |
2% |
3 |
| Enchanted (附魔) |
0.5% |
10 |
| Giant (巨型) |
0.1% |
50 |
每种作物都有独立的 YAML 配置文件,你可以更改其启用状态、稀有掉落概率、名称、描述文本、闪烁效果以及是否参与商人售卖、订单和活动。默认启用了玩家放置的南瓜和西瓜追踪功能,以减少“放置-破坏”式的刷取行为。
赚取农业经验值
成熟的合格作物会奖励标准的 Minecraft 经验值。各作物的数值可单独配置,稀有掉落还会提供额外的经验值奖励。XzHarvest 每秒缓冲一次支付,以避免为每株作物生成一个经验球。如果玩家的修复(Mending)装备受损,则会在适当时机使用经验球进行支付。
默认基础值范围从小麦、胡萝卜、马铃薯和甜菜根的 0.20 经验值到 下界疣的 0.35 经验值不等。基于权限组倍率使用最高匹配的主倍率,而配置的成员加成则累加至设定的总上限。
售卖与完成合约
/harvest merchant 打开丰收商人界面。它可以售卖支持的原版作物和稀有收成物品。价格默认为 DYNAMIC(动态),在 00:00 重置,并保持在每种作物配置的最小和最大价格范围内。
/harvest orders 打开配送板。初始配置包含 27 个活跃订单槽位,四小时过期时间和一小时完成冷却时间。安全合约会占用一个板槽位,直到完成或过期。风险合约可能需要押金并设定截止时间。
商人付款和默认的货币类合约操作需要 Vault 及一个经济插件支持。XzBank 可作为 XzPlugin 栈上的提供商,但任何兼容的 Vault 经济插件均可使用。
加入丰收活动
管理员可以手动启动配置好的社区活动。内置的 weekly_harvest_rush 持续一小时,拥有 5,000 株作物的社区目标,并记录每位玩家的贡献。符合条件的参与者及前三名贡献者将获得配置的奖励。
默认的活动奖励动作使用 PhoenixCratesLite 命令。运行活动前,请安装 PhoenixCratesLite 或在 events.yml 中替换这些动作。活动不会自动开始。
查看进度
玩家可以查看特定作物或综合的排行榜,涵盖今日、本周和历史所有时间。默认排行榜周期为一周,以周一作为每周起始日,缓存时间为 60 秒,最多显示十条记录。
要求
- Minecraft 服务器版本 1.21.11。
- Paper 或 Purpur。
- Java 21 或更高版本,遵循你的服务器软件所需的 Java 版本。
- XzCore 0.3.1。
可选集成:
- Vault 加上一个经济插件,用于商人付款和内置的货币合约。
- PlaceholderAPI,用于注册 XzHarvest 占位符。
- ajLeaderboards,用于在外部排行榜插件中消费这些占位符。
- PhoenixCratesLite,用于默认的丰收活动钥匙奖励。
这是一个服务器插件。玩家无需在客户端安装它。它不声明支持 Folia、Fabric/Forge 加载器或 Bedrock 服务器实现。
安装
- 首先安装 XzCore 0.3.1。
- 停止服务器,备份现有的 XzHarvest JAR 文件、
plugins/XzHarvest/ 文件夹和数据库。
- 将单个
XzHarvest-2.0.1.jar 放入服务器的 plugins 文件夹中。只保留一个活跃的 XzHarvest JAR 文件。
- 添加你打算使用的可选集成。
- 正常启动服务器,检查启动日志,然后运行
/harvest version、/xzharvest modules 和 /xzharvest data。
XzHarvest 捆绑了五个功能模块:稀有掉落、农业经验值、商人、订单和活动。首次启动时,它会将捆绑的模块 JAR 文件安装到 plugins/XzHarvest/modules/ 中。
从早期 XzHarvest 版本升级
更改 JAR 文件前请先备份。现有的已提取模块 JAR 文件被有意保留,因此仅替换主 JAR 文件不会替换它们。在迁移到较新的模块化版本时,请与主 JAR 文件一起审查和更新库存模块 JAR 文件。
保留所有者配置和数据。启动后运行 /xzharvest update 以审查配置的最新情况。仅在报告了你想要应用的更新时,才运行 /xzharvest update confirm。对于 JAR 文件的更改,请使用完整服务器重启。不要使用 Bukkit 的 /reload。
默认配置文件
plugins/XzHarvest/
├── config.yml
├── storage.yml
├── merchant.yml
├── orders.yml
├── shop.yml
├── leaderboard.yml
├── events.yml
├── xp.yml
├── audit.yml
├── messages.yml
├── menus.yml
├── modules.yml
├── crops/
│ ├── beetroot.yml
│ ├── carrot.yml
│ ├── cocoa.yml
│ ├── melon.yml
│ ├── nether_wart.yml
│ ├── potato.yml
│ ├── pumpkin.yml
│ └── wheat.yml
└── modules/orders/orders.yml
| 文件 |
配置项 |
config.yml |
启用的世界、调试模式以及玩家放置南瓜的追踪。默认的世界模式为 world、survival 和 resource 的白名单。 |
storage.yml |
存储后端。默认为 XZCORE,使用由 XzCore 插件拥有的 SQLite 存储。 |
crops/*.yml |
作物启用、稀有层级、商人资格、订单资格、活动资格以及方块追踪。 |
xp.yml |
作物经验值、发放时机、修补(Mending)行为、稀有加成以及乘数权限节点。 |
merchant.yml |
商人定价模式、重置时间以及基础/最低/最高作物价格。 |
shop.yml |
收获商人菜单布局和出售条目展示。 |
modules/orders/orders.yml |
交付板布局、货币、要求、奖励、赌注、过期时间和订单池。遗留的根目录 orders.yml 可保留作为兼容副本。 |
events.yml |
活动目标、持续时间、广播以及参与者或放置奖励。 |
leaderboard.yml |
周期、积分、缓存持续时间、结果数量以及排行榜菜单布局。 |
modules.yml |
在下次服务器启动时启用或禁用捆绑模块。 |
audit.yml |
稀有掉落审计日志记录以及异步审计批处理设置。 |
messages.yml 和 menus.yml |
面向玩家的提示消息和共享菜单默认值。 |
添加新的受支持作物类型需要修改代码。配置只能调整现有的八种捆绑作物类型,无法引入全新的作物注册表条目。
命令
/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 version |
xzharvest.admin.version |
显示 XzHarvest 和存储状态。 |
/xzharvest modules [info|enable|disable] <id> |
xzharvest.admin.modules |
检查模块健康状况或安排在下一次重启时更改模块。 |
/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 配置。 |
/xzharvest give <player> [crop] <rarity> [amount] |
xzharvest.admin.give |
给予一个参考稀有收获物品。 |
/xzharvest iteminfo |
xzharvest.admin.iteminfo |
检查手中物品的 XzHarvest 身份。 |
/xzharvest update [confirm] |
xzharvest.admin.update |
检查或应用安全配置更新。 |
/xzharvest data |
xzharvest.admin.data |
显示存储健康和表计数。 |
xzharvest.admin 默认授予操作员所有管理性 XzHarvest 权限。玩家权限 xzharvest.help、xzharvest.top 和 xzharvest.merchant 默认为开启。
PlaceholderAPI
安装 PlaceholderAPI 后,XzHarvest 提供以下格式的数值占位符:
%xzharvest_points_<crop|all>_<today|weekly|all>%
示例:
%xzharvest_points_all_weekly%
%xzharvest_points_pumpkin_all%
%xzharvest_points_wheat_today%
%xzharvest_points_carrot_weekly%
故障排除
| 症状 |
检查项 |
| 商人不可用 |
确认已安装 Vault 且已注册经济提供商。 |
| 活动密钥奖励未执行 |
安装 PhoenixCratesLite 或更改配置中的奖励动作。 |
| 没有稀有掉落或经验值 |
确认世界已被允许、作物已成熟、玩家不在创造/旁观者模式,且作物配置已启用。 |
| 模块被禁用 |
运行 /xzharvest modules info <id>,然后检查模块配置并在启用或禁用更改后重启。 |
| 缺少新的默认值 |
先运行 /xzharvest update。在使用 confirm 之前查看报告。 |
| 存储不健康 |
运行 /xzharvest data 并检查 XzCore 是否就绪。 |
XzHarvest
Make every harvest count.
XzHarvest turns ordinary farming into a complete SMP progression loop. Players discover rare crops, earn farming XP, sell harvests through a dynamic merchant, complete delivery contracts, compete on leaderboards and contribute to community harvest events.
It uses vanilla items and PersistentDataContainer identity, so no resource pack is required and rare harvests are never trusted by their display name or lore alone.
What players can do
Discover rare harvests
The default crop set includes wheat, carrots, potatoes, beetroot, cocoa, pumpkins, melons and nether wart. Each crop can reward four rare tiers:
| Tier |
Default chance per eligible harvest |
Default bonus XP |
| Fine |
8% |
1 |
| Golden |
2% |
3 |
| Enchanted |
0.5% |
10 |
| Giant |
0.1% |
50 |
Every crop has its own YAML file, so you can change its enabled state, rare-drop chances, names, lore, glint and participation in merchant, orders and events. Player-placed pumpkin and melon tracking is enabled by default to reduce placement-and-break farming abuse.
Earn farming XP
Eligible mature crops award normal Minecraft XP. Values are configurable per crop, and rare drops add their own XP bonus. XzHarvest buffers payouts every second to avoid spawning an orb for every crop. If the player has damaged Mending gear, the payout uses an XP orb when appropriate.
The default base values range from 0.20 XP for wheat, carrots, potatoes and beetroot to 0.35 XP for nether wart. Permission-based rank multipliers use the highest matching primary multiplier, while configured membership bonuses stack up to the configured total cap.
Sell and complete contracts
/harvest merchant opens the Harvest Merchant. It can sell supported vanilla crops and rare harvest items. Prices default to DYNAMIC, reset at 00:00, and stay inside each crop's configured minimum and maximum price.
/harvest orders opens the delivery board. A fresh configuration has 27 active order slots, a four-hour expiry and a one-hour completion cooldown. Safe contracts reserve a board slot until complete or expired. Risky contracts can require a stake and impose a deadline.
Merchant payments and the default money-based contract actions require Vault plus an economy provider. XzBank works as the provider on the XzPlugin stack, but any compatible Vault economy provider can be used.
Join Harvest Events
Staff can manually start configured community events. The bundled weekly_harvest_rush lasts one hour, has a 5,000-crop community goal and records each player's contribution. Qualifying participants and the top three contributors receive configured rewards.
The default event reward actions use PhoenixCratesLite commands. Install PhoenixCratesLite or replace those actions in events.yml before running the event. Events never start automatically.
Follow progress
Players can view crop-specific or combined leaderboards for today, this week and all time. The default leaderboard period is weekly, uses Monday as the week start, caches for 60 seconds and displays up to ten entries.
Requirements
- Minecraft server version 1.21.11.
- Paper or Purpur.
- Java 21 or newer, following the Java requirement of your server software.
- XzCore 0.3.1.
Optional integrations:
- Vault plus an economy provider for merchant payments and bundled money contracts.
- PlaceholderAPI to register XzHarvest placeholders.
- ajLeaderboards to consume those placeholders in an external leaderboard plugin.
- PhoenixCratesLite for the default Harvest Event key rewards.
This is a server plugin. Players do not install it on their clients. It does not claim Folia support, a Fabric/Forge loader or a Bedrock-server implementation.
Install
- Install XzCore 0.3.1 first.
- Stop the server and back up the existing XzHarvest JAR,
plugins/XzHarvest/ folder and database.
- Put the single
XzHarvest-2.0.1.jar in the server's plugins folder. Keep only one active XzHarvest JAR.
- Add the optional integrations you intend to use.
- Start the server normally, inspect its startup log, then run
/harvest version, /xzharvest modules and /xzharvest data.
XzHarvest bundles five feature modules: rare drops, farming XP, merchant, orders and events. On first startup, it installs the bundled module JARs into plugins/XzHarvest/modules/.
Upgrade from an earlier XzHarvest build
Back up before changing the JAR. Existing extracted module JARs are intentionally preserved, so replacing only the main JAR does not replace them. Review and update the stock module JARs together with the main JAR when moving to a newer modular release.
Keep owner configuration and data. Run /xzharvest update after startup to review configuration currency. Run /xzharvest update confirm only when it reports an update that you want to apply. Use a full server restart for JAR changes. Do not use Bukkit /reload.
Default configuration files
plugins/XzHarvest/
├── config.yml
├── storage.yml
├── merchant.yml
├── orders.yml
├── shop.yml
├── leaderboard.yml
├── events.yml
├── xp.yml
├── audit.yml
├── messages.yml
├── menus.yml
├── modules.yml
├── crops/
│ ├── beetroot.yml
│ ├── carrot.yml
│ ├── cocoa.yml
│ ├── melon.yml
│ ├── nether_wart.yml
│ ├── potato.yml
│ ├── pumpkin.yml
│ └── wheat.yml
└── modules/orders/orders.yml
| File |
What to configure |
config.yml |
Enabled worlds, debug mode and player-placed pumpkin tracking. The default world mode is a whitelist for world, survival and resource. |
storage.yml |
Storage backend. The default is XZCORE, which uses XzCore plugin-owned SQLite storage. |
crops/*.yml |
Crop enablement, rare tiers, merchant eligibility, order eligibility, event eligibility and block tracking. |
xp.yml |
Crop XP values, payout timing, Mending behavior, rare bonuses and multiplier permission nodes. |
merchant.yml |
Merchant pricing mode, reset time and base/minimum/maximum crop prices. |
shop.yml |
Harvest Merchant menu layout and sell-entry presentation. |
modules/orders/orders.yml |
Delivery board layout, currencies, requirements, rewards, stakes, expiry and order pool. The legacy root orders.yml can remain as a compatibility copy. |
events.yml |
Event goals, duration, broadcasts and participant or placement rewards. |
leaderboard.yml |
Periods, points, cache duration, result count and leaderboard menu layout. |
modules.yml |
Enables or disables bundled modules for the next server start. |
audit.yml |
Rare-drop audit logging and asynchronous audit batch settings. |
messages.yml and menus.yml |
Player-facing messages and shared menu defaults. |
Adding a new supported crop type is a code change. Configuration can adjust the eight bundled crop types, but cannot introduce an entirely new crop registry entry.
Commands
/harvest is an alias for /xzharvest.
| Command |
Permission |
Purpose |
/harvest |
xzharvest.help |
Open the harvest guide flow. |
/harvest top [crop|all] [today|weekly|all] |
xzharvest.top |
View farming leaderboards. |
/harvest merchant |
xzharvest.merchant |
Open the Harvest Merchant. |
/harvest orders |
None |
Open delivery contracts. |
/harvest event |
None |
Open the active event dashboard. |
/harvest event progress |
None |
Show current event progress in chat. |
/harvest stats [crop|all] [today|weekly|all] |
xzharvest.admin.stats |
View aggregate farming statistics. |
/xzharvest version |
xzharvest.admin.version |
Show XzHarvest and storage status. |
/xzharvest modules [info|enable|disable] <id> |
xzharvest.admin.modules |
Inspect module health or schedule a module change for the next restart. |
/xzharvest merchant reroll |
xzharvest.admin.prices |
Reroll active merchant prices. |
/xzharvest merchant set <crop> <price> |
xzharvest.admin.prices |
Set a crop price within its configured bounds. |
/xzharvest event start <id> |
xzharvest.admin.event |
Manually start a configured event. |
/xzharvest event complete|fail|cancel |
xzharvest.admin.event |
End the active event with the selected result. |
/xzharvest event preview <id> |
xzharvest.admin.event |
Preview an event without starting it. |
/xzharvest reload |
xzharvest.admin.reload |
Reload supported XzHarvest configuration. |
/xzharvest give <player> [crop] <rarity> [amount] |
xzharvest.admin.give |
Give a reference rare harvest item. |
/xzharvest iteminfo |
xzharvest.admin.iteminfo |
Inspect the held item's XzHarvest identity. |
/xzharvest update [confirm] |
xzharvest.admin.update |
Check or apply safe configuration updates. |
/xzharvest data |
xzharvest.admin.data |
Show storage health and table counts. |
xzharvest.admin defaults to operators and grants all administrative XzHarvest permissions. Player permissions xzharvest.help, xzharvest.top and xzharvest.merchant default to true.
PlaceholderAPI
When PlaceholderAPI is installed, XzHarvest provides numeric placeholders in this format:
%xzharvest_points_<crop|all>_<today|weekly|all>%
Examples:
%xzharvest_points_all_weekly%
%xzharvest_points_pumpkin_all%
%xzharvest_points_wheat_today%
%xzharvest_points_carrot_weekly%
Troubleshooting
| Symptom |
Check |
| Merchant is unavailable |
Confirm Vault is installed and an economy provider is registered. |
| Event key rewards do not run |
Install PhoenixCratesLite or change the configured reward actions. |
| No rare drops or XP |
Confirm the world is allowed, the crop is mature, the player is not in Creative/Spectator and the crop configuration is enabled. |
| A module is disabled |
Run /xzharvest modules info <id>, then inspect the module configuration and restart after an enable or disable change. |
| A new default is missing |
Run /xzharvest update first. Review the report before using confirm. |
| Storage is unhealthy |
Run /xzharvest data and check that XzCore is ready. |
评论 0
登录后参与评分
还没有评论,来抢沙发吧