《侠客风云传前传》无障碍模组 0.1.29

安装方法

本模组只支持已安装免费“幽冥路”DLC 的 Steam 版游戏。未安装该 DLC 时，即使授权文件有效，无障碍核心也无法加载。

将压缩包中的全部文件直接解压到游戏根目录。Steam 正版玩家优先运行“通过Steam启动侠客风云前传无障碍版.cmd”；它使用本游戏所有玩家共用的 Steam App ID，不包含个人 Steam ID，也不依赖 Steam 安装盘符。原来的“启动侠客风云前传无障碍版.cmd”继续保留，供已经能正常直接启动的环境使用。

授权文件不在公开压缩包内。取得授权后，将管理员单独提供的 wuxia-prequel-license.json 放到：
WuxiaPrequelAccessibility\授权\wuxia-prequel-license.json

未找到授权时，模组会保存并复制申请码；无障碍核心不会加载，但游戏仍可继续运行。

诊断日志

正式玩家版默认关闭模组诊断日志。需要排查问题时按 F8 可在当前游戏会话中开启或关闭，读屏会朗读当前状态。复现问题并正常退出游戏后，当前会话日志位于游戏根目录下的 MelonLoader\Latest.log，历史日志位于 MelonLoader\Logs。F12 是游戏截图键，不用于模组调试。

使用时绊路时，诊断开关默认改为 Ctrl+F8，游戏修改设置默认改为 Ctrl+F11，保留作者原来的 F8 和 F11 操作。实际键位以当前页面 F9 帮助为准。

语言兼容

模组提供简体中文和英文文本。若游戏实际以繁体中文运行，模组会使用简体中文提示和帮助；游戏原生文字保持游戏实际使用的语言，不会被模组改成简体或繁体。

默认按键与游戏内帮助

以下按游戏和模组的默认键位显示。玩家修改按键后，请以游戏内按 F9 实时朗读的实际按键为准。按 F9 只朗读当前界面的操作方法，不移动焦点，也不执行操作。

本版保留 Esc 的原功能，并增加退格键作为第二返回键。凡以下说明写 Esc 的界面，也可以按退格键执行相同的原生取消、返回或菜单操作。文字输入时，退格键仍只删除字符，不会执行返回；如果玩家把退格键绑定为其他游戏原生动作，第二返回键会自动停用以避免冲突。

游戏修改设置

在普通地图空闲、没有对话、菜单、影片、加载或战斗时按 F11，可打开“游戏修改设置”。用 W 和 S 选择设置，用 A 和 D 调整当前设置，按回车键保存当前设置。按 Esc 或退格键退出；尚未保存的修改会被取消。按 F9 可朗读当前页面帮助。

“偷窃天赋必定发动”默认开启。妙手空空或神偷盗帅攻击敌人时，只要敌人剩余气血不高于 80%（包含正好 80%），偷窃天赋就会必定发动；高于 80% 时不会发动。关闭后恢复各天赋的游戏原生气血要求与随机概率。

“偷窃时优先取得数量最少的物品”默认关闭。开启后，玩家一方的偷窃会优先取得目标原生物品栏中当前数量最少且大于零的物品；多个物品数量并列最少时，按目标原生物品栏顺序取得第一种；没有剩余物品时，保留游戏原生的金钱结果。该设置不改变敌方偷窃、物品转移、背包或战斗提示路径。

“天生神童经验加成”只调整说明为“战斗后获得经验加成”的天生神童百分比部分，游戏原生固定增加的 100 经验保持不变。默认和最小为 20%，每按一次 A 或 D 减少或增加 20%，最大 300%；按回车键保存后立即生效并在重新启动游戏后保留。

标题菜单

主标题菜单：用 W 和 S 选择，按回车键打开。
幽冥路标题菜单：用 W 和 S 选择，按回车键打开，按 Esc 返回主标题菜单。
片头影片：允许跳过时按回车键跳过；不能跳过时等待影片结束。

剧情对话

普通对话：按回车键继续。
对话选项：用 W、S、A、D 选择，按回车键确定。
对话纪录：用 W 和 S 浏览，按 Esc 或 F 关闭。

地图探索

普通地图：用 W、S、A、D 移动；用左、右方括号键浏览目标；按左 Shift 加方括号键切换目标类别；用 Q 和 E 转动镜头；按反斜杠键自动前往当前目标；按回车键交互；按 G 朗读日期、地图和方向；按 V 朗读坐标。
普通地图浏览目标时会播放方向提示音，提示音按固定朝北定位，不随人物转身而转动；目标在南侧时降低三个半音。按 = 重新朗读当前目标并刷新方位、距离和提示音。按 Alt+= 开关音频导航，开启后每 0.3 秒播放一次当前目标提示音，菜单、对话和战斗中暂停；再次按 Alt+= 关闭。
大地图：用 W、S、A、D 移动；用左、右方括号键浏览地点；用 Q 和 E 转动镜头；按反斜杠键自动前往当前地点；进入地点范围后按回车键进入；按 G 朗读日期、区域和方向；按 V 朗读坐标。
地图速度：在普通地图或大地图按左 Ctrl，可在正常速度、两倍速和三倍速之间切换；所选档位在普通地图和大地图之间保持，重新启动游戏后恢复正常。自动前往也使用当前档位。
自动行走时按任一移动键停止。
普通地图自动前往遇到原生分段路径时，会重新提交同一原生目标；如果游戏没有生成后续路径，导航会安全结束并朗读既有的“尚未到达”，不会停在无法移动却仍处于导航中的状态。
“任务与机关”会列出符合条件的碰撞任务点，例如弦剑山庄的“驰援弦剑山庄”、弦箫幽谷的“调查弦箫幽谷”、洛阳的“水盼盼的打抱不平”，以及姜望与楚绘的原生碰撞剧情；能直接取得任务名称或对白时使用游戏原生当前语言，水盼盼事件使用模组的对应名称。自动前往后仍须实际走入碰撞区域，由游戏触发剧情。
自动前往会移动的目标时会继续跟随；到达采集目标附近后仍须按回车键交互。
“人物”类别在室外会排除场景中的房间内人物，在建筑内只显示当前建筑范围内的 NPC；自动前往人物后，按回车键沿游戏原生交互路径交互。具有原生特殊剧情对话的人物，只要游戏数据能唯一确认姓名，也会出现在“人物”类别中；例如剧情结束后洛阳面摊旁的姜望可以正常浏览和自动前往，再按回车键原生确认交谈。
东渡口支线中的“东瀛女子”现在会出现在“人物”类别中，可浏览、自动前往，再按回车键原生交谈。
杭州传闻出现的隐元阁门人现在会以正确名称出现在“人物”类别中，不会再错误朗读为“泼皮”；浏览和自动前往后，仍须按回车键沿原生交互路径打开原生商店。室外列表继续排除寻芳阁、酒楼等房间内人物。
杭州寻芳阁老鸨现在会出现在“人物”类别中；浏览、自动前往和按回车键交谈仍走游戏原生交互路径。
“敌人”类别会列出当前原生战斗敌人；用左、右方括号键浏览，按反斜杠键自动前往，接近后由游戏原生距离和朝向触发警戒并进入战斗。
洛阳郊外鲤鱼王旁的河中小岛会在“出入口”类别中显示为“河中小岛出入口”；岸边选择它可自动前往并由原游戏动作上岛，岛上选择同名目标可自动前往并返岸。
杭州城的明月楼、废弃庙宇、杭州民房和寻芳阁会在“出入口”类别中朗读各自的入口或出口名称。
杭州民房的“人物”列表不会再错误列出其他房间内的吴老爹、吴大娘；两人在自己房间内仍可正常显示、自动前往和交互。

游戏内主菜单

主菜单：用 A 和 D 浏览，按回车键打开，按 Esc 关闭。
系统菜单：用 W 和 S 浏览，按回车键执行，按 Esc 返回主菜单。

角色界面

按 F1 打开或关闭角色界面。
角色资料：用 W、S、A、D 浏览，按回车键执行；用 U 和 I 切换队友；按 G 朗读详细资料。
装备、修练、使用药品、使用秘籍和离队确认：用 W、S、A、D 浏览，按回车键执行，按 Esc 返回角色资料。

队伍界面

按 F2 打开或关闭队伍界面。
队员列表和操作列表：用 W、S、A、D 浏览，按回车键打开或执行，按 Esc 返回。
加点界面：用 W、S、A、D 浏览，按回车键执行，按 G 朗读属性资料。

背包界面

按 F3 打开或关闭背包。
物品列表：用 U 和 I 切换分类，用 W 和 S 选择物品，按回车键使用。
选择使用者：用 W 和 S 选择队员，按回车键使用，按 Esc 返回物品列表，按 G 朗读所有可见队员及不可用状态。

任务与传闻

任务记录：按 F4 打开或关闭；用 U 和 I 切换分类，用 W 和 S 选择任务，按回车键读取详情。
传闻记录：按 F5 打开或关闭；用 W 和 S 浏览。

商店界面

商品列表：用 U 和 I 切换购买与出售，用 W 和 S 选择物品，按回车键打开数量，按 Esc 关闭商店。
数量界面：用 W、S、A、D 在增加、减少、结账和取消之间移动，按回车键执行，按 Esc 返回商品列表。

系统设置

设置列表：用 W 和 S 选择项目，用 A 和 D 调整，用 U 和 I 切换系统设置与按键设置，按回车键执行，按 Esc 退出并选择是否保存。
分辨率：用 W 和 S 选择，按回车键确认，按 Esc 返回。
改键：用 W 和 S 选择操作，用 A 和 D 切换键盘和手柄栏，按回车键开始改键，再按下新按键。F9 是无障碍帮助键，不能设为游戏按键。
确认窗口：用 A 和 D 选择，按回车键执行。

存档和读档

按 F6 打开存档界面；用 W 和 S 选择位置，按回车键保存，按 Esc 返回。覆盖确认时用 A 和 D 选择，按回车键执行。
按 F7 打开读档界面；用 W 和 S 选择存档，用 U 和 I 切换普通存档与自动存档，按回车键读取，按 Esc 返回。

锻造与炼丹

选择配方：用 U 和 I 翻页，用 W、S、A、D 选择，按回车键开始，按 Esc 关闭。
棋盘：用上、下、左、右方向键滑动；用 W、S、A、D 只读浏览格子；按 G 朗读当前物品、剩余次数、进度和四个方向的合并预测。
结算：按回车键关闭。

机关箱

用 W、S、A、D 选择行列移动动作，按回车键执行。
用上、下、左、右方向键只读浏览颜色格；每格只朗读颜色，以及它属于中央还是外围；按 G 朗读剩余次数和中央九格；按 Esc 立即以失败结束。
结算页按回车键关闭并返回地图。

战斗操作

战报默认简洁模式：按 Alt+End 切换简洁与完整并保存选择。简洁模式保留攻击、治疗、持续伤害、全部状态获得或移除、重要天赋结果、物品与金钱等变化；省略周期回复、重复续期与积累、纯天赋原因和成长明细。人物轮到行动时只读姓名，移动后不重复属性和坐标摘要，结束行动时只读简短结果。分号键手动查看角色属性与状态，原生查看角色、目标和坐标的操作仍保留完整信息。Page Up 和 Page Down 及 Alt 跳转始终朗读完整战报记录。F10 自动战斗在简洁模式中也按上述规则朗读；完整模式下的自动战斗继续沿用只读伤害规则。
浏览战场角色或目标时会播放相对于当前行动单位的方向提示音，按固定朝北定位，南侧降低三个半音；战场提示音最远可听到十五格。目标名称后会读出方位、格距及目标面向。

战前布阵：用 W、S、A、D 在可布阵格之间移动；按回车键放置当前角色，当前格已有本方角色时按 Esc 撤回；用 U 和 Tab 切换待配置角色；按 J 轮换到可布阵格；按 H 自动配置。听到“当前布阵阶段已完成”后按回车键继续；如果没有下一支队伍，战斗将开始。按 F9 可朗读按游戏当前设置解析的实际操作键。
战场光标：用 W、S、A、D 移动；按回车键选择角色或移动；按 Tab 切换可行动角色；按 I 查看单位；用左、右方括号键浏览敌人。
八方位逐格浏览：小键盘 8 北、9 东北、6 东、3 东南、2 南、1 西南、4 西、7 西北固定使用世界方向，不随镜头旋转；WASD 仍随镜头。只浏览对应方位的真实邻格，没有邻格时原位静默，不用其他方位替代，也不跨格。移格直接朗读人物、事件和坐标。移动状态受原生移动范围限制，技能／物品选点受当前范围限制，也能沿真实邻格返回行动者原格。仍用原来的确认键选择、移动或施放技能；方向浏览不会自行执行这些动作。九个小键盘键均可在配置中更改，F9 读取当前绑定。
回到行动者：按小键盘 5 将光标和镜头回到当前行动者所在格，并重读该格。普通浏览、移动、技能选择及技能／物品选点均可使用，不移动人物、不取消或施放技能。技能选择界面只启用这个回焦键，原生方向键继续选择动作。
转动镜头：Q 向左、E 向右，每按一次切换一个固定世界八方向。东北按 Q 到北，再按 Q 到西北；长按只转一步，保留原俯仰、缩放和跟踪。真正非标准的初始角度先落到所按一侧的下一标准方位，随后逐步切换。
战斗事件格：DLC 战斗光标停在事件格时，会朗读游戏当前数据能确认的用途和可触发单位或阵营；不能确认具体用途时只朗读“战斗事件格”。移动光标只浏览，不会执行事件。
特殊格快速定位：按主键盘 - 定位上一个特殊格，按 = 定位下一个特殊格，首尾循环。未选择人物时查看全场特殊格；选择人物准备移动时，只查看当前可移动范围和人物所在格中的特殊格。定位只移动光标，按原来的确认键执行游戏操作。全场没有候选时朗读“当前战场没有特殊格子。”；移动范围和人物所在格中没有候选时朗读“当前可移动范围和人物所在格中没有特殊格子。”。没有候选时光标不动。对话、技能选目标、布阵及动作执行期间不启用；F9 可朗读操作帮助。
行动栏：用 W、S、A、D 选择；用左、右方括号键逐项浏览当前招式的名称、说明、消耗、伤害和状态；按 I 查看全部招式详情；按回车键执行，按 Esc 返回。
选择目标：用 W、S、A、D 移动目标光标；用分号键和单引号键切换射程内的上一个和下一个有效敌人，用逗号键和句号键切换上一个和下一个有效队友，没有对应目标时会提示“无可选目标”；用左、右方括号键浏览目标详情；按回车键确认，按 Esc 返回。
单位资料：用 W 和 S 在当前区域逐项浏览，用 D 进入武学、天赋和内功区域，用 A 返回属性和状态区域；查看武功时，用左、右方括号键逐项浏览名称、说明、消耗、伤害和状态；按 I 重读人物资料，按 Esc 返回战斗。
战斗道具：用 W 和 S 浏览，按回车键使用，按 Esc 关闭。
测试自动战斗：F10 开启或关闭自动战斗。每场战斗默认关闭自动使用物品；需要自动使用物品时，在战斗中按 F 开启，再按一次 F 可关闭。这个物品开关只影响 F10 控制的玩家自动回合，进入下一场战斗时会重新默认关闭。
其他浏览键：按左 Ctrl 可在正常速度、两倍速和三倍速之间切换；战斗速度只加快战斗动画和节奏，不加快战场光标或战斗页面操作；所选速度在同一次游戏启动期间跨战斗保留，彻底退出并重新启动游戏后恢复正常速度，只有手动切换时才会朗读。分号键朗读当前角色状态；单引号键浏览行动；Q 向左转动战斗镜头，E 向右转动；Page Up 和 Page Down 浏览战斗消息；左 Alt 加这两键跳到第一条或最后一条；左 Shift 加 Page Up 和 Page Down 浏览胜负条件、战斗提示或人物对白；左 Alt 加左 Shift 加这两键跳到第一条或最后一条；逗号键和句号键浏览队友。
战斗对白：按回车键、Esc 或 Tab 继续。
战斗结果和结算：页面就绪后按回车键继续或退出。

时绊路兼容

先按时绊路作者要求安装剧情模组及配套文件，再将本无障碍包安装到对应游戏目录。本包只提供无障碍文件，不包含时绊路剧情、资源或存档。专用功能仅在已登记的时绊路终卷及难度十变体启用；作者更新文件后若无法识别，需核对新版后再登记。
时绊路剧情中，单独按住左、右 Alt 至少 0.3 秒才快进；短按无反应，组合键不误快进，松开恢复原实际速度。选项仍手动选择，保留作者不能跳过的片段。作者 Ctrl 变速与松开规则保持原样；Ctrl+F8、Ctrl+F11 等模组组合键不会误启动变速。
时绊路战斗使用作者速度倍率。按当前“切换模式”键打开变速／认输菜单，具体键位见 F9；原生键位冲突时不启用这个额外菜单入口。浏览菜单、确认执行作者原按钮、取消返回；认输先打开原生确认框，默认选中取消。
第七技能沿作者原动作浏览与确认，帮助读取实际绑定；未绑定时不自行分配物理键。普通新游戏命名页支持原生中文输入法，Tab 在姓、名、确认之间切换，Shift+Tab 反向，确认仍执行作者原入口。

战前准备

主页面：用 W 和 S 浏览关卡，用 A 和 D 浏览侠客，用 U 和 I 浏览战前操作，按回车键打开。
关卡详情：用 W 和 S 阅读说明和奖励，按回车键执行当前按钮，按 Esc 关闭。
系统菜单：用 W 和 S 浏览，按回车键执行，按 Esc 返回。
购买或确认窗口：用 A 和 D 选择，按回车键执行，按 Esc 取消。

侠客与部队管理

侠客或部队资料：用 W 和 S 浏览资料和操作，用 A 和 D 切换人物或部队，按回车键执行，按 Esc 返回战前准备。
装备和天赋：用 W 和 S 浏览，按回车键执行，按 Esc 返回。
确认窗口：用 A 和 D 选择，按回车键执行，按 Esc 取消。
提示窗口：按回车键关闭。

问答、列传和结局

问答：用 W、S、A、D 选择答案，按回车键提交或继续；问答开始后不能取消。
列传：按回车键继续；人物动作播放时等待动作结束。
结局影片和制作人员名单会自动朗读；能跳过的结局影片可按任意游戏操作键继续，其他阶段等待播放结束。

信息朗读保留原文实际换行，不同属性或控件片段用逗号分隔；不按视觉折行增加换行。启动时会在缺少设置时补充 Jumpmovie=true，可用原生 Q 键跳过剧情，已有设置保持原样。
