Notice
Repackaged copies of the launcher are circulating. Download only from this site or GitHub Releases.MapleLink and Beanfun are developed side by side: MapleLink for MapleStory only, Beanfun for every Gamania game.
All announcements
Skip to main content

FAQ

Grouped by situation. Expand the block under a question for the fix.

Installing and opening​

Won't open, blank window, or a WebView2 error​

The app needs the Microsoft Edge WebView2 Runtime to draw its interface. Windows 10 / 11 normally ship with it; install it by hand if it is missing.

MapleLink− □ ✕
An all-white window with no text, or one that closes by itself, means WebView2 is missing.
Steps
  1. Download the Evergreen Bootstrapper directly: https://go.microsoft.com/fwlink/p/?LinkId=2124703 (the file is MicrosoftEdgeWebView2Setup.exe). It is also on Microsoft's download page.
  2. Run it.
  3. Start MapleLink again.

SmartScreen says "unrecognized app"​

The app has no commercial code-signing certificate, so Windows has no reputation record for it. This is not a virus warning.

Fix

Check the SHA256 as described on the download page, then click "More info" and "Run anyway".

The dialog follows your Windows language:

Windows protected your PC

Microsoft Defender SmartScreen prevented an unrecognized app from starting. Running this app might put your PC at risk.

There is no Run anyway at first. Click More info.

My antivirus flags it​

Third-party launchers are often misclassified: this one starts another process, injects a DLL (locale emulation) and touches the clipboard.

Fix

Once the SHA256 matches, add the file to your antivirus allow list. If the SHA256 does not match, delete the file immediately.

My accelerator does not see the app​

Some accelerators only recognise Beanfun.exe.

Fix

Rename MapleLink.exe to Beanfun.exe; nothing else changes. The app also offers to do this on first launch:

MAPLELINK🛠−×
MAPLELINK
🚀Rename for accelerator?

Your connection looks like it is from mainland China. Game accelerators route traffic by process name. Renaming this app to Beanfun.exe lets the accelerator match it, so login and reCAPTCHA work reliably.

MapleLink.exe→Beanfun.exe
The app will rename itself and restart. Auto-update keeps the new name.
Using a game accelerator? Click Rename. Otherwise click Later.

Signing in​

It says "no auth key in response" or "missing akey in response URL"​

A failed sign-in shows a red line above the sign-in button, "Invalid credentials: login failed: no auth key in response", or a toast at the bottom right, "missing akey in response URL". Both mean the same thing: Beanfun did not hand back a sign-in token. There are two causes, and the message alone cannot tell them apart.

Password
••••••••

Invalid credentials: login failed: no auth key in response

Sign In
missing akey in response URL×
12
① The red line above the sign-in button; ② the toast at the bottom right. Both appear for a wrong password and for a bad connection node alike.
Fix
  1. Rule out a wrong password first: sign in on the website with the same credentials, at https://hk.beanfun.com/ for an HK account or https://tw.beanfun.com/ for TW. If that fails too, reset the password there.
  2. If the website works, it is the connection node: see the next question.
  3. If both are fine and it still fails, Beanfun's servers are usually having a moment; wait a few minutes.

What a bad connection node looks like​

With an accelerator or VPN, an unstable node or one Beanfun rejects shows up in three ways: "failed to extract session key (no OTP1 span)" above the sign-in button; the website's verification alert ("感謝您的配合，您的資料已驗證成功…") coming back every time you press OK; or Request timeout: https://tw.beanfun.com/…default.aspx?service=999999_T0.

••••••••

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

Sign In
1
tw.newlogin.beanfun.com says

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

OK
2
3Request timeout: https://tw.beanfun.com/beanfun_block/bflogin/default.aspx?service=999999_T0 (error sending request for url (…))
① "no OTP1 span" above the sign-in button; ② the website's verification alert that returns after OK; ③ Request timeout. All three point at the connection node.
Fix
  1. Change node: pick another node in the accelerator or VPN; if you can connect directly, turn it off and try again.
  2. Accelerator users, make sure the app is renamed to Beanfun.exe: accelerators route by process name, so an unrenamed MapleLink is not recognised and its traffic never goes through the node. See "My accelerator does not see the app" above.
  3. For the endless verification loop, close the app after changing node, reopen it and sign in again.

The image CAPTCHA keeps failing​

The app solves image CAPTCHAs itself and falls back to manual entry after repeated failures.

Fix

Type the code in the window that appears. If it keeps failing, Beanfun's servers are usually having a moment; try again later.

TW password sign-in is stuck on reCAPTCHA​

Regular TW password sign-in requires a reCAPTCHA.

Fix

The app opens a small window for you to complete it and continues on its own afterwards. If the window never appears, sign in with a QR code or GamaPass instead.

Starting the game​

Nothing happens when I press PLAY​

Usually the game path is unset or wrong.

Fix

Open Toolbox → Settings and check the folder containing MapleStory.exe. The app tries to detect it first; pick it by hand if that fails.

MAPLELINKHK🛠−×

Game

Game Path
—
Classic NGM path
Auto-detect

Appearance

Theme
SystemDarkLight
Language
English ▾
A dash means no path was detected. Click Browse and pick the folder that holds MapleStory.exe.

The game shows garbled text or will not start​

This happens when the system locale is not Traditional Chinese.

Fix

The app detects the system locale and, when it is not Traditional Chinese, launches the game through Locale Remulator by itself; there is no switch. If text is still garbled, confirm the game path first, then report it on GitHub Issues with the log.

Accounts and data​

My accounts vanished on a new PC​

Credentials live in %APPDATA%\com.maplelink.app\accounts.dat, encrypted with Windows DPAPI and bound to the original PC and Windows account, so they cannot simply be copied.

Fix

On the old PC open Toolbox → Account Manager and click "Export data"; on the new one click "Import data".

MAPLELINKHK🛠−×
Saved Accounts
MMainHKPassword Saved▾
TTW altTWPassword Saved▾
✓ Exported
Click Export data at the top right.

Where do my passwords go​

Nowhere but your PC. Remembered credentials are written to %APPDATA%\com.maplelink.app\accounts.dat, encrypted with Windows DPAPI, and are never sent to the developers. Signing in talks only to Beanfun's own servers.

About the project​

Both are maintained side by side by the same people. MapleLink is built for MapleStory players only and rewritten from scratch; new techniques and sign-in fixes land here first. Beanfun aims to support every Gamania game. See pungin/Beanfun#323.

How do I report a problem​

Include the app version, region and steps to reproduce:

GitHub Issues · Discord · QQ 2157875454