公告
有重新打包的启动器在外流传。只从本站或 GitHub Releases 下载，其他来源都不是我们发出的。MapleLink 与 Beanfun 双线并行开发：只玩枫之谷用 MapleLink，其他橘子游戏用 Beanfun。
全部公告
跳到主要内容

常见问题

依情况分类。点开标题下方的区块可以看到做法。

安装与打开​

打不开、白屏、提示 WebView2 错误​

程序需要「Microsoft Edge WebView2 运行时」才能显示界面。Windows 10 / 11 通常已内置；缺少时请手动安装。

MapleLink− □ ✕
整个窗口一片白、没有任何文字，或一打开就自己关掉，就是缺少 WebView2。
安装步骤
  1. 直接下载「常青版引导安装程序」：https://go.microsoft.com/fwlink/p/?LinkId=2124703（文件名为 MicrosoftEdgeWebView2Setup.exe）。也可以到微软官方下载页获取。
  2. 运行安装。
  3. 重新打开 MapleLink。

中国大陆用户若下载缓慢，可先开启加速器再下载。

Windows SmartScreen 说「无法识别的应用」​

程序没有购买商业代码签名证书，Windows 对它没有信誉记录。这不是病毒警告。

做法

先依下载页核对 SHA256，一致后点「更多信息」再点「仍要运行」。

对话框语言跟随你的 Windows：

Windows 已保护你的电脑

Microsoft Defender SmartScreen 已阻止启动一个未识别的应用。运行此应用可能会导致你的电脑存在风险。

一开始没有「仍要运行」。先点「更多信息」。

杀毒软件把它当成病毒​

第三方启动器常被误判，因为它会启动另一个程序、注入 DLL（区域模拟）并操作剪贴板。

做法

核对 SHA256 一致后，把该文件加入杀毒软件的白名单。若 SHA256 不一致，请立即删除。

加速器认不到程序​

部分加速器只认得 Beanfun.exe。

做法

把 MapleLink.exe 改名为 Beanfun.exe 即可，功能完全相同。第一次打开时程序也会提示一键改名：

MAPLELINK🛠−×
MAPLELINK
🚀改名以配合加速器？

检测到你的连接来自中国大陆。网游加速器是按进程名称来加速的。将本程序改名为 Beanfun.exe，加速器就能对应，登录与 reCAPTCHA 才会稳定。

MapleLink.exe→Beanfun.exe
程序会自行改名并重新启动。之后自动更新会保留新名称。
用网游加速器就点「改名并重启」；不用就点「稍后」。

登录​

显示 no auth key in response 或 missing akey in response URL​

登录失败时会在登录钮上方出现红字「Invalid credentials: login failed: no auth key in response」，或右下角弹出「missing akey in response URL」。两个信息代表同一件事：Beanfun 没有回传登录凭证。原因有两类，信息本身分不出是哪一类。

密码
••••••••

Invalid credentials: login failed: no auth key in response

登录
missing akey in response URL×
12
① 登录钮上方的红字，② 右下角的提示。两个都会在密码错误或连接节点有问题时出现。
做法
  1. 先排除账密错误：到官网用同一组账密登录一次。HK 账号到 https://hk.beanfun.com/，TW 账号到 https://tw.beanfun.com/。登录不了就是账密问题，请在官网重设密码。
  2. 官网登录得了，就是连接节点问题：见下一条。
  3. 两者都没问题仍然失败，多数是 Beanfun 服务器暂时异常，等几分钟再试。

连接节点有问题时会看到什么​

使用加速器或 VPN 时，节点不稳或被 Beanfun 拒绝，会有三种表现：登录钮上方出现「failed to extract session key (no OTP1 span)」；官网的进阶验证窗口「感谢您的配合，您的资料已验证成功…」点了确定又再弹出，无限重复；或出现 Request timeout: https://tw.beanfun.com/…default.aspx?service=999999_T0。

••••••••

Invalid credentials: failed to extract session key (no OTP1 span)

登录
1
tw.newlogin.beanfun.com 显示

感謝您的配合，您的資料已驗證成功，
請您於五分鐘內再次輸入您的帳號密碼進行驗證登入。！

确定
2
3Request timeout: https://tw.beanfun.com/beanfun_block/bflogin/default.aspx?service=999999_T0 (error sending request for url (…))
① 登录钮上方「no OTP1 span」、② 官网验证窗口点了确定又再弹出、③ Request timeout。三种都是节点问题。
做法
  1. 换节点：在加速器或 VPN 换一个节点再试；能直接连接的话，暂时关掉再试。
  2. 用加速器的人，确认程序已改名为 Beanfun.exe：加速器是按进程名称加速的，没改名就认不到 MapleLink，流量根本没有经过节点。做法见上方「加速器认不到程序」。
  3. 无限重复验证的情况，换节点后请关掉程序重开，再登录一次。

图形验证码一直失败​

程序会自动处理图形验证码，连续失败时会退回手动输入。

做法

在弹出的窗口手动输入验证码。若持续失败，多数是 Beanfun 服务器暂时异常，稍后再试。

TW 账密登录卡在 reCAPTCHA​

TW 一般账密登录需要通过 reCAPTCHA。

做法

程序会打开一个小窗口让你完成验证，完成后自动继续。若窗口没有出现，可以改用 QR Code 或 GamaPass 登录。

游戏启动​

点「开始游戏」没有反应​

多数是游戏路径未设置或不正确。

做法

到工具箱「设置」确认 MapleStory.exe 所在的文件夹。程序会先尝试自动检测，检测不到时请手动选择。

MAPLELINKHK🛠−×

游戏

游戏路径
—
经典版 NGM 路径
自动检测

外观

主题
系统深色浅色
语言
简体中文 ▾
游戏路径显示「—」代表未检测到。点「浏览」，选 MapleStory.exe 所在的文件夹。

游戏出现乱码或无法启动​

系统区域不是繁体中文时会发生。

做法

程序会自动检测系统区域，不是繁体中文时就经 Locale Remulator 启动游戏，没有开关。仍然乱码的话，请先确认游戏路径正确，再到 GitHub Issues 附上日志反馈。

账号与数据​

更换电脑后账号列表不见了​

账号存放在 %APPDATA%\com.maplelink.app\accounts.dat，以 Windows DPAPI 加密，绑定原本的电脑与 Windows 账户，无法直接复制。

做法

在旧电脑的工具箱「账号管理」点「导出数据」，再于新电脑「导入数据」。

MAPLELINKHK🛠−×
已保存账号
主主账HK已保存密码▾
台台服TW已保存密码▾
✓ 已导出
右上角点「导出数据」。

密码会传到哪里​

只存放在你的电脑。记住的账号密码以 Windows DPAPI 加密写入 %APPDATA%\com.maplelink.app\accounts.dat，不会传送给开发团队。登录时只与 Beanfun 官方服务器通讯。

关于项目​

两者由同一批人并行维护。MapleLink 专为《新枫之谷》玩家打造，由零重写，新技术与登录问题的修正会先在这里出现；Beanfun 以支持所有橘子旗下游戏为目标。详见 pungin/Beanfun#323。

如何反馈问题​

附上程序版本、地区与复现步骤：

GitHub Issues · Discord · QQ 2157875454