控制台面板界面，带收藏功能，通过 YAML 扩展原版物品集命令，并提供 EpicLoot 和 Jewelcrafting 示例。还添加了学习/遗忘和清空背包命令，抑制配方解锁刷屏，移除装备延迟和技能提升效果。

管理便捷

控制台面板界面，支持收藏功能、可配置的语言循环切换，以及通过 YAML 扩展原版物品集，附带 EpicLoot 和 Jewelcrafting 示例。还添加了学习/遗忘和清空背包命令，屏蔽配方解锁刷屏提示，移除装备延迟和技能提升特效。

搜索所有原版和其他模组添加的控制台命令。你还可以将命令按组收藏。

控制台面板还有木质主题。默认情况下，你可以用F6关闭控制台面板。

在原版中，有一个控制台命令 物品套装为测试制作你自己的套装。你可以编辑原版套装，也可以制作自己的套装。该套装同时支持Epicloot和Jewelcrafting。

调用内置套装示例。使用命令 清除物品栏 需要的话可以清空你的库存。

功能

• 抑制来自以下内容的 Valheim 解锁弹窗刷屏： 队列解锁消息.
• 可以独立隐藏技能升级的视觉特效、音效以及技能升级提示信息。
• 可选的即时装备/卸下，移除英灵神殿的装备动作延迟。
• 添加仅限管理员的本地命令：

功能

• 抑制来自 队列解锁消息.
• 可独立隐藏技能升级的视觉特效、音效以及技能升级提示消息。
• 移除《英灵神殿》的定时装备动作，即可选择瞬间装备/卸下。
• 添加仅管理员可用的本地命令：
  • 'itemsets' <itemsetname> 物品集名称定义于 管理员便利性.物品套装.yml, 管理员体验优化.物品套装.史诗战利品.yml 和 AdminQoL.物品套装.珠宝加工.yml
  • adminqol_learn <prefab|all> 学会所有配方/发现，或一个预制物品/建筑部件/制作站及其相关配方。
  • adminqol_unlearn <prefab|all> 遗忘所有已学会的物品，或一个预制物品/建筑部件/制作站及其相关配方。
  • 清空物品栏 永久移除本地玩家物品栏中的所有物品条目。
  • 管理便捷物品套装重载 重新装填 管理便捷模组.物品套装.yml.
  • 管理员便捷套装饰品列表 列出当前已加载的YAML项目集。
• 将 YAML 物品集注入 Valheim 的原版内容中 物品套装 命令，因此自定义设置可与之配合 物品集 <name> [quality] [keep].
• 可选的YAML物品元数据，用于在加载Jewelcrafting插槽和EpicLoot魔法物品模组时使用。
• 史诗掉落套装加成仍由史诗掉落定义 传奇物品.json；AdminQoL 只会标记具有匹配 EpicLoot ID 的套装物品。
• 为瓦尔海姆的F5控制台添加了一个ConsolePanel命令浏览器，支持命令分组、搜索、编号收藏配置以及F6显示/隐藏功能。
• 使设置中的语言切换顺序可编辑，通过 BepInEx/config/AdminQoL/LanguageSequence.yml.
• 添加一个需管理员权限的只读预制体性能分析悬浮层，用于检查当前悬停的本地对象。默认按 G 切换悬浮层，按 H 复制缓存的快照。兼容的 ZoneSavior 服务器可以选择解析缓存的创建者名称；如果没有该服务器，未解析的创建者将保持 未知.
• 不使用服务器同步。这是一项有意设计的客户端/管理员实用工具。
• 仅管理员 忽略负重 防止负重，并在库存空间和正常堆叠规则允许的情况下，让自动拾取在超过重量限制后继续进行。

配置

BepInEx配置文件位于 BepInEx/配置/sighsorry.AdminQoL.cfg运行时生成的管理便捷YAML文件存储在 BepInEx/config/AdminQoL/.

• 1 - 常规: 需要服务器管理员 和 加载YAML物品集.
• 2 - 游戏体验优化：解锁弹窗/日志屏蔽、技能升级效果/警报消除、即时装备，以及 忽略负重 （默认： 真）。
• 3 - 控制台面板：面板大小、视觉风格、原版控制台底部偏移、鼠标光标释放以及切换键。
• 4 - 控制台面板收藏：收藏标签页数量和收藏命令列表。
• 5 - 预制体性能分析：启用/管理员权限门控、切换或按住模式，以及显示/复制密钥。快照每秒刷新一次，并始终包含组件列表。

忽略负重 仅适用于本地主机/管理员玩家，即使 需要服务器管理员 对命令已禁用。它遵循游戏的自动拾取开关、物品归属、拾取延迟、范围和背包空间检查。它不会改变物品重量或最大负重上限，因此背包仍可能显示超重数值。关闭该选项会恢复正常重量检查；游戏的下一次状态更新会相应地添加或清除负重效果。在专用服务器上，请在管理客户端的配置中启用它；无需安装 AdminQoL 服务器端。

学习/取消学习示例：

学习全部 学习盾木 学习工作台 遗忘全部 遗忘盾木 遗忘工作台

目标仅匹配预制体名称。物品目标会影响物品发现和匹配输出配方；制作站目标会影响制作站条目及其处制作的配方。完整学习和完整遗忘均使用显式 全部 目标，以及 全部 包含在Tab补全中。

语言顺序

在客户端打开“设置 > 玩法”会创建 BepInEx/config/AdminQoL/LanguageSequence.yml 来自 Valheim 当前的语言顺序。该文件仅在缺失时生成，一旦存在便不会被覆盖。

YAML 是 Valheim 内部语言 ID 的顶级列表：

- 英语 - 瑞典语 - 法语 - 韩语

右箭头按从上到下的顺序浏览列表，左箭头则反向浏览，两个方向在两端都会循环。 英语 被用作顺序锚点。每次打开设置界面时都会读取该文件，因此编辑后请关闭并重新打开设置。未知和重复的ID会被忽略，而文件中缺失的已安装语言会按其当前运行时顺序追加。无法读取或为空的文件，或不包含任何受支持ID的文件，会回退到上一个有效顺序或瓦尔海姆的当前顺序。专用服务器不会创建或使用此文件。

YAML 物品集

当首次需要YAML物品集时，模组会创建 BepInEx/config/AdminQoL/AdminQoL.ItemSets.yml 来自Valheim内置的物品套装。该文件生成一次后，AdminQoL便不会再覆盖它。文件位于之前的 BepInEx/config/AdminQoL.ItemSets*.yml 根位置未加载或迁移。

管理员体验优化还会创建并加载以下可选的示例/参考文件：

• BepInEx/config/AdminQoL/AdminQoL.ItemSets.EpicLoot.yml
• BepInEx/配置/AdminQoL/AdminQoL.物品套装.珠宝加工.yml

所有匹配的文件 管理员便捷工具.物品套装*.yml 加载完成后，生成的EpicLoot文件仅在安装了EpicLoot时解析，生成的Jewelcrafting文件仅在安装了Jewelcrafting时解析。它们的示例条目从所有原版物品集中复制而来，经过重命名，并用模组专属的方块进行了扩展。它们 已启用：是 默认情况下；将条目设置为 已启用：否 如果你不想要它在 物品套装 命令。

套装：
- 名称：MyAdminSet
  物品：
  - 预制体：SwordIron
    品质：4
    数量：1
    使用：true
    快捷栏槽位：1
  技能：
  - 技能：Swords
    等级：100
  已解锁工作站：
  - piece_workbench
  已解锁物品：
  - Wood
  - Stone
  从物品套装继承已解锁内容：
  - Start

快捷栏槽位 是《英灵神殿》的物品栏快捷栏布局。 1 意思是快捷栏槽位1， 8 即快捷栏第 8 格，并且 0 或省略字段表示没有快捷栏移动。

如果YAML套件名称与原生套件匹配，并且 替换现有 为真时，YAML定义会在运行时替换原版套装。缺失 替换现有 被视为 false。如果你想 AdminQoL 重新生成该文件，请删除已生成的文件。

已知物品传承循环会在《英灵神殿》更改物品栏或角色知识之前被拒绝。缺失的父级集合保留《英灵神殿》的正常行为并被忽略。应用集合时，引用的制作站预制体使用其基础等级，而不查询仅场景内的扩展；已放置的制作站保留《英灵神殿》的正常等级计算。

珠宝加工插槽数值支持精确的宝石预制体名称， 空, 随机_简单, 随机进阶，以及 随机完美. EpicLoot效果支持精确效果ID或 类型：随机; 数值：随机 在EpicLoot的效果值范围内随机生成。

AdminQoL不注册EpicLoot套装定义。请在EpicLoot的 传奇物品.json，然后引用已加载的 传奇ID 以及可选 设置ID 来自一个 管理员便捷工具.物品套装*.yml 文件。如果 设置ID 如果省略，AdminQoL会询问EpicLoot哪个已加载的套装拥有该 传说ID生成的 管理员体验优化.物品套装.史诗战利品.yml 记录所有受支持 史诗战利品： 字段。

已知限制：可选物品元数据仅应用于瓦尔海姆添加操作返回的物品。当一次录入创建多个物品实例时，较早的实例可能无法获得元数据；部分失败的添加操作也可能导致已添加的物品缺少元数据。对于增强型不可堆叠装备，请使用单独的 堆叠：1 检查物品栏空间。AdminQoL 不会重试失败的物品发放。

开发验证

《英灵神殿》1.0 版本的适配最初是针对 1.0.7. 负重选项已构建，并已对照以下内容进行合同检查： 1.0.15 （Windows客户端版本25390630；专用服务器版本25390671）；仍需在游戏内实际验证。清单声明了BepInExPack_Valheim 5.4.2350构建引用使用原始安装的游戏 DLL，不会将其公开。

基于已安装的英灵神殿程序集构建，并自动将合并后的调试插件部署到本地游戏的 BepInEx/plugins 文件夹：

dotnet build AdminQoL.sln -c Debug -p:DeployToGame=true pwsh -NoProfile -File ./VerifyStructureRegression.ps1 -PluginDll ./bin/Debug/AdminQoL.dll -GamePath '<Valheim安装目录>' pwsh -NoProfile -File ./VerifyLightweightXRay.ps1 -PluginDll ./bin/Debug/AdminQoL.dll -MonoCecilDll '<Valheim安装目录>/BepInEx/core/Mono.Cecil.dll'

结构回归运行器需要 PowerShell 7，并执行已构建 DLL 中的托管方法：知识更新、继承验证、站点引用作用域、嵌套/终结器清理，以及负重指令重写（包括缺失/歧义目标以及保留的标签/异常标记）。它还会对照原始游戏程序集检查 Harmony 目标签名和注入参数，以及选定的 IL 契约和原始自动拾取重量/空间/归属检查。它不会安装 Harmony 补丁、构造实时 Unity 组件，也不会更改配置文件/世界。攻击目标工厂通过其编译后的名称进行检查，而不是在 PowerShell 中执行 Harmony 的初始化器。其可选的 基线Dll 参数会将目标与优先级同已发布的 AdminQoL 1.1.3 DLL 进行比较，仅允许两个新增的负重补丁。

要在保留的原始专用服务器 DLL 上重复执行，请在新的 PowerShell 进程中运行结构脚本，并 -托管目录'<服务器快照>/原始/valheim_server_Data/托管'; 保留 -游戏路径 指向 BepInEx 的客户端安装目录。每次运行当前会检查 184 项断言。这是程序集/托管代码检查，不是运行中的专用服务器。

1.0改编版使用了 输入指针位置，明确保持自定义命令可见，而不 开发者命令，并修补新的十参数 添加物品 过载。物品集赋予仍通过原版代码运行，保留新的 作弊 标记并 背包已满则掉落 行为。AdminQoL 不会拦截或重试溢出掉落。

这些检查不能替代游戏内验证。发布前，请确认启动过程完成且没有 AdminQoL 补丁错误；测试 F5/F6、指针点击、控制台/样式变更及关闭期间的搜索聚焦、权限/配置变更后的类别/收藏刷新、语言循环切换、预制件和已放置的制作站、学习/遗忘，以及带有可选模组时的物品数量/元数据。在背包为空/已满、物品掉落、作弊标记以及授予失败/嵌套授予的情况下检查物品集授予；在建造、修理、格挡和攻击期间检查耐久度保留。使用一次性角色/世界，分别以主机、专用服务器管理员和非管理员客户端的身份重复相关场景。当服务器集成不可用时，可选的 ZoneSavior 名称查找也必须安全降级。

为了 忽略负重，超出常规重量限制并验证移动/耐力以及自动拾取到空槽位或可堆叠的同类物品中。检查背包已满且无堆叠容量、自动拾取已禁用、物品归另一名玩家所有、负重状态下切换选项、重新连接，以及非管理员客户端（同样在 需要服务器管理员=false）。确认库存加地面物品的总数保持不变。缺失或存在歧义的自动拾取补丁目标会记录一条警告，并保持原有的拾取重量检查不变。