TalePickup

TalePickup

Hytale 的自动拾取模组

方块掉落 | 生物掉落 | 树木检测 | 自动熔炼

6种语言 | 每玩家开关 | BFS 树木扫描器 | 可配置过滤器

TalePickup 能在物品掉落生成的瞬间，直接将其重定向至玩家的背包。

本模组适用于 Hytale 更新 5。

概述

TalePickup 是一款专为 Hytale 服务器打造的优质自动拾取插件：

• 即时拾取：物品作为实体生成的那一刻，会直接进入背包。零延迟，100% 原生 API。
• 智能树木检测：算法会扫描实际的树木形状。适用于任何大小或形状的树木。
• 自动熔炼：拾取时自动将矿石熔炼为锭。配方完全可配置。
• 生物掉落拾取：击杀生物，战利品直接进入背包。
• 每玩家控制：每位玩家可以独立开关拾取和自动熔炼功能。偏好设置会保存到磁盘。

主要特性

即时背包拾取

• 掉落物在作为物品实体生成的瞬间即被收集
• 与标准方块破坏、容器和生物击杀自然兼容
• 容器处理：所有类型的容器在被破坏时，其内容物直接掉入背包
• 创造模式保护：自动忽略处于创造模式的玩家
• 背包已满处理：剩余物品会留在地上，并显示节流通知
• 每件收集到的物品都会有原生的 "拾取"反馈

智能树木检测 (BFS)

• 可配置的扫描模式：定义哪些方块类型属于树木的一部分（树干、树枝、树叶、树根）
• 独立的触发模式：只有树干/树枝方块会触发扫描，单独的树叶不会
• 性能上限：可配置的最大方块数（默认：1024）和最大扫描半径（默认：40）
• 掉落偏移容忍：±1 个方块面的相邻检查，以捕获稍微偏离中心生成的物品
• 适用于任何树木大小：从小树苗到巨大的古树。

自动熔炼

• 完全可配置的配方：在配置文件中定义每种配方的输入、输出和数量
• 10 种默认矿石配方：铜、铁、金、银、钴、秘银、精金、钍、黑曜石、棱镜石
• 每玩家开关：玩家可以使用 /autosmelt 命令启用/禁用自动熔炼
• 全局配置控制：必须在配置文件中启用后，玩家才能使用
• 独立权限：talepickup.smelt 用于访问自动熔炼功能

生物掉落拾取

• 自动拾取玩家击杀的生物所掉落的物品
• 可配置生物死亡位置周围的拾取范围（半径和高度）
• 可与方块拾取功能独立地启用/禁用
• 遵循与方块掉落相同的白名单/黑名单过滤器

物品过滤

• 白名单模式：仅拾取特定物品
• 黑名单模式：拾取除特定物品外的所有物品
• 两种模式均可独立开关

命令与权限

玩家命令

权限： talepickup.use

• /talepickup = 开关自动拾取。(别名：/ap, /pickup, /autopickup, /autoloot)

权限： talepickup.smelt

• /autosmelt = 开关自动熔炼。(别名：/smelt, /as)

管理员命令

权限： talepickup.admin

• /talepickup reload = 重新加载配置和语言文件
• 管理员会在聊天中收到更新通知

本地化

6种完全翻译的语言，并具备缺失键的自动修复功能：

• 英语 (en)
• 德语 (de) = Deutsch
• 西班牙语 (es) = Español
• 法语 (fr) = Français
• 巴西葡萄牙语 (pt-br) = Português
• 土耳其语 (tr) = Türkçe

所有消息都可配置，并支持格式化标签，例如 、、 以及十六进制颜色代码。

适用于任何服务器类型

• 生存服务器：更流畅的采矿和农耕体验，地面无堆积物品。
• RPG / 进度型服务器：战斗和采集后的等待时间更少。自动熔炼加速矿石处理。
• 注重性能的世界：减少地面实体数量，帮助保持繁忙区域更整洁。
• QoL / 基础包：完美适配其他轻量级功能，不改变核心游戏玩法。

安装指南

1. 将 TalePickup.jar 放入您服务器的 mods 目录。
2. 启动服务器以生成 config.yml 和 /lang 文件。
3. 在 config.yml 中配置设置（语言、过滤器、树木检测、自动熔炼等）。
4. 使用 /talepickup reload 应用配置更改，无需重启服务器。