Gestorage
Gestorage 是一个模块化的 Fabric 模组(适用于 Minecraft 1.21.1),旨在改善玩家存储和物品栏管理。它是一个由独立模块组成的生态系统,可以单独启用或禁用,因此你只需安装真正需要的功能。
所有模块默认均为禁用状态,可通过游戏内配置界面(/gestorage config)、按键绑定或编辑 config/gestorage/ 目录来激活。
功能特性
| 模块 | 功能说明 |
|---|---|
| Expanded Ender Chest | 将末影箱的容量从 27 格扩展至 54 格(大型)或 228 格(超大型),可通过游戏规则在全服范围内选择设定,支持按玩家保留溢出物品的持久化存储,并支持通过按键绑定访问。 |
| Shulker Restock | 自动补货:将物品栏中的某个槽位与潜影盒绑定,当该槽位物品不足时,会自动从绑定的潜影盒中补充。 |
| Stackable Shulkers | 空的潜影盒可堆叠至 64 个,适用于玩家物品栏及所有容器场景(漏斗、发射器等)。服务器权威校验,可切换开关。 |
| Storage Overlay | 信息面板:显示在任何打开的物品栏旁边,包括物品栏名称、物品名称、堆叠数量、物品总数以及剩余空槽数。 |
| Inventory Sorting | 为容器、潜影盒、末影箱和玩家物品栏提供排序按钮和按键绑定,支持配置合并堆叠、按名称排序和排序方向等选项。 |
| Careful Break | 服务器权威的挖掘套件:小心破坏至手中、小心掉落至物品栏、树冠砍伐器、优化收获(仙人掌/甘蔗/竹子和海带链)以及树木和作物的自动重植。 |
| Tool Wheel | 径向工具选择器,绑定按键使用:一个持久的 9 格轮盘,可在轮盘和主手之间交换真实物品,并可选地配备服务器端自动工具功能,在挖掘时瞬间切换至最佳工具。 |
模块详情
Expanded Ender Chest
- 三种存储层级,通过
gestorage:enderChestSize游戏规则在全服范围内选择:普通(27 格)、大型(54 格)和超大型(228 格)。 - 超出原版 27 格的溢出物品会按玩家单独存储,并在会话间保持持久化(NBT 状态,带有版本控制的备份)。
- 可配置的按键绑定允许你在任何位置打开自己的末影箱,无需手持物品。
- 也可通过
/gestorage endersize [normal|large|extra_large]命令访问(需要 OP 等级 2)。
Shulker Restock
- 使用配置的标记键标记两个槽位(源潜影盒和目标槽位),以创建持久的跨世界链接。
- 当目标槽位的物品低于配置的阈值时,会从潜影盒中自动补充至默认堆叠大小,并具有自适应退避机制。
- 链接保存在
config/gestorage/links.json中,重启后依然有效;这些链接在所有玩家之间共享。
Stackable Shulkers
- 空的潜影盒像其他物品一样行为(可堆叠至 64 个),而非空的潜影盒保持其通常的堆叠上限为 1。
- 服务器权威校验:配置界面中的切换开关会写入服务器配置,并且在连接到远程服务器时会禁用。
Storage Overlay
- 在打开的物品栏旁边渲染一个面板,显示物品栏名称、悬停物品名称、图标、堆叠数量和物品数量,以及剩余的空槽数。
- 每个元素都可以单独显示或隐藏,并且每个元素都有各自的可分配切换按键绑定。
Inventory Sorting
- 一键排序:适用于玩家物品栏(仅限主物品栏;快捷栏和护甲不受影响)、箱子、末影箱和潜影盒。
- 选项:合并堆叠、按名称排序、排序顺序(升序/降序)以及针对每种物品栏类型的屏蔽。
- 服务器会验证排序范围,因此无论谁作为主机,效果都是一致的。
Careful Break
服务器端标志,同步给所有客户端,并通过 OP 等级 2(或作为单人游戏主机)进行切换:
- Careful Break — 挖掘的方块直接进入你的物品栏(潜行以激活)。
- Careful Drop / Always Careful — 方块和实体掉落物(物品、战利品表、穿戴装备、矿车内容物)会被收集到你的物品栏中,而不是散落在地上。
- Tree Capitator — 通过破坏基座原木来砍倒整棵树(带有树木/树叶限制)。
- Better Harvesting — 一次性破坏整个仙人掌、甘蔗、竹子或海带链。
- Auto Replant — 收获后自动重新种植树木和作物。
Tool Wheel
- 径向 HUD 轮盘(9 格),通过按键绑定打开;点击可将真实物品在轮盘和主手之间交换。轮盘内容按玩家保存,并在会话和维度之间跟随你。
- Auto Tool(按玩家的服务器权威功能):在
START_DESTROY_BLOCK时,轮盘中最好的工具会瞬间切换到你手中,在你开始挖掘每个方块时重新评估,并在挖掘停止一秒钟后恢复到你原来的工具。 - 按玩家存储的数据保存在主世界(
gestorage_tool_wheel_<uuid>),并在加入游戏及每次更改后同步给所有者。
依赖要求
- Minecraft 1.21.1
- Fabric Loader >= 0.16.10
- Fabric API
- owo-lib 已随模组捆绑(如果缺失会发出警告)
安装步骤
- 为 Minecraft 1.21.1 安装 Fabric Loader。
- 安装对应版本的 Fabric API。
- 从 Releases 页面 下载最新的 Gestorage 发布版。
- 将
.jar文件放入.minecraft/mods目录。 - 启动游戏。模块默认关闭——通过
/gestorage config(或 Mod Menu)打开配置界面以启用它们。
配置
所有配置均位于 config/gestorage/ 目录下:
| 文件 | 用途 |
|---|---|
ender_chest.json |
末影箱访问快捷键及模块启用标志 |
shulker_refill.json |
填充阈值、标记快捷键及模块启用标志 |
shulker_stack.json |
服务器权威的堆叠潜影盒开关 |
storage_overlay.json |
覆盖层元素可见性及切换快捷键 |
inventory_sorting.json |
整理选项及切换快捷键 |
careful_break.json |
服务器权威的谨慎破坏标志(仅由服务器写入) |
careful_break_keybinds.json |
客户端的谨慎破坏快捷键 |
tool_wheel.json |
工具轮盘按键及模块启用标志 |
links.json |
潜影盒链接定义 |
命令与游戏内规则
/gestorage config— 打开游戏内配置界面。/gestorage endersize [normal|large|extra_large]— 设置gestorage:enderChestSize游戏内规则(需要 OP 等级 2)。- 游戏内规则
gestorage:enderChestSize— 接受0(普通)、1(大型)或2(超大型);该游戏内规则是服务器上末影箱大小的唯一权威来源。
反馈与贡献
Gestorage 正在积极开发中。如果遇到任何问题、有功能建议或希望为代码做出贡献,请提交 Issue 或 Pull Request。
许可证
依据 MIT License 发布。
Gestorage
Gestorage is a modular Fabric mod (Minecraft 1.21.1) that improves player storage and inventory management. It is an ecosystem of independent modules that can be enabled and disabled individually, so you only install the mechanics you actually want.
All modules ship disabled by default and are activated from the in-game config screen (/gestorage config), by keybind, or by editing config/gestorage/.
Features
| Module | What it does |
|---|---|
| Expanded Ender Chest | Grows the ender chest from 27 to 54 (Large) or 228 (Extra Large) slots, selectable server-wide via a game rule, with per-player overflow persistence and keybind access. |
| Shulker Restock | Auto-refill for inventories: bind a hotbar/inventory slot to a shulker box and it is topped up automatically when it runs low. |
| Stackable Shulkers | Empty shulker boxes stack up to 64, in the player inventory and in every container context (hoppers, droppers, etc.). Server-authoritative, toggleable. |
| Storage Overlay | Informational panel shown next to any open inventory: inventory name, item name, stack counts, item counts and free-slot count. |
| Inventory Sorting | Sort button and keybind for containers, shulker boxes, ender chests and the player inventory, with configurable merge, name and direction options. |
| Careful Break | Server-authoritative mining suite: careful break to hand, careful drop to inventory, tree capitator, better harvesting (cactus/sugarcane/bamboo/kelp chains) and auto replant for trees and crops. |
| Tool Wheel | Radial tool selector bound to a key: a persistent 9-slot wheel that swaps real items between the wheel and your hand, with an optional server-side Auto Tool that instantly swaps the best tool while mining. |
Module details
Expanded Ender Chest
- Three storage tiers, chosen server-wide with the
gestorage:enderChestSizegame rule: Normal (27), Large (54) and Extra Large (228 slots). - Overflow items beyond the vanilla 27 slots are stored per player and persist across sessions (NBT state, versioned with backups).
- A configurable keybind opens your ender chest from anywhere, without needing an item.
- Also accessible with
/gestorage endersize [normal|large|extra_large](requires OP level 2).
Shulker Restock
- Mark two slots (source shulker and target) with the configured marking key to create a persistent per-world link.
- The target slot is refilled from the shulker up to default stack size whenever it falls below the configured threshold, with adaptive back-off.
- Links are saved per world in
config/gestorage/links.jsonand survive restarts; they are shared across players.
Stackable Shulkers
- Empty shulker boxes behave like any other item (stack to 64) while non-empty ones keep their usual stack limit of 1.
- Server-authoritative: the toggle in the config screen writes the server config and is disabled while connected to a remote server.
Storage Overlay
- Renders a panel adjacent to the open inventory showing inventory name, hovered item name, icon, stack and item counts, and remaining free slots.
- Every element can be shown or hidden individually, each with its own assignable toggle keybind.
Inventory Sorting
- One-click sort for player inventory (main inventory only; hotbar and armor untouched), chests, ender chests and shulker boxes.
- Options: merge stacks, sort by name, sort order (ascending/descending), and per-inventory-type blocking.
- The server validates the sorted range, so this works consistently regardless of who is hosting.
Careful Break
Server-side flags, synced to all clients and toggleable with OP level 2 (or as the singleplayer host):
- Careful Break — mined blocks go straight into your inventory (sneak to activate).
- Careful Drop / Always Careful — block and entity drops (items, loot tables, worn equipment, minecart contents) are collected into your inventory instead of being scattered.
- Tree Capitator — fell whole trees by breaking the base log (with tree/leaf caps).
- Better Harvesting — break entire cactus, sugarcane, bamboo and kelp chains in one swing.
- Auto Replant — automatically replant trees and crops after harvesting.
Tool Wheel
- A radial HUD wheel (9 slots) opened with a keybind; click to swap a real item between the wheel and your main hand. The wheel contents are saved per player and follow you across sessions and dimensions.
- Auto Tool (server-authoritative per player): on
START_DESTROY_BLOCKthe best tool in the wheel is instantly swapped into your hand, re-evaluated on every block you start mining, and reverted to your original tool one second after mining stops. - Per-player storage is persisted in the overworld (
gestorage_tool_wheel_<uuid>) and synced to the owner on join and after every change.
Requirements
- Minecraft 1.21.1
- Fabric Loader >= 0.16.10
- Fabric API
- owo-lib is bundled with the mod (warns you if it is missing)
Installation
- Install Fabric Loader for Minecraft 1.21.1.
- Install the matching Fabric API version.
- Download the latest Gestorage release from the Releases page.
- Drop the
.jarfile into your.minecraft/modsdirectory. - Launch the game. Modules are off by default — open the config screen with
/gestorage config(or Mod Menu) to enable them.
Configuration
All configuration lives in config/gestorage/:
| File | Purpose |
|---|---|
ender_chest.json |
Ender chest access keybind and module enabled flag |
shulker_refill.json |
Refill threshold, marking key and module enabled flag |
shulker_stack.json |
Server-authoritative Stackable Shulkers toggle |
storage_overlay.json |
Overlay element visibility and toggle keybinds |
inventory_sorting.json |
Sorting options and toggle keybinds |
careful_break.json |
Server-authoritative Careful Break flags (written by the server only) |
careful_break_keybinds.json |
Client-side Careful Break keybinds |
tool_wheel.json |
Tool Wheel keys and module enabled flag |
links.json |
Shulker link definitions |
Commands and game rules
/gestorage config— opens the in-game config screen./gestorage endersize [normal|large|extra_large]— sets thegestorage:enderChestSizegame rule (OP level 2).- Game rule
gestorage:enderChestSize— accepts0(normal),1(large) or2(extra large); the game rule is the single authority for the ender chest size on the server.
Feedback & Contributions
Gestorage is actively developed. If you run into an issue, have a feature idea, or want to contribute to the code, open an Issue or submit a Pull Request.
License
Released under the MIT License.
下载 Gestorage
下载 Gestorage
下载 Gestorage
下载 Gestorage
下载 Gestorage
下载 Gestorage
下载 Gestorage
下载 Gestorage
下载 Gestorage
下载 Gestorage
已修复
- 当禁用漏斗堆叠时,漏斗拾取一个掉落的空潜影盒堆叠可能会删除大部分堆叠:整个实体堆叠被复制,目标端限制为 1,实体被丢弃。现在拾取操作最多移动有效限制的数量,并将剩余部分留在物品实体中。
- 通过物品实体碰撞和漏斗矿车刻来绕过漏斗规则的行为已被封堵;两者现在均在漏斗上下文中运行。在禁用漏斗堆叠时,按住 Shift 点击或手动插入漏斗界面也限制每个槽位只能放入一个潜影盒。
- 携带战利品表(
CONTAINER_LOOT)的空潜影盒曾被当作空处理并允许堆叠,这可能导致放置结构战利品时发生重复。现在它们始终被视为非空。 - 漏斗传输上下文现在是可重入的,并在
finally块中始终清除,因此嵌套的漏斗调用或异常不再会导致服务器线程标记为处于漏斗状态。 - 关闭玩家堆叠后,会将玩家背包、光标和末影箱中现有的超过最大数量的空潜影盒堆叠拆分为单个,溢出部分将掉落在玩家脚下。加入游戏时会执行相同的规范化操作,打开末影箱时也会对其进行规范化。
- 具有自定义
MAX_STACK_SIZE的模组潜影盒现在保留其自身的限制,而不是强制设为 64。 - Lithium 缓存的满槽数量现在在任一潜影盒规则更改时失效,因此切换漏斗堆叠设置不再导致漏斗卡住(或过于急切),直到库存发生变化。
- 遗留的超过最大数量的目标堆叠不再会损坏漏斗传输:原版合并计算会在目标已超过限制时减去负数,因此位于或超过限制的槽位会被跳过。
- 当漏斗堆叠功能关闭时,漏斗链不再在目标箱子清空后停止。空潜影盒仅在漏斗传输期间限制为最多 1 个,这使得 Lithium 缓存的满槽数量将每个单个视为满槽;使用玩家上限 64 移除它们时从未递减该缓存,包括按住 Shift 点击或手动取出堆叠时就地改变计数。兼容性 Mixin 现在在 Lithium 更新其缓存时应用相同的有效限制,以便一旦槽位清空即恢复漏斗工作。
- 末影箱溢出内容现在每两名玩家最多每秒保存一次,而不是每次重新填充请求都保存,这可能会强制进行重复的世界保存。关闭末影箱仍会立即保存,且重新填充仍会将目标堆叠保持至 64 个。
- 末影箱溢出的 NBT 数据在首次读取前会在每个会话中备份一次,因此首次写入不再会覆盖唯一可恢复的副本。
- 配置屏幕中的按键捕获现在会读取实时的修饰键状态。捕获开始前按住的修饰键会被包含在内,捕获期间释放的修饰键不再卡在绑定中。
- Careful Break 现在能正确处理嵌套死亡:没有玩家击杀者的内部死亡不再清除外部死亡上下文,因此后续来自外部击杀的掉落物仍会被收集。
- 带有格式错误条目的旧版(版本 0)潜影盒链接文件现在仅跳过该条目,而不是丢弃所有链接。
- 客户端末影箱大小镜像现在在加入游戏时以及
gestorage:enderChestSize更改时(包括纯/gamerule命令)更新,而不仅仅是在打开末影箱时更新。 - Tool Wheel 同步现在还会读取内存中仍处于待处理状态的状态,因此在下次世界保存之前所做的更改不再作为空值发送给客户端。
6.0.0
Minecraft 1.21.11
- 移植至 Minecraft 1.21.11(Fabric 加载器 >= 0.20.1,Fabric API 0.141.6+,owo-lib 0.13.0,Mod Menu 17.0.1)。此版本还包含原本在 5.0.0 开发中的所有功能。
- 游戏规则现在采用 snake_case 命名法。
gestorage:enderChestSize、gestorage:stackableShulkers和gestorage:hopperStackableShulkers分别变为gestorage:ender_chest_size、gestorage:stackable_shulkers和gestorage:hopper_stackable_shulkers。Minecraft 1.21.11 将游戏规则存储在以标识符为键的注册表中,而标识符路径不能包含大写字母(原版也对其所有规则进行了相同的重命名),因此旧名称无法再被注册。 - 现有世界保留其设置。 当首次打开 1.21.1 世界时,保存在旧名称下的值会被导入到新规则中。每个世界仅运行一次导入,因此后续的
/gamerule更改永远不会被覆盖。原版会在打开世界时记录它必须丢弃的旧键;这是预期行为且无害。
新增
- 槽位锁定模块:按住可配置的按键并左击一个槽位即可将其锁定。
- 可锁定的槽位:整个玩家物品栏(主物品栏、快捷栏、护甲栏和副手)以及打开时的末影箱。
- 按住按键时,可锁定的槽位会显示黄色轮廓;已锁定的槽位保持红色轮廓。
- 选项:排序时会跳过已锁定的槽位,防止丢弃,并防止使用(右击使用和方块放置;攻击和打开容器/门不受影响)。
- 锁定状态按玩家和世界存储,由服务器权威控制,不会阻止正常的物品移动。
- 潜影盒补货:可逆的填充顺序——你现在可以选择是从第一个槽位到最后一个槽位(默认)还是从最后一个槽位到第一个槽位从潜影盒中取出物品。通过模块设置中的“Reverse Order”选项或其专属的可分配按键切换;服务器会在
refill_request数据包中尊重你的选择。 - 配置界面:真正的半透明效果,无需额外模组。 设置菜单的窗口、按钮和复选框一直附带半透明素材,但原版的绘制路径从未在其上启用 Alpha 混合,因此需要外部模组(Translucency Fix)才能看透它们。Gestorage 现在会对它们进行混合渲染,使菜单开箱即用地与背后的世界融合。
gestorage:hopper_stackable_shulkers游戏规则(默认false):启用后,当gestorage:stackable_shulkers也处于启用状态时,漏斗和漏斗矿车会堆叠空潜影盒。漏斗堆叠独立于玩家堆叠,除非明确启用否则保持关闭。/gestorage shulkerstack players [on|off]和/gestorage shulkerstack hoppers [on|off];不带参数的形式报告两者的状态。开启漏斗堆叠也会启用玩家堆叠(如果之前是关闭的),因为主规则是必需的。
更改
/gestorage shulkerstack已简化为players和hoppers子命令;移除了旧的裸on/off和true/false别名。- 当漏斗堆叠关闭时,漏斗仅将空潜影盒移动到空槽位,因此目标箱子中每个槽位都有一个潜影盒时被视为已满。启用漏斗堆叠允许它们合并到现有的堆叠中。
- 潜影盒状态数据包现在同时镜像玩家和漏斗规则,以便客户端 GUI 限制与服务器匹配,而不是预测服务器会拒绝的堆叠。
修复
- 当漏斗拾取一个掉落的一堆空潜影盒,且关闭了漏斗堆叠功能时,可能会删除该堆叠中的大部分物品:整个实体堆叠被复制,目标槽位将其限制为 1,其余实体被丢弃。现在拾取操作最多移动有效限制的数量,并将剩余部分留在物品实体中。
- 通过物品实体碰撞和漏斗矿车刻来绕过漏斗规则的漏洞已被修复;两者现在都在漏斗上下文中运行。Shift 点击或手动插入到漏斗界面时,若关闭了漏斗堆叠功能,每个槽位也限制为一个潜影盒。
- 携带战利品表(
CONTAINER_LOOT)的空潜影盒此前被视为空并可以堆叠,这可能导致放置结构战利品时出现重复。现在它们始终被视为非空。 - 漏斗传输上下文现在是可重入的,并且总是在
finally块中清除,因此嵌套的漏斗调用或异常不再会导致服务器线程被标记为处于漏斗状态。 - 关闭玩家堆叠功能后,会将玩家背包、快捷栏和末影箱中现有的超过最大数量的空潜影盒堆叠拆分为单个,溢出的部分会掉落在玩家脚下。加入游戏时会执行相同的规范化处理,打开扩展末影箱时也会对其进行规范化。
- 具有自定义
MAX_STACK_SIZE的模组潜影盒现在保留其自身的上限,而不是强制设为 64。 - Lithium 的缓存满槽计数现在在任一潜影盒规则更改时失效,因此切换漏斗堆叠功能不再导致漏斗卡住(或过于积极),直到库存发生变化。
- 旧的超过最大数量的目标堆叠不再能损坏漏斗传输:原版合并计算在目标已超过限制时会减去一个负数,因此位于或超过限制的槽位会被跳过。
- 当漏斗堆叠功能关闭时,漏斗链不再在目标箱子清空后停止。空潜影盒仅在漏斗传输期间限制为最多 1 个,这使得 Lithium 的缓存满槽计数将每个单个视为已满;使用玩家限制 64 移除它们从未减少该缓存,包括在 Shift 点击或手动取走堆叠改变计数时。兼容性 mixin 现在在 Lithium 更新其缓存时应用相同的有效限制,以便一旦有槽位清空,漏斗即可恢复工作。
- 潜影盒补货:热键计数在重新填充方块时不再看起来像是在消耗。 放置方块的操作在客户端进行预测(本地递减堆叠数量),因此当重新填充将计数恢复到服务器已经发送的确切数字时,校正未被推送,客户端继续递减计数,而服务器保持满状态。服务器现在在重新填充后将校正后的堆叠强制推送给客户端,这样方块的行为就像火箭和其他所有物品一样。
- 工具轮盘:自动工具现在总是切换到固定的默认槽位。 以前,只有当需要更换工具时它才会移动你的手部选择,因此如果手中已经是正确的工具,它会保持选择不变并忽略默认槽位。现在,每次开始挖掘时,自动工具都会选择此槽位,无论是否需要切换物品。
- 扩展末影箱溢出现在每玩家最多每两秒保存一次,而不是在每次重新填充请求时保存,这可能会导致重复的世界保存。关闭末影箱仍然立即保存,重新填充仍保持目标堆叠数量为 64。
- 末影箱溢出的 NBT 数据在首次读取之前每会话备份一次,因此首次写入不再覆盖唯一可恢复的副本。
- 配置屏幕中的按键捕获现在读取实时的修饰符状态。捕获开始前按住的修饰符会被包含在内,捕获期间释放的修饰符不再卡在绑定中。
- 小心破坏现在正确处理嵌套死亡:没有玩家击杀者的内部死亡不再清除外部死亡上下文,因此后续来自外部击杀的掉落物仍可被收集。
- 带有错误条目的旧版(0 版本)潜影盒链接文件现在仅跳过该条目,而不是丢弃所有链接。
- 客户端末影箱大小镜像现在在加入游戏时以及
gestorage:ender_chest_size更改时(包括纯/gamerule命令)更新,而不仅仅是在打开末影箱时。 - 工具轮盘同步现在也读取内存中仍处于待处理状态的数据,因此在下次世界保存之前做出的更改不再作为空值发送给客户端。
兼容性
- 客户端和服务器都必须运行 6.0.0 版本:槽位锁定添加了新数据包,潜影盒状态数据包同时携带玩家和漏斗规则,重新填充数据包携带重新填充顺序字段,游戏规则名称已更改。
- Lithium 是可选的且受支持。运行时不需要任何 Lithium 类;未安装 Lithium 时会跳过兼容性 mixin。
5.0.0
新增
- 槽位锁定模块:按住一个可配置的按键并左击某个槽位以将其锁定。
- 可锁定的槽位:整个玩家物品栏(主物品栏、快捷栏、护甲和副手)以及打开时的末影箱。
- 按住该键时,可锁定的槽位会显示黄色轮廓;已锁定的槽位保持红色轮廓。
- 选项包括:排序时跳过已锁定的槽位、禁止丢弃、禁止使用(右击使用和方块放置;攻击和打开容器/门不受影响)。
- 锁定状态按玩家和世界分别存储,具有服务器权威性,且不会阻止正常的物品移动。
gestorage:hopperStackableShulkers游戏规则(默认值为false):启用后,当gestorage:stackableShulkers也已启用时,漏斗和漏斗矿车会对空潜影盒进行堆叠。漏斗堆叠独立于玩家堆叠,除非明确启用,否则默认关闭。/gestorage shulkerstack players [on|off]和/gestorage shulkerstack hoppers [on|off];不带参数的形式将报告两者的状态。如果玩家堆叠处于关闭状态,开启漏斗堆叠也会同时启用玩家堆叠,因为主规则是必需的。
更改
/gestorage shulkerstack已简化为players和hoppers子命令;移除了旧的裸on/off和true/false别名。- 在漏斗功能关闭的情况下,漏斗仅将空潜影盒移动到空槽位中,因此如果一个目标箱子每个槽位都有一个潜影盒,它将被视为已满。启用漏斗后,它们可以合并到现有的堆叠中。
- 潜影盒状态数据包现在同时镜像玩家规则和漏斗规则,因此客户端 GUI 的限制与服务端匹配,而不是预测一个服务端会拒绝的堆叠。
修复
- 在漏斗堆叠关闭时,漏斗拾取掉落的空潜影盒堆叠可能会删除大部分堆叠:整个实体堆叠被复制,目标槽位将其限制为 1,然后丢弃了实体。现在拾取操作最多移动有效限制数量的物品,并将剩余部分留在物品实体中。
- 通过实体碰撞和漏斗矿车刻实现的漏斗规则绕过漏洞已被修补;两者现在都在漏斗上下文中运行。在漏斗堆叠关闭时,Shift 点击或手动插入漏斗屏幕也限制每个槽位只能有一个潜影盒。
- 携带战利品表(
CONTAINER_LOOT)的空潜影盒之前被视为空且可以堆叠,这可能导致结构战利品重复。现在它们始终被视为非空。 - 漏斗传输上下文现在是可重入的,并在
finally块中始终清除,因此嵌套的漏斗调用或异常不再导致服务器线程被错误地标记为漏斗状态。 - 关闭玩家堆叠现在会将玩家物品栏、光标和末影箱中超过最大数量的空潜影盒堆叠拆分为单个物品,并将溢出部分掉落至玩家脚下。加入游戏时会运行相同的规范化操作,并且在打开扩展末影箱时也会对其进行规范化。
- 具有自定义
MAX_STACK_SIZE的模组潜影盒现在保留其自身的限制,而不是被强制为 64。 - Lithium 的缓存满槽计数现在在任一潜影盒规则更改时失效,因此切换漏斗堆叠不再导致漏斗卡住(或过于急切),直到物品栏发生变化。
- 遗留的超过最大数量的目标堆叠不再损坏漏斗传输:原版合并计算在目标已超过限制时会减去负数,因此位于或超过限制的槽位会被跳过。
- 在漏斗功能关闭时,漏斗链不再在目标箱子排空后停止。空潜影盒仅在漏斗传输期间限制为最多 1 个,这使得 Lithium 的缓存满槽计数将每个单个物品视为满槽;使用玩家限制 64 移除它们从未减少该缓存,包括在 Shift 点击或手动取走堆叠就地改变计数时。兼容性 Mixin 现在在 Lithium 更新其缓存时应用相同的有效限制,以便一旦有槽位被清空,漏斗即可恢复工作。
- 扩展末影箱溢出保存现在每玩家最多每两秒保存一次,而不是每次填充请求都保存,这可能会导致重复的世界保存。关闭末影箱仍会立即保存,且填充操作仍会将目标堆叠保持在 64 个。
- 末影箱溢出的 NBT 数据在首次读取前会在每个会话中备份一次,因此首次写入不再覆盖唯一可恢复的副本。
- 配置屏幕中的按键绑定捕获现在会读取实时的修饰键状态。捕获开始前持有的修饰键将被包含在内,且在捕获期间释放的修饰键不再卡在绑定中。
- Careful Break 现在正确处理嵌套死亡事件:没有玩家击杀者的内部死亡不再清除外部死亡上下文,因此后续来自外部击杀的掉落物仍会被收集。
- 带有格式错误的条目的旧版(版本 0)潜影盒链接文件现在仅跳过该条目,而不是丢弃所有链接。
- 客户端末影箱大小镜像现在在加入游戏时以及每当
gestorage:enderChestSize更改时(包括普通的/gamerule命令)都会更新,而不仅仅是在打开末影箱时。 - Tool Wheel 同步现在也读取内存中仍处于待处理状态的设置,因此在下次世界保存之前所做的更改不再作为空值发送到客户端。
兼容性
- 客户端和服务端都必须运行 5.0.0 版本:槽位锁定新增了数据包,漏斗行为新增了游戏规则,且潜影盒状态数据包现在同时携带玩家和漏斗规则。
- Lithium 是可选的且受支持。运行时不需要任何 Lithium 类;如果未安装 Lithium,兼容性 Mixin 将被跳过。
更新日志
Gestorage 的所有重要变更均记录在此文件中。
未发布版本
新增
- 潜影盒补货:可逆的补货顺序 — 你现在可以选择物品是从潜影盒的第一个格子到最后一个格子取出(默认设置),还是从最后一个格子到第一个格子取出。你可以在模块设置中通过
Reverse Order选项,或使用其专属的可分配按键来切换此设置;服务器会在refill_request数据包中尊重你的选择。 - 配置界面:真实半透明效果,无需额外模组。 设置菜单的窗口、按钮和复选框一直附带半透明材质,但原版 Minecraft 从未在纹理绘制路径上启用 Alpha 混合,因此需要外部模组(Translucency Fix)才能看到透过它们的内容。Gestorage 现在在这些绘制操作中自行启用混合功能,使得菜单能够开箱即用地与背后的世界场景融合。
更新前须知
- 客户端和服务器必须运行相同版本:补货数据包现在携带了补货顺序字段。
4.0.0
发布日期:2026-10-09
修复
- 潜影盒补货:补货方块时,快捷栏数量不再显示为正在消耗状态。 放置方块的操作会在你的客户端进行预测(本地堆叠数量会减少),因此当补货操作将数量恢复至服务器已经发送的确切数值时,该修正值不会被推送,导致你的客户端继续递减计数,而服务器端保持满额。现在,服务器在补货后会将修正后的堆叠强制同步回客户端,从而使方块的行为与火箭及其他所有物品一致。
- 工具轮盘:自动工具(Auto Tool)现在始终切换到固定的默认槽位。 之前它仅在需要更换工具时才会移动你的手,因此如果手中已有的工具正是当前方块所需的,它会保留当前的选择不变,从而忽略默认槽位。现在,无论是否需要交换物品,每次开始挖掘时,自动工具都会选中该槽位。
更新前须知
- 客户端和服务器必须运行相同版本。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧