E C H O - 自适应背包

E C H O - 自适应背包

适用于7 Days to Die 3.0+的可配置自适应背包扩展。新增分页背包、Pack Mule缩放、更智能的死亡背包恢复、更安全的载具/无人机/存储处理,以及Move All/Take All修复。支持原版UI;其他UI布局为实验性支持。

[center]
[size=6][b][color=#BE944E]E C H O[/color] // 自适应背包[/b][/size]
[size=4][i]更多空间。更智能的分页。更安全的恢复。[/i][/size]

[color=#BE944E]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/color]

适用于 [b]7 Days to Die V3.3[/b] 的可配置多页物品栏系统。


[quote][b][color=#BE944E]维护与交接[/color][/b]
由于个人和工作方面的原因,我已退出自适应背包的开发和支持工作。

自 [b]2.2.4 版本[/b]起,[b]RhaellaStark[/b] 和 [b]Snipey360[/b] 已接管维护和更新工作。他们已获得我的完全许可,可以继续开发、修复和发布该模组,并全权掌控其未来方向。

请通过本模组页面将新的错误报告、兼容性问题和支持请求提交给现任维护者。我仍保留原创作者的署名,但不再担任活跃开发者或支持联系人。

Nexus Mods 页面的管理权移交将通过 Nexus 支持另行安排;此处并非表示该移交已经完成。

[i]感谢所有支持和测试过本模组的人,也感谢 RhaellaStark 和 Snipey360 将其延续下去。[/i][/quote]
[size=5][b][color=#BE944E]新增:背包存储 —— 可选的独立下载[/color][/b][/size]

由 [b]Snipey360[/b] 创建的 [b]E C H O // Backpack Storage 1.0.0[/b] 为 V3.3 的可装备背包物品提供了独立存储空间。它是一个独立的附加组件,[b]并非[/b]自适应背包的必需项。

每页每个品质等级提供 [b]8 个槽位[/b]:Q1 = 8,Q2 = 16,Q3 = 24,Q4 = 32,Q5 = 40,Q6 = 48。

[list]
[][b]小背包[/b] —— 1 页,Q6 时最多 48 个槽位。[/]
[][b]中背包[/b] —— 2 页,Q6 时最多 96 个槽位。[/]
[][b]大背包[/b] —— 3 页,Q6 时最多 144 个槽位。[/]
[/list]
当背包处于已装备、携带在物品栏中或放置在快捷栏中时,打开其物品菜单,然后为可用页面选择 [b]打开存储 1/2/3[/b]。页面将通过游戏的载具式存储窗口打开。

内容物会在变更后随背包物品一同存储,并随其一同移动——无论是被丢弃、存放、交易还是随角色死亡携带。出售或拆解背包时会先返还其内容物。禁止嵌套背包存储;放入另一个背包内的背包会被退回。

将 [b]zzzzEcho_BackpackStorage[/b] 与 [b]zzzEcho_AdaptiveBackpack[/b] 一同安装在 Mods 目录中,使其在其后加载。该附加组件也可以在 V3.3 上单独运行。必须禁用 EAC,并且多人游戏的主机/服务器和客户端需要安装相同版本的模组。

[b]移除该附加组件之前,请清空每个背包存储页面。[/b]否则内容物将保留在背包物品数据中,没有附加组件便无法访问。

存储空间附加于每个背包物品上,并与你配置的自适应玩家物品栏分开。模组作者可以通过 [b]StoragePages[/b] 属性让其他物品加入此存储系统;详情请参阅附加组件的 README。

[quote][b][color=#E8E2D5]重要[/color][/b]
E C H O // Adaptive Backpack 包含自定义 DLL。启动游戏前[b][color=#BE944E]必须禁用 Easy Anti-Cheat[/color][/b]。

在多人游戏中,服务器或主机以及每位连接的玩家都必须安装相同版本。这不是一个仅服务器端的 XML 模组。[/quote]
[size=5][b][color=#BE944E]什么是 E C H O // 自适应背包?[/color][/b][/size]

更多物品栏空间不应意味着接受不可见的槽位、损坏的物品转移或死亡后装备消失。

[b]E C H O // 自适应背包[/b]将玩家物品栏转变为可配置的基于页面的系统。它读取当前生效的背包网格,将该布局与选定的页面数相结合,并计算出界面背后的真实容量。

该计算由背包、Pack Mule 成长、负重容量效果和死亡背包恢复共同使用。载具存储、无人机和容器获得单独的安全处理,因此扩展玩家物品栏不会把其他每个存储系统都变成不受控的后台空间。

目标很简单:[b]提供更大的物品栏,并具备页面感知的物品处理、成长和控制。[/b]

[quote][b][color=#BE944E]当前版本:2.2.5 —— 7 DAYS TO DIE V3.3[/color][/b]
[b]2.2.4[/b] 针对 V3.3 的新物品栏和容器 API 重建了本模组,同时保留了现有功能、设置、存档和槽位锁定数据。

[b]2.2.5[/b] 修复了背包显示为空或不可见网格的情况,包括与其他 UI 模组组合时的情形。UI 检测现在只读取当前生效的 [b]Config/XUi_InGame/windows.xml[/b] 文件。所选的物品槽模板会与已加载的模板进行比对,若不可用则回退到原版模板。

最新修复不会更改设置、存档、槽位锁定或公共兼容性 API。完整历史请参阅随附的 [b]CHANGELOG.txt[/b]。

[b]仍待确认:[/b] Hidden Wallet + Dump'n'Run 的存入/关闭/重新打开交互仍是一个已报告的兼容性案例,等待游戏内重新测试。控制器行为和 Take-All 冻结修复已在早期版本中由用户确认;但这并不能确认 V3.3 上的每一种 UI 或模组组合。[/quote]
[quote][b][color=#BE944E]V3.3 可装备背包与物品栏容量[/color][/b]
自适应背包控制玩家背包的配置容量,而不是允许 V3.3 的已装备背包调整自动缩小它。

[b]装备 V3.3 的小型、中型或大型背包不会为自适应玩家物品栏增加槽位。[/b]你的配置页面数和网格决定容量。

独立的 [b]E C H O // Backpack Storage[/b] 附加组件为这些背包物品提供了各自的存储页面。它是可选的,详见下文。[/quote]
[color=#BE944E]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/color]

[size=5][b][color=#BE944E]一个背包 —— 最多九页[/color][/b][/size]

最终物品栏大小根据可见网格计算,而不是绑定到某个硬编码的槽位数量。

[size=4][b]每页可见槽位 × 配置页数[/b][/size]

使用随附的标准 45 槽自适应背包网格(9 列 × 5 行):

[list]
[]4 页提供 180 个槽位。[/]
[]6 页提供 270 个槽位。[/]
[]9 页提供 405 个槽位。[/]
[/list]
兼容的更大网格使用相同规则。当检测到的布局发生变化时,自适应背包会使用检测到的布局围绕该 UI 重新计算容量。有效的槽模板回退可防止不可用的自定义模板产生空背包。

[list]
[]可配置的 1–9 页背包。[/]
[]默认四页。[/]
[]可选的页面填充显示,可显示为数量、百分比或隐藏。[/]
[]可选的 Shift + 鼠标滚轮翻页。[/]
[]移除未使用页面时安全地减少页面数。[/]
[]隐藏槽位和溢出保护。[/]
[/list]
[size=5][b][color=#BE944E]实时配置[/color][/b][/size]

打开 [b]选项 > 自适应背包[/b] 即可配置物品栏,无需手动编辑 XML,也无需为每项支持的更改重启游戏。

[list]
[]背包页面数。[/]
[]物品栏 UI 配置档。[/]
[]原版网格覆盖模式、行数和列数。[/]
[]响应式宽屏网格。[/]
[]Shift + 鼠标滚轮翻页。[/]
[]控制器翻页。[/]
[]页面填充显示。[/]
[]兼容性消息。[/]
[]调试日志和 UI 测试模式。[/]
[/list]
当物品仍保留在将被移除的页面内时,减少页面数会被阻止。这可防止设置更改将成堆物品放置到新的可见容量之外。

[quote][b][color=#BE944E]原版网格说明[/color][/b]
手动网格覆盖和响应式宽屏网格专为原版物品栏布局设计。自定义 UI 模组保留其自身检测到的网格,以避免将不兼容的尺寸强行纳入其 XML 布局。[/quote]
高级用户仍可编辑:

[code]Config/AdaptiveBackpack.xml[/code]
[size=5][b][color=#BE944E]随背包规模成长的 Pack Mule[/color][/b][/size]

Pack Mule 成长遵循最终计算出的背包大小,而非保持固定的原版数值。

[list]
[]从一开始即可使用最终容量的 35%。[/]
[]剩余的 65% 在 Pack Mule 等级 1–5 中解锁。[/]
[]等级 5 移除超载惩罚。[/]
[]物品栏标记边界随扩展后的容量缩放。[/]
[/list]
类固醇、上帝模式负重容量和 Twitch Pack Mule 获得匹配的自适应数值,防止临时增益使更大的背包意外超载。

[size=5][b][color=#BE944E]为整套装备构建的死亡背包[/color][/b][/size]

多页物品栏需要的不仅仅是一个更大的死亡容器。它需要一个了解每件物品来源的恢复系统。

自适应背包预留足够的后台容量用于:

[list]
[]每个配置的背包页面。[/]
[]快捷栏内容物。[/]
[]护甲和衣物。[/]
[]生存装备。[/]
[]安全恢复已装备物品所需的额外恢复数据。[/]
[/list]
死亡背包翻页与普通玩家背包相互独立。键盘用户使用 [b]Alt + 1–9[/b] 选择页面,使用 [b]Alt + 0[/b] 选择第 10 页。控制器用户使用 [b]LT/L2[/b] 和 [b]RT/R2[/b] 在死亡背包页面间移动。

恢复包括对手动拾取、部分 Take All 操作、满物品栏、重新登录和装备恢复的保护。死亡背包会留在世界中,直到其真实内容物被恢复。

[size=5][b][color=#BE944E]载具、无人机与存储[/color][/b][/size]

玩家背包变大了。载具不会变成不可见无底容器。

[list]
[]自行车、迷你摩托和摩托车。[/]
[]旋翼机和 4x4 卡车,包括槽位 45 以上的可交互槽位。[/]
[]机器人无人机存储。[/]
[]木制、铁制和钢制储物箱。[/]
[]原版载具存储模组和兼容的容量扩展。[/]
[/list]
载具和无人机数值是最低回退容量,而非硬性上限。合法的存储修改可以增加真实容量,移除该修改后存储大小会再次缩小,不会留下过期的扩展槽位。

Shift+点击、拖放、Move All 和 Take All 在有效存储范围内处理,同时溢出保护防止物品悄悄进入无法访问的后台位置。

[size=5][b][color=#BE944E]理解页面的锁与排序[/color][/b][/size]

槽位锁定以绝对背包位置存储,而非重复的可见页面掩码。

[list]
[]锁只属于创建它的页面和槽位。[/]
[]排序在每一页保留锁定的堆叠。[/]
[]Move All 跳过真正锁定的槽位,与显示的页面无关。[/]
[]锁在商人、UI 重建、重新登录和完全重启游戏后仍然保留。[/]
[]Sort All 保持外部隐藏钱包和专用存储不受影响。[/]
[/list]
持久化锁定数据存储在:

[code]Config/Persistent/SlotLocks.dat[/code]
[color=#BE944E]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/color]

[size=5][b][color=#BE944E]键盘、鼠标与控制器[/color][/b][/size]

[size=4][b]玩家背包[/b][/size]

[list]
[][b]Shift + 鼠标滚轮[/b] —— 启用时切换到上一页或下一页。[/]
[][b]LT / L2[/b] —— 上一页。[/]
[][b]RT / R2[/b] —— 下一页。[/]
[/list]
[size=4][b]死亡背包[/b][/size]

[list]
[][b]Alt + 1–9[/b] —— 选择死亡背包第 1–9 页。[/]
[][b]Alt + 0[/b] —— 选择死亡背包第 10 页。[/]
[][b]LT / L2[/b] —— 上一死亡背包页。[/]
[][b]RT / R2[/b] —— 下一死亡背包页。[/]
[/list]
[size=4][b]制作分类[/b][/size]

[list]
[][b]右摇杆左推[/b] —— 上一个制作分类。[/]
[][b]右摇杆右推[/b] —— 下一个制作分类。[/]
[/list]
右摇杆上推/下推切换配方列表页面。每次切换之间将摇杆回中;支持缓慢移动,按住不会重复触发。这些控制适用于个人制作和支持的制作台。

在工作台,L1/LB 和 R1/RB 也会切换配方分类。在个人制作中,它们保留原有的顶部菜单标签功能。控制器翻页可在自适应背包选项中禁用。

[size=5][b][color=#BE944E]可选兼容性 API v2 —— 独立下载[/color][/b][/size]

兼容性 API v2 开发者套件[b]不包含在 ECHO 自适应背包主压缩包中[/b]。它作为独立的可选下载提供,供希望自己的物品栏、排序、存储、钱包或 UI 模组与自适应背包安全通信的开发者使用。

[b]普通玩家只需要主要的自适应背包下载即可。[/b]你不需要开发者套件来安装或游玩自适应背包。

借助独立的开发者套件,其他模组作者不再需要猜测哪个页面可见,或仅扫描已显示的 XUi 控制器。

公共 API 直接集成于:

[code]Echo.AdaptiveBackpack.dll[/code]
公共类型:

[code]Echo.AdaptiveBackpack.AdaptiveBackpackApi[/code]
[list]
[]读取检测到的 UI 名称、网格、页面数和计算出的容量。[/]
[]解析绝对页面和槽位位置。[/]
[]读取 Pack Mule 可用性和持久化槽位锁。[/]
[]捕获并提交安全的完整背包快照。[/]
[]选择页面并刷新当前生效的背包 UI。[/]
[]保护锁定、受限、钱包和外部后台槽位。[/]
[/list]
单独下载 [b]ECHO_Adaptive_Backpack_COMPATIBILITY_API_V2_SDK.zip[/b] 以获取完整契约、设置说明和集成示例。模组作者应引用玩家已安装的 ECHO DLL 并禁用 Copy Local,且不得将该 DLL 与其他模组一起再分发。

[size=5][b][color=#BE944E]诊断与支持命令[/color][/b][/size]

[code]eab status[/code]显示检测到的 UI、网格、页面数和当前生效容量。

[code]eab selftest[/code]检查重要的运行时数值和预期的物品栏状态。

[code]eab conflicts[/code]扫描已安装的模组以查找可能的 XML 兼容性点。

[code]eab report[/code]创建用于错误报告的紧凑支持报告。

完整命令别名为 [b]adaptivebackpack[/b]。旧版 [b]pab[/b] 命令对现有用户和集成仍然可用。

[color=#BE944E]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/color]

[size=5][b][color=#BE944E]需求[/color][/b][/size]

[list]
[][b]7 Days to Die V3.3[/b] PC 版,适用于 2.2.5 版本。对于较旧的游戏版本,请使用明确标记为该版本的发布版本。[/]
[][b]已安装 0_TFP_Harmony。[/b][/]
[][b]必须禁用 Easy Anti-Cheat。[/b][/]
[]主机/服务器和每位连接的玩家安装相同的模组版本。[/]
[]受支持或可检测的物品栏布局。[/]
[/list]
[size=5][b][color=#BE944E]安装[/color][/b][/size]

[list=1]
[]关闭 7 Days to Die。[/]
[]解压下载的压缩包。[/]
[]将 [b]zzzEcho_AdaptiveBackpack[/b] 移动到游戏的 [b]Mods[/b] 目录中。[/]
[]如果仍安装着旧的 [b]zzzPaddy_AdaptiveBackpack[/b] 文件夹,请将其移除。[/]
[]在禁用 Easy Anti-Cheat 的情况下启动游戏。[/]
[/list]
最终路径必须如下所示:

[code]7 Days To Die\Mods\zzzEcho_AdaptiveBackpack\ModInfo.xml[/code]
如果在 [b]zzzEcho_AdaptiveBackpack[/b] 和 [b]ModInfo.xml[/b] 之间还存在另一个文件夹,则说明压缩包解压错误。

[quote][b][color=#BE944E]请勿同时加载两个品牌[/color][/b]
之前的 Paddy 版本和 ECHO 重制版包含相同的物品栏系统。同时安装两者会应用重复的 Harmony 和 XML 行为。只保留 [b]zzzEcho_AdaptiveBackpack[/b] 处于激活状态。[/quote]
[size=5][b][color=#BE944E]更新[/color][/b][/size]

关闭游戏,用新版本替换之前的 ECHO 模组文件夹。[b]请勿合并不同版本。[/b]遗留的旧 DLL 或 XML 文件可能产生重复补丁或过时的布局。

在替换文件夹之前,请备份 [b]Config/AdaptiveBackpack.xml[/b] 和 [b]Config/Persistent[/b](包括 SlotLocks.dat)。在加载重要存档之前,将这些设置和持久化数据恢复到新文件夹中。请勿恢复旧 DLL 或生成的 XUi 文件。移除 [b]zzzEcho_WalletReopenTest[/b]:其保护现已集成。在主机/服务器和所有客户端上使用相同的当前版本。版本 2.2.4 和 2.2.5 保留现有的设置和持久化数据,但旧 DLL 和生成的 UI 文件不得恢复到新版本中。

[size=5][b][color=#BE944E]卸载[/color][/b][/size]

移除模组之前,请将所有物品移出在原版物品栏中不存在的页面和槽位。然后关闭游戏并移除:

[code]7 Days To Die\Mods\zzzEcho_AdaptiveBackpack[/code]
[b]切勿在重要物品仍留在其额外容量中时卸载背包扩展。[/b]

[color=#BE944E]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/color]

[size=5][b][color=#BE944E]UI 兼容性[/color][/b][/size]

[list]
[][b]原版 UI[/b] —— 主配置档,使用标准自适应网格。[/]
[][b]E C H O // Hybrid UI[/b] —— 专用配置档,具备原生槽位和锁定样式;请使用与 V3.3 兼容的 UI 版本。[/]
[][b]SteelShot UI Hybrid[/b] —— 专用配置档和适配器;所安装的 UI 必须支持 V3.3。[/]
[][b]Project Z[/b] —— 网格检测支持;早期的兼容性报告并不能确认每个 V3.3 版本。[/]
[][b]Quartz[/b] —— 使用明确兼容 V3.3 的框架版本。来自旧游戏版本的先前报告不能确立当前兼容性。[/]
[][b]SMX with Quartz[/b] —— 需要两个组件均有兼容的 V3.3 版本;兼容性不会自动得到保证。[/]
[][b]其他自定义 UI[/b] —— 尽可能检测,但不保证。[/]
[][b]AGF BackpackPlus / HUDPlus[/b] —— 无专用支持。[/]
[/list]
物品栏 UI 配置档选择器可以恢复原版背包,同时保留另一个已安装 UI 的不相关部分。检测到的自定义背包窗口可能显示为实验性配置档。

版本 2.2.5 避免了旧版 UI 文件检测,并检查生成的槽模板。这些保障措施解决了空网格故障;但它们不保证与每个大修的兼容性。替换相同背包窗口、物品堆叠控制器或转移逻辑的模组仍可能需要专门的集成。调查某种组合时,请使用 [b]eab conflicts[/b] 和 [b]eab report[/b]。

[size=5][b][color=#BE944E]已知限制[/color][/b][/size]

[list]
[]手动和响应式网格覆盖设置仅适用于原版 UI。[/]
[]无法自动保证与大幅重建的物品栏 UI 的兼容性。[/]
[]AGF BackpackPlus 和 AGF HUDPlus 没有专用适配器。[/]
[]自适应背包不会为存储容器和载具添加通用的翻页系统。独立的 Backpack Storage 附加组件仅为其存储系统所配置的物品添加页面。[/]
[]更改视觉网格无法修复 XML 提供空间不足的自定义 UI。[/]
[/list]
[size=5][b][color=#BE944E]常见问题[/color][/b][/size]

[b]该模组需要新世界吗?[/b]
不需要。它可以安装到现有存档上,但在引入真正的物品栏扩展之前,应备份重要存档。

[b]它能在启用 Easy Anti-Cheat 的情况下运行吗?[/b]
不能。自定义 DLL 需要禁用 Easy Anti-Cheat。

[b]它仅限服务器端吗?[/b]
不是。主机/服务器和每位连接的客户端都需要相同版本,因为该模组会更改真实的物品栏行为和 XUi 呈现。

[b]我可以使用多少槽位?[/b]
总数取决于检测到的网格和选定的页面数。随附的标准自适应网格每页提供 45 个槽位,九页时最多可达 405 个槽位。检测到的自定义网格可能产生不同的总数。

[b]V3.3 的可装备背包会增加我的自适应物品栏吗?[/b]
不会。从 2.2.4 起,自适应背包掌控玩家背包的尺寸调整并保持其配置容量。可选的 Backpack Storage 附加组件则在背包物品内部提供独立存储。

[b]死亡背包会随普通背包增长吗?[/b]
会。其容量遵循当前生效的背包大小,并包括为快捷栏和已装备物品预留的空间。

[b]载具存储模组仍然有效吗?[/b]
原版载具存储模组受支持。它们的真实容量增加会被保留,而不是被固定上限替换。

[b]其他模组可以与所有背包页面集成吗?[/b]
可以。模组作者可以下载独立的兼容性 API v2 开发者套件,以获取安全访问完整分页背包和受保护槽位掩码所需的契约和示例。普通玩家不需要此下载。

[size=5][b][color=#BE944E]报告问题[/color][/b][/size]

请通过本模组页面将报告和支持请求发送给现任维护者 [b]RhaellaStark 和 Snipey360[/b]。EchoNoxis 不再处理活跃支持。请包含:

[list]
[]游戏版本和自适应背包版本。[/]
[]单人游戏、对等主机多人游戏或专用服务器。[/]
[]配置的页面数和当前生效的 UI 配置档。[/]
[]已安装的 UI、背包、排序、钱包、快捷栏和存储模组。[/]
[]确切的复现步骤。[/]
[][b]eab report[/b] 的输出。[/]
[]上传至 [url=https://mclo.gs/][b]mclo.gs[/b][/url] 的完整客户端日志。[/]
[/list]
请勿在没有完整日志的情况下粘贴孤立的异常片段。物品栏错误之前紧邻的事件通常比最后一行红色信息更有用。

[color=#BE944E]━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━[/color]

[size=5][b][color=#BE944E]致谢[/color][/b][/size]

最初由 [b]EchoNoxis[/b] 创建。

自 2.2.4 版本起由 [b]RhaellaStark[/b] 和 [b]Snipey360[/b] 维护和更新,并获得原作者的完全许可。

特别感谢 [b]siwoo5125[/b] 在整个 3.0/3.1 重建过程中提供的广泛测试、详细报告、耐心复测和宝贵帮助。

特别感谢 SteelShot UI 作者对兼容性支持的许可与合作。

[size=4][b]E C H O // Adaptive Backpack 2.2.5[/b][/size]
当前发布目标:[b]7 Days to Die V3.3[/b]

[i]携带更多。损失更少。掌控自如。[/i]

[/center]