[MD]
# WTF：潜影盒物品追踪模组
WTF 会记录你存放物品的位置，让你不再为“我到底把这东西放哪了？”而发愁。
模组会持续维护你已标记的每个箱子和潜影盒的清单：记录其中的物品、所在位置以及最后一次出现的位置，并提供可搜索的网格界面，帮助你快速找回需要的物品。
## 功能特色
- **可搜索的物品栏网格**：查看所有已追踪容器，并按物品名称搜索，快速确认某件物品存在哪个箱子里。
- **潜影盒追踪**：追踪潜影盒在背包、容器、方块状态与掉落物状态之间的移动。无论是放置、破坏、丢弃，还是被漏斗抽取，记录都会保持更新。
- **最后已知位置**：当潜影盒因漏斗、其他玩家操作或服务器同步等原因突然被移走时，WTF 会保留其最后已知位置，而不是直接丢失记录。
- **支持命名与未命名潜影盒**：优先通过名称识别潜影盒；无法使用名称时，则改用内容匹配等方式进行识别。
- **轻量信息提示**：通过工具提示和标记显示追踪信息，尽量不干扰正常游玩。
## 使用方法
将一个潜影盒标记为“Happy”。你可以在背包、箱子或其他容器界面中，将鼠标悬停在潜影盒上并按下对应快捷键；当潜影盒本身处于打开状态时，也可以使用 `☺/☹` 按钮进行标记。
完成标记后，WTF 会持续记录该潜影盒的实际位置，包括所在维度、坐标，以及它当前处于玩家背包、作为方块放置在世界中，还是以掉落物形式存在。潜影盒在不同容器之间移动、被放置或破坏、被漏斗抽取时，记录都会自动更新。
如果潜影盒暂时离开视野，模组仍会保留其最后已知的维度和位置，而不会直接删除追踪信息。
潜影盒会优先通过 UUID 标记识别；若标记缺失，例如未命名潜影盒或服务器同步清除了数据，则会回退至槽位位置或内容匹配方式，以避免不同潜影盒的身份记录混淆或互换。
追踪数据会跨游戏会话保存于 ``config/wtf/``。
## Happy Shulkers 管理界面
通过快捷键打开 **Happy Shulkers** 网格界面，即可浏览所有正在追踪的潜影盒和容器。
- 顶部搜索栏可按物品名称筛选全部已追踪容器。
- 左侧面板列出容器与分类。
- 右侧面板显示当前选中容器的物品预览及位置信息。
## 前置依赖
- Fabric API
- Fabric Language Kotlin
## 源码
## 截图
[/MD]
# WTF：潜影盒物品追踪模组
WTF 会记录你存放物品的位置，让你不再为“我到底把这东西放哪了？”而发愁。
模组会持续维护你已标记的每个箱子和潜影盒的清单：记录其中的物品、所在位置以及最后一次出现的位置，并提供可搜索的网格界面，帮助你快速找回需要的物品。
## 功能特色
- **可搜索的物品栏网格**：查看所有已追踪容器，并按物品名称搜索，快速确认某件物品存在哪个箱子里。
- **潜影盒追踪**：追踪潜影盒在背包、容器、方块状态与掉落物状态之间的移动。无论是放置、破坏、丢弃，还是被漏斗抽取，记录都会保持更新。
- **最后已知位置**：当潜影盒因漏斗、其他玩家操作或服务器同步等原因突然被移走时，WTF 会保留其最后已知位置，而不是直接丢失记录。
- **支持命名与未命名潜影盒**：优先通过名称识别潜影盒；无法使用名称时，则改用内容匹配等方式进行识别。
- **轻量信息提示**：通过工具提示和标记显示追踪信息，尽量不干扰正常游玩。
## 使用方法
将一个潜影盒标记为“Happy”。你可以在背包、箱子或其他容器界面中，将鼠标悬停在潜影盒上并按下对应快捷键；当潜影盒本身处于打开状态时，也可以使用 `☺/☹` 按钮进行标记。
完成标记后，WTF 会持续记录该潜影盒的实际位置，包括所在维度、坐标，以及它当前处于玩家背包、作为方块放置在世界中，还是以掉落物形式存在。潜影盒在不同容器之间移动、被放置或破坏、被漏斗抽取时，记录都会自动更新。
如果潜影盒暂时离开视野，模组仍会保留其最后已知的维度和位置，而不会直接删除追踪信息。
潜影盒会优先通过 UUID 标记识别；若标记缺失，例如未命名潜影盒或服务器同步清除了数据，则会回退至槽位位置或内容匹配方式，以避免不同潜影盒的身份记录混淆或互换。
追踪数据会跨游戏会话保存于 ``config/wtf/``。
## Happy Shulkers 管理界面
通过快捷键打开 **Happy Shulkers** 网格界面，即可浏览所有正在追踪的潜影盒和容器。
- 顶部搜索栏可按物品名称筛选全部已追踪容器。
- 左侧面板列出容器与分类。
- 右侧面板显示当前选中容器的物品预览及位置信息。
## 前置依赖
- Fabric API
- Fabric Language Kotlin
## 源码
## 截图
[/MD]