潜影盒预览（ShulkerBoxTooltip）
阅读
2020-10-31更新
最新编辑:Salt_lovely
阅读：
更新日期：2020-10-31
最新编辑：Salt_lovely
潜影盒预览（ShulkerBoxTooltip）是由MisterPeModder开发的 Fabric 模组，允许玩家在不放置或打开容器物品的情况下预览其中的存储，或是在不使用物品的情况下预览其战利品表。
简介
潜影盒预览（ShulkerBoxTooltip）是一个用于预览容器物品所包含的全部内容的 Fabric 模组，只需要将光标放在容器物品上并按下快捷键，即可在浮窗中查看该容器物品所存储的全部物品或战利品表。
对于绝大部分的常用功能（例如预览背包中的某个潜影盒存储了哪些物品），不论是在单人游戏还是多人游戏中使用，只需在客户端安装了此模组即可；但在多人游戏中，部分功能（例如预览自己的末影箱存储了哪些物品）需要服务端也安装了此模组，并且客户端与服务端分别启用了对应的通信配置才能使用。
下载
你可以在 CurseForge 或 GitHub 中找到本模组的简介和下载链接。如果长时间无法访问 CurseForge 的下载链接或无法加载其验证码，请转为在本模组于 GitHub 的 Releases 页面下载对应版本的 shulkerboxtooltip-<模组版本号>+<Minecraft 版本号>.jar 文件。
安装
确保你已安装了最新版本的 Fabric Loader，并且在 mods 文件夹中存在最新版本的前置模组 Fabric API。然后，只需将模组文件放入 mods 文件夹中即可完成安装。
预览浮窗
预览浮窗是用于显示一个容器物品的存储或一个物品的战利品表的界面，根据显示内容的不同方式又分为简略浮窗和完整浮窗。
默认情况下，模组会优先显示简略浮窗，然后才是完整浮窗，但可以通过模组配置文件（config/shulkerboxtooltip.json5）或模组菜单（Mod Menu） 中的模组配置界面来颠倒这一优先级。优先级的设定也会对快捷键的使用产生一定影响，详见快捷键与常用场景配置。
此外，预览浮窗的颜色、显示位置、每排格数等属性也可以在配置中进行修改。
简略浮窗
简略浮窗旨在直观地显示容器的存储或物品的战利品表中所包含的每种物品的数量，并且可以在配置中修改物品种类的区分方式。
NBT 分组标准
由于同种物品可能会因为不同的 NBT 标签而具有不同的功能（例如带有不同 NBT 的附魔书虽然拥有同样的命名空间 ID minecraft:enchanted_book，但会携带由 NBT 定义的不同的魔咒，使它们成为实际意义上“不同种”的物品），简略浮窗在配置中提供了基于 NBT 的三种不同分组标准，以确定是否要将不同 NBT 的同种物品合并计算与显示：
- 忽略 NBT
- 在该标准下，不论多个物品分别带有什么 NBT，只要它们拥有相同的命名空间 ID，就会在简略浮窗中合并显示为同一格物品，且物品数量是它们的数量之和。
- 首个 NBT
- 在该标准下，带有不同 NBT 的同种物品仍然会合并显示为同一格物品（就像“忽略 NBT”一样），但物品图标会取决于容器中首个此种物品的 NBT。
- 每个 NBT
- 在该标准下，拥有相同命名空间 ID 但带有不同 NBT 的物品会在简略浮窗中显示为不同格的不同物品。
完整浮窗
完整浮窗旨在完整显示容器中每个物品槽位的情况，或是战利品表的完整分布。因此在完整浮窗中，同种物品可以分散在不同的格子中显示，并且受到其可堆叠性与最大堆叠数的限制（就像普通容器界面中的物品陈列一样）。
浮窗颜色
预览浮窗在不受相关配置影响的情况下会显示为类似原版界面的灰白色，但默认有两个配置条目会对其进行修改，即彩色预览浮窗与外观。
彩色预览浮窗
此配置条目决定了预览浮窗的颜色是否会根据容器的颜色变化，且优先级高于外观配置：
- 是
- 在该选项下，浮窗颜色会变为容器的颜色——对潜影盒而言，浮窗的颜色就是染色潜影盒对应的颜色（未染色的潜影盒对应其未染色材质的紫灰色）；而对末影箱而言，浮窗的颜色就是末影箱材质的墨绿色
- 否
- 在该选项下，浮窗颜色取决于外观，不受容器颜色影响
外观
此配置条目决定了预览浮窗的颜色是否会根据外观主题变化，且仅在彩色预览浮窗的值为否时生效：
- 自动
- 在该选项下，如果安装了 LibGui 模组，则会根据其外观设定决定浮窗的外观是浅色还是深色；否则会使用浅色
- 浅色
- 在该选项下，浮窗颜色为默认的、类似原版的灰白色
- 深色
- 在该选项下，浮窗颜色为深灰色
浮窗自适应
默认情况下，预览浮窗会在界面超出窗口边框时尝试改变显示位置，从而避免界面无法完整显示。
具体来说，预览浮窗默认会在物品信息的上方显示；但当浮窗高度大于其底边到窗口边框的距离时（通常发生在预览容器中的容器物品，或将浮窗每行可显示的最大格数设置得过低时），浮窗就会超出窗口范围而显示不全。此时，默认启用的自适应功能会检测到这一情况，并将浮窗转为在物品信息的下方显示。
在配置文件中，有关浮窗自适应的条目说明是“禁用预览浮窗自适应”，且默认为否。这意味着如果你想启用自适应功能，则不应对该条目的默认值进行任何修改（可以通过点击该条目旁的“重置”恢复默认值）；
每排最大格数
默认情况下，预览浮窗每排最多显示 9 个格子（就像普通的容器界面一样），但你可以将其值设定为任意的正整数（低于 9 的数值可能会导致浮窗特别瘦长；而高于 9 的数值并不会带来任何改变，浮窗每排仍然只会显示 9 格）。
快捷键
默认逻辑
默认情况下，本模组的快捷键为以下两个：
| 按键 | 配置界面描述 | 功能 |
|---|---|---|
左 Shift |
呼出“简略浮窗” | 按下后显示高优先级的浮窗 （默认“简略浮窗”） |
左 Alt |
呼出“完整浮窗” | 按下后显示低优先级的浮窗 （默认“完整浮窗”） |
由于简略浮窗的默认优先级高于完整浮窗，所以完整浮窗需要在呼出简略浮窗后Alt（或修改后的低优先级快捷键）时并不能呼出完整浮窗；而在按住左 Shift（或修改后的高优先级快捷键）的同时再按下左Alt（或修改后的低优先级快捷键），完整浮窗才会显示。
完整浮窗优先
有时同时按下两个快捷键来查看完整浮窗会显得十分麻烦，或者你的使用习惯恰好与默认的优先级相反。此时，可以在配置中将“‘完整浮窗’优先”条目的值设定为是，这样完整浮窗就会由低优先级变为高优先级，而简略浮窗反之。在实际使用中，这体现为直接按下左Shift（或修改后的高优先级快捷键）即可查看完整浮窗，而简略浮窗需要在此基础上再按下左 Alt（或修改后的低优先级快捷键）。
预览浮窗常亮
如果不希望按下两个快捷键来查看另一种浮窗，或者单纯想什么也不按地预览，那么可以在配置中将“预览浮窗常亮”条目的值设定为是，这样每当光标覆盖到支持的容器或物品上时，高优先级的浮窗就会直接显示出来；如果想要切换低优先级的浮窗，则只需按下左Alt（或修改后的低优先级快捷键）一个按键。
常用场景配置
告别快捷键
在默认配置下，按下方表格所示来修改以下配置条目的值，就可以使你无需快捷键即可查看简略浮窗（按下左Alt 或修改后的低优先级快捷键以查看完整浮窗）：
| 配置条目 | 默认值 | 修改值 |
|---|---|---|
| 预览浮窗常亮 | 否 | 是 |
如果你习惯优先查看完整浮窗，则在此基础上做出以下修改（此时按下左Alt 或修改后的低优先级快捷键以查看简略浮窗）：
| 配置条目 | 默认值 | 修改值 |
|---|---|---|
| “完整浮窗”优先 | 否 | 是 |
统计材料数
在默认配置下，按下方表格所示来修改以下配置条目的值，就可以使你直接查看潜影盒中每种材料的总数（而不是让同种材料按最大堆叠数分散在不同的格子中）：
| 配置条目 | 默认值 | 修改值 |
|---|---|---|
| 预览浮窗常亮 | 否 | 是 |
| “简略浮窗”的 NBT 分组标准 | 每个 NBT | 忽略 NBT |
多人游戏预览末影箱
确保下方表格中的配置条目的值与服务端配置文件（config/shulkerboxtooltip.json5）中的值相同：
| 行数 | 配置条目 | 值 |
|---|---|---|
| 65 | "clientIntegration" |
true |
沪公网安备 31011002002714 号