原创 闭源 工具 娱乐 DreamFarm - 一款多功能的农作物仓库[支持folia 版本1.12.x-26.x] 1.0.1

PS： 我对DreamFarm插件进行了重构，原来写的代码bug有点多​

目前支持的农作物:
​

DreamFarm​

> 成熟即入仓，仓库无上限，一键换钱 —— 一款为农业服打造的自动收集 / 虚拟仓库 / 一键出售插件。

为什么选 DreamFarm​

核心功能​

1. 自动收集​

2. 三种采集机制自动区分（对应作物配置的 `harvest-type`）：​

收获反馈做了聚合：ActionBar 与音效每 0.5 秒合并发送，高频收割也不卡​

虚拟仓库​

1. 每名玩家一份独立仓库，容量无上限
2. 单向流动：只能自动流入，取用与出售必须玩家主动操作，杜绝当作无限背包
3. 分页浏览，仓库再大也不卡界面

一键出售​

1. 每种作物独立每日限额，`daily-limit: 0` 表示不限
2. 到达重置时间自动清零，支持 **`HH:mm:ss` 时间** 与 **cron 表达式** 两种写法
3. 收入直接经 Vault 入账，价格 = 单价 × 数量
4. 出售顺序为「扣减 → 落盘 → 发钱」，异常时完整回滚

界面​

1. **原生 Bukkit Inventory 实现**，不依赖任何第三方 GUI 库
2. 界面识别靠 `InventoryHolder` 判定，不看标题，不会与其他插件串线
3. 标题、材质、lore、槽位全部 YAML 可配，出售按钮位置**自动跟随**作物卡片（`槽位 + 9`）
4. 支持 `model-data`（1.14+）与资源包自定义贴图
5. 文本支持占位符：`{crop_name}` `{amount}` `{daily_sold}` `{daily_limit}` `{can_sell}` `{total_value}` `{status}`
---

命令与权限​

命令​

/df crops 用法

/df crops WHEAT 1000 # 给自己发 1000 个小麦
/df crops 小麦 1000 # 中文名同样可用
/df crops carrots 64 Steve # 给在线玩家发
/df crops POTATO 500 Notch # 离线玩家也能发（需进过服务器）

点击展开...

作物名支持配置键（`WHEAT`）、英文别名（`wheat` / `carrots`）、中文名（`小麦`），未命中会列出全部可用值。

权限节点​

dreamfarm.use # 基础使用权限（打开界面） 默认: true
dreamfarm.autocollect # 自动收集权限 默认: true
dreamfarm.sell # 一键出售权限 默认: true
dreamfarm.withdraw # 从仓库取出物品 默认: true
dreamfarm.admin # 管理员权限（reload / crops） 默认: op

点击展开...

安装​

1. 安装前置：**Vault** + 经济插件（如 EssentialsX）
2. 将 `DreamFarm-1.0.0.jar` 放入 `plugins/`
3. 重启服务器

兼容性​

- **服务端**：Spigot / Paper / Purpur **1.12 – 26.x**，以及 **Folia**
- **硬前置**：仅 Vault
- **软前置**：Residence / GriefPrevention / WorldGuard / Towny（自动检测，不装也能跑）
- **跨版本材质**：由 XSeries 归一化，`SEEDS → WHEAT_SEEDS`、`CARROT_ITEM → CARROT` 自动映射
- **1.12 说明**：`BlockData` 相关代码只存在于现代适配器，1.12 运行时不会加载

点击展开...

常见问题​

**Q：玩家说作物没收进仓库？**
A：先确认该作物是否写进了 `crops:`（未写入就不注册收集）；再确认已成熟（未成熟会弹 Title）、且不是骨粉催熟（催熟不收）。
**Q：改配置要重启吗？**
A：不用。保存文件后 2 秒内自动重载，也可手动 `/df reload`。
**Q：切换存储后端会迁移数据吗？**
A：不会。`/df reload` 只切换读取源，请先备份再手工迁移。
**Q：手动改玩家数据文件不生效？**
A：请让该玩家先下线再改。在线玩家仓库常驻内存，每 30 秒回写一次会覆盖你的修改。
**Q：在 Folia 上能跑吗？**
A：可以。插件启动时会识别 Folia 并切换到区域调度，所有发包与开界面都派发到玩家所属区域；
传统端则继续使用主线程调度，互不影响。
**Q：1.12 服务器能用吗？**
A：能。`BlockData` 等 1.13+ API 只出现在现代适配器里，1.12 走传统实现；
---

点击展开...