Farm Zone

插件

· 作者 Wtrihardx

受保护农场:为玩家提供隔离且可扩展的私人区域,让他们在不受破坏或干扰的情况下进行农耕。 自动化经济系统:通过独特的定时漏斗售卖机制,调节并实现服务器收入的自动化管理。

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

最新 1.0.0 · 26.2 · Paper

一键开服(送7天)

FarmZone

简介: 私人万圣节主题农场世界,支持升级、受保护的建筑、共享访问、自动商店销售以及延迟收入。

FarmZone 是一款服务端 Paper 插件,为玩家提供一个附带自定义万圣节南瓜头的私人农场世界。每个农场区域(Farm Zone)初始为一个受保护的 25 × 25 × 25 区域,并可升级至 Level X。它专为作物农场、合作建造和自动化销售而设计,无需安装客户端模组。

功能特性

  • 带有独特农场区域身份的自定义雕刻万圣节南瓜头。
  • 将农场区域南瓜头放置在坚实地面上,已放置的区域之间至少需间隔 20 个水平方块。
  • 每位玩家最多拥有 2 个农场区域。
  • 每个区域对应一个独立的空农场世界。
  • 受保护的草地板、不可见的屏障墙壁和天花板;农场内无坠落伤害,且禁止玩家对战(PvP)。
  • I–X 级升级系统。每升一级,宽度、长度和高度各增加 10 个方块;Level X 尺寸为 115 × 115 × 115。
  • 移动南瓜头时,保留现有的建筑、储物设施、等级、成员、银行余额及测试状态。
  • 拾起的南瓜头可通过兼容的物品交易插件进行交易。放置南瓜头的玩家将成为所有者;没有“转移所有权”命令或菜单。
  • 默认情况下,最多可添加 3 位好友进行建造和破坏操作。
  • 最多可添加 3 位合作成员进入并查看农场,但无法建造、破坏、使用容器或获得额外权限。
  • 针对每位好友的独立权限控制,分别为建造、破坏、收割、容器、红石、水桶、实体和销售漏斗提供单独的图标。
  • 生产测试完成后,所有者、好友和合作成员可使用 /jump farmzone 和 /fz jump 传送至农场。
  • /leave farmzone 和 /fz leave 命令会在每次玩家离开时启动或重启 10 分钟的生产测试。
  • 外部全息投影显示剩余测试时间和农场的平均 10 分钟收入。
  • 收入存储在农场区域银行中,仅在测试结束后在农场外方可提取。
  • 增强对小麦、胡萝卜、土豆、甜菜根、下界疣、菌杆、甘蔗、仙人掌、竹子、浆果、可可和海带等作物的生长支持。
  • 自定义销售漏斗:Level I–IV 拥有 5 个可用槽位,Level V–IX 拥有 9 个槽位,Level X 拥有 13 个槽位。
  • 销售漏斗在相同方块高度的水平 2 个方块范围内(包括对角线)收集完整的物品堆叠。它不会收集上方或下方的物品,也不需要 feeder hopper(供给漏斗)。
  • 漏斗摄入计时:第一个物品堆叠耗时 1.5 秒,后续堆叠耗时 800 毫秒,空闲重置时间为 8 秒。
  • 销售通过 EconomyShopGUI 的官方售价集成运行。FarmZone 不发明备用价格。
  • 仅限管理员使用漏斗黑名单编辑器,基于实时的 EconomyShopGUI 商店目录进行操作。选择 Done(完成)后,更改会立即保存至 hopper-blacklist.yml。
  • 可选的 PrimeSellChest 集成,支持受保护的农场世界处理和农场区域银行支付。
  • 广泛的管理员控制功能,涵盖价格、维护、销售、全息投影、限制、区域锁定、统计、测试和安全农场尺寸压缩。
  • 英文界面、消息、命令帮助和标签补全。

要求与推荐服务器环境

要完整搭建 FarmZone 服务器,请使用以下环境栈:

  • Paper 1.20.4 或更高版本,处于支持的 1.20.x–1.21.x API 范围内。
  • Java 21 或更高版本,具体取决于所用 Paper 构建版本的 Java 要求。
  • Vault — 作为经济桥接所需。
  • EssentialsX — Vault 所需的经济提供者。也可以使用其他兼容 Vault 的经济提供者,但必须安装并启用其中一个。
  • EconomyShopGUI — 用于商店售价、库存限制和自动漏斗销售所需。
  • PlaceholderAPI — 用于服务器范围占位符兼容性以及其他暴露 FarmZone 占位符的插件所需。FarmZone 的核心经济和菜单本身不需要 PlaceholderAPI。
  • LuckPerms 或其他权限管理器 — 推荐用于分配 farmzone.admin 权限。
  • DecentHolograms 或其他全息图插件 — 对于希望使用独立全息图系统的服务器为可选。FarmZone 已经使用 Paper TextDisplay 实体创建自己的全息图,因此内置的倒计时和平均收入显示不需要外部全息图插件。

可选集成:

  • PrimeSellChest — FarmZone 检测并与受支持的公共 PrimeSellChest API 集成。如果缺失,FarmZone 仍可正常工作,只是缺少其额外功能。

简而言之,必需的运行链是 Vault + 经济提供者(如 EssentialsX)+ EconomyShopGUI。PlaceholderAPI 和外部全息图插件是推荐的集成项,而 FarmZone 的内置全息图显示无需其中任何一项即可工作。FarmZone 是一个服务器插件;玩家无需在客户端安装任何内容。不支持 Folia。应将 Paper 26.2 视为服务器端兼容性目标;在生产使用前,请在测试服务器上验证确切的服务器和依赖项版本。

官方下载链接

安装依赖项时,请使用以下可信的项目页面:

这些是标准的 Markdown 链接。Modrinth 会将它们渲染为项目描述中的可点击链接,以便读者可以选择依赖项名称或下载条目并直接跳转到其项目页面。

安装

  1. 停止服务器。
  2. 安装 Vault、一个 Vault 经济提供者和 EconomyShopGUI。
  3. (可选)安装 PrimeSellChest。
  4. 将 FarmZone-1.0.0.jar 放入服务器的 plugins 文件夹中。
  5. 启动服务器一次。FarmZone 会创建自己的数据文件夹和所需文件,包括 config.yml、data.yml 和 hopper-blacklist.yml。
  6. 赋予管理员 farmzone.admin 权限,或使用 OP(操作员)账号。
  7. 使用 /fz give <player> [amount] 给予玩家一个 Farm Zone 头颅,并将其放置在实地上。
  8. 首先,在管理面板中设置农场区域的升级价格。完成此操作后,玩家可以在每个等级以设定的价格升级他们的农田区域、漏斗容量以及作物生长速度。 第一个 Farm Zone 等级是免费的。默认情况下未设置升级价格,必须由管理员配置后,玩家才能购买升级。

玩家命令

所有常规命令均支持 /farmzone 及其简写别名 /fz。同时也提供独立的 /jump farmzone 和 /leave farmzone 形式。

命令 描述
/fz 或 /fz menu 打开已拥有的选定 Farm Zone 菜单。
/fz select <1|2> 选择玩家拥有的其中一个区域。
/fz jump [owner] 测试后进入已拥有或受邀的 Farm Zone。
/jump farmzone [owner] 替代跳转命令。
/fz leave 离开当前的 Farm Zone 并开始 10 分钟测试。
/leave farmzone 替代离开命令。
/fz invite <name> 邀请朋友,他们可以根据权限进行建造和破坏。
/fz remove <name> 移除受邀的朋友或合作成员。
/fz coop <name> 邀请永久只读模式的合作成员。
/fz uncoop <name> 移除合作成员。
/fz friends 打开朋友权限菜单。
/fz coops 查看并移除合作成员。
/fz permission <name> 打开选定拥有农场中某位朋友的权限。
/fz premission <name> 成员权限命令的接受拼写别名。
/fz upgrade 通过 Vault 购买下一个已配置的等级。
/fz claim 在农场外领取可用的 Farm Zone 银行余额。
/fz help 显示命令帮助。

普通玩家无法使用管理面板、管理员黑名单编辑器或全局区域控制功能。他们只能管理自己拥有的农场区域及其成员。合作成员仅具有查看权限,且无法升级为建造者。

管理员命令与权限

farmzone.admin 权限默认授予操作员(operator),并允许访问所有管理工具。

命令 描述
/fz admin 或 /fz adminpanel 打开管理面板。
/fz give <name> [1–64] 给予玩家农场区域头颅。
/fz list 列出已注册的农场区域及所有者。
/fz reload 重新加载配置、黑名单数据和集成模块。
/fz hopperblacklist 打开基于 EconomyShopGUI 的黑名单编辑器。

管理面板包含全局 I–X 级升级价格、全区域管理、区域锁定、生产暂停、即时测试完成、统计数据重置、删除确认、访客驱逐、维护、销售开关、全息图切换、农场限制、集成状态、头颅分发、重新加载和安全尺寸压缩等功能。

EconomyShopGUI 与漏斗黑名单

EconomyShopGUI 是物品售价和库存限制的唯一权威来源。当 EconomyShopGUI 不可用、物品没有有效价格、API 不兼容或材质被列入黑名单时,FarmZone 会保留存储的物品。

管理员可以执行 /fz hopperblacklist 打开编辑器。该编辑器读取服务器实际的 EconomyShopGUI 分类和产品物品。点击某个产品可切换其材质,然后点击右下角的 Done 保存。左下角的 Cancel 将丢弃草稿。保存的材质名称会自动写入以下文件:

plugins/FarmZone/hopper-blacklist.yml

示例:

items:
  - DIAMOND_BLOCK
  - NETHERITE_INGOT

材质名称为精确的 Bukkit/Minecraft 材质名称,且不区分大小写。如果 YAML 格式无效、材质名称无效或列表格式错误,系统将采取保守策略(fail closed):在文件修正并重新加载之前,FarmZone 不会出售任何物品。

PrimeSellChest

PrimeSellChest 为可选模块。当检测到受支持的版本时,FarmZone 会保护农场世界中的 Prime 箱子免受直接支付行为的影响,并将受支持的农场销售路由至 Farm Zone 银行。紧邻 FarmZone Sell Hopper 的 Prime 箱子可根据配置的倍率提高销售速度。PrimeSellChest 在农场区域之外的行为保持独立。

PrimeSellChest 的版本可能会更改其公共 API。在生产服务器上使用前,请确保将特定版本的 PrimeSellChest 与对应版本的 Paper 进行兼容性测试。

配置

生成的 config.yml 包含主要设置:

  • minimum-distance:头部之间的最小水平距离;默认值为 20。
  • max-zones-per-player:玩家最大拥有的区域数量;硬上限为 2。
  • base-size 和 base-height:初始尺寸;默认值为 25。
  • size-per-level 和 height-per-level:维度增长量;默认值为 10。
  • calibration-seconds:出发测试持续时间;默认值为 600 秒。
  • growth.bonus-per-level:额外生长加成;默认值为 0.35。
  • growth.offline-tick-chance:基础补充生长尝试概率;默认值为 0.06。
  • hopper.first-stack-millis:首次收集延迟;默认值为 1500。
  • hopper.next-stack-millis:后续收集延迟;默认值为 800。
  • hopper.idle-reset-millis:空闲重置时间;默认值为 8000。
  • hopper.sale-interval-ticks:正常出售间隔;默认值为 50 刻。
  • hopper.pickup-radius:水平收集范围;默认值为 2。
  • upgrade-prices.2 至 upgrade-prices.10:由管理员设置的全局价格。
  • blocked-commands:在农场区域中禁用的商店命令。

现有配置文件已迁移至当前的尺寸与生长默认值,同时保留已配置的升级价格。在压缩前会安全检查现有的大型农场。如果即将移除的区域包含玩家方块或实体,FarmZone 将保留旧尺寸,并提示管理员在清理后重试。

数据与隐私

FarmZone 将农场区域数据本地存储在服务器的插件文件夹中,包括所有权、成员、银行余额、漏斗内容、作物位置及设置。它不需要远程账户,也不会将玩家数据上传至远程服务。Vault、EconomyShopGUI 以及可选集成遵循其各自的行为和政策。

FarmZone 不与 Mojang、Microsoft、EconomyShopGUI、Vault 或 PrimeSellChest 有关联。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源