StorageGuide
停止在箱子中盲目搜索,开始精准查找物品。
StorageGuide 将你的 Minecraft 储物间转化为一个干净、可搜索且由服务器支持的库存地图。按下按键、输入物品名称,或手持想要存放的物品,StorageGuide 就会高亮显示其所属的确切箱子。
它是为真正的多人游戏基地设计的:一名管理员只需定义一次储物墙,每个玩家都能获得相同的引导式整理体验,无需背诵标签、打开随机箱子,或第 900 次询问“石英到底放哪?”
StorageGuide 还能处理已封存的潜影盒,在与 Photon 等光影包一起使用时保持可见,甚至可以通过 Big Brother(一个可选的服务器端监控系统,用于保持共享储物整洁)来捕捉放置错误的物品。
为什么选择 StorageGuide?
- 告别随机开箱子: 搜索一次,直接前往正确的箱子。
- 非常适合共享基地: 每个人遵循相同的服务器管理储物布局。
- 配置过程真正愉快: 游戏内菜单、物品图标、悬停提示、颜色设置和按键绑定控制让设置变得平易近人。
- 支持潜影盒: 已封存的潜影盒可以按其内容而非仅按盒子颜色进行路由。
- 默认整洁有序: Big Brother 可以在物品被放置在错误位置时发出警告。
- 兼容光影: 专用的渲染高亮效果使箱子标记在使用常见的 Iris 光影管线时依然清晰可见。
功能特性
- 即时物品查找: 通过名称搜索,选择结果,并获得本地箱子的视觉高亮。
- 手持物品定位: 手持物品并按下
~ 键,立即定位其配置的目的地。
- 共享储物地图: 一个由服务器管理的布局确保所有客户端同步。
- 智能潜影盒处理: 根据兼容的内容对满装潜影盒进行路由,支持所有颜色。
- Big Brother 监控: 可选地检测放置错误的物品,并保留按玩家分组的持久历史记录。
- 自定义公告: 管理员可以配置一个或多个 Big Brother 消息模板,其中包含
{playername} 占位符。
- 兼容光影的高亮显示: 清晰的世界内标记可与 Iris 光影配合使用,包括 Photon。
- 精致的菜单: 游戏内提供滚动条、物品图标、工具提示、颜色选择器和按键绑定控制。
- 安全的多人游戏兼容性: 版本感知的网络通信避免盲目发送不受支持的数据包格式,并为旧版客户端推荐升级。
- 单文件适用于所有端: 在专用服务器、局域网主机和客户端上使用同一个 Fabric 模组。
快速入门
- 一名管理员在储物间的某一垂直侧面创建网格。
- 管理员打开每个网格单元,并分配属于该箱子的物品。
- 玩家按下
O 键并输入物品名称,或手持物品并按下 ~ 键。
- StorageGuide 为该玩家本地高亮显示匹配的箱子。
控制键
| 默认按键 |
操作 |
[ |
选择储物网格或编辑网格单元 |
O |
打开物品查找器 |
~ |
定位手持物品 |
所有按键绑定都可以在 Minecraft 的控制菜单中更改,也可以直接从 StorageGuide 的客户端设置屏幕中更改。
创建储物网格
创建网格需要管理员权限。
- 注视储物墙的其中一个角落,然后按下
[。
- 注视对角线相对的另一个角落,再次按下
[。
- StorageGuide 会在该矩形区域内的每个方块上创建一个单元格。
两个角落必须位于相同的垂直 X/Y 或 Z/Y 平面上。每个占据一个方块的网格单元代表一个储物位置,通常是箱子所占用的方块或双层箱子的一半。
创建新网格会替换当前配置的网格,因此请在确定最终边界后再分配储物墙。
为箱子分配物品
- 按下
[ 一次以显示已配置的网格。
- 注视高亮的单元格,再次按下
[。
- 选择所有属于该箱子的物品类型。
- 按下 Save(保存)应用草稿。编辑器会报告有多少物品被分配到该箱子或被从该箱子移除。
编辑器会沿你的视线方向选择第一个适用的网格方块。箱子前面安装的告示牌和物品展示框不会阻止选中它。
物品列表基于正常的创造模式库存选项卡构建,并排除仅限管理员使用的技术条目。选中的物品会通过行颜色反馈进行高亮显示,长列表则使用鼠标滚轮滚动和滚动条。一个箱子可以接受多种物品类型,但将物品分配给新单元格会从之前的单元格中移除该物品,以确保搜索始终只有一个目的地。
离开世界、打开暂停菜单或按下 Escape 键会取消当前的编辑流程,而不会保存未完成的更改。
查找物品
按下 O 打开空白搜索字段。随着你输入内容,结果会出现,并使用干净的物品名称,不包含 minecraft: 命名空间。选择一个结果即可关闭菜单并高亮显示其分配的箱子。查找器使用原生的游戏内物品图标、鼠标滚轮滚动以及当结果溢出时显示的滚动条。
要跳过菜单,请手持任一手中的物品并按下 ~ 键。当双手都持有物品时,主手优先。
如果没有箱子与该物品关联,StorageGuide 会清除任何先前的结果,并报告不存在匹配的单元格。
短暂按下 ~ 会将选中的快捷栏帧变色以显示查找状态:
- 绿色表示选中的物品已配置了存储目的地。
- 红色表示选中的物品未分配到任何箱子。
- 非空的潜影盒仅在所有内容都属于同一个配置的箱子时才显示为绿色。
该状态会短暂地将原始 Minecraft 选中槽位的纹理重新着色,并在短暂延迟后恢复为正常状态;如果你切换槽位,状态显示会立即取消。两种状态颜色、已定位箱子的突出显示颜色以及指示器本身都可以从 StorageGuide 的 Mod Menu 配置屏幕中进行更改。
潜影盒
手持物品查找功能理解所有彩色和无色的潜影盒:
- 非空的潜影盒会根据其内部物品进行路由。每个非空槽位必须包含分配给同一存储单元的物品。
- 空槽位将被忽略。
- 正确打包的潜影盒会高亮显示接受其内容的箱子,即使该潜影盒自身的颜色被分配到了其他地方。
- 空的潜影盒被视为普通物品,并定位到分配给该特定潜影盒颜色的箱子。
- 如果任何内部物品未分配,或者内容属于不同的单元,则不会高亮任何箱子,玩家会看到:
The shulker box has items incompatible with any chest configuration(潜影盒中的物品与任何箱子配置不兼容)。
高亮显示与光影
StorageGuide 渲染自己世界内的单元标记,而不是依赖原版的方块轮廓。这使得查找和编辑高亮在常见的光影管线中可见,包括 Photon 和 BSL。
高亮显示仅针对客户端,并且只有请求它们的玩家才能看到。它们不会改变方块、容器或服务器光照。
Big Brother(大兄弟)
可选的 Big Brother 监控会在玩家向已配置的箱子中添加不兼容物品时发出公告。默认情况下禁用此功能,并且需要操作员权限才能配置。
/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:
- 检查新添加的物品,而不仅仅是因为已经存在旧的错位物品而警告;
- 移除物品时不会发出警告;
- 理解双层箱子的任一半;
- 当所有物品都属于该箱子时,接受非空的潜影盒;
- 根据该特定潜影盒物品的分配来处理空的彩色潜影盒;并且
- 记录每次检测到的实例到持久历史记录中,即使没有发送公告;
- 允许操作员排除单个已配置的箱子不被检测;并且
- 为每个玩家和每个箱子应用可配置的公告冷却时间,以防止聊天 spam。
默认情况下,警告广播为 Big Brother caught <player> slacking off.(大兄弟抓到 <玩家> 偷懒了.)。操作员可以在操作员设置中更改消息。多个模板可以用 | 分隔;每次 Big Brother 宣布事件时选择一个。
任何人都可以通过 StorageGuide 的客户端设置或运行以下命令打开历史记录:
/storageguide history
历史记录以玩家列表形式打开,每个玩家都有一个按钮显示他们被抓到的实例数量。选择一名玩家会按最新优先顺序显示他们的详细信息,并带有物品图标。公告冷却时间不会移除或合并历史记录条目。
多人游戏与版本兼容性
服务器拥有网格、分配和大兄弟设置。客户端请求操作并渲染接收到的结果。
连接时,兼容的客户端和服务器交换它们的模组和协议版本。新版本构建广告支持的数据包类型,并在另一方不支持较新格式时使用旧版请求格式。不支持自定义数据包不会盲目发送,防止格式更改导致旧节点断开连接。
如果玩家使用比服务器旧的 StorageGuide 客户端加入,StorageGuide 建议升级,以便获得最新的 UI 和兼容性修复。
为了获得完整功能,请尽可能保持服务器和客户端在同一版本的 StorageGuide 上。
配置与备份
尽可能在游戏中配置 StorageGuide:
- 打开 Escape Menu → StorageGuide(退出菜单 → StorageGuide)或 Mod Menu → StorageGuide → Configure(模组菜单 → StorageGuide → 配置)来更改定位的箱子高亮、找到的物品快捷栏颜色、缺失物品的快捷栏颜色、按键绑定或快捷栏指示器。
- 操作员可以在连接到服务器时从该屏幕选择 Operator Settings(操作员设置)。
- 玩家可以运行
/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。此为可选模块,服务端无需安装。
- 玩家无法编辑网格: 网格的创建与分配编辑需要操作员权限。
- 找不到操作员设置(Operator Settings): 请先以操作员权限加入服务器,然后通过 StorageGuide 客户端设置打开它,或执行
/storageguide operator_settings 命令。
- 操作员设置提示需要权限: 菜单仍可查看,但只有操作员才能更改服务器设置。
- 加入时客户端断开连接: 服务器可能要求所有加入的玩家安装兼容版本的 StorageGuide 客户端。
- StorageGuide 建议升级: 您的客户端版本低于服务端。请安装最新版的 StorageGuide,以避免缺少对新 UI 或数据包的支持。
- 箱子从未触发 Big Brother 高亮: 请检查该存储格是否在其编辑界面中被标记为排除项。
- 未显示搜索结果: 仅已分配的方块才会产生箱子高亮效果。
- 潜影盒被拒绝: 其非空内容必须全部分配给同一个存储格。
- 高亮被光影遮挡: 请验证客户端是否运行的是当前发布版本。Photon 兼容性依赖模组专用的渲染器进行高亮显示。
StorageGuide
Stop searching chests. Start finding items.
StorageGuide turns your Minecraft storage room into a clean, searchable, server-backed inventory map. Press a key, type an item name, or hold the item you want to store, and StorageGuide highlights the exact chest it belongs in.
It is built for real multiplayer bases: one operator defines the storage wall once, and every player gets the same guided organization without memorizing signs, opening random chests, or asking “where do we keep the quartz?” for the 900th time.
StorageGuide also handles packed shulker boxes, stays visible with shader packs such as Photon, and can even catch misplaced items with Big Brother, an optional server-side monitoring system for keeping shared storage tidy.
Why StorageGuide?
- No more chest roulette: Search once and go straight to the right chest.
- Perfect for shared bases: Everyone follows the same server-managed storage layout.
- Actually pleasant to configure: In-game menus, item icons, hover help, color settings, and keybind controls keep setup approachable.
- Shulker-aware: Packed shulkers can be routed by their contents, not just by box color.
- Tidy by default: Big Brother can warn when items are placed where they do not belong.
- Shader-friendly: Dedicated highlight rendering keeps chest markers visible with common Iris shader pipelines.
Features
- Instant item lookup: Search by name, select a result, and get a local chest highlight.
- Held-item locating: Hold an item and press
~ to locate its configured destination immediately.
- Shared storage maps: One server-managed layout keeps every client in sync.
- Smart shulker handling: Route full shulker boxes by compatible contents, with support for every color.
- Big Brother monitoring: Optionally detect misplaced items and keep a persistent, player-grouped history.
- Custom announcements: Operators can configure one or more Big Brother message templates with
{playername} placeholders.
- Shader-compatible highlights: Clear in-world markers work with Iris shaders, including Photon.
- Polished menus: Scrollbars, item icons, tooltips, color pickers, and keybind controls are available in-game.
- Safe multiplayer compatibility: Version-aware networking avoids blindly sending unsupported packet formats and recommends upgrades for older clients.
- One jar for every side: Use the same Fabric mod on dedicated servers, LAN hosts, and clients.
Quick Start
- An operator creates a grid over one vertical side of the storage room.
- The operator opens each grid cell and assigns the items belonging in that chest.
- Players press
O and type an item name, or hold an item and press ~.
- StorageGuide highlights the matching chest locally for that player.
Controls
| Default key |
Action |
[ |
Select the storage grid or edit a grid cell |
O |
Open the item finder |
~ |
Locate the held item |
Every keybind can be changed under Minecraft's Controls menu or directly from StorageGuide's client settings screen.
Creating the Storage Grid
Grid creation requires operator permissions.
- Look at one corner of the storage wall and press
[.
- Look at the diagonally opposite corner and press
[ again.
- StorageGuide creates one cell for every block in that rectangle.
Both corners must lie on the same vertical X/Y or Z/Y plane. Each one-block grid cell represents one storage position, normally the block occupied by a chest or one half of a double chest.
Creating a new grid replaces the currently configured grid, so assign the wall only after choosing its final bounds.
Assigning Items to Chests
- Press
[ once to reveal the configured grid.
- Look toward a highlighted cell and press
[ again.
- Select all item types that belong in that chest.
- Press Save to apply the draft. The editor reports how many items were assigned to or removed from the chest.
The editor selects the first applicable grid block along your line of sight. Signs and item frames mounted in front of a chest do not prevent selecting it.
The item list is built from normal creative inventory tabs and excludes operator-only technical entries. Selected items are highlighted with row color feedback, and long lists use mouse-wheel scrolling with a scrollbar. A chest may accept several item types, but assigning an item to a new cell removes that item from its previous cell so searches always have one destination.
Leaving the world, opening the pause menu, or pressing Escape cancels the active editing flow without saving an unfinished change.
Finding an Item
Press O to open a blank search field. Results appear as you type and use clean item names without the minecraft: namespace. Select a result to close the menu and highlight its assigned chest. The finder uses native in-game item icons, mouse-wheel scrolling, and a scrollbar when results overflow.
To skip the menu, hold an item in either hand and press the ~ key. The main hand takes priority when both hands contain an item.
If no chest is assigned to the item, StorageGuide clears any previous result and reports that no matching cell exists.
Pressing ~ briefly changes the selected hotbar frame to show the lookup status:
- Green means the selected item has a configured storage destination.
- Red means the selected item is not assigned to a chest.
- Non-empty shulker boxes are green only when all their contents belong to one configured chest.
The status briefly recolors the original Minecraft selected-slot texture, blends it back to normal after a short delay, and is cancelled immediately if you switch slots. Both status colors, the located-chest highlight color, and the indicator itself can be changed from StorageGuide's Mod Menu configuration screen.
Shulker Boxes
Held-item lookup understands all colored and uncolored shulker boxes:
- A non-empty shulker is routed by its contents. Every non-empty slot must contain an item assigned to the same storage cell.
- Empty slots are ignored.
- A correctly packed shulker highlights the chest that accepts its contents, even when the shulker's own color is assigned elsewhere.
- An empty shulker is treated like a normal item and locates the chest assigned to that exact shulker color.
- If any contained item is unassigned, or the contents belong to different cells, no chest is highlighted and the player sees:
The shulker box has items incompatible with any chest configuration.
Highlights and Shaders
StorageGuide renders its own in-world cell markers instead of relying on vanilla block outlines. This keeps lookup and editing highlights visible with common Iris shader pipelines, including Photon and BSL.
Highlights are client-side and visible only to the player who requested them. They do not alter blocks, containers, or server lighting.
Big Brother
Optional Big Brother monitoring announces when a player adds an incompatible item to a configured chest. It is disabled by default and requires operator permissions to configure.
/storageguide big_brother
/storageguide big_brother on
/storageguide big_brother off
/storageguide sloppiness_detector
/storageguide sloppiness_detector on
/storageguide sloppiness_detector off
The sloppiness_detector command remains as a compatibility alias. The command without on or off reports the current state. The setting is saved in config/storageguide.json.
Big Brother:
- checks newly added items rather than warning merely because an old misplaced item is already present;
- does not warn when items are removed;
- understands either half of a double chest;
- accepts a non-empty shulker when all its contents belong to that chest;
- treats an empty colored shulker according to the assignment for that exact shulker item; and
- records every detected instance in persistent history, even when no announcement is sent;
- allows operators to exclude individual configured chests from detection; and
- applies a configurable announcement cooldown per player and per chest to prevent chat spam.
By default, warnings are broadcast as Big Brother caught <player> slacking off. Operators can change the message in Operator Settings. Multiple templates can be separated with |; one is chosen each time Big Brother announces an event.
Anyone can open the history through StorageGuide's client settings or by running:
/storageguide history
History opens as a player list, with a button for each player showing their number of caught instances. Selecting a player shows their details newest-first with item icons. The announcement cooldown does not remove or combine history entries.
Multiplayer and Version Compatibility
The server owns the grid, assignments, and Big Brother setting. Clients request actions and render the results they receive.
On connection, compatible clients and servers exchange their mod and protocol versions. Newer builds advertise supported packet types and use legacy request formats when the other side does not support the newer form. Unsupported custom packets are not sent blindly, preventing a format change from disconnecting an older peer.
If a player joins with an older StorageGuide client than the server, StorageGuide recommends upgrading so they get the newest UI and compatibility fixes.
For complete functionality, keep the server and clients on the same StorageGuide release whenever possible.
Configuration and Backups
Whenever possible, configure StorageGuide in-game:
- Open Escape Menu → StorageGuide or Mod Menu → StorageGuide → Configure to change the located-chest highlight, found-item hotbar color, missing-item hotbar color, keybinds, or hotbar indicator.
- Operators can select Operator Settings from that screen while connected to a server.
- Players can run
/storageguide or /storageguide settings to open StorageGuide's client settings. Operators can run /storageguide operator_settings to open the server-owned operator settings directly.
- Operator Settings controls Big Brother, announcement cooldown, announcement templates, and whether joining clients must have StorageGuide installed.
- Use
[ to create the storage grid and assign items. Cell edits stay as a draft until Save is pressed, then the editor shows the assigned/removed item counts.
- A cell's edit screen can exclude that chest from Big Brother without removing its item assignments.
- The
/storageguide big_brother commands are available for command-based management, and /storageguide sloppiness_detector remains as an alias.
The in-game tools validate changes and keep assignments consistent automatically.
Client colors are saved to:
config/storageguide-client.json
The server stores this configuration at:
config/storageguide.json
The file contains grid bounds, cell assignments and exclusions, operator settings, Big Brother message templates, and Big Brother history. Manual editing is intended for advanced recovery or migration only. If it is necessary, stop the server first and make a backup before changing or restoring the file.
Troubleshooting
- The controls do nothing: Confirm StorageGuide and Fabric API are installed on both the client and server. Also ensure no other control is bound to the same key in the game settings.
- StorageGuide has no Configure button: Install Mod Menu on the client. It is optional and is not required on the server.
- A player cannot edit the grid: Grid creation and assignment editing require operator permissions.
- Operator Settings is missing: Join the server with operator permissions first, then open it from StorageGuide client settings or run
/storageguide operator_settings.
- Operator Settings says permission is required: The menu remains viewable, but server settings can only be changed by an operator.
- A client is disconnected when joining: The server may require all joining players to install a compatible StorageGuide client.
- StorageGuide recommends upgrading: Your client is older than the server. Install the current StorageGuide version to avoid missing newer UI or packet support.
- A chest never triggers Big Brother: Check whether that cell is marked as excluded in its edit screen.
- No search result appears: Only assigned items can produce a chest highlight.
- A shulker is rejected: Its non-empty contents must all be assigned to one storage cell.
- A highlight is hidden by a shader: Verify the client is running the current release. Photon compatibility uses the mod's dedicated highlight renderer.
评论 0
登录后参与评分
还没有评论,来抢沙发吧