yyz的背包

🚨 模组已重置。旧版本不再受支持。背包存储格式已更改。升级到新版本前请清空你的背包，否则里面的所有物品都会丢失。

简介

Yyz的背包 是一个轻量、便捷的背包模组，旨在不破坏原版UI风格的前提下提供更高效的物品管理体验。背包可以直接在各类界面（如工作台、箱子、熔炉等）中打开，并支持合成、整理、快速移动等操作。

✨ 特性

• 随处访问：背包UI直接显示在容器界面上，无需切换界面即可放入或取出物品。
• 合成辅助：支持使用背包中的物品进行合成，兼容配方书和JEI，支持一键快速填充。
• 染色系统：背包可以像皮革盔甲一样染色，让你个性化其外观。
• 背包模型：装备背包时，玩家身上会显示3D模型，可通过配置隐藏。
• 点击整理：内置物品整理功能。点击整理按钮或按下自定义按键（默认未绑定）进行整理，支持多种整理模式（创造模式物品栏顺序、名称、数量、ID等），可通过在整理按钮上滚动切换。
• 快速移动：Shift + 右键点击可快速将物品存入背包；Shift + 点击可取出物品。同时提供批量快速移动按钮，支持移动同类物品或移动全部物品。
• 快速切换：点击背包上方的标签页可在多个背包间快速切换；标签页会显示背包的名称和外观。你也可以按下快捷键（默认B）打开当前鼠标所指的背包。
• 自动收集：当你的物品栏已满时，新获得的物品会自动进入背包。
• 负重系统：携带多个背包（默认3个或以上）时，会施加“沉重”效果，降低移动速度和跳跃高度。

🎒 背包等级

背包类型	额外槽位	特殊能力
铁	+18	基础容量
金	+36	基础容量
钻石	+54	基础容量
下界合金	+54	免疫火焰和熔岩的摧毁

🛠️ 合成配方

📦 安装与使用

1. 为你的Minecraft版本安装合适的模组加载器（Fabric、Forge 或 NeoForge）。
2. 下载模组.jar文件并将其放入游戏目录中的mods文件夹。
3. 启动游戏，将背包放在物品栏中的任意位置。如果你安装了相应的模组，也可以将其放入饰品槽位。
4. 通过标签页或快捷键选择要使用的背包。

🧩 兼容性

🤝 兼容

• Trinkets
• JEI
• Curios
• （更多待添加）

❌ 不兼容

• 所有物品整理类模组（例如Inventory Tweaks、Mouse Tweaks等）：
  • 症状：它们只会整理原版物品栏而忽略背包；或者将背包和物品栏混在一起作为一个整体整理；或者完全失效，有时会导致崩溃。
  • 原因：由于本模组的特殊实现方式，它无法与大多数整理模组兼容，且尚未找到通用的修复方法。作为替代方案，本模组内置了功能完整的整理系统，可满足日常需求。
• （更多待添加）

🗺 开发路线图

• 支持更多Minecraft版本
• 支持更多模组化UI界面

🔗 链接

• GitHub
• Discord

🛠 自定义

模组配置

主配置 /config/yyzsbackpack.json

配置键	类型	描述
model	boolean	是否在玩家背部显示背包模型
heavy	int	携带多少个背包后获得“负重”效果

按钮位置配置 /config/yyzsbackpack/control/default.json

配置键	类型	描述
controlPoss	object	各类UI界面上整理、快速移动等按钮的坐标

UI偏移配置 /config/yyzsbackpack/ui/default.json

配置键	类型	描述
uiOffsets	object	每个容器界面上背包UI的整体偏移量

背包自定义（资源包与数据包）

你可以完全重新定义背包的GUI布局、槽位位置和容量。详细信息请参阅模组文件或GitHub上的示例。

• 资源包路径：assets/yyzsbackpack/backpacks/<文件名>.json
• 数据包路径：data/yyzsbackpack/backpacks/<文件名>.json

通用属性

属性	描述
type	背包材料：iron、gold、diamond、netherite
maxVisibleTabs	同时可见的背包切换标签页数量（超出可滚动）
segments	槽位布局段列表

段属性

属性	描述
startSlot、endSlot	该段的槽位索引范围
order	"DEFAULT"（网格布局，从左到右，从上到下）或"CUSTOM"（每个槽位使用自定义坐标）
startX、startY	起始坐标（用于DEFAULT模式）
columns、rows	网格的列和行（用于DEFAULT模式）。如果槽位超出网格范围，支持滚动。
customPositions	每个槽位的{"x": number, "y": number}数组（用于CUSTOM模式）。注意：CUSTOM模式不支持滚动。
guiTexture	自定义GUI纹理路径
backgroundX、backgroundY	背景相对于原版GUI左上角的偏移量

仅数据包可用的属性

属性	描述
size	设置背包大小（最大值为256）。在多人游戏中，只有服务器设置生效。
force_server	如果为true，服务器将强制所有客户端使用此配置。