Game Client
The full MapleStory TW client is about 67 GB, and there is no single installer for it. The beanfun game manager works from an official manifest and pulls the whole game folder from the official CDN. MapleLink's built-in Game client manager uses that same manifest and the same CDN, so it can install, check, or fetch back only the files that are broken.
Both the manifest and the files come from beanfun. Every download is checked against the published SHA-256 before it is written; anything that fails that check never replaces what you already have.
The manifest is public, so you can check it yourself: productInfo.json. The path, size and SHA-256 on each line are exactly what the window compares against.
Where to find it
The download icon at the top right of the title bar, or Toolbox → Game client manager. The window has two tabs: Check & repair and Download & install.
Here it is to play with — press the buttons and walk through it:
Which case are you in
| Situation | What to use |
|---|---|
| Fresh install, or moving to another PC | Download and install |
| Broken client, failed update, "file corrupted" on launch | Check and repair |
| The game folder is full of files you don't recognise | Clean up extra files |
| The manifest won't load with your accelerator on, or downloads crawl | Manifest source and network |
| You'd rather drive the download yourself | Manual: use the torrent |
Download and install
On the Download & install tab, press Download and install and pick an empty folder. MapleLink fetches the whole client straight from the official CDN.
- You can pause and resume at any point, or cancel.
- Closing part-way is fine: check the same folder again later and finished files are not fetched twice.
- A file whose connection drops is retried automatically, up to three times. Errors a retry cannot fix, such as a file that does not exist, are reported straight away.
- At once at the bottom sets how many files download at the same time; the default is 6. More connections do not add bandwidth, they share the line: more is faster over a long path, while a slow or rate-limited line does better with fewer — each file finishes sooner and progress is steadier.
When it finishes, point Settings → Game path at MapleStory.exe inside that folder.
Check and repair
On the Check & repair tab, set the game path and press Check files.
| Mode | What it does | How long |
|---|---|---|
| Quick | Compares file sizes; catches anything missing or truncated | Seconds |
| Full | Verifies every file's SHA-256 | Depends on the drive; minutes on an SSD |
The result lists every file. Filter by "to fix / fine / extra", or search the paths. Confirm what you want back and press Download and repair.
Once the repair starts, the list switches to "to fix":
- Each file being downloaded has its own progress bar, and the line under the main bar names the file in progress.
- Finished files move to "fine", so "to fix" counts down to zero.
- Failed files are gathered under a "failed" filter, with the reason in the status column.
- Finished files are unticked as they land, so pressing Download and repair again fetches only what is left.
Close the game first, and back up anything you modified yourself. Anything outside the manifest is only listed for your information, unless you pick it under Extra files and confirm — then it is moved to the Recycle Bin, where you can restore it.
The game path on this tab is used by this window alone; the one in Settings is untouched.
Does "damaged" or "out of date" mean it's broken?
The status column says why each file would be replaced: missing is not on disk, out of date means the client is behind the official version, damaged means the version matches but the contents do not, and unreadable usually means the file is in use. Hover the status for the detail.
A mismatch does not necessarily mean damage. The manifest is that version's base client, and the game's own updater modifies some files after install — MapleStory.exe above all. MapleLink knows about this: it asks the official patch server what the current executable is, and treats a match as fine.
If the game runs correctly today, you can leave these unticked. Repairing restores them to the base version, which the game usually re-applies on its next launch.
Can it check automatically?
Yes. The first time the window opens it asks whether to check automatically on every open; afterwards, Auto check at the bottom changes it whenever you like. With it on, a quick check runs as the window appears.
If you use "Block the game's auto-update", the notice that appears when an update is blocked has a button that takes you straight to this window.
Clean up extra files
"Extra files" lists what is in the game folder but not in the official manifest: logs, screenshots, leftovers from older versions, or files another program put there. Nothing happens to them by default.
To clear some out, tick them, press Move to Recycle Bin and confirm:
- Files go to the Recycle Bin rather than being deleted, so any of them can be restored.
- A file in the official manifest is never moved, whatever the case of its name; folders and links are not either.
- Close the game first. A file in use cannot be moved; the window says so and keeps it ticked.
An extra file may be your own settings, or something another program needs. Only move what you recognise.
Manifest source and network
The four tiles at the top of the window show where things stand:
| Tile | What it shows |
|---|---|
| MapleStory TW | The official version, its publish date and the executable's date |
| Installed client | Whether this folder is up to date, and how many files matched on the last check |
| Disk space | Free space on that drive, and what a full install or this repair needs |
| Network | The region downloads come out in, the official CDN's latency, and whether a system proxy is in use |
Where the manifest comes from
The manifest has two sources: beanfun's own address, and the HiNet catalog the game manager uses. Some accelerators can reach only one of them.
List from defaults to Automatic: it asks whichever source worked last time, uses the other only if that fails, and remembers the one that answered. Each source is retried once after a dropped connection or a timeout.
You can also pick beanfun or HiNet catalog yourself. Then only that source is used, and a failure does not quietly switch to the other — useful for finding out which side is unreachable.
Test sources asks both sources for the manifest once each, at the same time, and shows whether each answered, how long it took and which version it serves, for example:
beanfun ✓ 0.4 s HiNet catalog ✗ timed out
Automatic mode learns from the test: if the source it would ask first failed and the other worked, the one that worked is asked first from then on. If the window is running on its stored copy, a test that finds a working source loads the manifest again straight away.
Accelerators and the system proxy
Downloads, manifest loads and the source test all follow Windows' system proxy setting, the way a browser does, so an accelerator or proxy tool that works by setting the system proxy applies to them too.
An accelerator that intercepts traffic per program instead shows here as "No system proxy", but connections still go through it. A PAC auto-config script is not applied, and the Network tile says so.
The stored copy for when the source is unreachable
Every time the manifest loads, MapleLink keeps a copy on disk. If the official side cannot be reached later, the window uses that copy and says how old it is in a yellow notice: checking still works, but fetching files back still needs a connection.
Can I send my stored copy to a friend who can't connect?
There is no need, and it is not advised. Ask them to press Test sources first, or switch List from to the other source; that nearly always gets the manifest directly.
MapleLink also accepts only a manifest whose download address is beanfun's official CDN over HTTPS. A copy that was edited to point somewhere else is refused; don't use a copy you can't vouch for.
Manual: use the torrent
To drive the download yourself, press Manual: save the torrent on the Download & install tab and open it in your own client.
- Install a BitTorrent client, for example qBittorrent.
- Open the saved torrent and pick where to save. You may rename the root folder to whatever you like.
- When it finishes you have a complete client folder.
- Back in MapleLink, point Settings → Game path at
MapleStory.exeinside it.
The torrent carries a web seed pointing at beanfun's CDN, so it downloads from the official server even with no other peers.
The same torrent repairs an existing install: set the save location to the folder above your client, rename the torrent's root folder to match yours, then run "force recheck" — only the mismatched parts come back.
Why MapleLink generates the torrent
beanfun's own torrent is built for the game manager, and downloads nothing if you use it directly:
- The root folder it records does not match the official CDN's real path, so a client follows the spec, asks for the files, and every one comes back missing.
- The game manager never seeds, so no other peer can fill the gap either.
MapleLink only renames that root folder to the real CDN path and leaves everything else untouched, including every piece hash and the web seed address. Your client still verifies every byte against the hashes beanfun published.
Can I have a magnet link instead?
No. A magnet link is only a pointer: it holds no file list and no hashes, so the client has to get those from another peer. Nobody seeds this torrent, so a magnet link just sits at "downloading metadata" forever.
Should I install the Gamania Games Manager?
Not advised. Installing or updating it points the gamaniagames:// registry key back at itself, and MapleLink's web-launch interception stops working until you switch it on again in Settings. Installing and updating are covered by the two routes above.