Elden Ring Keyboard Overhaul

基于 AutoHotkey v2 的《艾尔登法环》键位增强脚本，核心目标是：

• 更稳定地切换记忆魔法
• 优化奔跑 / 翻滚手感
• 提供常用物品一键使用与少量辅助操作

主脚本文件：eldenring.ahk

功能概览

• 魔法绝对切换（1~5、F1~F3）
• 魔法顺切 / 反切（↑ / ↓）
• 魔法状态重置（Alt）
• 奔跑 / 翻滚状态机（LShift + Space，规避毫秒级实测死亡判定区间）
• 巡航模式（CapsLock）
• 左手副武器双持宏（6）
• 随身包包 4 格一键使用（Tab / C / V / B）
• 漫步模式切换（M）

环境要求

• Windows
• AutoHotkey v2.x
• 游戏进程名：eldenring.exe

脚本使用了 #HotIf WinActive("ahk_exe eldenring.exe")，仅在艾尔登法环窗口激活时生效。

安装与运行

1. 安装 AutoHotkey v2。
2. 克隆或下载本仓库。
3. 双击运行 eldenring.ahk（或右键用 AHK v2 解释器运行）。

关键前置设置（非常重要）

在游戏中设置： 设置 > 显示及声音设定 > 量表显示设定 = 开启

否则魔法切换功能无法正确工作。

默认键位说明

1) 魔法切换

• 1 2 3 4 5 F1 F2 F3：切换到对应序号魔法（默认总数 MagicCount := 8）
• ↑ 或滚轮上：下一个魔法（非 UI 状态）（建议换绑滚轮上为↑）
• ↓：上一个魔法（非 UI 状态）（建议换绑滚轮下为↓）
• Alt：重置魔法状态并重新同步脚本状态

2) UI 状态切换

脚本会根据按键推断你是否在菜单/UI 中，并在 UI 内禁用部分热键：

• 进入 UI：Esc、G
• 退出 UI：`（反引号）

3) 奔跑 / 翻滚

• LShift：切换奔跑状态（CapsLock 指示灯同步显示）
• Space：翻滚（短按单滚，长按连滚）
• 跑滚逻辑已改为状态机调度，会在关键时序上规避 396~429ms 判定区间
• 该区间来自 AHK 精确定时输入实测，按毫秒级窗口处理

4) 巡航模式

• CapsLock：切换持续前进（按住 W）
• 手动按 W 或 S 时会退出巡航

5) 武器与物品

• 6：左手副武器双持宏
• Tab：随身包包槽位 T（默认上马）
• C：随身包包槽位 Y（默认回血）
• V：随身包包槽位 R（默认回蓝）
• B：随身包包槽位 X（默认常驻道具）
• M：切换漫步模式（切换 P 键按下状态）

可调参数

在 eldenring.ahk 中可直接修改：

• MagicCount := 8：当前记忆魔法数量
• Sleep 与 SetTimer 的时序参数：影响宏稳定性与手感

已知限制

• 该脚本大量依赖固定时序（Sleep/SetTimer），在不同机器帧率、负载下可能需要微调。
• UI 状态是按键推断，不是读取游戏内真实状态；极端操作下可能需要按 Alt 重置同步。
• 建议不要使用“滚轮翻滚”类方案，以免与魔法切换冲突。

风险与免责声明

• 仅供学习与单机体验优化使用。
• 使用任何宏脚本都存在封禁或违规风险，请自行评估并承担后果。

许可证

当前仓库未声明 LICENSE。若需要开源发布，建议补充 LICENSE 文件（如 MIT）。