在瓦尔海姆中，通过可配置的按钮组合为你的控制器提供额外可用的按钮，从而为其他模组触发虚拟键盘按键。

# 手柄组合键

**如果你的手柄按键不够用，现在够了。**

手柄组合键功能可以让你的Xbox风格手柄替你“按下”键盘按键，这样你就能使用仅限键盘的模组，而无需触碰键盘。

---

## 从这里开始：这个模组实际是做什么的

许多优秀的英灵神殿模组都是通过键盘按键触发的。比如某个模组会在你按下 C，或在按下时喝水 E键盘上倒是没问题，但手柄的按键就那么几个，而且大多都已经有功能了。

控制器和弦是一个翻译器。它安静地待在后台，等待你按下一个控制器按钮。当你按下时，它会告诉游戏“玩家刚刚按下了这个键盘按键”——然后你的其他模组就会像你真的按了一样做出反应。

有一件重要的事必须先了解：

**单独使用这个模组时，你看不到任何效果。**它没有菜单，也没有可见的作用。它的全部工作就是把按键输入传递给你的*其他*模组。所以你只需设置一次，让它匹配你已有的模组，之后你的控制器就能做到以前需要键盘才能完成的事情。

你可以把它想象成一个万能遥控器：遥控器本身不播放电影，它只是向真正播放电影的设备发送正确的信号。

---

## 它能帮到你的三种方式

映射有三种方式。你可以随意混合使用，只需设置你需要的那几种即可。

### 1. 一键对应一按键（最简单的方式）

按下一个手柄按键，即发送一个键盘按键。

*示例：* 按 **Y**，游戏会表现得像你按了 **E**。如果你有一个绑定到 E，现在**Y**喝水了。

你也可以为此选择**按住**。开启按住后，只要你按住按钮，按键就会保持按下状态，松开按钮时便会释放。对于需要*按住*某个键的模组（例如“按住缩放”键）来说，这是必需的。

### 2. 两个按钮同时按下 → 一个按键（“组合键”）

按住一个按钮，再按第二个按钮。两者组合发送一个按键。

*示例：* 按住 **RB** 并点击 **A**，游戏会认为你按下了 **Left Control**。

当你没有多余的按键可用时，这招很实用。按住**RB**键可以把你的四个面键（A、B、X、Y）变成四个*全新*的动作，同时不会丢失这些按键原本单独的功能。

### 3. 一个按钮 -> 一个鼠标滚轮的“档位”

有些模组会用**鼠标滚轮**来缩放或切换选项——这是手柄通常做不到的。这个功能可以让某个按键模拟一次滚轮点击。

*示例：* 按钮可以“向上滚动”以放大，或“向下滚动”以缩小。

---

## 安装模组

1. 安装 **BepInExPack Valheim**（大多数瓦尔海姆模组所需的标准模组加载器）。

2. 放置 控制器组合键.dll 在此文件夹中：

BepInEx/plugins/ControllerChords/

3. 启动一次英灵神殿，然后退出。这会生成你将编辑的设置文件。

4. 打开设置文件：

BepInEx/config/marc.valheim.controllerchords.cfg

你可以在任何文本编辑器（记事本就行）中编辑该文件，或者使用游戏内的**配置管理器**模组（如果你有的话）。

---

## 如何更改按钮功能

当你打开设置文件时，你会看到它被分成带标签的多个部分，比如 [单按钮 01], [卷轴 01]，以及 [和弦 01]。每个部分对应一个映射。要进行设置，只需填写几个简单的配置项。

以下是每个设置的含义，用通俗的话来说：

| 设置 | 含义 |

| --- | --- |

| **启用** | 开启此映射（真)或关闭(假). |

| **按钮** | 你按下的控制器按钮。 |

| **修饰键** | 你先按住的按键（用于组合键和分段滚动）。 |

| **TargetKey** | 你希望它发送的键盘按键。这必须与其他模组使用的按键一致。 |

| **保持模式** | 真 按住按钮的同时按住按键。 假 = 快速轻点。|

| **方向**（仅滚动） | 在 = 向上滚动（通常用于放大）。 退出 =向下滚动（通常缩小）。|

你可以使用的按钮名称有： A, B, X, Y, 方向键上, 方向键下, 方向键左, 方向键右, 磅, RB, LT, 转发, 左摇杆, 右摇杆, 返回, 开始对于和弦，所按住的**修饰键**必须是以下之一 右摇杆键, 磅, 转发，或 LT.

**TargetKey** 使用标准按键名称，例如 E, G, C, H, 左Ctrl, 左Alt，等等。

提示：如果你不知道某个模组使用哪个按键，可以查看该模组自己的页面或其配置文件——里面会告诉你按键是什么。它列出的那个按键，就是你填入**TargetKey**的内容。

---

## 现成示例（复制这些）

### 一键喝水——为“你渴了”设计

“你渴了”喝水需使用使用键 E，并清空你的容器，用 G将它们映射到备用按钮：

```ini ```

[单按钮 02]

启用 = true

按钮 = Y

目标键 = E

[单按钮 03]

启用 = 真

按钮 = X

G键

抱歉，您没有提供需要翻译的文本。请把要翻译的内容发给我。

现在**Y**喝酒，**X**干杯。随便选你喜欢的按键吧。

### 使用控制器缩放——用于 FrostJack 的“缩放”

这个mod是三种思路协同工作的最佳范例，因为它需要你**按住某个键**并且**使用滚轮**。

模组已就位 C 按住按钮开启缩放，然后滚动即可放大和缩小。所以我们要按住一个按钮来保持 C 按下，并将方向键用作滚轮。**此设置默认已开启**，但这里显示出来是为了让你了解其工作方式：

```ini ```

[SingleButton 01]

启用 = 真

按钮 = LB

C

保持模式 = 开启

[卷轴 01]

启用 = 真

修饰符 = LB

按钮 = 十字键上

方向 = 进

[卷轴 02]

已启用 = true

修饰符 = 左键

按钮 = 方向键下

方向 = 向外

请提供需要翻译的文本内容。

**实际操作方法：** 用手指按住 **LB**（这会开启缩放功能），然后点击 **十字键上** 放大，点击 **十字键下** 缩小，每次缩放一档。松开 LB 即可停止缩放。由于只有在按住 LB 时缩放才会激活，所以十字键在其他情况下仍可正常使用。

如果感觉不对，可以快速调整几个地方：

- **缩放方向反了？** 把这两个对调 方向 值（在 和 退出）。

- **更改了模组的按住键？** 如果你使用了模组的 缩放按键绑定 用于选择其他按键的命令，设置 目标键 在……里 [单按钮 01] 匹配。

### 用组合键腾出四个额外按钮

按住 **RB**，面部按钮将变为四个新动作：

抱歉，您没有提供需要翻译的具体文本内容。请提供待翻译的文本，我会为您翻译成中文。

[和弦 01]

启用 = 真

修改键 = RB

按钮 = A

左Ctrl键

HoldMode = false

抱歉，您似乎没有提供需要翻译的文本。请把待翻译内容发给我，我会按您的要求输出中文翻译。

按住 **RB** 并轻按 **A** → 发送 左 Ctrl.用同样的方式为其他模组添加更多和弦（RB + B、RB + X、RB + Y）。

---

## 一个友好的推荐布局

你想做什么都可以，但如果你想要一个容易记住的起点：

| 你按的键 | 适合用于 |

| --- | --- |

| 一个备用面板按钮（Y、X…） | 日常快捷操作（喝、吃） |

| 按住 LB + 方向键 | 缩放 |

| 按住 RB + A / B / X / Y | 四个额外模组动作 |

| 按住 LB + A / B / X / Y | 另外四个 |

| 按住 RT 或 LT + 一个按键 | 更稀有的工具或调试操作 |

先从一两个映射开始，确保手感自然，然后再逐步添加。不必一夜之间就把你的手柄变成钢琴。

---

## 如果某些功能无法正常使用

按下按钮后没有任何反应。请仔细检查该映射的 已启用 = true，而且它的 目标键 与你的其他模组使用的按键完全匹配。

它在键盘上有效，但手柄上无效。请确保你按下的确实是你设置的手柄按键，并且修饰键（如果有）是在按下第二个按键之前就已按住。

- **我想看看它是否在开火。** 在 [常规] 章节设置 LogChordEvents = true每次按下后将被写入 BepInEx/LogOutput.log，这样你就能确认它正常工作了。

- **我在菜单里时按钮会触发。** 默认情况下不会——在菜单、物品栏、商店、文本框和控制台中，映射是关闭的。只有设置 允许在菜单中 = 真 如果你确实想让他们在那里活跃。

- **每次按下缩放两个级别。** 确保 脉冲帧 = 1 在卷轴槽位上。如果有时会漏按，就把它调高到 2.

好的，请发送需要翻译的游戏文本内容。

## 温馨提示

- 此模组不会添加菜单、更改存档或影响其他玩家。它只读取你的控制器，并将按键传递给你的其他模组。

- 不要在同一个组合键中将同一个按钮同时用作修饰键和触发键。

- 如果两个模组同时响应同一个按键，它们都会触发——这通常没问题，但值得了解一下。

---

## 报告问题

如果需要帮助，请附上：

- 你的英灵神殿版本。

- 你的控制器类型。

- 从以下位置精确截取的部分 marc.valheim.controllerchords.cfg 你正在使用的。

你的 BepInEx/LogOutput.log 文件。

---

**插件GUID：** marc.valheim.控制器和弦

**版本：** 0.4.0