Traveler's Backpack: Stack Upgrades

Authors: Poluo_0, Huziyang520

An addon for Traveler's Backpack (Fabric) that adds five stack upgrades to the backpack sidebar. Each installed upgrade multiplies how many items a single backpack slot can hold.

Upgrades

Slot capacity is floor(item max stack size x total multiplier), capped at 1,073,741,824.

How the multipliers combine

• Every installed stack upgrade multiplies the slot capacity again — the multipliers are multiplicative, not additive.
• Different tiers stack with each other: all five tiers installed give x1536, so a 64-stack item fits 98,304 per slot.
• The same tier can be installed more than once; six tier-4 upgrades (every upgrade slot of a netherite backpack) give 64 x 16^6 = 1,073,741,824 items per slot.
• Duplicates can be disabled in the config; the cap can be lowered as well.

Recipes

All recipes use vanilla materials plus Traveler's Backpack's blank upgrade. X is the metal block of the tier, S is the previous upgrade (or the blank upgrade for tier 1).

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

Installation

Install Fabric Loader and Fabric API, then drop Traveler's Backpack and this mod into the mods/ folder. Both the client and the server need the mod.

Configuration

The config screen is available from Mod Menu (it is provided by Forge Config API Port, which is optional: without it the mod runs on the defaults below). Settings live in config/tbstackupgrades-common.toml:

| Key | Default | Meaning | |---|---|---| | allowNonStackableItems | true | Let items with a max stack size of 1 (tools, armor) use the multiplier | | allowDuplicateStackUpgrades | true | Allow installing the same tier more than once | | maxSlotLimit | 1073741824 | Hard cap for a single slot (64 - 1073741824) | | lootEnabled | true | Put the upgrades into structure loot | | lootChanceMultiplier | 1.0 | Scales every loot chance (0 - 5) | | lootTier4Chance | 0.01 | Chance of the tier 4 upgrade in bastion treasure | Loot follows the tier order: early structures drop the starter and tier 1, mid-game structures add tier 2, and tier 3 only appears in end-game structures. Tier 4 is limited to bastion treasure.

Client options live in config/tbstackupgrades-client.toml:

Behaviour

• Taking items out of the backpack is limited to one vanilla stack (64) at a time, so oversized stacks never end up in a player inventory. Inserting is not limited.
• The sort button keeps oversized stacks in place instead of splitting or merging them.
• An upgrade cannot be removed while a stack in the backpack is larger than the capacity that would remain after removing it; a red warning is drawn above the backpack screen instead.
• Hovering an item inside the backpack shows amount / capacity in cyan while the capacity is above 64.
• The placed backpack block uses the same storage and behaves identically.
• Items from other mods use their own max stack size as the base, so any stackable item is affected.
• Slot counts above three digits are scaled down so they stay inside the slot.

Licence

Released under LGPL-3.0-or-later OR MIT (dual licence): the Mixin injection layer is LGPL-3.0-or-later OR MIT, everything else is MIT except the item textures, which are LGPL-3.0. Both licence texts are in LICENSE.

• Traveler's Backpack is licensed LGPL-3.0 and is a required dependency. None of its code, textures, models or language files are copied or bundled; it is loaded from the player's own installation, and its public API and Mixin targets are used at runtime.
• Fabric API (Apache-2.0) is a required dependency and is not bundled either.
• Gameplay is inspired by Sophisticated Backpacks' stack upgrade (All Rights Reserved). No code, textures, models, sounds or language files from it are used, and no affiliation is implied.
• The upgrade-plate silhouette of the item textures is derived from Traveler's Backpack's own upgrade icons (LGPL-3.0), so those textures are licensed LGPL-3.0; the stack glyph and the mod icon are drawn for this mod.

Issues

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

旅行者背包：堆叠升级

作者：Poluo_0、Huziyang520

为 旅行者背包（Fabric）新增 五种堆叠升级插件，放进背包侧栏后即可提升背包内单个格子的叠放上限。

升级等级

单格上限 = floor(物品自身最大堆叠数 × 总倍率)，硬顶 1,073,741,824。

倍率叠加规则

• 每装一个堆叠升级就再乘一次倍率，即乘算而非加算；
• 不同等级之间同样相乘：五个等级全装 = ×1536，64 个/组的物品单格可放 98,304 个；
• 同一等级也可以重复安装：六个四级插件（下界合金背包的全部升级槽）= 64 × 16⁶ = 单格 1,073,741,824 个；
• 重复安装与上限都可以在配置里关掉或调低。

合成配方

全部只使用原版材料与旅行者背包的空白升级。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

安装

先装好 Fabric Loader 与 Fabric API， 再把 旅行者背包 与本 MOD 一起放进 mods/ 目录。客户端与服务端都要安装。

配置

模组列表（Mod Menu）里的「配置」按钮可打开配置界面——界面由 Forge Config API Port 提供， 该库为可选：未安装时本 MOD 按下面的默认值运行。配置文件为 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：

行为说明

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

许可证

本 MOD 采用 LGPL-3.0-or-later OR MIT 双许可：Mixin 注入层为 LGPL-3.0-or-later OR MIT，其余代码为 MIT，贴图为 LGPL-3.0，两份协议全文见 LICENSE。

• 旅行者背包 采用 LGPL-3.0，是必需前置；本 MOD 不复制、不打包 它的任何代码、贴图、模型或语言文件，运行时由玩家自行安装，只通过其公开 API 与 Mixin 注入点协作。
• Fabric API（Apache-2.0）同为必需前置，同样不打包。
• 玩法灵感来自 精妙背包 的堆叠升级（All Rights Reserved）；未使用其任何代码、贴图、模型、音效或语言文件， 也不暗示任何官方关联。
• 贴图的板身轮廓取自旅行者背包自带的升级图标（LGPL-3.0），因此贴图按 LGPL-3.0 发布； 堆叠符号与模组图标为本 MOD 自绘。

问题反馈

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