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 会将它们渲染为项目描述中的可点击链接,以便读者可以选择依赖项名称或下载条目并直接跳转到其项目页面。
安装
- 停止服务器。
- 安装 Vault、一个 Vault 经济提供者和 EconomyShopGUI。
- (可选)安装 PrimeSellChest。
- 将
FarmZone-1.0.0.jar 放入服务器的 plugins 文件夹中。
- 启动服务器一次。FarmZone 会创建自己的数据文件夹和所需文件,包括
config.yml、data.yml 和 hopper-blacklist.yml。
- 赋予管理员
farmzone.admin 权限,或使用 OP(操作员)账号。
- 使用
/fz give <player> [amount] 给予玩家一个 Farm Zone 头颅,并将其放置在实地上。
- 首先,在管理面板中设置农场区域的升级价格。完成此操作后,玩家可以在每个等级以设定的价格升级他们的农田区域、漏斗容量以及作物生长速度。
第一个 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 有关联。
FarmZone
Summary: Private Halloween-themed farm worlds with upgrades, protected building, shared access, automated shop sales and delayed income.
FarmZone is a server-side Paper plugin that gives players a private farm world attached to a custom Halloween pumpkin head. Each Farm Zone starts as a protected 25 × 25 × 25 area and can be upgraded to Level X. It is designed for crop farms, cooperative building and automated sales without requiring a client-side mod.
Features
- Custom carved Halloween pumpkin head with a unique Farm Zone identity.
- Place Farm Zone heads on solid ground, with at least 20 empty horizontal blocks between placed zones.
- A maximum of 2 owned Farm Zones per player.
- A separate, empty farm world for every zone.
- Protected grass floor, invisible barrier walls and ceiling, no fall damage and no player-versus-player damage inside the farm.
- Level I–X upgrades. Each level adds 10 blocks to the width, length and height; Level X is 115 × 115 × 115.
- Existing buildings, storage, levels, members, bank balance and testing state are preserved when a head is moved.
- A picked-up head can be traded through a compatible item-trading plugin. The player who places it becomes the owner; there is no Transfer Ownership command or menu.
- Up to 3 friends who can build and break by default.
- Up to 3 co-op members who can enter and view the farm, but cannot build, break, use containers or receive extra permissions.
- Per-friend permission controls with separate icons for building, breaking, harvesting, containers, redstone, buckets, entities and the Sell Hopper.
/jump farmzone and /fz jump for owners, friends and co-op members after the production test is complete.
/leave farmzone and /fz leave start or restart the 10-minute production test every time a player leaves.
- Outside holograms show the remaining test time and the farm's average 10-minute income.
- Income is stored in the Farm Zone bank and can be collected only outside the farm after testing finishes.
- Stronger crop-growth support for wheat, carrots, potatoes, beetroot, nether wart, stems, sugar cane, cactus, bamboo, berries, cocoa and kelp.
- Custom Sell Hopper with 5 usable slots at Levels I–IV, 9 at Levels V–IX and 13 at Level X.
- The Sell Hopper collects complete item stacks within 2 horizontal blocks, including diagonals, at the same block height. It does not collect above or below itself and does not require a feeder hopper.
- Hopper intake timing: 1.5 seconds for the first stack, 800 ms for following stacks and an 8-second idle reset.
- Sales run through EconomyShopGUI's official sell-price integration. FarmZone does not invent fallback prices.
- Admin-only hopper blacklist editor using the live EconomyShopGUI shop catalog. Changes are saved to
hopper-blacklist.yml immediately when Done is selected.
- Optional PrimeSellChest integration with protected farm-world handling and Farm Zone bank payments.
- Extensive admin controls for prices, maintenance, sales, holograms, limits, zone locking, statistics, testing and safe farm-size compaction.
- English menus, messages, command help and tab completion.
Requirements and recommended server stack
For a complete FarmZone server setup, use this stack:
- Paper 1.20.4 or newer in the supported 1.20.x–1.21.x API range.
- Java 21 or newer, according to the Java requirement of the Paper build being used.
- Vault — required as the economy bridge.
- EssentialsX — requied economy provider for Vault. Another Vault-compatible economy provider can be used instead, but one must be installed and enabled.
- EconomyShopGUI — required for shop sell prices, stock limits and automated hopper sales.
- PlaceholderAPI — requied for server-wide placeholder compatibility and other plugins that expose FarmZone placeholders. FarmZone's core economy and menus do not require PlaceholderAPI by themselves.
- LuckPerms or another permissions manager — recommended for assigning
farmzone.admin.
- DecentHolograms, or another hologram plugin — optional for servers that want a separate hologram system. FarmZone already creates its own holograms with Paper TextDisplay entities, so an external hologram plugin is not required for the built-in countdown and average-income display.
Optional integrations:
- PrimeSellChest — FarmZone detects and integrates with supported public PrimeSellChest APIs. If it is missing, FarmZone still works without its extra features.
In short, the required runtime chain is Vault + an economy provider such as EssentialsX + EconomyShopGUI. PlaceholderAPI and an external hologram plugin are recommended integrations, while FarmZone's built-in hologram display works without either one. FarmZone is a server plugin; players do not need to install anything on their clients. Folia is not supported. Paper 26.2 should be treated as a server-side compatibility target; validate the exact server and dependency versions on a test server before production use.
Official download links
Use the following trusted project pages when installing dependencies:
These are normal Markdown links. Modrinth renders them as clickable links in the project description, so readers can select a dependency name or download entry and go directly to its project page.
Installation
- Stop the server.
- Install Vault, a Vault economy provider and EconomyShopGUI.
- Optionally install PrimeSellChest.
- Put
FarmZone-1.0.0.jar in the server's plugins folder.
- Start the server once. FarmZone creates its own data folder and required files, including
config.yml, data.yml and hopper-blacklist.yml.
- Give administrators the
farmzone.admin permission, or use an operator account.
- Give a player a Farm Zone head with
/fz give <player> [amount] and place it on solid ground.
- First, set an upgrade price for the farm zone in the admin panel. Once that's done, players can upgrade their farm area,hopper capacity, and crop growth rate for that set price at every level.
The first Farm Zone level is free. Upgrade prices are unset by default and must be configured by an administrator before players can purchase upgrades.
Player commands
All normal commands work with /farmzone and the short /fz alias. The separate /jump farmzone and /leave farmzone forms are also available.
| Command |
Description |
/fz or /fz menu |
Open the selected owned Farm Zone menu. |
/fz select <1|2> |
Select one of the player's owned zones. |
/fz jump [owner] |
Enter an owned or invited Farm Zone after testing. |
/jump farmzone [owner] |
Alternative jump command. |
/fz leave |
Leave the current Farm Zone and start the 10-minute test. |
/leave farmzone |
Alternative leave command. |
/fz invite <name> |
Invite a friend who can build and break according to their permissions. |
/fz remove <name> |
Remove an invited friend or co-op member. |
/fz coop <name> |
Invite a permanent view-only co-op member. |
/fz uncoop <name> |
Remove a co-op member. |
/fz friends |
Open the friend permission menu. |
/fz coops |
View and remove co-op members. |
/fz permission <name> |
Open permissions for a friend in the selected owned farm. |
/fz premission <name> |
Accepted spelling alias for the member permission command. |
/fz upgrade |
Purchase the next configured level through Vault. |
/fz claim |
Collect the available Farm Zone bank balance outside the farm. |
/fz help |
Show command help. |
Normal players do not receive the admin panel, the admin blacklist editor or global zone controls. They can manage only the Farm Zones they own and the members of those zones. A co-op member is always view-only and cannot be upgraded to a builder.
Admin commands and permission
The farmzone.admin permission is operator-default and grants access to all administration tools.
| Command |
Description |
/fz admin or /fz adminpanel |
Open the admin panel. |
/fz give <name> [1–64] |
Give a player Farm Zone heads. |
/fz list |
List registered Farm Zones and owners. |
/fz reload |
Reload configuration, blacklist data and integrations. |
/fz hopperblacklist |
Open the EconomyShopGUI-based blacklist editor. |
The admin panel includes global Level I–X upgrade prices, all-zone management, zone locking, production pause, immediate test completion, statistics reset, deletion confirmation, visitor eviction, maintenance, sales and hologram switches, farm limits, integration status, head distribution, reload and safe size compaction.
EconomyShopGUI and hopper blacklist
EconomyShopGUI is the authoritative source for item sell prices and stock limits. FarmZone keeps items stored when EconomyShopGUI is unavailable, an item has no valid price, the API is incompatible or the material is blacklisted.
Administrators can open /fz hopperblacklist. The editor reads the server's actual EconomyShopGUI categories and product items. Click a product to toggle its material, then click Done in the bottom-right corner to save. Cancel in the bottom-left corner discards the draft. The saved material names are written automatically to:
plugins/FarmZone/hopper-blacklist.yml
Example:
items:
- DIAMOND_BLOCK
- NETHERITE_INGOT
Material names are exact Bukkit/Minecraft material names and are case-insensitive. Invalid YAML, invalid material names or an invalid list format fail closed: FarmZone does not sell items until the file is corrected and reloaded.
PrimeSellChest
PrimeSellChest is optional. When a supported version is detected, FarmZone protects farm-world Prime chests from direct payout behavior and routes supported farm sales into the Farm Zone bank. A Prime chest immediately beside the FarmZone Sell Hopper can increase the sale speed according to the configured multiplier. PrimeSellChest behavior outside Farm Zones remains separate.
PrimeSellChest versions can change their public APIs. Test the exact PrimeSellChest version with the exact Paper version before using it on a production server.
Configuration
The generated config.yml contains the main settings:
minimum-distance: minimum horizontal distance between heads; default 20.
max-zones-per-player: maximum owned zones; hard-capped at 2.
base-size and base-height: starting dimensions; default 25.
size-per-level and height-per-level: dimension increase; default 10.
calibration-seconds: departure test duration; default 600 seconds.
growth.bonus-per-level: additional growth bonus; default 0.35.
growth.offline-tick-chance: base supplemental growth attempt chance; default 0.06.
hopper.first-stack-millis: first intake delay; default 1500.
hopper.next-stack-millis: subsequent intake delay; default 800.
hopper.idle-reset-millis: idle reset; default 8000.
hopper.sale-interval-ticks: normal sale interval; default 50 ticks.
hopper.pickup-radius: horizontal collection range; default 2.
upgrade-prices.2 through upgrade-prices.10: global prices set by administrators.
blocked-commands: shop commands blocked inside Farm Zones.
Existing configuration files are migrated to the current dimension and growth defaults while preserving configured upgrade prices. Existing larger farms are checked safely before compaction. If the area that would be removed contains player blocks or entities, FarmZone keeps the old dimensions and reports that an administrator can retry after clearing it.
Data and privacy
FarmZone stores Farm Zone data locally in the server's plugin folder, including ownership, members, bank values, hopper contents, crop positions and settings. It does not require a remote account or upload player data to a remote service. Vault, EconomyShopGUI and optional integrations follow their own behavior and policies.
FarmZone is not affiliated with Mojang, Microsoft, EconomyShopGUI, Vault or PrimeSellChest.
评论 0
登录后参与评分
还没有评论,来抢沙发吧