InOr

InOr

一键自动整理你的物品栏。按物品类别、类型或具体物品定义自定义槽位规则,从此无需手动整理。

Inventory Organizer — 完整说明

一个 Fabric 模组,可一键整理你的物品栏和存储容器,另有一套服务器感知的多箱子“仓库”系统、一组可选自动化功能以及远程合成。运行于 Minecraft 26.1 / 26.1.1 / 26.1.2。环境:"*" —— 这是一个客户端模组(客户端必需),并可选支持服务端,以解锁多人共享功能。

第 1 部分 —— 全部功能

整理

OI(Organize Inventory,整理物品栏):一键整理整个物品栏 —— 相同物品合并为满堆叠,同类型物品归在一起。

OST(Organize STorage,整理存储):对当前打开的箱子执行相同操作。

整理快捷键:打开箱子时为 OST,否则为 OI。Sort action(整理操作)设置可选择行为:Smart(默认)、OI‑only、OST‑only 或 Both。

堆叠合并:同一种物品散落的未满堆叠会重新合并为满堆叠。

Slot Config 编辑器

中央界面(S 按钮或快捷键)。顶部标签页:Inv、Storage、Groups。

Inv 标签页:物品栏的实时视图。从右侧调色板选择一条规则,然后左键点击槽位进行分配;右键点击可将槽位重置为 any。

规则:any(接受任何物品)、empty(保持空)、Groups(Weapons、Tools、Armor、Blocks、Food、Valuables、Potions、Splash、Arrows、Utility、Misc)、Sub‑groups(Logs、Boats……)或特定物品。搜索框可筛选 1600+ 种物品。

盔甲 + 副手:头盔 / 胸甲 / 护腿 / 靴子以及盾牌/副手槽位的规则。

自动补充标记:中键点击快捷栏槽位,用绿色 R 标记它(见自动化)。

底栏:Save、Clear、Kits、Names、Ranks (Tier Order)、Back,以及可用时的 Warehouse。

帮助:Guide 按钮(完整手册)和 ? 快速提示浮层(点击外部关闭)。

每个箱子的配置档案

每个箱子可以记住自己的整理布局。打开箱子 → New profile? → Yes。

身份解析顺序为:铁砧自定义名称 → 精确方块坐标(双箱的两半)→ 相邻告示牌文本。箱子旁边的告示牌也可为其配置档案命名。

携带模式:配置档案仅在其箱子打开时“激活”;Pr 按钮可将携带的配置档案重新绑定到当前打开的箱子。不会将箱子标记为非存储(从地图中隐藏)。

配置档案是私有且本地的 —— 从不共享。

Groups 与 Tier Order (Ranks)

Groups 标签页 / 编辑器:编辑内置物品组或创建自定义组,使规则精确匹配你的意图。

Tier Order (Ranks):在同一类型内设置优先级顺序,使整理结果确定(例如下界合金高于钻石)。双击槽位可直接跳转到对应位置。

Kits

将整个槽位配置布局保存为具名 Kit,之后可加载。Cycle slot preset 快捷键可在已保存的 Kit 之间即时切换。

仓库(关联箱子)

Warehouse 地图(Wh 按钮 / 快捷键)是箱子的俯视图。

将附近 2 个以上箱子(在范围内且相连)关联为一个仓库;在任一成员处执行 OST —— 或在地图上执行 Sort —— 即可整体整理该组。取消关联会将其拆散。

在服务器上,关联默认私有;他人的关联只有在对方打开其中一个箱子后才会对其显示(之后整个仓库会显示在其地图上)。

权限与防盗(服务器)

每位玩家的 OST 权限:选择你自己的关联 → OST 按钮 → 从已知玩家中选择,逐一开关。默认关闭 —— 已显示的关联可见但不可整理,直到授权。

防盗(服务端强制执行):不能关联他人仓库中的箱子,不能从他人的关联中远程取出,无权限时不能整理关联。

自动化(Free 模式)

自动补充(绿色 R):被标记的快捷栏槽位在清空时,会按该槽位的规则或此前物品从物品栏自动补充。

箱子补充(Rf):一键从打开的箱子中补满所有已标记的快捷栏槽位。

全部存入(Dep):将物品栏中物品已存在于该箱子的所有堆叠存回。

滚动:普通滚动槽位可快速移动它;Shift+滚动每格整理一个物品。

垃圾桶 / 虚空(Storage 下):一个规则网格;匹配的物品在拾取时被丢弃。Trash mode 开关可在 Drop‑all 与 Keep‑1‑stack 之间切换。

远程合成

物品栏和合成台旁的材料面板列出附近箱子的合并内容(图标 + 名称 + 数量),带搜索和数量框;点击可将物品拉入物品栏。范围:单人游戏在合成台旁 60 格,其他情况 15 格。

服务器友好性与安全性

快速切换(主模式):一个按钮可在 Server‑Friendly 与 Free 之间切换全部设置。

Free 限制:自动化仅在私有/白名单环境中运行(单人、LAN、Realms、Aternos、白名单服务器);在普通公共服务器上关闭。

白名单(可选加入):添加受信任的服务器(需确认)以在该服务器启用 Free 功能。

战斗模式:真实 PvP 会强制 Server‑Friendly 约 20 秒(带小型 HUD 计时器);在公共服务器上始终开启,因此模组绝不会提供战斗优势。

死亡自动整理:可选在找回装备后重新整理。

快捷键(Controls → Inventory Organizer)

默认均未绑定:Sort、Open Kits、Open Settings、Open Warehouse map、Chest refill、Cycle slot preset。Keybind mode 设置(Inventory‑only / Free / Off)控制它们允许触发的位置。

帮助与语言

完整的、自动换行的游戏内 Guide(首次进入设置时自动打开)以及每个界面的 ? 快速帮助。

9 种语言:English、Magyar、Deutsch、Español、Français、中文、日本語、Русский、Português,按钮标签尺寸经过调整,翻译不会溢出。

第 2 部分 —— 构建方式(架构)

端与入口点

环境 "*" —— 双端加载。主入口点注册网络载荷类型(通用)和服务端接收器;客户端入口点注册快捷键、界面钩子(Fabric ScreenEvents)、HUD 元素和客户端 tick。

核心分离:客户端拥有全部 UI/整理/配置;服务端仅拥有共享仓库关联存储 + 整理引擎 + 远程合成聚合。

配置(客户端,本地)

OrganizerConfig —— 一个 JSON 配置,保存槽位规则、存储预设、自定义组、仓库组(本地关联)、已知箱子、Kits、快捷键/整理设置、白名单、垃圾桶规则等。

StoragePreset —— 一个箱子的布局(槽位规则、尺寸、身份:名称/位置/告示牌)。SlotRule、WarehouseGroup —— 支持数据。

整理

InventorySorter / SortLogic —— 物品栏整理 + 规则匹配 + 堆叠合并。

StorageSorter —— 使用活动 StoragePreset 的箱子整理。

ChestIdentifier(客户端)—— 解析当前打开的箱子对应哪个本地配置档案(名称 → 坐标 → 告示牌),以及该箱子是否属于他人的关联(仅整理)。

仓库子系统

WarehouseClient —— 客户端状态:握手标志、可见关联缓存(自己的 + 已显示的他人关联)、远程合成库存、OST 名单缓存,以及所有发送辅助方法。

WarehouseNet —— 注册载荷和服务端接收器;所有工作由服务端线程执行。

WarehouseLinks —— 服务端关联存储(所有者、维度、位置、所有者的每箱规则、OST 允许列表)+ 已加入玩家名单;持久化到 inventory-organizer-warehouse-links.json。

WarehouseEngine —— 整理引擎:将组内所有物品拉入一个池,然后将每个堆叠重新放入规则最匹配的箱子(双箱感知、距离保护)。

RemoteStock —— 服务端远程合成:聚合附近箱子内容并取出物品(跳过他人关联的箱子)。

WarehouseMapScreen、OstPermScreen —— 地图 UI 和 OST 权限选择器。

网络(握手门控)

加入时服务器发送 WarehouseHelloPayload;客户端设置可用标志。在此之前客户端不发送任何内容,因此在原版服务器上模组完全静默。

客户端→服务端:仓库地图查询、上传/删除关联、整理关联、整理组、请求 OST 名单、设置 OST 权限、合成库存查询、合成取出。

服务端→客户端:hello、关联地图数据、OST 名单、合成库存。

每个服务端操作都会重新验证距离和所有权/权限,绝不信任客户端;防刷冷却保护整理和取出。

客户端集成与健壮性

Mixin:CreativeInventoryScreenMixin(创造模式物品栏中的按钮)、InventoryScreenMixin、ContainerScreenAccessor(leftPos/topPos/hovered slot)、ContainerScrollMixin(容器界面滚动)。

FightModeTracker(防篡改 PvP 检测 + HUD)、ServerEnvironment(Free 模式门控)、DeathSortTracker。

UI 可安全调整大小:布局在 init() 中重建(调整大小时重新运行);通用守卫在界面缓存尺寸与窗口不同时强制重新初始化,leftPos 监视器在配方书移动 GUI 时重新布局游戏内浮层。

构建与发布

单一 Java 源码基础;各版本项目(26.1 / 26.1.1 / 26.1.2)共享相同代码,仅 Fabric 元数据按版本不同。每个 Minecraft 版本发布一个 jar。