又一个《英灵神殿》存储整理系统

[size=6][b]YAVSOS：又一个英灵神殿存储整理系统[/b][/size]

你已经玩了一段时间英灵神殿，所以你清楚是什么情况。到处都是箱子，背包里塞满了物品。英灵神殿要求你一个一个地打开箱子，一次一个箱子地堆放物品。它还要求你管理数百种物品以及每种物品该放在哪里。YAVSOS 说：“看我的。”YAVSOS 让你可以为箱子指定一个类别，然后只需按下一个按钮，就能把物品存放到区域内所有箱子中。“但是，YAVSOS！”你惊呼道。“那箱子里不该在那儿的物品怎么办？！”YAVSOS 说：“交给我。”再按下一个按钮，区域内的每个箱子都会根据其类别、过滤器和优先级神奇地重新整理。

你不需要花几个小时来给物品分类；YAVSOS 会为你完成，使用实际的游戏数据和提示来判断物品属于哪些类别。指定类别还能预见你尚未找到的物品，并为它们预留位置。

[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/hero.gif[/img]

[size=5][b]AI 免责声明[/b][/size]

本项目的代码库完全由 AI 编写。如果这让你不想使用本项目，我完全理解。我不是程序员。我曾多次尝试成为程序员，但每次都失败了。这对我来说就是行不通。这不是为我使用 AI 的辩护，事实就是如此。

话虽如此，我对本项目的参与是，并将继续是，设计每一个行为、UI 流程、特性和功能。它们的实现是我选择的直接结果。我无法阅读或理解代码；这意味着我和我的朋友/家人通过其行为来测试它。

到目前为止，我已经在这个项目上投入了将近一个月的时间（写这段话时），并计划以我唯一能做到的方式继续支持它。错误和问题将被处理和修复。我会阅读并倾听功能请求，并将它们与我为项目设想的愿景进行权衡，以及如何最好地让它保持对人们有帮助或有用。

本文档由我本人撰写，而非 AI。

[size=5][b]为什么选择 YAVSOS？[/b][/size]

我们知道市面上有太多其他的存储模组（这也是名字的由来），我所看到的是，它们中的大多数在某种意义上试图重新发明轮子，从头构建一切：一个存放功能，也许是它们自己的箱子界面，多用户箱子逻辑等等。

这样做的问题在于，它们最终会替换掉你信任或偏好的其他模组的部分功能，或者最坏的情况是，它们完全不兼容或与这些模组大量重叠，迫使你在某个功能和最喜欢的模组之间做出选择。

YAVSOS 尝试走一条不同的路线。它与你已经熟悉和喜爱的模组[i]协同[/i]工作，并且不遗余力地让它们的行为完全符合你的预期。

[list]
[][b]以模组间协作为设计理念。[/b]YAVSOS 不会替换 AzuAutoStore (AAS) 等模组；它告诉 AAS 每个物品属于哪个箱子，而 AAS 继续做它最擅长的事。你的存放体验仍然像 AAS，因为它仍然是 AAS。[/]
[][b]对其他模组的设置保持克制。[/b]当另一个模组已经有发言权时，YAVSOS 会尽量尊重它。例如，如果 AAS 的配置中有存放排除项，YAVSOS 会尊重它们，面板会显示它们影响哪些物品。属于另一个模组的设置保留在那个模组中，因此永远只有一个地方可以更改它们。[/]
[][b]当你已经拥有时，主动让位。[/b]YAVSOS 自带一份 MultiUserChest (MUC)，用于将物品移入其他玩家已打开的箱子。如果你有独立模组，或 AzuAutoStore 内置的那份，YAVSOS 会改用那一份。如果你只运行 YAVSOS，我们的 MUC 会添加保护措施，防止在某些情况下丢失物品。[/]
[][b]向前兼容。[/b]YAVSOS 绝不会仅仅因为版本号变了就关闭某个功能。每次游戏启动时，它会检查它实际依赖的其他模组的部分。如果更新改变了其中某一部分，只有那部分会关闭，其他一切继续工作，面板会告诉你发生了什么。[/]
[/list]
[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/panel-compatibilitychecks.png[/img]

[list]
[][b]共同努力！[/b]当与 YAVSOS 协作的模组存在缺口时，我们更愿意与其模组作者合作，看看修复是否应该在那里进行，而不是构建一个替代品。我们不得不绕过的任何问题都保持小巧、独立，并在不再需要时易于移除。[/]
[/list]
在我看来，你不应该为了整理存储而放弃你信任的模组。YAVSOS 应该自然而然地融入其中。

[size=5][b]入门[/b][/size]

[size=4][b]必需模组[/b][/size]

[list]
[][b]BepInEx[/b][/]
[][b]Jotunn[/b][/]
[/list]
虽然本模组设计为与 [b]AzuAutoStore[/b] (AAS) 等模组配合使用，但它仍然是可选的。配合 AAS 时，YAVSOS 利用它来处理存放，而 YAVSOS 提供规则。没有 AAS 时，它使用自己的存放功能，功能大致相当，所以用哪个由你决定；你不必为了使用本模组而牺牲舒适度。参见存放。

[size=4][b]Gale[/b][/size]

[list=1]
[]选择你的英灵神殿配置文件。[/]
[]在模组浏览器中搜索 [b]YAVSOS[/b] 并按下 [b]安装[/b]。Gale 会同时安装 BepInEx 和 Jotunn。[/]
[]可选：搜索 [b]AzuAutoStore[/b] 并按下 [b]安装[/b]。[/]
[]按下 [b]启动游戏[/b]。[/]
[/list]
[size=4][b]r2modman[/b][/size]

[list=1]
[]选择 [b]英灵神殿[/b] 和你的配置文件。[/]
[]转到 [b]在线[/b]，搜索 [b]YAVSOS[/b]，选中它并按下 [b]下载[/b]。r2modman 会同时安装 BepInEx 和 Jotunn。[/]
[]可选：对 [b]AzuAutoStore[/b] 执行相同操作。[/]
[]按下 [b]启动模组版[/b]。[/]
[/list]
[size=4][b]手动安装[/b][/size]

[list=1]
[][b]BepInEx：[/b]下载 [b]BepInExPack_Valheim[/b]，将其 [font=Courier New]BepInExPack_Valheim[/font] 文件夹内的所有内容复制到你的英灵神殿文件夹中，与 [font=Courier New]valheim.exe[/font] 放在一起。要在 Steam 中找到该文件夹，右键点击英灵神殿并选择 [b]管理 → 浏览本地文件[/b]。[/]
[]启动游戏一次然后关闭，以便 BepInEx 创建其文件夹。[/]
[][b]Jotunn：[/b]将 [font=Courier New]Jotunn.dll[/font] 放入 [font=Courier New]BepInEx/plugins[/font]。[/]
[][b]YAVSOS：[/b]将下载文件中的 [font=Courier New]YAVSOS[/font] 文件夹放入 [font=Courier New]BepInEx/plugins[/font]，最终路径为 [font=Courier New]BepInEx/plugins/YAVSOS/YAVSOS.dll[/font]。[/]
[]可选：将 [font=Courier New]AzuAutoStore.dll[/font] 放入 [font=Courier New]BepInEx/plugins[/font]。[/]
[/list]
[size=4][b]服务器[/b][/size]

Steam 托管的世界不需要额外操作：主机像其他玩家一样安装 YAVSOS 即可。

对于专用服务器，将相同的文件安装到服务器文件夹中，即包含 [font=Courier New]valheim_server.exe[/font] 的那个文件夹：

[list]
[]BepInExPack_Valheim 的内容放在 [font=Courier New]valheim_server.exe[/font] 旁边。[/]
[][font=Courier New]Jotunn.dll[/font] 和 [font=Courier New]YAVSOS[/font] 文件夹（如果你使用的话还有 [font=Courier New]AzuAutoStore.dll[/font]）放入服务器的 [font=Courier New]BepInEx/plugins[/font]。[/]
[]在 Linux 上，使用 BepInExPack 中的 [font=Courier New]start_server_bepinex.sh[/font] 启动服务器。在 Windows 上，按你平常的方式启动。[/]
[]如果你的主机有模组或文件管理器，将相同的文件上传到相同的文件夹。[/]
[/list]
服务器的 YAVSOS 设置位于其 [font=Courier New]BepInEx/config/com.bastionntb.yavsos.cfg[/font] 中，并会发送给每个加入的玩家。

[size=5][b]设置类型[/b][/size]

[list]
[][b]单人游戏[/b] — YAVSOS 启用位置：你的游戏；工作方式：全部功能，使用你自己的类别和设置。[/]
[][b]客户端和服务器[/b] — YAVSOS 启用位置：服务器和每个玩家；工作方式：完整设置。服务器的类别和共享设置适用于所有人。[/]
[][b]仅客户端[/b] — YAVSOS 启用位置：你的游戏，而非服务器；工作方式：YAVSOS 仅为你运行。[/]
[][b]仅服务器[/b] — YAVSOS 启用位置：服务器，而非玩家；工作方式：不是可用设置：没有 YAVSOS 的玩家无法加入。[/]
[/list]
[list]
[][b]客户端和服务器。[/b]这涵盖专用服务器和 Steam 托管世界，其中主机充当服务器。需要 YAVSOS：每个玩家都需要它，版本 1.0.0 或更高。没有它的玩家无法加入，拥有旧版本的玩家会被提示更新。所有人共享服务器的类别和设置，而共享设置被锁定时，只有管理员可以更改它们。[/]
[][b]仅客户端。[/b]当你加入一个没有 YAVSOS 的服务器时，它会注意到并仅为你运行，使用你自己的类别和设置。其他任何人都不受影响，你仍然可以存放到其他玩家的箱子中。[/]
[][b]仅服务器。[/b]一旦服务器安装了 YAVSOS，它就会要求所有玩家都安装。如果你的部分玩家无法或不愿安装它，请不要在服务器上启用；他们仍然可以仅客户端使用它。[/]
[/list]
[size=5][b]工作原理[/b][/size]

[size=4][b]在箱子中创建规则[/b][/size]

打开一个箱子，规则面板会显示在旁边。勾选你希望它接受的类别，例如[i]矿石与金属碎片[/i]或[i]生食[/i]。YAVSOS 规则在你更改后立即生效。这些类别中的每个物品现在都属于那里，包括你尚未找到的物品。

[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/panel-overview.png[/img]

[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/set-rule.gif[/img]

你随时可以点击按钮清除规则。

当箱子位于守卫区域范围内时，规则编辑会遵守守卫的权限设置；私人箱子只能由建造者编辑。

如果你想要更多控制：

[list]
[][b]始终或从不。[/b]在“物品”选项卡下，你可以点击物品图标将其标记为[i]始终[/i]，意味着它总会在此被接受（即使它不在类别中），再次点击为[i]从不[/i]，意味着它不会被存放于此（即使它在类别中）。再次点击清除，意味着它将遵循类别和过滤器。这样你就可以精细控制什么能进入箱子、什么不能。[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/always-never.gif[/img][/]
[/list]
[list]
[][b]过滤器。[/b]缩小范围，例如仅限升级装备、你制作的物品、EpicLoot 稀有度，或主要以生命值为主的食物。面板只会提供对你所选物品有意义的过滤器。[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/filters.png[/img][/]
[/list]
[list]
[][b]优先级。[/b]当两个箱子都设置为接受某个物品时，你可以对那些你希望优先接受该物品的箱子设置优先级等级，然后将其他箱子作为备用。优先级 1（关键）对优先级 10（甭想了），优先级 5 为普通。[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/priority.png[/img][/]
[/list]
[size=4][b]状态标记[/b][/size]

在 YAVSOS 面板的右上角，你可以找到集成的状态，如果它们处于活动或非活动状态，仅当配套模组已安装时显示。在游戏中将鼠标悬停在每个状态图标上，可以查看究竟发生了什么的解释。以下是一般概述：

[list]
[]绿色表示集成处于活动状态。[/]
[]琥珀色/黄色表示部分失败或有些事情你可能需要查看，例如某个箱子的 AAS 排除项或某个模组的类别不工作。[/]
[]红色 X 表示某个模组集成因自动不兼容检查而被禁用，或 YAVSOS 的某项功能被认为不工作。[/]
[]灰色短横线表示某个设置已被禁用。[/]
[/list]
[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/status-marks.png[/img]

[size=4][b]存放[/b][/size]

存放会从你的背包中取出物品并自动放入附近的箱子中。YAVSOS 还会根据你设置的规则指引这些物品最终去往何处。

按下 [b].[/b]（句号）存放背包中的所有物品，或[b]中键点击[/b]背包中的单个堆叠/物品来仅存放那一个。安装 AzuAutoStore (AAS) 后，YAVSOS 在存放方面交给 AAS，你将照常使用 AAS 的存放键。

[list]
[][b]对于有规则的箱子：[/b]你的物品根据已设置的规则最终进入箱子，无论该物品是否已经在箱子中。[/]
[/list]
[list]
[][b]对于没有规则的箱子：[/b]箱子将接受已有物品相匹配的物品。（这是 AAS 的默认行为。）[/]
[/list]
已装备的物品永远不会被存放。快捷栏或 AzuExtendedPlayerInventory (AzuEPI) 快速栏中的物品默认不会被存放。安装 AAS 时通过 AAS 配置，独立使用时通过 YAVSOS 配置。

[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/stash-single.gif[/img]

[size=4][b]清理[/b][/size]

有时人们不总是把东西存放在正确的地方，或者你想更改现有箱子的规则或优先级，又或者你的关键补给箱已经用完了也存放在附近某个低优先级箱子中的物品。清理功能可以在这里帮上忙！

它会找到更适合放在其他箱子中的物品（规则不匹配、优先级更高等），并将它们移动到配置范围内的合适位置。你可以通过点击箱子面板上的[b]清理附近[/b]，或按下[b]Ctrl + 存放键[/b]（默认为 [font=Courier New].[/font]，句号）来执行此操作。之后，你会看到一个面板显示，告知你哪些移动了或哪些留下了。

[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/cleanup.gif[/img]

[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/result-panel.png[/img]

[size=4][b]查找物品[/b][/size]

[list]
[]将鼠标悬停在箱子上可查看其规则，例如“食物 › 被野猪吃掉 · 优先级 2（紧急）”。[/]
[]将鼠标悬停在背包中的物品上，可查看其类别以及存放会将其送到哪里。[/]
[]在面板中搜索，会接受该物品的附近箱子会亮起。[/]
[/list]
[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/labels-tooltips.png[/img]

[img]https://raw.githubusercontent.com/BastionNtB/YAVSOS/main/assets/media/search-highlight.gif[/img]

[size=5][b]帮助与反馈[/b][/size]

一切都通过 [b]GitHub issues[/b] 处理：错误、问题、想法和请求。

---

[size=5][b]参考[/b][/size]

[size=4][b]面向服务器管理员和模组作者[/b][/size]

[list]
[][url=https://github.com/BastionNtB/YAVSOS/blob/main/docs/SETTINGS.md]设置[/url]：查看所有设置及其默认值以及更多内容。[/]
[][url=https://github.com/BastionNtB/YAVSOS/blob/main/docs/MODDING.md]类别文件[/url]：想添加你自己的类别？在这里了解如何操作！[/]
[/list]
[size=4][b]面向开发者[/b][/size]

[list]
[][url=https://github.com/BastionNtB/YAVSOS/blob/main/docs/BUILDING.md]从源码构建[/url][/]
[][url=https://github.com/BastionNtB/YAVSOS/blob/main/CONTRIBUTING.md]贡献[/url][/]
[][url=https://github.com/BastionNtB/YAVSOS/blob/main/docs/DESIGN.md]设计[/url]：YAVSOS 如何工作以及为什么。[/]
[][url=https://github.com/BastionNtB/YAVSOS/blob/main/CHANGELOG.md]更新日志[/url][/]
[/list]
[size=4][b]其他模组详解[/b][/size]

[list]
[][b]AzuAutoStore：[/b]每个物品仍然通过 AzuAutoStore 自己的存放调用进入，因此其消息、跳过列表和多人处理方式保持不变。它按名称和质量匹配堆叠，保留你的已装备物品、快捷栏、快速栏和收藏，任何没有规则要求的物品都遵循其自身设置。[/]
[][b]MultiUserChest：[/b]移入其他玩家箱子的操作遵循 MultiUserChest 自己的规则，包括当该玩家在移动等待期间延迟或离开时会发生什么。当 YAVSOS 的副本无法确定其他玩家会正确读取物品时，它会拒绝移动。[/]
[][b]EpicLoot：[/b]YAVSOS 读取其物品定义以按稀有度过滤。如果某个堆叠的稀有度在那一刻无法读取，稀有度过滤器不会接受该堆叠。[/]
[][b]RossItemDrawers：[/b]抽屉不接受 YAVSOS 规则，因为抽屉自身的物品分配已经完成了这项工作。分配给某个物品的空抽屉会通过 AzuAutoStore 获得该物品。[/]
[][b]游戏的“放置堆叠”按钮[/b]一如既往地工作，不遵循规则。[/]
[][b]物品来源：[/b]“来自模组”过滤器识别通过 Jotunn 或 ItemManager 注册的物品。模组以其他方式添加的物品会将其来源显示为“未知”。[/]
[/list]
已使用 AzuAutoStore 3.1.7、Jotunn 2.30.2、EpicLoot 0.15.4、RossItemDrawers 1.3.0 和 AzuExtendedPlayerInventory 2.6.4 进行测试。测试期间也测试了其他模组，但不会在此列出；该模组设计为默认情况下通常兼容。如果需要扩展或建立特定的兼容性，请在 GitHub 上创建一个 issue！

[size=5][b]许可证与致谢[/b][/size]

YAVSOS 使用 GPL-3.0-or-later（[url=https://github.com/BastionNtB/YAVSOS/blob/main/LICENSE]LICENSE[/url]）。没有这些模组作者及其模组的辛勤工作，YAVSOS 将无法工作：ServerSync 由 blaxxun 制作，MultiUserChest 由 MSchmoecker 制作，均为 MIT 许可（[url=https://github.com/BastionNtB/YAVSOS/blob/main/third_party/README.md]声明[/url]）。基于 Jotunn 和 BepInEx 构建。