存储指南

StorageGuide

别再翻箱倒柜，直接找到你要的物品。

StorageGuide 能将你的 Minecraft 储藏室变成一个整洁、可搜索、由服务器驱动的库存地图。按下一个按键、输入物品名称，或手持想要存放的物品，StorageGuide 就会高亮显示它应该归属的箱子。

它专为真实的多人游戏基地而设计：由一名管理员定义一次储藏墙，所有玩家都能获得同样的引导式整理体验，无需记住告示牌、无需打开随机箱子，也无需第900次问“石英在哪里？”。

StorageGuide 还能处理装有物品的潜影盒，与 Photon 等光影包保持可见，甚至可以通过“老大哥”（可选的服务端监控系统）捕捉放错位置的物品，让共享储藏室保持整洁。

为什么要用 StorageGuide？

• 告别箱子抽奖： 搜索一次，直接找到正确的箱子。
• 共享基地的理想之选： 每个人都遵循同一个由服务器管理的储藏布局。
• 配置过程轻松愉悦： 游戏内菜单、物品图标、悬停帮助、颜色设置和按键绑定让设置变得简单。
• 潜影盒感知： 已装填的潜影盒可以根据其内容物路由，而不仅仅是盒子的颜色。
• 默认整洁： “老大哥”可以在物品放错位置时发出警告。
• 光影友好： 专用的高亮渲染可确保在常见的 Iris 光影管线中，箱子标记依然可见。

功能特点

• 即时物品查找： 按名称搜索，选择一个结果，本地箱子便会高亮显示。
• 手持物品定位： 手持物品并按 ~ 键，立即定位其配置的存放位置。
• 共享储藏地图： 一份由服务器管理的布局，让所有客户端保持同步。
• 智能潜影盒处理： 根据兼容的内容物为装满的潜影盒路由，支持所有颜色。
• 老大哥监控： 可选检测放错位置的物品，并保留按玩家分组的持久历史记录。
• 自定义公告： 管理员可以配置一个或多个“老大哥”消息模板，其中可使用 {playername} 占位符。
• 光影兼容高亮： 清晰的世界内标记可与 Iris 光影（包括 Photon）配合使用。
• 精良的菜单： 游戏内提供滚动条、物品图标、工具提示、颜色选择器和按键绑定控件。
• 安全的多人游戏兼容性： 版本感知的网络通信可避免盲目发送不受支持的包格式，并为较旧的客户端推荐升级。
• 单 Jar 文件，通用于各端： 在专用服务器、局域网主机和客户端上使用同一个 Fabric 模组。

快速开始

1. 一名管理员在储藏室的一面垂直墙上创建一个网格。
2. 管理员打开每个网格单元格，并分配属于该箱子的物品。
3. 玩家按 O 键并输入物品名称，或者手持物品并按 ~ 键。
4. StorageGuide 会为玩家本地高亮显示匹配的箱子。

操作控制

默认按键	动作
[	选择储藏网格或编辑一个网格单元格
O	打开物品查找器
~	定位手持物品

所有按键绑定都可以在 Minecraft 的控制菜单或 StorageGuide 的客户端设置界面中更改。

创建储藏网格

创建网格需要管理员权限。

1. 看向储藏墙的一个角落并按 [ 键。
2. 看向对角线的另一个角落并再次按 [ 键。
3. StorageGuide 会为该矩形内的每个方块创建一个单元格。

两个角落必须位于同一个垂直的 X/Y 或 Z/Y 平面上。每个一格的网格单元格代表一个存放位置，通常是由一个箱子或双箱的一半所占据的方块。

创建新网格会替换当前已配置的网格，因此请在确定好储藏墙的最终边界后再进行分配。

为箱子分配物品

1. 按一次 [ 键以显示已配置的网格。
2. 看向一个高亮显示的单元格并再次按 [ 键。
3. 选择所有属于该箱子的物品类型。
4. 按“保存”以应用草稿。编辑器会报告有多少物品被分配或移出了该箱子。

编辑器会沿你的视线方向选择第一个合适的网格方块。放在箱子前面的告示牌和物品展示框不会妨碍选择。

物品列表基于普通的创造模式物品栏标签页构建，排除了仅限管理员的物品。选中的物品会通过行颜色反馈高亮显示，长列表则使用鼠标滚轮配合滚动条滚动。一个箱子可以接受多种物品类型，但将物品分配给新单元格会将其从之前的单元格中移除，因此搜索时始终只有一个目的地。

离开世界、打开暂停菜单或按 Escape 键会取消正在进行的编辑流程，而不会保存未完成的更改。

寻找物品

按 O 键打开一个空白搜索框。输入时会出现结果，并使用不带 minecraft: 命名空间的简洁物品名称。选择一个结果即可关闭菜单并高亮显示其分配的箱子。查找器使用游戏内的原生物品图标、鼠标滚轮滚动，并在结果溢出时显示滚动条。

要跳过菜单，可以用任意一只手手持物品并按 ~ 键。当双手都持有物品时，主手优先。

如果没有为物品分配箱子，StorageGuide 会清除之前的任何结果，并报告没有匹配的单元格。

按下 ~ 键会短暂更改所选快捷栏边框，以显示查找状态：

• 绿色表示所选物品已配置了存放位置。
• 红色表示所选物品未分配给任何箱子。
• 非空的潜影盒仅当其所有内容都属于同一个配置好的箱子时，才会显示为绿色。

该状态会短暂地为原版 Minecraft 的选中栏位纹理重新着色，并在短暂延迟后恢复为正常状态。如果你切换快捷栏槽位，该状态会立即取消。两种状态颜色、已定位箱子高亮颜色以及指示器本身都可以在 StorageGuide 的 Mod Menu 配置界面中更改。

潜影盒

手持物品查找功能理解所有有色和无色的潜影盒：

• 非空的潜影盒会根据其内容物路由。每个非空槽位必须包含一个已分配到同一个存放单元格的物品。
• 空槽位会被忽略。
• 一个正确打包的潜影盒会高亮显示接受其内容物的箱子，即使该潜影盒自身的颜色被分配到了别处。
• 空的潜影盒被视为普通物品，并定位分配给该潜影盒颜色的箱子。
• 如果任何包含的物品未分配，或者内容物属于不同的单元格，则不会高亮显示任何箱子，玩家会看到：该潜影盒中的物品与任何箱子配置均不兼容。

高亮与光影

StorageGuide 会渲染自己的世界内单元格标记，而不是依赖原版的方块轮廓。这确保了查找和编辑时的提示在常见的 Iris 光影管线（包括 Photon 和 BSL）下依然可见。

高亮是客户端渲染的，只有发起请求的玩家才能看到。它们不会改变方块、容器或服务器照明。

老大哥

可选的“老大哥”监控功能会在玩家向已配置的箱子中添加不兼容物品时发出公告。默认情况下此功能是禁用的，并且需要管理员权限才能配置。

/storageguide big_brother
/storageguide big_brother on
/storageguide big_brother off
/storageguide sloppiness_detector
/storageguide sloppiness_detector on
/storageguide sloppiness_detector off

sloppiness_detector 命令作为兼容性别名保留。不带 on 或 off 的命令会报告当前状态。该设置保存在 config/storageguide.json 中。

老大哥：

• 仅检查新增的物品，而不会因为旧放错物品已经存在而发出警告；
• 移除物品时不会发出警告；
• 可以识别双箱的任一半；
• 如果一个非空的潜影盒中的所有内容物都属于该箱子，则接受该潜影盒；
• 将空的彩色潜影盒视为该特定潜影盒物品的分配；
• 每次检测到都会记录在持久历史中，即使没有发送公告；
• 允许管理员将单个已配置的箱子排除在检测之外；以及
• 按玩家和按箱子应用可配置的公告冷却时间，以防止聊天刷屏。

默认情况下，警告会广播为 Big Brother caught <player> slacking off.。管理员可以在管理员设置中更改消息。多个模板可以用 | 分隔；每次老大哥发布事件时都会随机选择一个。

任何人都可以通过 StorageGuide 的客户端设置或运行以下命令打开历史记录：

/storageguide history

历史记录会显示为一个玩家列表，每个玩家都有一个按钮，显示其被抓住的次数。选择一个玩家会显示其详细记录，最新记录优先，并带有物品图标。公告冷却时间不会移除或合并历史条目。

多人游戏与版本兼容性

服务器拥有网格、分配设置和老大哥设置的权限。客户端请求操作并渲染它们接收到的结果。

在连接时，兼容的客户端和服务器会交换它们的模组版本和协议版本。较新的版本会通告支持的包类型，并在对方不支持较新格式时使用旧版请求格式。不会盲目发送不支持的自定义包，从而防止格式更改导致旧版客户端断开连接。

如果玩家使用比服务器更旧的 StorageGuide 客户端加入，StorageGuide 会建议其升级，以便获得最新的 UI 和兼容性修复。

为了获得完整功能，请尽量让服务器和客户端使用相同的 StorageGuide 版本。

配置与备份

尽可能在游戏内配置 StorageGuide：

• 打开 暂停菜单 → StorageGuide 或 Mod Menu → StorageGuide → 配置，以更改已定位箱子高亮、已找到物品快捷栏颜色、未找到物品快捷栏颜色、按键绑定或快捷栏指示器。
• 管理员可以在连接到服务器时从该界面中选择 管理员设置。
• 玩家可以运行 /storageguide 或 /storageguide settings 打开 StorageGuide 的客户端设置。管理员可以直接运行 /storageguide operator_settings 打开服务器拥有的管理员设置。
• 管理员设置控制着老大哥、公告冷却时间、公告模板以及加入的客户端是否必须安装 StorageGuide。
• 使用 [ 键创建储藏网格并分配物品。单元格编辑在按下“保存”前保持为草稿状态，之后编辑器会显示已分配/已移除的物品数量。
• 单元格的编辑界面可以将该箱子排除在老大哥检测之外，而无需移除其物品分配。
• /storageguide big_brother 命令可用于进行基于命令的管理，/storageguide sloppiness_detector 作为别名保留。

游戏内工具会自动验证更改并保持分配的一致性。

客户端颜色保存到：

config/storageguide-client.json

服务器将此配置存储在：

config/storageguide.json

该文件包含网格边界、单元格分配与排除、管理员设置、老大哥消息模板以及老大哥历史记录。手动编辑仅适用于高级恢复或迁移。如有必要，请先停止服务器，并在更改或恢复文件之前进行备份。

故障排除

• 控制无反应： 确认客户端和服务器都已安装 StorageGuide 和 Fabric API。同时确保游戏设置中没有其他控件绑定到同一个按键。
• StorageGuide 没有“配置”按钮： 在客户端安装 Mod Menu。这是可选项，在服务器上不需要。
• 玩家无法编辑网格： 创建网格和编辑分配需要管理员权限。
• 找不到“管理员设置”： 先以管理员权限加入服务器，然后从 StorageGuide 客户端设置中打开，或运行 /storageguide operator_settings。
• 管理员设置显示需要权限： 菜单仍然可以查看，但服务器设置只能由管理员更改。
• 客户端加入时断开连接： 服务器可能要求所有加入的玩家都安装兼容的 StorageGuide 客户端。
• StorageGuide 建议升级： 你的客户端版本比服务器旧。安装当前版本的 StorageGuide，以免缺少新 UI 或包支持。
• 某个箱子从未触发老大哥： 检查该单元格的编辑界面中是否已标记为排除。
• 没有搜索结果显示： 只有已分配的物品才能产生箱子高亮。
• 潜影盒被拒绝： 其非空内容物必须全部归属于同一个存放单元格。
• 高亮被光影遮挡： 确认客户端正在运行当前版本。Photon 兼容性使用了模组专用的高亮渲染器。