背包页面

背包页面

Adds up to 4 pages (40 slots each) to your Sun Haven backpack. 给 Sun Haven 随身背包加第 2~4 页（每页 40 格）

背包页面预览查看大图

[size=6][b]背包分页[/b][/size]

你的 Sun Haven 背包现在有了可以翻页的额外页面——拾取物会继续流入背包，而不是掉到地上。

[size=5][b]功能[/b][/size]

  • [b]额外的背包页面。[/b] 每页额外 40 个格子，最多共 4 页（默认：2）。第 1 页是原版的 40 格背包，保持不变。
  • [b]不再有“背包已满”的满地掉落。[/b] 当那 40 个格子满了之后，新的拾取物会进入额外页面，而不是被丢到地上。
  • [b]合成可以看到额外页面。[/b] 合成台会计算第 2 页的材料并消耗它们；Shift+点击快速移动路径也能到达第 2 页。
  • [b]整理涵盖每一页。[/b] 原版整理按钮将第 1 页和额外页面视为一个整体，使用原版排序键进行排序，先填满第 1 页，然后将你切回第 1 页，以便看到结果。
  • [b]箱子存入涵盖第 2 页。[/b] 所有四个原版“存入箱子”按钮（全部/仅背包，各有普通和仅同类两个变体）也会清空第 2 页。
  • [b]不干涉[/b] 你的快捷栏（槽位 0–9）、17 个装备和功能槽位（帽子、衣服、裤子、手套、背部、戒指、护符、纪念品，以及礼物/出售/畜栏）以及任何箱子——不调整大小、不重新排列、不增加新按键。

[size=5][b]安装[/b][/size]

  1. 为 Sun Haven 安装 [b]BepInEx 5 (x64)[/b]（已在 5.4.23.5 上测试）。
  2. 将 **[b]BackpackPages.dll[/b] 放入你的 [b]BepInEx\plugins\[/b] 文件夹。
  3. 启动游戏一次以生成 [b]BepInEx\config\sunhaven.backpackpages.cfg[/b]。
  4. 要更改设置，请编辑该文件或在游戏内使用 BepInEx Configuration Manager。

[size=5][b]使用[/b][/size]

  • [b]翻页：[/b] 将鼠标悬停在背包网格上并使用鼠标滚轮，或按 [b]PageUp[/b] / [b]PageDown[/b]（均可重新绑定）。翻到边缘会停止而不是循环，打开背包时总是回到第 1 页。
  • [b]在页面之间移动物品：[/b] 按住一个物品，翻页，然后放下。被持有的图标跟随你的光标，不会随页面一起隐藏，因此拖拽并翻页是跨页移动物品的常规方式。
  • [b]整理 / 快速移动 / 箱子存入：[/b] 像往常一样使用原版按钮——额外页面会被自动包含。
  • [b]多人游戏：[/b] 当你加入别人的存档时也能工作。你的额外页面存储在你自己的角色文件中，不使用网络消息；箱子转移使用与原版相同的同步方式注册。

[size=5][b]配置[/b][/size]

[b]常规[/b]

  • [b]Enabled[/b]（默认：[i]true[/i]）—— 总开关；关闭时，不会克隆任何槽位，也不会修补任何桥接，即与原版完全相同。
  • [b]PageCount[/b]（默认：[i]2[/i]，范围 1–4）—— 背包页面数量；1 表示原版行为。需要重启游戏。
  • [b]VerboseLogging[/b]（默认：[i]false[/i]）—— 记录每次翻页、溢出和桥接决策。
  • [b]SpillWhenBackpackFull[/b]（默认：[i]true[/i]）—— true：一旦 40 个背包槽位已满，溢出就进入第 2 页，而不填充快捷栏。false：原版语义（快捷栏和背包都必须已满）。

[b]UI[/b]

  • [b]ScrollToTurn[/b]（默认：[i]true[/i]）—— 背包界面打开时，在背包网格上滚动鼠标滚轮来翻页。
  • [b]PrevPageKey[/b]（默认：[i]PageUp[/i]）—— 上一页的键盘快捷键。
  • [b]NextPageKey[/b]（默认：[i]PageDown[/i]）—— 下一页的键盘快捷键。
  • [b]ShowPageHint[/b]（默认：[i]false[/i]）—— 翻页时显示一行包含当前页码的通知。

[b]调试[/b]

  • [b]DumpPanelHierarchyOnOpen[/b]（默认：[i]true[/i]）—— 每次运行时将 UI 层级和关键字段写入日志一次。设为 false 以获得安静的日志。
  • [b]LogPickupSpawns[/b]（默认：[i]true[/i]）—— 每当游戏在地上掉落拾取物时记录一行日志（带调用栈）。设为 false 以获得安静的日志。

[size=5][b]兼容性[/b][/size]

  • [b]Inventory First (devopsdinosaur.sunhaven.inventory_first)[/b] —— 两个模组都修补 Inventory.AddItem。这个模组的前缀先运行（Harmony Priority.First），将整个堆叠送到第 2 页；Inventory First 随后放置的重复物品——在快捷栏或地上——会被回收，其重复物品通知也会被吞掉。没有这种回收，你会看到“买了 1 个种子，得到了 2 个”。如果你更想保留 Inventory First 的快捷栏回退，禁用 [b]SpillWhenBackpackFull[/b] 就是你要做的。
  • [b]设计上零重复：[/b] 所有“背包已满，丢到地上”的路径都通过同一个生成调用汇聚，这正是本模组接管的地方。无论是另一个模组从自己的前缀丢弃堆叠，还是游戏本身这么做，你要么在第 2 页获得一次物品，要么获得原版掉落——绝不会两者都有。
  • [b]任何其他修补 Inventory.AddItem 的东西[/b] —— Harmony 会运行每个前缀，无论返回值如何；Priority.First 只保证我们的先投递。上面的去重路径处理其余情况。
  • [b]Craft from Storage / Stack Size / 任务和 UI 模组[/b] —— 无重叠。堆叠大小始终来自物品数据库，因此两个模组一致。
  • [b]Quest Chest Delivery[/b]（独立模组）—— 相互独立，彼此无依赖。它的箱子抽取在额外页面之后运行，给出顺序：背包 → 额外页面 → 箱子。

[size=5][b]已知限制[/b][/size]

  • [b]装备和功能槽位永远不属于任何页面。[/b] 本模组刻意从不提高游戏的槽位总数，因为 17 个装备/功能索引位于同一索引空间的中间——加宽它会让原版循环遍历它们（自动装备你刚捡到的护甲、将穿戴的装备存入箱子、合成吃掉你的装备）。只有背包会增长。
  • [b]卸载会隐藏第 2 页物品，而不是删除它们。[/b] 它们存储在原版从不读取的存档键下，并在加载时受到边界保护，因此移除模组会显示空的第 2 页；重新安装后物品会回来。
  • [b]整理不会合并部分堆叠。[/b] 与原版相同——物品会重新排序，不会合并。
  • [b]当你在光标上持有物品时，整理交给原版处理。[/b] 在该状态下，持有的物品已经离开其槽位，因此跳过跨页重排，而不是冒险让数据与图标不匹配。
  • [b]满背包不再回退到快捷栏（默认）。[/b] 将 [b]SpillWhenBackpackFull[/b] 设为 false 以恢复原始行为。
  • [b]页面数量更改需要重启。[/b] 槽位在容器创建时一次性构建。
  • [b]本版本调试日志默认开启。[/b] [b]DumpPanelHierarchyOnOpen[/b] 和 [b]LogPickupSpawns[/b] 都默认为 true。它们是诊断选项；如果你更喜欢小日志，请将它们设为 false。
  • [b]只有你自己的背包会增长。[/b] 箱子、畜栏和其他存储保持原版容量。

[size=5][b]要求[/b][/size]

  • BepInEx 5 (x64) —— 已在 5.4.23.5 上测试（Harmony 包含在 BepInEx 中）
  • Sun Haven（PC，Unity 2022.3）

[size=5][b]更新日志[/b][/size]

[b]0.1.0[/b]

  • 初始发布：额外背包页面，支持翻页、拾取溢出、合成计数/消耗桥接、跨页排序以及箱子存入对第 2 页的支持。

[size=5][b]致谢[/b][/size]

作者：AUTHOR_NAME。插件 GUID： sunhaven.backpackpages

[size=4][b]—— 简体中文 ——[/b][/size]

[size=5][b]功能简介[/b][/size]

  • [b]背包多出几页。[/b] 每页 40 格，最多 4 页（默认 2 页）。第 1 页就是原版那 40 格背包，完全不动。
  • [b]不再满地掉东西。[/b] 背包区 40 格满了之后，新拾取物进第 2 页，而不是被丢到地上。
  • [b]合成台看得见第 2 页。[/b] 合成时会把第 2 页的材料算进数量、也会从第 2 页扣；Shift+左键快速移动同样能进第 2 页。
  • [b]整理覆盖所有页。[/b] 点原版的「整理」按钮，第 1 页与第 2 页当成一个池子排序，先填满第 1 页，整理完自动切回第 1 页让你看见结果。
  • [b]存入箱子覆盖第 2 页。[/b] 原版四个「存入」入口（含快捷栏的全部存入、仅背包的全部存入，以及各自的同类变体）都会把第 2 页一起存空。
  • [b]完全不动[/b] 快捷栏（0–9 格）、17 个装备与功能格（头/衣/裤/手套/背/戒指/护符/纪念品，以及礼物、卖出、畜栏）和任何箱子 —— 不扩容、不重排、不加新键。

[size=5][b]安装[/b][/size]

  1. 为 Sun Haven 安装 [b]BepInEx 5（x64）[/b]（实测 5.4.23.5）。
  2. *把 **[b]BackpackPages.dll[/b] 放入 [b]BepInEx\plugins\[/b]。*
  3. 启动一次游戏，生成配置：[b]BepInEx\config\sunhaven.backpackpages.cfg[/b]。
  4. 改设置：编辑该文件，或用 BepInEx Configuration Manager 在游戏内修改。

[size=5][b]使用[/b][/size]

  • [b]翻页：[/b]鼠标悬停在背包网格上滚滚轮，或按 [b]PageUp[/b] / [b]PageDown[/b]（都可改键）。两端停住不循环；每次打开背包都回到第 1 页。
  • [b]跨页搬运：[/b]按住物品、翻页、再放下。被拖动的图标跟着光标走、不会随页面一起被隐藏，所以「拖拽中翻页」就是跨页搬运的正常方式。
  • [b]整理 / 快速移动 / 存入箱子：[/b]按原来的按钮用法即可，第 2 页会自动参与。
  • [b]联机：[/b]作为客人加入别人的存档同样可用。第 2 页存在你自己的角色档里、不发任何网络消息；存入箱子走的是原版自带的同步。

[size=5][b]配置项[/b][/size] [b]General[/b]

  • [b]Enabled[/b]（默认 true）— 总开关。关闭时不克隆任何格子、不打任何桥接，行为等同原版。
  • [b]PageCount[/b]（默认 2，范围 1–4）— 背包页数；1 = 原版行为。改动需重启游戏。
  • [b]VerboseLogging[/b]（默认 false）— 输出每次翻页 / 溢出 / 桥接的详细日志。
  • [b]SpillWhenBackpackFull[/b]（默认 true）— true：背包区 40 格一满就进第 2 页，不占用快捷栏。false：与原版一致（快捷栏与背包都放不下才溢出）。

[b]UI[/b]

  • [b]ScrollToTurn[/b]（默认 true）— 背包界面打开时，鼠标悬停网格滚轮翻页。
  • [b]PrevPageKey[/b]（默认 PageUp）— 上一页快捷键。
  • [b]NextPageKey[/b]（默认 PageDown）— 下一页快捷键。
  • [b]ShowPageHint[/b]（默认 false）— 翻页时弹一行页码提示。

[b]Debug[/b]

  • [b]DumpPanelHierarchyOnOpen[/b]（默认 true）— 每次运行把 UI 层级与关键字段写一次日志。想安静的日志就设为 false。
  • [b]LogPickupSpawns[/b]（默认 true）— 每当有拾取物落到地上就记一行日志（含调用栈）。想安静的日志就设为 false。

[size=5][b]兼容性[/b][/size]

  • [b]Craft from Storage / Stack Size / 任务与 UI 类模组[/b] — 无重叠。堆叠上限始终取自物品数据库，两边口径一致。
  • [b]Quest Chest Delivery[/b]（独立插件）— 互不依赖。它的取箱顺序排在追加页之后，即 背包 → 追加页 → 箱子。

[size=5][b]已知限制[/b][/size]

  • [b]装备与功能格永远不参与分页。[/b] 本插件刻意不抬高游戏的格子总数：17 个装备/功能格的索引夹在同一段索引空间中间，一旦加宽，原版循环就会扫过它们（捡到护甲自动穿上、把身上的装备存进箱子、合成吃掉装备）。变大的只有背包。
  • [b]卸载只是隐藏第 2 页，不是删除。[/b] 第 2 页物品存在原版从不读的存档键下，且载入时有越界保护；卸掉插件会看到空的第 2 页，装回来物品就回来了。
  • [b]整理不并叠。[/b] 与原版一致 —— 只重排、不合并。
  • [b]手上拿着物品时整理交还原版。[/b] 此时那件物品已经离开槽位，跨容器重排有数据与图标不一致的风险，所以这种状态下不做跨页整理。
  • [b]默认不再往快捷栏兜底。[/b] 要把行为改回原版，请把 [b]SpillWhenBackpackFull[/b] 设为 false。
  • [b]改页数需重启。[/b] 格子只在容器建立时构建一次。
  • [b]本版本调试日志默认开启。[/b] [b]DumpPanelHierarchyOnOpen[/b] 与 [b]LogPickupSpawns[/b] 默认都是 true，属于诊断开关；想要小日志请设为 false。
  • [b]只有你自己的背包变大。[/b] 箱子、畜栏等其它容器保持原版容量。

[size=5][b]前置要求[/b][/size]

  • BepInEx 5（x64）— 实测 5.4.23.5（Harmony 随 BepInEx 附带）
  • Sun Haven（PC，Unity 2022.3）

[size=5][b]更新日志[/b][/size] [b]0.1.0[/b]

  • 首个版本：背包追加页与翻页、拾取溢出、合成计数与消耗桥接、跨页整理、存入箱子覆盖第 2 页。