TravelersBackpack StackUpgrades

---

🎒 旅行者背包：堆叠升级

作者：Poluo_0、Huziyang520

为 Traveler’s Backpack（Fabric 平台）制作的附属模组。本模组在背包侧栏新增了 5 种堆叠升级插件，可按倍率提升背包内各个格子的物品堆叠上限。

---

📦 升级等级与容量

单格容量计算公式：floor(item's base max stack size × total multiplier)，默认硬上限为 1,073,741,824。

升级等级	堆叠倍率	每组 64 个物品	每组 16 个物品	不可堆叠物品（工具/护甲）
入门	×1.5	96	24	1（向下取整）
一级	×2	128	32	2
二级	×4	256	64	4
三级	×8	512	128	8
四级	×16	1024	256	16

---

⚡ 倍率叠加规则

• 乘算叠加：每额外安装一个堆叠升级，无论等级相同或不同，都会进一步乘算总倍率（乘算而非加算）。

---

🛠️ 合成配方

配方使用原版材料和 Traveler’s Backpack 的空白升级。

• X代表对应等级的金属块。
• S代表上一级升级（一级升级也可以使用空白升级）。

Starter             Tier 1              Tier 1 (Alternative)
  C C C                 I                 X X X
  C B C               I S I               X S X
  C C C                 I                 X X X

产物	合成配方
入门	用 8 个铜块围住 1 个空白升级
一级	1 个入门升级加 4 个铁锭，或用 8 个铁块围住 1 个空白升级
二级	用 8 个金块围住 1 个一级升级
三级	用 8 个钻石块围住 1 个二级升级
四级	用 8 个下界合金块围住 1 个三级升级

---

⚙️ 配置

可通过模组菜单（Mod Menu）中的“配置”按钮打开配置界面（由 Forge Config API Port 提供；未安装时使用默认设置）。

配置文件 config/tbstackupgrades-common.toml：

• allowNonStackableItems = true —— 最大堆叠数为 1 的物品（工具、护甲）是否也应用倍率。
• allowDuplicateStackUpgrades = true —— 是否允许同时安装多个同等级的堆叠升级。
• maxSlotLimit = 1073741824 —— 单格容量硬上限（范围：64–1073741824）。
• lootEnabled = true —— 是否允许在结构战利品中生成升级。
• lootChanceMultiplier = 1.0 —— 所有战利品生成概率的倍率（范围：0–5）。
• lootTier4Chance = 0.01 —— 在堡垒遗迹中找到四级升级的概率。

战利品生成：战利品会随游戏进度逐步提升。早期结构会掉落入门和一级升级，中期结构会加入二级升级，三级升级仅出现在后期结构中，四级升级则只会出现在堡垒遗迹的宝箱里。

客户端配置 config/tbstackupgrades-client.toml：

• quickTransferStacking = true—— 使用 Shift 快速转移时，最大堆叠数不是 64 的物品也会合并进背包。
• sorterStacking = true —— 整理按钮会根据升级后的单格容量合并堆叠。

---

📌 行为说明

• 取出限制：从背包取出物品时，每次点击最多取出一个原版堆叠（64 个）；剩余物品会留在格子里。玩家不会在个人物品栏中获得超大堆叠。放入物品不受限制。
• 一键整理：排序按钮不会拆分或合并超大堆叠；它们会保持原样留在原格子中。
• 拆卸保护：如果背包中有堆叠数量超过拆除升级后容量上限的物品，点击侧栏图标拆除插件时会被阻止，并在背包界面顶部（空间不足时则在底部）显示红色错误提示。
• 数字显示：悬停在背包内的物品上时，提示框会显示青色的 Count / Limit；只有安装了升级且容量上限超过 64 时才会显示。单格物品数量超过 3 位时，数字会按比例缩小，避免遮挡相邻格子。
• 放置行为：将背包放在地上并打开时，它会使用完全相同的存储数据，行为也保持一致。
• 跨模组兼容：其他模组中的可堆叠物品会根据自身最大堆叠数计算上限，并获得相应倍率提升。

---

📜 许可证

本模组采用 LGPL-3.0-or-later OR MIT 双重许可：

• Mixin 注入层：LGPL-3.0-or-later OR MIT
• 其余代码：MIT
• 贴图：LGPL-3.0（板身轮廓贴图源自 Traveler’s Backpack 内置的升级图标；堆叠符号和模组图标则为本模组原创绘制。）
• Traveler’s Backpack采用 LGPL-3.0许可，并作为必需前置。本模组不复制或打包其中的任何代码、贴图、模型或语言文件。玩家需单独安装该模组；本模组仅通过其公开 API 和 Mixin 注入点与之交互。

---

🐛 问题反馈

https://github.com/Huziyang520/TravelersBackpack-StackUpgrades/issues

---

🎒 旅行者背包：堆叠升级

作者：Poluo_0、Huziyang520

为 旅行者背包 (Traveler’s Backpack)（Fabric 平台）打造的附属模组。本模组在背包侧栏新增了 5 种堆叠升级插件，放入后即可按倍率提升背包内单个格子的物品堆叠上限。

---

📦 升级等级与容量

单格容量计算公式：floor(物品自身最大堆叠数 × 总倍率)，默认硬顶为 1,073,741,824。

升级类型	堆叠倍率	64 个/组物品	16 个/组物品	不可堆叠物品（工具/装备）
入门 (Starter)	×1.5	96	24	1（向下取整）
一级 (Tier 1)	×2	128	32	2
二级 (Tier 2)	×4	256	64	4
三级 (Tier 3)	×8	512	128	8
四级 (Tier 4)	×16	1024	256	16

---

⚡ 倍率叠加规则

• 乘算叠加：每多装一个堆叠升级就会再乘一次倍率（乘算而非加算）。

---

🛠️ 合成配方

配方均使用原版材料与 旅行者背包 的空白升级。

• X 代表对应等级的金属块
• S 代表上一级升级（一级也可用空白升级）

入门                 一级                   一级（备用）
  C C C                 I                 X X X
  C B C               I S I               X S X
  C C C                 I                 X X X

产物	合成配方
入门	8 个铜块围 1 个空白升级
一级	1 个入门 + 4 个铁锭，或 8 个铁块围 1 个空白升级
二级	8 个金块围 1 个一级
三级	8 个钻石块围 1 个二级
四级	8 个下界合金块围 1 个三级

---

⚙️ 配置

模组列表（Mod Menu）里的“配置”按钮可打开配置界面（界面由 Forge Config API Port 提供，未安装时按默认值运行）。

配置文件 config/tbstackupgrades-common.toml：

• allowNonStackableItems = true —— 最大堆叠数为 1 的物品（工具、护甲）是否也吃倍率。
• allowDuplicateStackUpgrades = true —— 同等级的堆叠升级是否允许重复安装。
• maxSlotLimit = 1073741824 —— 单格上限硬顶（范围 64–1073741824）。
• lootEnabled = true —— 是否把升级放进结构战利品。
• lootChanceMultiplier = 1.0 —— 所有战利品概率的倍率（范围 0–5）。
• lootTier4Chance = 0.01 —— 堡垒遗迹出四级升级的概率。

战利品生成：战利品按游戏进程推进。早期结构出入门与一级，中期结构加入二级，三级只在末期结构，四级仅限堡垒遗迹宝箱。

客户端配置 config/tbstackupgrades-client.toml：

• quickTransferStacking = true —— Shift 快速转移时，最大堆叠数不是 64 的物品也会合并进背包。
• sorterStacking = true —— 整理按钮按升级后的单格容量合并堆叠。

---

📌 行为说明

• 取出限制：从背包取出时每次最多取一个原版堆叠（64 个），剩余留在格子里，玩家背包里不会出现超量堆叠；放入不受此限制。
• 一键整理：排序按钮不会拆分或合并超大堆叠，会保持整组待在原格子里。
• 拆卸保护：背包内若还有超过“拆下后上限”的堆叠，点击侧栏图标拆下插件会被拒绝，并在背包界面上方（空间不足时下方）显示红字提示。
• 数字显示：悬停背包内物品时，提示里多出青色的 数量 / 上限，仅在装了升级且上限高于 64 时显示。单格数量超过 3 位时数字会等比缩小，不会盖住相邻格子。
• 放置行为：背包放地上打开时共用同一套存储，行为一致。
• 跨模组兼容：其它 MOD 的可堆叠物品按自身最大堆叠数计算，同样获得提升。

---

📜 许可证

本模组采用 LGPL-3.0-or-later OR MIT 双许可：

• Mixin 注入层：LGPL-3.0-or-later OR MIT
• 其余代码：MIT
• 贴图：LGPL-3.0（贴图的板身轮廓取自旅行者背包自带的升级图标，堆叠符号与模组图标为本 MOD 自绘）
• 旅行者背包 (Traveler’s Backpack) 采用 LGPL-3.0，是必需前置。本模组不复制、不打包其任何代码、贴图、模型或语言文件，运行时由玩家自行安装，只通过其公开 API 与 Mixin 注入点协作。

---

🐛 问题反馈

https://github.com/Huziyang520/TravelersBackpack-StackUpgrades/issues