XzHarvest

插件

· 作者 Xenderz

将农业转化为进度系统,包含稀有作物、经验值、动态商人、配送合约和社区丰收活动。

0 本站下载 0 关注 更新于 2 个月前

需要前置:XzCore

最新 2.0.1 · 1.21.11 · Paper / Purpur

一键开服(送7天)

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 服务器实现。

安装

  1. 首先安装 XzCore 0.3.1。
  2. 停止服务器,备份现有的 XzHarvest JAR 文件、plugins/XzHarvest/ 文件夹和数据库。
  3. 将单个 XzHarvest-2.0.1.jar 放入服务器的 plugins 文件夹中。只保留一个活跃的 XzHarvest JAR 文件。
  4. 添加你打算使用的可选集成。
  5. 正常启动服务器,检查启动日志,然后运行 /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 是否就绪。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源