新物品指示器

新物品指示器

当你首次在每个世界中发现物品时,显示特殊的"发现新物品!"通知。非常适合新玩家,并帮助你追踪新发现的内容。

生活质量

Discord


Item Collector

一款《Hytale》物品图鉴。记录你发现的每种物品,浏览完整收集网格,收藏你最爱的发现,并向100%完成度迈进。“发现新物品!”通知让你在拾取新物品时第一时间知晓。


功能

收集界面

  • 完整收集页面 —— 在一个分页网格中浏览游戏中的每种物品
  • 已发现的物品显示其图标和名称;未发现的物品显示为锁定的占位符
  • 3个标签页: 全部物品、收藏夹和最近发现
  • 按物品名称或编号搜索(例如:"wild"可找到野生浆果,"12"可找到所有#12xx编号的物品)
  • 按字母顺序、发现日期(最新/最旧切换)或类别排序
  • 收藏夹 —— 点击任何已发现物品上的星形图标即可收藏(金色星星=已收藏,灰色星星=未收藏)
  • 悬浮提示 —— 鼠标悬停在任何物品上可查看其稀有度、类别和描述
  • 进度标题显示你的发现数量和百分比(例如:"已发现 2/3173 (0.06%)")
  • 排序偏好为每位玩家单独保存
  • 物品单元格在悬停/点击时高亮显示
  • 切换收藏夹时有界面音效反馈

发现通知

  • “发现新物品!”通知,用于首次发现的物品
  • 基于世界的追踪(每个世界有独立的发现记录)
  • 带有星形图标的即时通知
  • 无重复通知(常规拾取由原版处理)

里程碑

随着你发现更多物品,获得里程碑通知:

  • 10 —— 探索者
  • 25 —— 收集者
  • 50 —— 爱好者
  • 100 —— 鉴赏家
  • 150 —— 档案员
  • 200 —— 学者
  • 300 —— 收集大师
  • 400 —— 传奇
  • 100% —— 完美主义者

要求

  • Java 21 或 25
  • Hytale 抢先体验版

安装

  1. 从“文件”标签页下载 ItemCollector-1.0.0.jar
  2. 将 JAR 文件放入 %AppData%\Roaming\Hytale\UserData\Mods\
  3. ItemCollector/ 资源文件夹复制到同一个 Mods\ 目录下
  4. 启动服务器并加入游戏
  5. 拾取任意物品 —— 如果这是你在此世界中首次拾取该物品,你将看到“发现新物品!”
  6. 使用 /collect 打开收集页面

使用方法

当你首次拾取一个物品时,发现通知会自动出现。无需设置。 当你想要浏览进度时,使用 /collect 打开收集页面。

指令

  • /collect —— 打开物品收集器(全部物品标签页)
  • /collect favorites/collect fav —— 打开收藏夹标签页
  • /collect recent —— 打开最近发现标签页
  • /collect stats —— 在聊天中显示发现统计信息
  • /collect help —— 显示指令用法
  • /newitem —— 显示插件信息
  • /newitem reset —— 清除当前世界中所有已发现的物品(会创建备份)

配置

设置按世界保存在:%AppData%\Roaming\Hytale\UserData\Saves\[WORLD_NAME]\mods\BeyondSmash_NewItemIndicator\config.json

收集数据(收藏夹、排序偏好)按玩家与配置文件一同保存。


工作原理

新发现: 当你在世界中首次拾取一个物品时:

  • 显示带有星形图标的“发现新物品!”通知
  • 以亮灰色文本显示物品名称
  • 保存到发现记录中
  • 记录时间戳,用于收集界面中的时间顺序排序
  • 之后再次拾取同一物品只显示原版通知

基于世界的系统:

  • 每个世界独立追踪已发现的物品
  • 创造世界的发现 ≠ 冒险世界的发现
  • 发现记录在游戏会话间保持不变

收集界面:

  • 浏览游戏中的所有物品 —— 已发现的物品显示图标,未发现的物品显示为锁定状态
  • 按名称、ID或物品编号搜索
  • 按A-Z、最新/最旧或类别排序
  • 为你的收藏夹标注星标以便快速访问
  • 悬停可查看包含稀有度、类别和描述的丰富悬浮提示
  • 活动标签页和排序按钮带有彩色下划线高亮

通知显示:

  • 位置:屏幕右下角
  • 图标:白色星形
  • 主要文本:"发现新物品!"(金色)
  • 次要文本:物品名称(亮灰色)
  • 持续时间:4秒

备份系统

/newitem reset 指令在清除已发现的物品之前会自动创建备份:

  • 备份存储在:%AppData%\Roaming\Hytale\UserData\Saves\[WORLD_NAME]\mods\BeyondSmash_NewItemIndicator\backups\
  • 自动保留最近3个备份(删除更早的备份)
  • 备份命名格式:config_YYYY-MM-DD_HH-mm-ss.json
  • 仅影响当前世界(其他世界不受影响)

示例备份:

config_2026-01-30_14-23-45.json

故障排除

通知不出现

  • 确保你在此世界中之前没有发现过这个物品
  • 检查原版物品拾取通知是否正常工作
  • 尝试使用 /testnewitemindicator 来验证通知是否工作

收集界面无法打开

  • 确保 ItemCollector/ 资源文件夹已放入你的 Mods\ 目录中
  • 检查服务器日志是否有错误

想要测试而不丢失进度?

  • 使用 /testnewitemindicator 而不是 /newitem reset
  • 如果你意外重置,备份文件在 backups\ 文件夹中

我的配置文件在哪里? %AppData%\Roaming\Hytale\UserData\Saves\[WORLD_NAME]\mods\BeyondSmash_NewItemIndicator\config.json (将 [WORLD_NAME] 替换为你实际的世界名称)

我可以手动编辑已发现的物品吗? 可以,在游戏关闭状态下编辑 config.json。每个世界都有一个UUID键,对应一个已发现的物品ID数组。


版本历史

v2.0.0 —— Item Collector

  • 从 New Item Indicator 品牌重塑为 Item Collector
  • 新增收集界面 —— 包含搜索、排序、收藏夹和悬浮提示的完整网格页面
  • 新增带标签页的 /collect 指令:全部物品、收藏夹、最近发现
  • 新增 /collect stats/collect help
  • 新增里程碑通知(探索者、收集者、爱好者等)
  • 新增带星形图标和音效反馈的收藏系统
  • 新增包含稀有度、类别和描述的丰富物品悬浮提示
  • 新增带有百分比的进度追踪标题
  • 物品单元格在悬停/点击时高亮显示

v1.0.1

  • 为适配更新3,在清单中添加了服务器版本

v1.0.0

  • 初始版本
  • 首次物品发现通知
  • 基于世界的追踪系统
  • 重置指令的备份系统
  • 带有金色“发现新物品!”文本的星形图标
  • 亮灰色的物品名称显示
  • 指令:/newitem/newitem reset

作者

BeyondSmash