chest backpack hs

# Chest Backpack —— Minecraft 26.3

## What This Mod Does

Adds two extra slots to the player inventory:

- **Bottom slot**: place this mod's "Leather Backpack" (`chestbackpack:leather_backpack`).
- **Top slot**: place an Ender Chest / Shulker Box / Chest / Barrel.

Only **after wearing the backpack first and then attaching a container** will 27 extra storage slots (3×9) appear at the bottom of the inventory.
If you remove the container, these 27 slots immediately disappear.

## Installation

1. Install the prerequisites:

| Loader | Requirement |
|---|---|
| Fabric | Fabric Loader **0.19.5**, Fabric API **0.162.0 26.3** |
| NeoForge | NeoForge **26.3.0.67-beta** |

2. Put the jar for **your loader** into the game’s `mods` folder.
**Only install one**, don’t install both.
3. Requires **Java 25**.

## Usage

| Action | Effect |
|---|---|
| Open inventory (default E) | Two extra slots appear on the right |
| Place the "Leather Backpack" in the bottom slot | Backpack equipped |
| Place Chest / Barrel / Ender Chest / Shulker Box in the top slot | Container attached |
| Both in place | 27 extra storage slots appear at the bottom |
| Shift + left-click backpack | Quickly wear / remove |

Crafting recipe (Workbench):

```
Leather Copper Ingot Leather
String String
```

Also available directly in Creative Mode under "Tools & Utility Items".

## Known Limitations

- The Creative Mode "Inventory" tab hides these two slots (vanilla rearranges them to avoid overlapping the hotbar).
- Shift-clicking items to move them in bulk into the new 27 slots is not supported.
- When opening other containers, the 27 slots are not synced.
- Items inside the expanded backpack **can** be recognized by the recipe book as ingredients, but **cannot** be used for crafting — attempting to craft will show: "Cannot craft using items from expanded backpack, please place items in player inventory."
The text follows the game language: Chinese shows in Chinese, others show in English.
- In multiplayer, **both players must have the same version of the same loader installed**.
- Minecraft 26.3 itself has rendering glitches; the UI may display incorrectly, which is beyond the mod’s control.

在原版规则下合理扩大玩家背包：玩家先佩戴背包，然后就可以背负各种箱子。

直接到 Releases 页面下载对应版本的 jar。

装哪一个加载器？ 你的整合包用 NeoForge 就下 neoforge 那份，用 Fabric 就下 fabric 那份。 两个都装会冲突，同一时间只能装一个。

一份源码，五个版本，一次 -All 全出。

编译版本必须跟实例里真正在跑的那个 NeoForge 对齐，不能图省事挑最新的。 26.1 就有过教训：曾按 26.1.2.114 编译、丢进跑着 26.1.0.19-beta 的实例， 因为 AvatarRenderStateModifier 这个类 0.19 里还没有，直接 NoClassDefFoundError 崩在启动阶段。各实例 versions/<版本>/<版本>.json 里锁的是哪个 NeoForge，就按哪个编译（见 build-mod.ps1 里 $TARGETS 的注释）。

Java 目标版本同样要对齐，而且它跟「游戏版本新旧」不呈单调关系： **1.21.11 是 Java 21，26.x 才是 Java 25。**曾经想当然把 1.21.11 标成 25， 编出来的 class 是 v69，启动直接 UnsupportedClassVersionError: class file version 69.0 ——模组在 pre-loading 阶段就废了，还会连带刷一屏 Cowardly refusing to send event ... to a broken mod state， 真正的报错被淹在中间。判断依据有两条，都在本机可查： 实例 JSON 的 javaVersion.majorVersion， 以及运行期那些 jar 的 class 文件版本（实测 1.21.11 全是 65、26.x 是 69）。

还有一个坑：连 loader jar 也要挑对版本。1.21.11 用的是 loader 10.0.36 （class v65），而 loader-11.x/12.x 是 v69。拿 v69 的 loader 配 --release 21， javac 会报「类文件具有错误的版本 69.0, 应为 65.0」， 连 @Mod / @EventBusSubscriber 都解析不了（annotations 在 loader 里）。

功能在五个版本上完全一致。下面这份文档以 1.21.1 为主线描述， 跨版本的差异集中在「八、多版本适配」里。

尽量在原版规则下合理扩大玩家的背包。

流程就一句话：先佩戴背包，然后就可以背负各种箱子。

1. 把 牛皮背包 放进背包界面新增的下面那个格子（佩戴）。
   • 也可以手里拿着背包右键，或者在背包界面里 Shift 点击 它，直接穿上。
2. 把 末影箱 / 潜影盒 / 箱子 / 木桶 放进上面的格子（背负）。
   • 只能靠鼠标拖进去（见下面的说明）。
3. 背包界面下方立刻多出 3×9 = 27 格储存。
4. 容器一拿下来，多出来的 27 格立刻关闭。

背上背包之后，玩家背后会出现一个 3D 背包（自己看第三人称、别人看你都可见）。

模型不做自己的动画 —— 硬壳背包跟着躯干就够了。走路时躯干的摆动会带着它一起动， 转头、摆手臂则不会。

为什么容器不开放右键和 Shift 点击：容器那四样都是方块物品， 右键本来是要放置方块的，Shift 点击本来是要在原版背包里快速移动的。 让模组去抢这两个动作，就会跟"想放方块""想整理背包"打架。 只留拖拽这一条路，意图最明确，也不会误触。

容器的落点判定仍然照旧：必须先背着背包，否则拖不进去， 并提示「先佩戴背包，才能背负容器。」

三条都写在 Slot.mayPickup / mayPlace 里，所以所有取出与放入路径 （左键拿起、Shift 快移、Q 丢弃、数字键交换、拖拽）都会被统一挡住， 不存在哪条漏网。

右键为什么不会和"放方块"打架：原版只有在没瞄准任何方块（对着空气）时 才会走到 Item#use 这条路径，也就是 PlayerInteractEvent.RightClickItem 触发的地方。一旦瞄着方块，客户端走的是 useItemOn 分支， 根本不会触发这个事件。不过这条对背包其实无所谓 —— 背包不是方块物品， 本来就没有"放置"可言。真正需要避开这个冲突的是容器，而容器已经不给右键了。

工作台中，左右两个牛皮、中间 1 个铜锭，牛皮下各有一格线：