Repository navigation
Releases
QuickShulker 4.0.1+26.3
QuickShulker 4.0.1+26.3
Fixes the 4.0.0 regression that prevented clients without Quick Shulker from joining a modded server.
- Removed the unconditional
quickshulker:bundle_itemmenu registration. Choosing a vanilla menu after login was insufficient: Fabric checked the custom registry entry during the handshake. - Vanilla clients and Fabric clients without Quick Shulker can join and use server-side quick-open actions again.
- Original upstream v3 clients remain supported. Their bundle interface now uses the vanilla paged container instead of the custom 64-slot menu. All bundle contents remain accessible; v4 clients keep the enhanced scrolling interface.
- Existing legacy integration APIs, v3 packet formats, and the v4 direct shulker API/protocol are unchanged.
- Added a handshake-registry GameTest and dedicated-server connection tests with real vanilla, Fabric-without-QS, upstream-v3 and v4 clients. Tests extract items from both shulker boxes and bundles and verify the authoritative server inventory. The connection matrix now gates CI releases.
Requires Minecraft 26.3, Java 25, Fabric Loader and Fabric API on the server. Install Quick Shulker on both sides to use client shortcuts and the direct shulker protocol; it is not required on the client just to join.
中文
修复 4.0.0 中未安装 Quick Shulker 的客户端无法进入服务器的问题。
- 移除无条件注册的旧收纳袋菜单,消除登录阶段的“未知注册表项”错误,不修改 Fabric 全局注册表校验。
- 纯原版客户端、未安装 QS 的 Fabric 客户端均可进服,并使用服务端快速打开功能。
- 原版 v3 客户端继续兼容;收纳袋界面改为原版分页布局,全部内容仍可访问。v4 客户端保留增强滚动界面。
- legacy 集成 API、v3 数据包格式、新版潜影盒 API 与协议保持不变。
- 新增真实客户端连接与取物测试,核对服务端最终背包;四种客户端测试加入 CI,失败时不发布。
4.0.0 服务端建议升级至此版本。
Minecraft 1.21 系列:最低稳定依赖
以下文件覆盖 1.21 至 1.21.11,共 12 个游戏版本。打印机统一为 1.1.3。Java 21。
表格列出三个模组组合的最低稳定依赖。QuickShulker 单独使用不要求 MaLiLib 或 Litematica。
| Minecraft | 最低 Fabric Loader | 最低 Fabric API | MaLiLib | Litematica | 下载 |
|---|---|---|---|---|---|
| 1.21 | 0.16.0 | 0.100.2+1.21 | 0.21.10 | 0.19.61 | quickshulker-4.0.1+1.21.jar |
| 1.21.1 | 0.16.0 | 0.102.0+1.21.1 | 0.21.10 | 0.19.61 | quickshulker-4.0.1+1.21.1.jar |
| 1.21.2 | 0.16.8 | 0.106.1+1.21.2 | 0.22.8 | 0.20.9 | quickshulker-4.0.1+1.21.2.jar |
| 1.21.3 | 0.16.8 | 0.106.1+1.21.3 | 0.22.8 | 0.20.9 | quickshulker-4.0.1+1.21.3.jar |
| 1.21.4 | 0.16.9 | 0.110.5+1.21.4 | 0.23.5 | 0.21.7 | quickshulker-4.0.1+1.21.4.jar |
| 1.21.5 | 0.16.10 | 0.119.5+1.21.5 | 0.24.3 | 0.22.5 | quickshulker-4.0.1+1.21.5.jar |
| 1.21.6 | 0.16.13 | 0.128.0+1.21.6 | 0.25.7 | 0.23.7 | quickshulker-4.0.1+1.21.6.jar |
| 1.21.7 | 0.16.13 | 0.128.1+1.21.7 | 0.25.7 | 0.23.7 | quickshulker-4.0.1+1.21.7.jar |
| 1.21.8 | 0.16.13 | 0.129.0+1.21.8 | 0.25.7 | 0.23.7 | quickshulker-4.0.1+1.21.8.jar |
| 1.21.9 | 0.17.0 | 0.133.14+1.21.9 | 0.26.7 | 0.24.8 | quickshulker-4.0.1+1.21.9.jar |
| 1.21.10 | 0.17.0 | 0.134.1+1.21.10 | 0.26.7 | 0.24.8 | quickshulker-4.0.1+1.21.10.jar |
| 1.21.11 | 0.17.3 | 0.139.4+1.21.11 | 0.27.15 | 0.26.11 | quickshulker-4.0.1+1.21.11.jar |
验证:既有 11 个版本复用此前测试证据;每个文件的全部类文件与运行资源必须匹配本地测试版本。
1.21.11 另外通过单元测试、服务端 GameTest,以及三种真实客户端组合的 54 项检查。
1.21.11 固定提交 CI。
QuickShulker 4.0.1-26.2
QuickShulker 4.0.1 for Minecraft 26.2
Fixes the 4.0.0 regression that prevented clients without Quick Shulker from joining a modded server.
- Removed the unconditional
quickshulker:bundle_itemmenu registration. Choosing a vanilla menu after login was insufficient: Fabric checked the custom registry entry during the handshake. - Vanilla clients and Fabric clients without Quick Shulker can join and use server-side quick-open actions again.
- Original upstream v3 clients remain supported. Their bundle interface now uses the vanilla paged container instead of the custom 64-slot menu. All bundle contents remain accessible; v4 clients keep the enhanced scrolling interface.
- Existing legacy integration APIs, v3 packet formats, and the v4 direct shulker API/protocol are unchanged.
- Added a handshake-registry GameTest and dedicated-server connection tests with real vanilla, Fabric-without-QS, upstream-v3 and v4 clients. Tests extract items from both shulker boxes and bundles and verify the authoritative server inventory. The connection matrix now gates CI releases.
Requires Minecraft 26.2, Java 25, Fabric Loader and Fabric API on the server. Install Quick Shulker on both sides to use client shortcuts and the direct shulker protocol; it is not required on the client just to join.
中文
修复 4.0.0 中未安装 Quick Shulker 的客户端无法进入服务器的问题。
- 移除无条件注册的旧收纳袋菜单,消除登录阶段的“未知注册表项”错误,不修改 Fabric 全局注册表校验。
- 纯原版客户端、未安装 QS 的 Fabric 客户端均可进服,并使用服务端快速打开功能。
- 原版 v3 客户端继续兼容;收纳袋界面改为原版分页布局,全部内容仍可访问。v4 客户端保留增强滚动界面。
- legacy 集成 API、v3 数据包格式、新版潜影盒 API 与协议保持不变。
- 新增真实客户端连接与取物测试,核对服务端最终背包;四种客户端测试加入 CI,失败时不发布。
4.0.0 服务端建议升级至此版本。
QuickShulker 4.0.1-26.1
QuickShulker 4.0.1 for Minecraft 26.1
Fixes the 4.0.0 regression that prevented clients without Quick Shulker from joining a modded server.
- Removed the unconditional
quickshulker:bundle_itemmenu registration. Choosing a vanilla menu after login was insufficient: Fabric checked the custom registry entry during the handshake. - Vanilla clients and Fabric clients without Quick Shulker can join and use server-side quick-open actions again.
- Original upstream v3 clients remain supported. Their bundle interface now uses the vanilla paged container instead of the custom 64-slot menu. All bundle contents remain accessible; v4 clients keep the enhanced scrolling interface.
- Existing legacy integration APIs, v3 packet formats, and the v4 direct shulker API/protocol are unchanged.
- Added a handshake-registry GameTest and dedicated-server connection tests with real vanilla, Fabric-without-QS, upstream-v3 and v4 clients. Tests extract items from both shulker boxes and bundles and verify the authoritative server inventory. The connection matrix now gates CI releases.
Requires Minecraft 26.1, Java 25, Fabric Loader and Fabric API on the server. Install Quick Shulker on both sides to use client shortcuts and the direct shulker protocol; it is not required on the client just to join.
中文
修复 4.0.0 中未安装 Quick Shulker 的客户端无法进入服务器的问题。
- 移除无条件注册的旧收纳袋菜单,消除登录阶段的“未知注册表项”错误,不修改 Fabric 全局注册表校验。
- 纯原版客户端、未安装 QS 的 Fabric 客户端均可进服,并使用服务端快速打开功能。
- 原版 v3 客户端继续兼容;收纳袋界面改为原版分页布局,全部内容仍可访问。v4 客户端保留增强滚动界面。
- legacy 集成 API、v3 数据包格式、新版潜影盒 API 与协议保持不变。
- 新增真实客户端连接与取物测试,核对服务端最终背包;四种客户端测试加入 CI,失败时不发布。
4.0.0 服务端建议升级至此版本。
QuickShulker 4.0.0-26.2
QuickShulker 4.0.0 for Minecraft 26.2
QuickShulker 4.0 introduces a stable, screen-independent integration path for carried shulker boxes while preserving the established QuickShulker public API and player-facing features.
Highlights
- Added a shulker-specific client protocol for moving items between player inventory slots and carried shulker boxes without simulating a container screen.
- Added a server API that exposes carried shulker boxes as standard Fabric Transfer API
SlottedStorage<ItemVariant>instances. - Made server-side storage operations transactional: changes become authoritative only on commit, rollback remains isolated, and stale or competing handles cannot overwrite newer contents.
- Serialized client requests and added stable request IDs and retries so lost responses do not duplicate transfers or leave integrations permanently waiting.
- Preserved the existing
QuickOpenableRegistrypublic API and routed old and new behavior through the same underlying implementation. - Added server compatibility for the original MoRanpcy Quick Shulker v3 client on the matching Minecraft version.
- Kept vanilla clients safe on a modded server by using only vanilla menu types for them, including the paged bundle interface.
- Kept the new direct protocol scoped to shulker boxes; bundles continue to use their existing APIs and UI paths.
Compatibility
- This artifact is for Minecraft 26.2 and requires Java 25, Fabric Loader, and Fabric API.
- Install matching QuickShulker 4.x builds on the client and server to use the direct shulker protocol.
- Original Quick Shulker
3.0.2-26.2clients can connect to this v4 server and retain their original packet and bundle-menu behavior. - Vanilla clients can connect to a server running this release; client-only shortcuts are naturally unavailable.
- This fork's discontinued 3.x releases are not a compatibility target.
The release is covered by unit tests, the main server GameTest suite, frozen original-v3 wire-contract tests, and the legacy public-API behavior suite.
This repository is a fork of MoRanpcy/quickshulker, based on the original kyrptonaught/quickshulker.
QuickShulker 4.0.0-26.1
QuickShulker 4.0.0 for Minecraft 26.1
QuickShulker 4.0 introduces a stable, screen-independent integration path for carried shulker boxes while preserving the established QuickShulker public API and player-facing features.
Highlights
- Added a shulker-specific client protocol for moving items between player inventory slots and carried shulker boxes without simulating a container screen.
- Added a server API that exposes carried shulker boxes as standard Fabric Transfer API
SlottedStorage<ItemVariant>instances. - Made server-side storage operations transactional: changes become authoritative only on commit, rollback remains isolated, and stale or competing handles cannot overwrite newer contents.
- Serialized client requests and added stable request IDs and retries so lost responses do not duplicate transfers or leave integrations permanently waiting.
- Preserved the existing
QuickOpenableRegistrypublic API and routed old and new behavior through the same underlying implementation. - Added server compatibility for the original MoRanpcy Quick Shulker v3 client on the matching Minecraft version.
- Kept vanilla clients safe on a modded server by using only vanilla menu types for them, including the paged bundle interface.
- Kept the new direct protocol scoped to shulker boxes; bundles continue to use their existing APIs and UI paths.
Compatibility
- This artifact is for Minecraft 26.1 and requires Java 25, Fabric Loader, and Fabric API.
- Install matching QuickShulker 4.x builds on the client and server to use the direct shulker protocol.
- Original Quick Shulker
3.0.0-26.1clients can connect to this v4 server and retain their original packet and bundle-menu behavior. - Vanilla clients can connect to a server running this release; client-only shortcuts are naturally unavailable.
- This fork's discontinued 3.x releases are not a compatibility target.
The release is covered by unit tests, the main server GameTest suite, frozen original-v3 wire-contract tests, and the legacy public-API behavior suite.
This repository is a fork of MoRanpcy/quickshulker, based on the original kyrptonaught/quickshulker.
QuickShulker 4.0.0-alpha.1-26.1
QuickShulker 4.0.0-alpha.1 for Minecraft 26.1
This alpha introduces a screen-independent, shulker-specific integration API while preserving QuickShulker's existing public API and legacy screen behavior.
- Client integrations can transfer items between player slots and carried shulker boxes without opening a simulated container screen.
- Server integrations can discover carried shulker boxes as standard Fabric Transfer API
SlottedStorage<ItemVariant>instances with transactional commit and rollback semantics. - Client requests are serialized and retried with stable request IDs, preventing duplicate transfers after a lost response.
- Storage leases prevent stale or concurrent handles from overwriting authoritative shulker contents.
- The existing
QuickOpenableRegistryAPI and legacy compatibility path remain available. - The new protocol is currently scoped to shulker boxes; bundle support remains on the existing path.
This is an alpha release for Minecraft 26.1 and requires Java 25.
This repository is a fork of MoRanpcy/quickshulker, based on the original kyrptonaught/quickshulker.
QuickShulker 4.0.0-alpha.1-26.2
QuickShulker 4.0.0-alpha.1 for Minecraft 26.2
This alpha introduces a screen-independent, shulker-specific integration API while preserving QuickShulker's existing public API and legacy screen behavior.
- Client integrations can transfer items between player slots and carried shulker boxes without opening a simulated container screen.
- Server integrations can discover carried shulker boxes as standard Fabric Transfer API
SlottedStorage<ItemVariant>instances with transactional commit and rollback semantics. - Client requests are serialized and retried with stable request IDs, preventing duplicate transfers after a lost response.
- Storage leases prevent stale or concurrent handles from overwriting authoritative shulker contents.
- The existing
QuickOpenableRegistryAPI and legacy compatibility path remain available. - The new protocol is currently scoped to shulker boxes; bundle support remains on the existing path.
This is an alpha release for Minecraft 26.2 and requires Java 25.
This repository is a fork of MoRanpcy/quickshulker, based on the original kyrptonaught/quickshulker.
QuickShulker 3.0.4
QuickShulker 3.0.4
This maintenance release introduces a new, clean QuickShulker logo recreated as a maintainable SVG source.
- The box body's side edges now align exactly with the lid.
- The rendered PNG icon is included for Fabric and launcher compatibility.
- Public API signatures remain fully compatible with 3.0.3 and upstream integrations.
- Builds are provided for Minecraft 26.2.x and 26.1.x.
This repository is a fork of MoRanpcy/quickshulker, based on the original kyrptonaught/quickshulker.
QuickShulker 3.0.3
QuickShulker 3.0.3
This release adds client-optional bundle screens for Fabric servers.
- Vanilla clients can join a QuickShulker server while bundle opening is enabled.
- Unmodded clients receive a server-side paged vanilla container.
- Modded clients retain the existing scrolling 64-slot bundle interface.
- The custom bundle
MenuTyperegistry entry has been removed. - Enhanced bundle interactions use vanilla open-screen, slot-sync, click, drag, and close packets after the initial QuickShulker request.
- Builds are provided for Minecraft 26.2 and 26.1.
This repository is a fork of MoRanpcy/quickshulker, based on the original kyrptonaught/quickshulker.