物品添加器

物品添加器

ItemAdder 是 Valheim 的单人游戏物品工具。在游戏中按 `F7` 打开面板,你可以在其中浏览、搜索并直接将基础游戏或其他已安装模组注册的物品添加到你的物品栏中。

描述

ItemAdder 是 Valheim 的一款单人游戏物品工具。在游戏中按 F7 可打开一个面板,在其中你可以浏览、搜索基础游戏或其他已安装模组注册的物品,并直接将其添加到背包中。

功能:

  • 从游戏当前的 ObjectDB 动态读取物品,无需固定的物品列表。
  • 支持中文和英文界面。点击标题栏中的 EN / 中文 可即时切换;语言选择会自动保存。
  • 可按材料、武器、护甲、食物、箭矢、工具、建筑、战利品、模组/自定义物品以及最近添加的物品进行分类浏览。
  • 支持按本地化名称、内部预制体名称、物品类型或描述进行搜索。
  • 可配置数量、物品品质和耐久度百分比。
  • 添加物品前会检查背包剩余空间,绝不会将溢出的物品掉落到地上。
  • 过滤掉攻击预制体、测试/作弊对象以及没有图标的对象。
  • 在单人游戏中,面板打开时会暂停世界,并阻止移动、攻击、交互和快捷栏输入。

前置要求

  1. Valheim 1.0.7(网络版本 39)。其他游戏版本可能可用,但未经测试。
  2. BepInExPack Valheim 5.4.23.5。加载本模组所必需。
  3. 不需要 Jötunn,也不需要其他依赖模组。

安装

  1. 关闭 Valheim。
  2. 按照 BepInExPack Valheim 的说明安装 BepInEx 5.4.23.5。
  3. 将此压缩包中的 BepInEx 文件夹解压到游戏根目录,并与现有的 BepInEx 文件夹合并。
  4. 确认 DLL 位于:
Valheim\BepInEx\plugins\ItemAdder.dll
  1. 启动游戏并加载一个单人存档。
  2. 按 F7 打开或关闭物品面板。

默认 Steam 游戏文件夹示例:

...\steamapps\common\Valheim

使用方法

  • 首次启动后会自动创建配置文件:

    BepInEx\config\npp.valheim.itemadder.cfg
    
  • 配置文件可让你更改快捷键、单次添加的最大数量、是否暂停游戏以及界面语言。

  • 使用标题栏中的 EN / 中文 按钮可即时切换语言。选择会被保存。

  • 选择一个物品,配置其数量、品质和耐久度,然后点击添加按钮将其放入背包。

卸载

  1. 关闭游戏。
  2. 删除 BepInEx\plugins\ItemAdder.dll。
  3. 如需重置所有设置,还需删除 BepInEx\config\npp.valheim.itemadder.cfg。

注意事项与限制

  • 仅限单人本地存档。连接到多人会话时面板不会打开。
  • 通过本模组获得的物品仍属于非正常途径获取。使用前请备份存档。
  • 依赖专用初始化、自定义数据或网络 RPC 的模组自定义物品,在从基础物品数据克隆时可能无法保留其全部特殊行为。
  • 中文界面需要系统中文字体,最好是微软雅黑。缺少字体时可能显示为方块字形。
  • 在游戏重大更新后,新添加的物品在名称表更新之前可能暂时显示为“未本地化物品”。
  • 部分较新的物品没有官方描述;面板将显示“无可用描述”。

包内容

README.md
BepInEx\plugins\ItemAdder.dll