常见问题

AntiMicroX 完全免费开源，采用 GPL v3 协议发布。所有功能无任何限制，无内购、无广告、无遥测代码。你可以自由使用、修改、分发源代码，包括用于商业场景。如果你愿意支持开发，欢迎在 GitHub 上 Star 项目或贡献代码。

原版 AntiMicro 自 2016 年起停止维护，存在大量 bug 与兼容性问题。AntiMicroX 是社区发起的 fork 分支，主要改进包括：

• 修复了数百个历史 bug，包括摇杆漂移、蓝牙断线、按键丢失等
• 迁移到 Qt6 框架，性能与内存占用显著改善
• 新增 Lua 风格脚本编辑器与时序可视化
• 更新 SDL2 游戏控制器数据库，支持 PS5、Xbox Series、8BitDo 等新一代手柄
• 持续维护，平均每 2-3 个月发布新版本

如果你是 AntiMicro 老用户，配置文件 (.amgp) 可直接导入 AntiMicroX 无需迁移。

官方支持 Windows 与 Linux 两大平台：

• Windows：7 SP1 / 8 / 10 / 11，64 位
• Linux：Ubuntu 18.04+、Fedora 32+、Arch Linux、Debian、openSUSE 等主流发行版，glibc 2.27+

最低配置：1 GHz 双核 CPU、512 MB 内存、50 MB 磁盘空间。推荐配置：2 GHz 四核 CPU、2 GB 内存。详细要求请查看 下载中心 的系统要求表格。

AntiMicroX 内置 SDL2 通用驱动，理论上可识别任意 HID 标准手柄。以下型号经过社区测试确认完美兼容：

• Microsoft Xbox One / Series 控制器（USB / 蓝牙 / 2.4G）
• Sony DualShock 4 (PS4) / DualSense (PS5)（USB / 蓝牙）
• Nintendo Switch Pro 控制器（USB / 蓝牙）
• 8BitDo Pro 2 / SN30 / Ultimate 全系列
• 北通阿修罗、神话系列（X-Input 模式）
• 雷蛇 Wolverine、Kishi 系列
• 罗技 F710 / F310

未列出的型号通常也能通过 SDL2 通用驱动正常工作，可能需要手动配置按键布局。

请按以下顺序排查：

1. 检查系统识别：Windows 打开"控制面板 → 设备和打印机"查看手柄是否在列表；Linux 执行 lsusb 或 jstest /dev/input/js0 验证。
2. 切换手柄模式：许多第三方手柄需要切换到 X-Input 模式（如 8BitDo 按住 X + Start 开机）。
3. 更换连接方式：USB 与蓝牙互相切换试一下，部分手柄蓝牙兼容性差。
4. 更新驱动：Windows 用户更新系统与 USB 驱动；Linux 用户确保安装了 libsdl2-2.0-0 与 udev 规则。
5. 权限检查（Linux）：将用户加入 input 组：sudo usermod -aG input $USER，注销重登。
6. 重启 AntiMicroX：连接手柄后再启动 AntiMicroX，避免冷启动识别问题。

如仍无法识别，请前往 GitHub Issues 提交反馈，附上 jstest 输出或设备管理器截图。

这是最常见的问题，请按顺序排查：

1. 确认启用状态：主界面顶部"启用"复选框必须勾选，否则所有映射无效。
2. 检查当前 Set：底部 Set 切换栏确保选中了你配置的那个 Set。
3. 关闭冲突软件：Joy2Key、Xpadder、Steam Input、DS4Windows 等同时运行会冲突，请关闭。
4. 管理员权限：Windows 下以管理员身份运行游戏时，AntiMicroX 也需要管理员权限才能向其注入按键事件。
5. 反作弊系统：部分网络游戏启用了反作弊（如 EAC、BattlEye），可能屏蔽 AntiMicroX 的模拟输入。这类游戏不建议使用手柄映射。
6. Wayland 限制：Linux Wayland 用户需要使用 Flatpak 版本并授予输入权限。

摇杆参数需要根据手感细调，建议按以下步骤优化：

• 死区 (Dead Zone)：默认 10-25%，过小会导致漂移，过大会导致小幅推杆无响应。
• 灵敏度 (Sensitivity)：默认 1.0，调大加快光标速度，调小获得精细控制。
• 加速曲线：线性适合精确操作，二次曲线适合日常浏览，指数曲线适合游戏。
• 最大速度：摇杆推到底时的鼠标每秒像素数，建议 1000-3000。
• 更新驱动：老版显卡驱动可能影响输入轮询速率，更新至最新版本。

可以。AntiMicroX 支持同时连接多个手柄并独立配置。每个手柄在主界面顶部有自己的选项卡（Controller 1、Controller 2...），可分别设置映射关系、摇杆参数、配置集。本地双人合作游戏中，两个手柄可分别映射到键盘的不同区域（玩家 1：WASD+QER；玩家 2：方向键+小键盘），无需购买额外的手柄适配器。

可以。AntiMicroX 的配置文件 (.amgp) 是 XML 格式纯文本，Windows 与 Linux 版本共享同一文件格式。你在 Windows 上精心配置的 .amgp 文件可原样导入 Linux 系统，所有映射关系保持一致。这是 Steam Input 等闭源方案无法提供的开放性。配置文件默认保存路径：

• Windows：%APPDATA%\antimicrox\profiles\
• Linux (Flatpak)：~/.var/app/io.github.antimicrox.antimicrox/data/antimicrox/profiles/
• Linux (原生)：~/.config/antimicrox/profiles/

可以。在 AntiMicroX 设置中开启"Application Profile Switching"功能，即可根据当前激活窗口的应用程序自动加载对应的 .amgp 配置文件。设置方法：

1. 进入 Settings → Application Profiles。
2. 点击"Add"添加规则。
3. 指定目标应用的可执行文件路径（如 game.exe）。
4. 选择该应用启动时自动加载的 .amgp 配置文件。
5. 保存规则后，当该应用窗口成为前台时，配置自动切换。

这一功能不依赖 Steam，可作用于任意桌面应用。

不会。AntiMicroX 是完全开源的软件，代码托管在 GitHub，无任何遥测、统计、用户行为收集代码。软件运行时不会连接任何服务器（除更新检查时连接 GitHub API 一次，可在设置中关闭）。所有配置文件保存在本地，不上传任何位置。你可以自行审查源代码验证这一点。

存在风险，请谨慎使用。AntiMicroX 的输入模拟方式可能被部分反作弊系统（EAC、BattlEye、Vanguard 等）识别为异常输入。虽然 AntiMicroX 本身不是作弊软件，但部分游戏厂商对手柄映射工具持保守态度。

建议：

• 竞技类网游（CS:GO、Valorant、APEX 等）不建议使用，可能触发反作弊。
• MMORPG（魔兽世界、FF14）通常可正常使用，但建议查阅游戏 ToS。
• 单机游戏与不支持联机的应用完全安全。
• 如因使用本软件被封号，开发者不承担责任。

AntiMicroX 是社区驱动的开源项目，欢迎各种形式的贡献：

• 提交 Bug：前往 GitHub Issues，按模板填写问题描述、复现步骤、系统信息。
• 功能建议：在 Issues 中使用 Feature Request 模板提交。
• 代码贡献：Fork 仓库 → 创建分支 → 提交 PR。建议先在 Issue 中讨论方案。
• 翻译：在 Transifex 平台参与界面多语言翻译。
• 文档：完善 wiki 与教程内容。
• 分享：在社区中分享你的配置文件与使用心得。