StorageGuide

模组

· 作者 AkhilBoyapati

别再为了找一个缺失的物品而翻遍整个储物间了。StorageGuide 允许服务器定义一个共享的存储墙,将物品分配到箱子槽位,并高亮显示玩家应该前往的位置。你甚至可以抓到那些不整理物品的玩家。

0 本站下载 0 关注 更新于 2 天前

需要前置:Fabric API

最新 2.5.0 · 26.3 · Fabric

一键开服(送7天)

StorageGuide

停止在箱子中盲目搜索,开始精准查找物品。

StorageGuide 将你的 Minecraft 储物间转化为一个干净、可搜索且由服务器支持的库存地图。按下按键、输入物品名称,或手持想要存放的物品,StorageGuide 就会高亮显示其所属的确切箱子。

它是为真正的多人游戏基地设计的:一名管理员只需定义一次储物墙,每个玩家都能获得相同的引导式整理体验,无需背诵标签、打开随机箱子,或第 900 次询问“石英到底放哪?”

StorageGuide 还能处理已封存的潜影盒,在与 Photon 等光影包一起使用时保持可见,甚至可以通过 Big Brother(一个可选的服务器端监控系统,用于保持共享储物整洁)来捕捉放置错误的物品。

为什么选择 StorageGuide?

  • 告别随机开箱子: 搜索一次,直接前往正确的箱子。
  • 非常适合共享基地: 每个人遵循相同的服务器管理储物布局。
  • 配置过程真正愉快: 游戏内菜单、物品图标、悬停提示、颜色设置和按键绑定控制让设置变得平易近人。
  • 支持潜影盒: 已封存的潜影盒可以按其内容而非仅按盒子颜色进行路由。
  • 默认整洁有序: Big Brother 可以在物品被放置在错误位置时发出警告。
  • 兼容光影: 专用的渲染高亮效果使箱子标记在使用常见的 Iris 光影管线时依然清晰可见。

功能特性

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

快速入门

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

控制键

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

所有按键绑定都可以在 Minecraft 的控制菜单中更改,也可以直接从 StorageGuide 的客户端设置屏幕中更改。

创建储物网格

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

  1. 注视储物墙的其中一个角落,然后按下 [。
  2. 注视对角线相对的另一个角落,再次按下 [。
  3. StorageGuide 会在该矩形区域内的每个方块上创建一个单元格。

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

创建新网格会替换当前配置的网格,因此请在确定最终边界后再分配储物墙。

为箱子分配物品

  1. 按下 [ 一次以显示已配置的网格。
  2. 注视高亮的单元格,再次按下 [。
  3. 选择所有属于该箱子的物品类型。
  4. 按下 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 兼容性依赖模组专用的渲染器进行高亮显示。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源