HLR (Crop hoppers) - HLR作物漏斗优化

HLR 是一款简单而强大的插件，旨在通过调整漏斗的工作方式来减少实体卡顿。它只会修改特定的漏斗，而不会完全改变原版体验。本插件尤其适用于拥有大量大型农场（包括刷怪农场）的服务器，例如常见的空岛或领地服。

💡工作原理

本插件通过将物品列表中出现的任何物品实体瞬间移动到区块内特定的漏斗中来实现优化。这从根本上消除了大量物品实体的物理计算，并降低了总体实体数量。它还能替代笨重的水流收集通道，并通过极大减少物品因飞出收集通道或被仙人掌等破坏而造成的损失，从而提高农场效率。

✨功能特性

• 可配置的权限使用
• 可配置的经济系统使用及 /converthopper 命令的费用
• 可配置的物品白名单（已预设默认物品，可禁用）
• 可配置的每个区块内优化漏斗数量上限
• 可配置的提示信息
• 可配置的 /converthopper 命令冷却时间及开关
• 可配置的漏斗名称与描述（Lore）
• 可配置的单次可转换的漏斗数量
• 可配置的启用世界
• 可配置的农场优化选项
• 轻量级设计

🎮命令与权限

命令

• /converthopper - 本插件的主要命令。将原版漏斗转换为特定漏斗。
• /HLR help - 显示本插件的帮助页面。
• /HLR reload - 重新加载配置文件。
• /HLR about - 关于本插件。显示作者和版本信息。
• /HLR give - 给予在线玩家优化后的漏斗。
• /HLR revert - 将优化后的漏斗恢复为原版状态。

权限

• /converthopper - HLR.convert
• 使用 /converthopper 时免除费用（如已设置）- HLR.nofee
• 使用 /converthopper 时免除冷却（如已设置）- HLR.nocooldown
• 转换漏斗时绕过转换数量限制（如已设置）- HLR.limitbypass
• 绕过区块漏斗数量限制（如已设置）- HLR.nochunklimit
• /HLR give - HLR.give*
• /HLR reload - HLR.reload*

> 注意：带星号()的权限无法在配置文件中禁用。

❓性能测试说明

> 注意：此性能测试无法完全体现插件的全部功能，因为我无法复现一个足够庞大的模拟环境来让插件发挥全部潜力。

>

> 测试在约60秒内完成，游戏规则 randomtickspeed 设置为60。为增加服务器负载，分配了2GB RAM（但效果有限）。服务器安装了 Essentials、WorldEdit、Vault、PermissionsEx 和本插件。

>

> **测试设置**

> 使用了一个 2313182 的仙人掌农场。

>

> **测试结果**

> 启用 HLR 后，实体数量及相关事件的处理器占用时间百分比（PCT Ticks）显著下降，从而降低了服务器负载。

🔧配置文件详解

# HLR v1.3.2 配置文件
# 由 despawningbone 创建

# 选择优化漏斗在哪些世界生效。
Enabled-in-worlds:
  - world

# 在此选择优化漏斗将吸收哪些类型的物品。
ItemList:
  # 包含所有常见农作物，例如南瓜、仙人掌、小麦、种子、胡萝卜、
  # 马铃薯（包括毒马铃薯）、甘蔗、红/棕色蘑菇、西瓜和地狱疣。
  Crops: true
  # 包含所有常见的生物掉落物，例如羽毛、生鸡肉、生牛肉、生猪排、
  # 生羊肉、蜘蛛眼、末影珍珠、骨头、箭、羊毛、铁锭、烈焰棒、火药、
  # 线、金粒、粘液球、墨囊、皮革、腐肉、海晶碎片、海晶砂粒和生鱼。
  Mob-drops: true
  # 在此添加你希望优化漏斗吸收的自定义物品。
  # 请使用 Bukkit 材料列表中的名称。
  # 对于有附加值（damage value）的物品，请在物品名后加冒号，如示例2所示。
  Custom-items:
    # - EXAMPLE_MATERIAL
    # - EXAMPLE_MATERIAL:1
    -

# 设置单次可以转换多少个漏斗。
# 例如：Max-amount: 5，玩家无法转换超过5个漏斗的漏斗堆。
Max-amount: 10

# 是否使用权限系统？
Use-permissions: true

# 在此设置单个区块内最多允许存在多少个优化漏斗。
# 设置为 -1 表示单个区块内优化漏斗数量无限制。
# 任何大于或等于 16*16 的数字都等同于无限制。
Chunk-HopperLimit: -1

# 优化漏斗被破坏时，是保留优化漏斗还是掉落一个新的原版漏斗？
Retain-tweaked: false
# 如果保留优化漏斗，是否仅在用精准采集挖掘时才掉落？
Silk-only: true
# 优化漏斗被破坏时，是直接掉入玩家背包还是正常掉落在地上？
# 这可以修复优化漏斗被破坏后飞出的问题。
To-inv: false

# 设置是否吸收玩家死亡掉落的物品。
Greedy-mode: false

# 为了进一步减少农场造成的卡顿，此设置强制以下类型的农场
# 仅在区块内存在优化漏斗时才能工作。
# 设置为 false 可禁用对该类农场的限制。
Farm-tweaks:
  # 此项指刷怪笼初始生成实体，而非其死亡。
  Spawners:
    Allow: true
    # 此项允许特定类型的刷怪笼在无优化漏斗时仍可工作。
    Whitelist:
      -
  # 此项指所有使用活塞破坏作物的农场。
  Piston-farms:
    Allow: false
    # 此项黑名单指定你不想让活塞收割的方块。默认为南瓜、西瓜和甘蔗。
    Blacklist:
      - PUMPKIN
      - MELON_BLOCK
      - SUGAR_CANE_BLOCK
  # 此项指所有用水流破坏作物的农场。
  Water-farms:
    Allow: true
    # 此项黑名单指定你不想让水流破坏的方块。默认为马铃薯、胡萝卜、小麦和地狱疣。
    Blacklist:
      - POTATO
      - CARROT
      - CROPS
      - NETHER_WARTS
  # 此项指通过相邻方块破坏仙人掌的传统方法。
  Cactus-farms: true

# 是否启用 /converthopper 命令的冷却时间？
Cooldown:
  Enable: false
  Seconds: 30

# 在此重命名优化漏斗的显示名称。
Hopper-name: "&3Farming &fHopper"
# 在此设置优化漏斗的描述（Lore）。
Hopper-lore:
  - "&7这个漏斗很特别。"
  - "&7它能找到特定的物品"
  - "&7并瞬间将物品传送过来。"

# 是否使用经济系统？需要 Vault API
Eco:
  Use: false
  Conversion-fee: 0.0

⭐待办事项与已知问题

待办事项

• 添加半径选项，而非仅限于单个区块
• 采纳您的建议

已知问题

• 如果管理员仅更改了优化漏斗的描述（Lore）或名称，拥有旧版优化漏斗的玩家将无法重新转换。
• 当触发异常处理时，触发异常的物品将不会被受影响区块内的任何优化漏斗拾取，即使存在优化漏斗。

源代码现已发布于 GitHub：https://github.com/despawningbone/HLR