快速切换 - 武器与奥术

快速切换 1.1.0

请注意
• 默认情况下，此模组会在游戏过程中接管方向键，这可能会妨碍输入经典的科乐美秘技。如果你想输入该秘技，请先关闭此模组（模组 → QuickSwitch → 启用，或将接管方式设为左摇杆/关闭），输入秘技后再重新开启。使用键盘（方向键或WASD）输入秘技不受影响。
• 我自己的存档还在游戏前期，所以奥秘选择器只测试了少数法术。包含大量法术（多行）的布局已经实现，但尚未在实际游玩中测试——如果发现任何异常，请反馈。

游玩过程中无需打开菜单即可切换武器与奥术法术。轻按方向键可循环切换，长按则可打开武器轮盘或由游戏原生美术构成的奥术卡牌手牌，选择时时间会减慢。只会装备你已拥有的武器与法术。

控制器
• 方向键左/右（轻按）：切换上一种/下一种武器类型。每种类型会记住你上次使用的层级。
• 十字键上/下（轻按）：切换上一个/下一个阿尔卡那法术。
• 按住方向键左/右：打开武器轮盘。按住上/下：打开阿卡纳卡牌。选择器打开时时间会减慢。
• 在选单中：右摇杆选择，松开方向键装备，B / 圆圈取消。R1 / RB 切换高亮物品是否参与轻按循环。在武器轮盘上，L2 / R2（LT / RT）切换层级。
• 阿卡纳牌每排最多排列六张：左右拨动右摇杆可在牌之间移动，上下拨动可切换排。
• 模组激活期间，方向键不再移动角色；请使用左摇杆。你可以在设置中交换此功能（左摇杆用于切换，方向键用于移动），或将其关闭。
• 右摇杆模式：左右轻推切换武器，上下轻推切换法术；按住可打开并保持右摇杆按住状态。使用左摇杆选择（奥术选择器中也可使用方向键），右摇杆居中即可装备，按 B / Circle 取消。此模式下无法使用右摇杆控制视角。
• 游戏过程中双击 L3 可暂停/恢复所有快速切换，包括键盘和鼠标。暂停会恢复原生方向并取消已排队的切换。暂停状态不会保存，游戏重启后清除；可在设置中通过暂停开关禁用该手势。

键盘和鼠标
• 鼠标侧键：后退键 = 上一把武器，前进键 = 下一把武器（轻按）。按住任一键可打开武器轮盘。
• 鼠标滚轮上/下：上一个/下一个阿卡纳法术（可在配置文件中关闭）。
• F：下一个法术（轻按）/ 奥秘卡牌（长按）。Q：下一把武器（轻按）/ 武器轮盘（长按），作为无侧键鼠标的备用方案。
• 在选择器中：用鼠标指向或使用鼠标滚轮，松开按住的按钮即可装备，右键切换点击循环，按 Esc 取消。
• 如果你的鼠标软件重新映射了侧键（例如映射为浏览器后退/前进），请将其恢复为默认设置，或使用 Q 键。

切换什么时候发生？
• 站立或奔跑：立即。
• 在地面攻击期间：在游戏允许你通过移动取消攻击的同一帧，因此感觉几乎是瞬间的。
• 在空中、施法时、硬直时等状态下：切换会进入队列，一旦你恢复控制便立即执行（请求在4秒后过期）。
• 切换使用游戏自身的装备功能，因此属性、阿卡纳祝福和HUD的更新与装备菜单中完全一致。

HUD
• 当前武器以小型图标形式显示在左上角秘术卡下方（可关闭）。
• 已装备的遗物显示在武器图标旁：仅显示原有的3个槽位，额外装备的遗物以+N表示；此功能可单独关闭。
• 暂停时，武器图标变为灰色，并短暂显示暂停/恢复提示。

设置
• 已安装 Belmont Minimap 时：暂停菜单 → MODS → QuickSwitch。Minimap 1.1.0 或更高版本还会显示时间流速和时间限制滑块，以及方向键 / 左摇杆 / 右摇杆 / 关闭的选项；更早版本仅显示开/关切换。
• 如果没有小地图，或其他情况，请编辑 BepInEx/config/local.belmont.quickswitch.cfg：
  – 通用.已启用（开）；
  – Input.TakeOver：方向键（默认）、左摇杆、右摇杆或关闭；Input.HoldSeconds：轻点/长按阈值（0.25 秒）；Input.PauseToggle：双击L3（默认）或关闭；
  – SlowMotion.Enabled（开启），SlowMotion.Factor：时间速度 1/2 – 1/10（默认 1/10），SlowMotion.MaxSeconds：选择器时间限制 1–5 秒（默认 5）；
  – Hud.ShowWeaponIcon（开），Hud.ShowRelics（开）；
  – Keys.WeaponPrevious（鼠标4）、Keys.WeaponNext（鼠标5）、Keys.WeaponAlt（Q）、Keys.Spell（F）、Keys.SpellAlt（空）：键盘按键或鼠标4/鼠标5/中键；关闭或空=未绑定；
  – 输入.鼠标滚轮循环切换法术（开）；
  – Rotation.ExcludedWeaponTypes / ExcludedSpells：轻触循环时跳过的物品（在选择器中用 R1 / 右键设置更方便）。

存档
• 该模组绝不会写入你的存档。游戏本身会保存你当前装备的武器和法术，因此正常存档后，你会保留最后一次切换的装备——就如同你使用了装备菜单一样。
• 方向接管仅在运行时存在，绝不会写入你的控制设置。禁用、切换模式或卸载后将恢复相应的原生方向。

要求
• Windows x64 上的 Steam 版本，游戏 BuildID 25975867。
• BepInEx 6 Unity IL2CPP x64（前沿版本 #788）： 官方下载使用Unity.IL2CPP-win-x64。如果已安装则无需重新安装。
• 游戏专属的 Nexus 包 恶魔城BepinEx （6.0.788，同一构建版本）也可用且已测试。
• 可选：贝尔蒙特小地图（游戏内设置页面；1.1.0 或更高版本可使用滑块）。

安装/升级
1. 退出游戏。首次使用BepInEx：将其解压到游戏文件夹中（与游戏exe同级），启动游戏一次让其初始化，然后退出。
2. 将此模组的 zip 文件解压到游戏文件夹中，保留 BepInEx/plugins/QuickSwitch/ 目录结构。升级时直接覆盖即可，你的设置将会保留。
3. 开始游戏。

卸载
退出游戏并删除BepInEx/plugins/QuickSwitch/文件夹。你的存档和操作设置无需任何改动。

已知限制
• 在默认方向键模式下，方向键不会移动角色；双击L3可暂时暂停，或选择右摇杆、左摇杆或关闭。右摇杆模式会接管相机方向。
• 长动作（蓄力或引导法术、处于硬直状态、长时间空中动作）会延迟切换；如果4秒后你仍未恢复控制，该请求将被取消，你可以再次按下。
• 首次切换到某把武器或法术时，游戏加载它可能会导致短暂的卡顿（与装备菜单中的情况相同）。
• 模组的按键会在启动时与你当前的游戏按键绑定进行比对；若发生冲突，仅会记录日志，不会阻止运行。如果你将 Q、F 或侧键用于其他功能，请修改配置文件中 Keys.* 的相关条目。
• 如果游戏报告装备错误，您之前的物品可能已经卸下：请在原生装备菜单中选择一件物品。快速切换功能此后将保持关闭，直到您重新启动游戏。
• 如果你在轻触循环中排除了所有武器类型（或所有法术），轻触将回退为循环切换全部类型。
• 其他在游戏过程中也使用方向键的模组可能会冲突；请将快速切换设为左摇杆或关闭。
• 已在游戏 1.1.3（BuildID 25975867）上测试。游戏更新后可能需要兼容的模组更新；如果某项功能停止工作，请检查 BepInEx/LogOutput.log。

常见问题
• 无 MODS 设置页面：请安装 Belmont Minimap，或使用配置文件。
• 轮盘上缺少一种武器类型：你尚未拥有该类型的任何武器（轮盘只显示已拥有的物品）。被排除在点击循环之外的物品仍会显示，并标有红色边框。
• 报告问题：请附上游戏 BuildID、模组版本、截图以及 BepInEx/LogOutput.log。

制作人员
• BepInEx 由BepInEx团队（包括Il2CppInterop和HarmonyX）制作——本模组所运行的框架。
• 《恶魔城》BepInEx 插件 由KZekai制作——本游戏的BepInEx整合包。
• 所有图标、卡牌美术和边框均为游戏自有资源，在运行时加载；均未重新分发。


1.1.0 更新
• 修复了游戏一段时间后图标丢失灰度外观的问题（1.0.0版本也受影响）。



中文说明

请注意
• 本 mod 默认在游玩时接管十字键，可能会影响输入经典的科乐美秘籍（Konami Code）。需要输入秘籍的玩家，请先关闭本 mod（MODS → 快速切换 → 启用，或把接管改成左摇杆 / 关闭），输入秘籍后再开启。用键盘（方向键或 WASD）输入秘籍不受影响。
• 我自己的存档还在游戏早期，法术选择栏只在法术较少时实测过；法术多到分成好几行的排列已经实现，但还没有在实际游玩中测过，遇到显示问题欢迎反馈。

游玩中无需打开菜单即可切换武器和 Arcana 法术。短按十字键循环切换；按住十字键打开使用游戏原版素材制作的武器轮盘或 Arcana 卡牌，选择时游戏会放慢。仅可使用你已拥有的武器和法术。

手柄
• 十字键 左 / 右（短按）：上一类 / 下一类武器，每类记住你上次用的档位。
• 十字键 上 / 下（短按）：上一个 / 下一个 Arcana 法术。
• 按住十字键 左 / 右：打开武器轮盘；按住 上 / 下：打开 Arcana 卡牌。打开期间游戏放慢。
• 选择时：右摇杆选择，松开十字键装备，B / 圆圈取消；R1 / RB 设置当前项是否参与短按轮换；武器轮盘里 L2 / R2（LT / RT）切换档位。
• Arcana 卡牌每行最多 6 张：右摇杆左右拨动换牌，上下拨动换行。
• 本 mod 生效时十字键不再控制移动，请用左摇杆走路。设置里可以改成“左摇杆切换、十字键走路”，或关闭手柄切换。
• 右摇杆模式：左右短拨切换武器，上下短拨切换法术；按住开启栏位，保持右摇杆推住，用左摇杆选择（法术栏也可使用十字键），右摇杆回中装备，B / 圆圈取消。此模式下右摇杆无法转动镜头。
• 游玩时双击 L3 暂停 / 恢复全部快速切换（包括键鼠），暂停时归还原版方向控制并取消排队切换。暂停不保存，重启游戏恢复；设置中的“暂停开关”可关闭此手势。

键鼠
• 鼠标侧键：后侧键 = 上一把武器、前侧键 = 下一把武器（短按）；按住任一侧键打开武器轮盘。
• 鼠标滚轮 上 / 下：上一个 / 下一个 Arcana 法术（可在配置文件里关闭）。
• F：下一个法术（短按）/ 奥术卡牌（按住）。Q：下一把武器（短按）/ 武器轮盘（按住），给没有侧键的鼠标备用。
• 选择时：鼠标指向或滚轮选择，松开你按住的那个键装备，右键设置是否参与轮换，Esc 取消。
• 如果鼠标驱动把侧键改成了别的功能（比如浏览器的后退 / 前进），请恢复默认或改用 Q。

什么时候真正换上？
• 站立或跑动时：立即生效。
• 地面攻击中：在游戏允许“推方向打断这一招”的那一帧换上，几乎没有等待。
• 空中、施法、受击硬直等：先排队，恢复控制后立刻换上（4 秒内没恢复则取消）。
• 切换调用游戏自身的装备函数，属性、Arcana 祝福和 HUD 的变化与在装备菜单中更换时完全一致。

HUD
• 左上角 Arcana 卡牌下方显示当前武器的小图标（可关闭）。
• 武器图标右侧显示原版 3 槽已装备魔导器；额外装备以 +N 表示，可单独关闭。
• 暂停时武器图标变灰，并短暂显示已暂停 / 已恢复。

设置
• 装了 Belmont Minimap 时：暂停菜单 → MODS → 快速切换。Minimap 1.1.0 及以上还会显示“时间速度”“时长上限”滑块和“十字键 / 左摇杆 / 右摇杆 / 关闭”选项；更早的版本只显示开关。
• 没有 Minimap，或要改其他项，用配置文件 BepInEx/config/local.belmont.quickswitch.cfg：
  – 通用.已启用（开）；
  – Input.TakeOver：方向键（默认）/ 左摇杆 / 右摇杆 / 关闭；Input.HoldSeconds：短按与按住的分界（0.25 秒）；Input.PauseToggle：双击L3（默认）/ 关闭；
  – 慢动作.启用（开）、慢动作.倍率：时间速度 1/2 – 1/10（默认 1/10）、慢动作.最大秒数：选择时长上限 1–5 秒（默认 5）；
  – Hud.ShowWeaponIcon（开）、Hud.ShowRelics（开）；
  – Keys.WeaponPrevious（Mouse4）、Keys.WeaponNext（Mouse5）、Keys.WeaponAlt（Q）、Keys.Spell（F）、Keys.SpellAlt（空）：可填键盘键或 Mouse4 / Mouse5 / Middle，Off 或留空 = 不绑定；
  – Input.MouseWheelCyclesSpells（开）；
  – Rotation.ExcludedWeaponTypes / ExcludedSpells：短按轮换时跳过的项（在选择界面用 R1 / 右键设置更方便）。

存档
• 本 mod 从不写存档。当前装备的武器和法术由游戏自己存档，所以正常存档后会保留你最后切换的装备——和在装备菜单里换一样。
• 方向接管只在游戏运行时存在，不会写进你的按键设置；关闭、切模式或卸载后恢复对应方向的原版用途。

前置
• Steam 版 Windows x64，游戏 BuildID 25975867。
• BepInEx 6 Unity IL2CPP x64（前沿版本 #788）：官方下载务必选 Unity.IL2CPP-win-x64。已经装好的不用重装。
• 也可以使用 Nexus 上本游戏的 BepInEx 包：《恶魔城》BepinEx（6.0.788，与上面是同一构建，已测试）。
• 可选：Belmont 小地图（游戏内设置页；滑块需 1.1.0 及以上）。

安装 / 升级
1. 退出游戏。首次使用 BepInEx：把框架解压到游戏根目录（与游戏 exe 同级），启动一次游戏完成初始化后退出。
2. 将本 mod 的压缩包解压到游戏根目录，保留 BepInEx/plugins/QuickSwitch/。升级时直接覆盖，设置会保留。
3. 启动游戏。

卸载
退出游戏，删除 BepInEx/plugins/QuickSwitch/。存档和按键设置都不需要处理。

已知限制
• 默认的十字键模式下，十字键不能走路，可双击 L3 临时暂停，或在设置里改成右摇杆、左摇杆模式或关闭。右摇杆模式会占用镜头方向。
• 较长的动作（蓄力 / 持续法术、受击硬直、较长的空中动作）会推迟切换；4 秒内仍没恢复控制的话，这次请求会取消，再按一次即可。
• 第一次切到某把武器或某个法术时，游戏要加载它，可能短暂卡一下（和在装备菜单里换一样）。
• 启动时会检查本 mod 的按键是否与你的游戏按键冲突，冲突只记日志、不阻止。若你把 Q、F 或侧键用在别处，请在配置文件里改对应的 Keys.* 项。
• 万一游戏报装备错误，原来的装备可能已经卸下：去原版装备菜单重新选一个即可，快速切换在重启游戏前保持停用。
• 如果把所有武器类型（或所有法术）都移出了短按轮换，短按会退回在全部之间轮换。
• 其他在游玩时也使用十字键的 mod 可能冲突，请把 QuickSwitch 改成左摇杆模式或关闭。
• 在游戏 1.1.3（BuildID 25975867）测试。游戏更新后可能需要等本 mod 的兼容更新；若功能停用或出现异常，请查看 BepInEx/LogOutput.log。

常见问题
• 没有 MODS 设置页：安装 Belmont Minimap，或用配置文件。
• 轮盘里少了某类武器：你还没有这一类的武器（只显示已拥有的）。不参与轮换的项仍会显示，带红框。
• 反馈问题：请附上游戏 BuildID、mod 版本、截图和 BepInEx/LogOutput.log。

致谢
• BepInEx 团队的 BepInEx（含 Il2CppInterop 与 HarmonyX）——本 mod 运行的框架。
• KZekai 的 《恶魔城》BepinEx——本游戏的 BepInEx 包。
• 所有图标、卡面和边框都是游戏自带素材，运行时加载，本 mod 不包含也不分发。


1.1.0 更新
• 修复游玩一段时间后黑白图标显示失效的问题（1.0.0 也受影响）。