收藏夹分组 - 多个收藏页面

[center][size=6][b]收藏夹分页[/b][/size]
[size=4]为 Starfield 原版收藏轮盘提供多个持久化页面[/size][/center]

大家好，又见面了。我是 [b]Sator[/b]，一个巴西人，这是我上传到 Nexus 的第二个模组。

我做这个模组是因为原版的 12 个收藏槽位不足以同时容纳武器、能力、治疗物品和手雷。我想要额外的页面，而不是用一个完全不同的菜单来替换原有的轮盘。

[size=4][b]当前版本 0.7.5 - 测试版[/b][/size]

[b]此构建仅适用于 Steam 上的 Starfield 1.16.244.0。[/b] DLL 在其他运行时上会拒绝加载，因为原版收藏夹地址是特定于版本的。

[size=4][b]功能说明[/b][/size]

[list]
[]为按 Q 打开的原版 12 槽位收藏轮盘添加独立页面。[/]
[]默认四页：最多 48 个收藏分配。[/]
[]可配置为 2 至 8 页：最多 96 个分配。[/]
[]使用鼠标滚轮、F1-F8、手柄 LB/RB 或轮盘下方的小型可点击指示器切换页面。[/]
[]原版的 1-0、[ 和 ] 快捷键保持原版行为，并使用你最后选择的页面。[/]
[]武器、能力、辅助物品、服装、手雷和地雷使用 Starfield 自身的原生收藏处理机制。[/]
[]页面按角色持久保存，并通过一个小型附属文件在存档/读档之间保留。[/]
[]快速滚动轮盘时会进行防抖处理，避免旧页面的图标覆盖到新页面上。[/]
[]图标大小稳定且可配置。[/]
[]丢失、出售、存放或消耗的物品不会锁定该页面的其余部分。[/]
[]安全检查会在清除任何原生收藏槽位之前验证页面是否可写入。[/]
[/list]
[size=4][b]使用方法[/b][/size]

[list=1]
[]按 [b]Q[/b] 正常打开收藏夹。[/]
[]使用鼠标滚轮、F1-F4 或手柄 LB/RB 选择页面。[/]
[]在该页面关闭轮盘，或选择一个槽位。该页面将成为活动的原生页面。[/]
[]在游戏中正常使用 1-0、[ 和 ]。[/]
[/list] 要在其他页面上收藏新物品，请正常从物品栏或能力中收藏该物品，在分配轮盘中选择目标页面，然后选择一个槽位。你不需要单独的配置菜单。

[size=4][b]默认控制[/b][/size]

[list]
[][b]Q[/b] - 打开原版收藏轮盘。[/]
[][b]鼠标滚轮[/b] - 轮盘打开时切换到上一页/下一页。[/]
[][b]F1-F4[/b] - 轮盘打开时直接选择第 1-4 页。[/]
[][b]手柄 LB/RB[/b] - 轮盘打开时切换到上一页/下一页。方向键保持正常选择收藏槽位。通过 XInput 读取，因为轮盘永远不会接收到 Starfield 自身的 LShoulder/RShoulder 事件；设置 ShoulderButtonsEnabled=0 可禁用。[/]
[][b]可点击的水平指示器[/b] - 用鼠标选择页面。[/]
[][b]1-0、[ 和 ][/b] - 使用活动页面上的原版 Starfield 收藏槽位。[/]
[/list]
[size=4][b]安装[/b][/size]

[list=1]
[]安装 [url=https://www.nexusmods.com/starfield/mods/106]SFSE 0.2.21[/url]。[/]
[]安装与 Starfield 1.16.244.0 匹配的 [url=https://www.nexusmods.com/starfield/mods/3256]Address Library for SFSE Plugins[/url]。[/]
[]使用 Vortex 或 Mod Organizer 2 安装 Favorites Banks 主压缩包。[/]
[]确保 DLL 和自定义的 favoritesmenu.swf 均已启用。[/]
[]通过 [b]sfse_loader.exe[/b] 启动 Starfield。[/]
[/list]手动安装则意味着将压缩包中的 SFSE 和 Interface 文件夹复制到游戏的 Data 文件夹中。
手动文件位置：

[code]Starfield\Data\SFSE\Plugins\FavoritesBanks.dll
Starfield\Data\SFSE\Plugins\FavoritesBanks.ini
Starfield\Data\Interface\favoritesmenu.swf[/code]
[b]同一版本的 DLL 和 favoritesmenu.swf 必须一起安装。[/b]

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

用记事本编辑
[code]Data\SFSE\Plugins\FavoritesBanks.ini[/code]：

[code][Settings]
BankCount=4
IconSize=2
ShowIndicator=1
IndicatorYPercent=84

[Controls]
ModifierKey=NONE
Bank1Key=F1
Bank2Key=F2
Bank3Key=F3
Bank4Key=F4

[Controller]
ShoulderButtonsEnabled=1

[MouseWheel]
Enabled=1
ReverseDirection=0
SettleMs=120[/code]
[b]BankCount[/b] 接受 2-8。减小它不会清除隐藏的页面。[b]IconSize[/b] 接受 1、2 或 3。直接页面按键仅在收藏轮盘打开时有效。

[size=4][b]存档与卸载行为[/b][/size]

此模组不会创建新的 Starfield 角色或单独的游戏存档。其页面数据按角色存储在：

[code]Documents\My Games\Starfield\SFSE\Plugins\FavoritesBanks\States\[/code]
卸载前，请打开轮盘并停留在你想要保持活动的页面上。Starfield 会将该页面保留在其正常的 12 个槽位中。其他页面保留在附属文件中，如果重新安装此模组则会恢复。

[size=4][b]兼容性与已知限制[/b][/size]

[list]
[][b]与 Favorites Menu Extended 不兼容。[/b] 两个模组都拥有扩展收藏状态。Favorites Banks 会检测其 DLL 并禁用自身，以避免损坏风险。[/]
[]任何替换
[code]Data\Interface\favoritesmenu.swf[/code]的模组都会在文件层面产生冲突，需要兼容性补丁。[/]
[]物品栏中的心形图标仅代表当前已提交到 Starfield 真实 12 个槽位的页面。非活动页面上的物品在该页面变为活动之前不会显示心形图标。[/]
[]如果物品离开你的物品栏，其槽位会显示为空。描述符仍会保存，如果同一物品再次出现，则可以恢复。[/]
[]这是第一个公开测试版。主要行为已在我的存档上测试过，但并非所有加载顺序、语言、UI 模组或重复传奇物品组合都经过测试。请保留正常的存档备份。[/]
[/list]
[size=4][b]源码与致谢[/b][/size]

这是基于 Starfield 原版 12 槽位收藏菜单契约的原创洁净室实现。它不包含来自 Favorites Menu Extended 的代码或资源。

由 Sator 制作。使用 SFSE 和 CommonLibSF 的 libxse 分支构建。完整的相应源码作为可选下载提供，采用 GPL-3.0-or-later 及所含例外条款。

我仍在学习 C++ 和 Starfield UI 模组制作。如果出现问题，请附上你确切的 Starfield 版本、SFSE 版本、UI 模组以及此日志：

[code]Documents\My Games\Starfield\SFSE\Logs\Favorites Banks.log[/code]