Lf-Pistons

插件

· 作者 LF-Studios

使用活塞实现全自动作物收割——无需红石!

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

最新 2.0.1 · 1.21.11 · Paper / Purpur

一键开服(送7天)

? LF-Pistons

? 智能且优化的基于活塞的作物收割系统

Java 21 • Paper/Purpur 1.21.x


? 简介

LF-Pistons 是一个轻量级且高度可配置的插件,它利用活塞创建了一个优化后的自动收割系统。

当受支持的植物达到可收割阶段时,插件会检查是否有有效的活塞正对着该植物。如果检测到活塞,LF-Pistons 会自动收割该植物,生成掉落物,并在必要时安全地重置作物。

该系统基于事件驱动,并包含性能限制、缓存优化、掉落物分组以及自动 TPS/MSPT 保护功能,使其非常适合拥有大型农场和大量活跃玩家的服务端使用。

LF-Pistons 适用于:

  • 创建平衡的自动农场
  • 减少过度的红石使用
  • 防止不受控制的农场自动化
  • 替换沉重的活塞和方块更新系统
  • 创建自定义农业机制
  • 在不同世界中以不同方式控制农场

⚙️ 主要功能

? 农业系统

  • 当有效活塞指向成熟植物时自动收割
  • 支持普通活塞、粘性活塞或两者兼用
  • 可选的仅通电模式
  • 可配置的活塞检测半径
  • 自动作物重置
  • 成熟植物恢复
  • 自定义掉落物(含数量范围和概率)
  • 每种植物的独立行为配置
  • 可配置的骨粉行为
  • 默认启用所有内置支持的植物

? 按世界配置

每个世界都可以拥有独立的:

  • 启用状态
  • 注册植物列表
  • 活塞模式
  • 仅通电设置
  • 检测半径
  • 农场配置文件
  • 处理行为

?️ 可复用的农场配置文件

为不同类型的农场创建可复用的配置文件,并将其应用到多个世界中。

可以创建的示例配置文件包括:

  • 甘蔗
  • 竹子
  • 仙人掌
  • 海带
  • 传统农作物
  • 自定义植物布局

?️ 管理界面

  • 内置植物管理菜单
  • 植物搜索
  • 植物分类
  • 分页显示
  • 植物状态显示
  • 活塞模式选择
  • 移除植物前的确认提示
  • 菜单更改前的自动备份
  • 需要时的聊天输入交互

? 收割统计

持久化记录以下统计数据:

  • 全局范围
  • 按世界
  • 按植物类型
  • 总收割操作次数
  • 总收割植物单位数

可以通过命令和 PlaceholderAPI 访问统计数据。

? 语言支持

包含的语言:

  • English
  • Portuguese
  • French
  • Spanish

默认使用英文,可在 config.yml 中更改。


? 支持的植物

  • Pumpkin
  • Melon
  • Bamboo
  • Sugar Cane
  • Glow Berries / Cave Vines
  • Amethyst Clusters
  • Cactus
  • Kelp
  • Wheat
  • Carrots
  • Potatoes
  • Beetroots
  • Nether Wart
  • Cocoa
  • Sweet Berries
  • Torchflower
  • Pitcher Plant

可以使用可选的 ItemsAdder 和 CustomCrops 桥接插件配置其他自定义植物。


? 工作原理

  1. 注册的植物生长或变为可收割状态。
  2. LF-Pistons 检查是否有指向该植物的有效活塞。
  3. 验证配置的活塞类型和检测半径。
  4. 如果启用了“仅通电”模式,则活塞必须处于通电状态。
  5. 检查保护钩子和性能限制。
  6. 收割植物并生成其配置的掉落物。
  7. 可再生的作物被安全地重置为其初始阶段。
  8. 收割记录到统计系统中。

默认情况下,活塞只需指向植物即可。如果需要红石信号,请启用 powered-only。


? 活塞模式

  • NORMAL — 仅接受普通活塞
  • STICKY — 仅接受粘性活塞
  • BOTH — 接受普通活塞和粘性活塞

活塞模式可以全局配置、通过农场配置文件配置,或为每个世界单独配置。


? 单个植物设置

每种植物都可以覆盖全局配置。

可用选项包括:

  • 自定义活塞检测半径
  • 自定义掉落物
  • 最小和最大掉落数量
  • 独立掉落概率
  • 骨粉行为
  • 特定世界的覆盖设置

自定义掉落格式

MATERIAL:min-max:chance

示例:

WHEAT:1-2:1.0

此示例将以 100% 的概率生成 1 到 2 个小麦。

骨粉模式

  • VANILLA — 保持正常的 Minecraft 行为
  • HARVEST — 允许骨粉生长触发收割
  • DENY — 阻止骨粉影响已配置的植物

♻️ 成熟植物恢复

在 LF-Pistons 禁用期间、服务器启动期间或区块卸载期间,植物可能已经长至完全成熟。

LF-Pistons 可以自动恢复这些植物:

  • 在服务器启动期间
  • 当区块加载时
  • 当活塞被激活时
  • 使用 /lfpistons recover 命令时

加载的区块将逐步处理,以防止卡顿。


? 性能保护

LF-Pistons 包含多种系统,以安全地处理大型农场:

  • 基于事件的植物处理
  • 按世界的植物缓存
  • 安全的活塞检测缓存
  • 每秒刻全局收割限制
  • 自动 TPS 保护
  • 自动 MSPT 保护
  • 服务器过载时减少处理量
  • 增量式成熟植物恢复
  • 异步区块快照扫描
  • 按区块分组的掉落物
  • 每秒刻可配置的实体物品上限
  • 世界卸载时自动清理缓存
  • 无不受控制的全世界扫描

当服务端性能低于配置的 TPS 或超过配置的 MSPT 时,LF-Pistons 会暂时降低其处理限制。


? 检查与诊断

农场出现问题?LF-Pistons 包含内置的故障排除工具。

使用 /lfpistons inspect 并点击植物即可查看:

  • 检测到的活塞
  • 活塞方向
  • 距植物的距离
  • 当前运行模式
  • 仅通电状态
  • 植物未被收割的原因

可以为有限分钟数启用临时诊断。诊断系统会自动禁用自身,以防止不必要的日志记录。

示例:

/lfpistons diagnose 5

这将启用持续五分钟的高级诊断功能。


✅ 配置验证器

使用 /lfpistons validate 检测配置问题。

验证器会检查:

  • 无效的 Minecraft 材质
  • 不支持的植物
  • 无效的自定义掉落物
  • 危险的加工限制
  • 缺失的农场配置文件
  • 冲突的设置
  • 无效的世界配置

验证器仅在请求时运行,对服务器正常运行性能几乎没有影响。


⌨️ 命令

命令 描述
/lfpistons 显示可用命令或打开主界面
/lfpistons menu 打开植物管理菜单
/lfpistons status 显示植物、缓存、模式、服务器负载、待处理掉落物和诊断信息
/lfpistons stats [world] [plant] 显示持久化的收获统计数据
/lfpistons inspect 启用植物和活塞检查模式
/lfpistons validate 验证材质、掉落物、配置文件、限制和冲突
/lfpistons diagnose [minutes|off] 启用或禁用临时诊断
/lfpistons recover 在已加载区块中搜索成熟的植物
/lfpistons reload 重新加载插件并显示更改内容

命令别名:/lfp


? 权限

权限 描述 默认值
lfpistons.admin 完全访问管理命令和功能 操作员
lfpistons.status 允许访问 /lfpistons status 所有人
lfpistons.stats 允许访问收获统计 操作员
lfpistons.inspect 允许植物和活塞检查 操作员

? PlaceholderAPI

PlaceholderAPI 为可选组件。

可用的占位符:

  • %lfpistons_harvests_total% — 总收获操作次数
  • %lfpistons_plant_units_total% — 总收获植物单位数
  • %lfpistons_harvests_world% — 玩家当前世界中的收获次数
  • %lfpistons_harvests_world_WORLD_NAME% — 指定世界中的收获次数
  • %lfpistons_harvests_plant_MATERIAL% — 指定植物的收获次数
  • %lfpistons_state% — 当前系统状态
  • %lfpistons_mode% — 当前活塞模式
  • %lfpistons_cache_size% — 当前缓存大小
  • %lfpistons_pending_drop_groups% — 待处理掉落组
  • %lfpistons_diagnostics% — 诊断系统状态
  • %lfpistons_plants_world% — 当前世界中注册的植物数量

请将 WORLD_NAME 和 MATERIAL 替换为所需的世界名称或 Minecraft 材质名称。


? 可选集成

PlaceholderAPI

提供收获统计和系统状态的占位符。

WorldGuard

可选择性地阻止在受保护区域内进行自动收获。

GriefPrevention

可选择性地阻止在领地内(claims)进行自动收获。

ItemsAdder

提供对自定义植物标识符和显示物品的支持。

CustomCrops

提供对自定义作物、成熟阶段和自定义掉落物的支持。

所有集成为可选的软依赖项。LF-Pistons 可以在没有它们的情况下启动和运行。

WorldGuard 和 GriefPrevention 的限制默认处于禁用状态。由于自动生长缺乏明确的责任玩家身份,启用这些限制将阻止 LF-Pistons 在受保护位置内进行收获。


?️ 开发者 API

LF-Pistons 通过 Bukkit 的 ServicesManager 提供公共 API。

其他插件可以:

  • 访问已注册的植物
  • 读取收获统计数据
  • 检查活塞检测结果
  • 注册自定义保护钩子
  • 取消或修改收获行为
  • 在收获成功后接收信息

可用事件:

  • HarvestPreEvent — 可取消,并允许修改掉落物
  • HarvestPostEvent — 在成功收获后调用

? 配置安全

  • 自动配置迁移
  • 菜单更改前自动备份
  • 可配置的备份保留策略
  • 管理员变更历史记录
  • 详细的重新加载报告
  • 无效配置检测
  • 安全的缓存失效机制
  • 自动清理世界缓存

来自先前版本的现有配置会自动迁移。

我们仍然建议在每次重大更新之前创建备份。


? 安装

  1. 下载最新的 LF-Pistons JAR 文件。
  2. 停止 Minecraft 服务器。
  3. 将 JAR 文件放入 /plugins/ 文件夹中。
  4. 启动服务器。
  5. 配置生成的 plugins/LF-Pistons/config.yml 文件。
  6. 运行 /lfpistons validate。
  7. 运行 /lfpistons status 以确认系统已激活。

? 从旧版本升级

  1. 停止服务器。
  2. 备份现有的 plugins/LF-Pistons/ 文件夹。
  3. 用新版本替换旧的 JAR 文件。
  4. 正常启动服务器。
  5. 现有配置值将自动迁移。
  6. 启动后运行 /lfpistons validate。
  7. 查看控制台以获取迁移或验证警告。

除非您希望完全重置插件,否则请勿删除现有配置。


❓ 故障排除

如果植物未被收获:

  1. 运行 /lfpistons status。
  2. 运行 /lfpistons validate。
  3. 使用 /lfpistons inspect 并点击植物。
  4. 检查活塞是否朝向植物。
  5. 检查已配置的活塞模式。
  6. 检查是否启用了仅受动力驱动模式(powered-only mode)。
  7. 检查 WorldGuard 和 GriefPrevention 的限制设置。
  8. 如果植物已经成熟,请使用 /lfpistons recover。
  9. 如果问题仍然存在,请启用临时诊断功能。

? 重要说明

  • 专为性能和稳定性设计
  • 推荐用于生存和经济类服务器
  • 支持大型自动化农场
  • 除非启用仅受动力驱动模式,否则不需要红石
  • 现有配置会自动迁移
  • 可选的集成插件在启动时并非必需
  • 替换插件 JAR 文件前请务必停止服务器

? 技术支持

需要帮助或想要报告问题?

? 加入 LF Studios Discord


❤️ 由 LF Studios 制作

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源