必须启用编辑模式并满足权限与版本要求才能完成键位映射：需v2.8.0+版本、Windows以管理员运行、macOS开启辅助功能权限；进入“设置→控制方案→新建自定义方案”，启动游戏后绑定动作，支持敲击或拖拽方式，最后导出配置、设为默认并重启生效。
想在Bubbly里把键盘按键映射成游戏内操作，比如用空格跳、R释放技能，但打开软件找不到映射入口或点不动保存按钮——这通常是因为没启用编辑模式，或配置文件被系统权限锁死。
确认Bubbly版本与运行环境
打开Bubbly主界面右下角「关于」→ 查看版本号。必须为v2.8.0及以上（2025年12月后发布），旧版不支持实时键位重映射功能。若版本过低，请卸载后从官网 bubbly.dev/download 下载最新安装包——【切勿通过第三方应用市场安装，存在签名冲突导致映射开关灰显】。
Windows用户需以管理员身份运行Bubbly；macOS用户需前往「系统设置→隐私与安全性→辅助功能」中勾选Bubbly进程。
进入映射编辑界面
点击顶部菜单栏「设置」→「控制方案」→「新建自定义方案」。
此时界面右侧出现空白键位图，左侧列出当前游戏识别到的可绑定动作（如“移动”“技能1”“交互”）。若左侧为空，请先启动目标游戏并进入主场景，Bubbly会自动抓取UI控件坐标。
点击任意动作条目（例如“跳跃”），光标自动聚焦到右侧键盘图上对应区域——这时才能开始按键绑定。
绑定物理按键到游戏动作
方法一：直接敲击键盘
聚焦在“跳跃”动作后，直接按下你想要的键（比如空格键），Bubbly立即显示「空格 → 跳跃」绑定成功提示。
方法二：拖拽式绑定
按住左侧动作名称（如“技能3”）不放→拖入右侧键盘图中任意键帽区域（建议拖到F12位置）→松手即完成绑定。此方式适合将多个动作集中映射到功能键区，避免与系统快捷键冲突。
【注意：不要将Ctrl/Cmd键单独绑定，它必须作为组合键前缀使用；若误绑，会导致后续所有组合键失效】
保存并启用配置
第一步：点击右上角「导出配置」→ 保存为.bbl文件（建议命名含游戏名，如原神_手柄适配.bbl）。
第二步：返回「控制方案」列表→ 找到刚创建的方案→ 点击右侧「设为默认」按钮。
第三步：关闭Bubbly窗口→ 重新启动软件→ 进入游戏验证。此时按下绑定键，屏幕左上角会弹出半透明操作提示（如「跳跃✔」），无提示则说明未生效。
