Home > End User, Gaming, Guides, MapleStory, Windows > How to: Play MapleStory Using VirtualBox 4.1.x (and above)

How to: Play MapleStory Using VirtualBox 4.1.x (and above)

With the recent updates to the MapleStory (GMS) game client (v.102 and above), many new security features have been introduced with the expressed intent of preventing players from  using multiple clients, virtualizing, and other things. This guide will show you how to escape those restrictions by playing MapleStory in a virtual version of the Windows operating system. This technique has been verified to work with versions v.102, v.103, and v.104 of the MapleStory (Global) game client.

Minimum Requirements

  • (Optional) Processor that supports hardware-level virtualization.
  • At least 2 GB of physical memory (RAM).
  • At least 20 GB of hard drive space available.
  • A graphics card that support 3D acceleration.
    • If you are unsure if your video card supports 3D acceleration: Open the Run window ([Win Key] + [R]) and type ‘dxdiag’ and press [ENTER].
  • (Recommended)  Installation of all current drivers, that work, for your hardware.

Software Requirements

  • Installation of the latest DirectX runtime (If you do not have the DirectX runtime installed, or want to upgrade it, you can download and run the DirectX End User Runtime Web Installer here).
  • Installation of  the latest version of VirtualBox (download).
  • (Optional) Installation of the latest version of the VirtualBox Extensions Pack (download).
  • An install disc for: Microsoft Windows XP; Microsoft Windows Vista; or Microsoft Windows 7 (32-bit versions preferred).


Creating the Virtual Machine

  1. Open VirtualBox.
  2. Click on ‘New’.
  3. Use the ‘Create New Virtual Machine’ wizard to create a new virtual machine.
    • On the ‘VM Name and OS Type’ page, select ‘Microsoft Windows’ as the Operating System; and select the appropriate version of Windows based on your install disc (i.e. If your install disc is for a version of Windows XP, then you would select ‘Windows XP’ as the version).
    • On the ‘Memory’ page, allocate at least 512 MB of RAM for the virtual machine. This is the amount of RAM that will be taken from your computer and dedicated to the virtual machine while its running; when the virtual machine is not active, that RAM will be returned to your computer.
    • On the ‘Virtual Hard Disk’ page, check ‘Start-up Disk’ and select ‘Create new hard disk’; After clicking ‘Next’, use the ‘Create New Virtual Disk’ wizard to create a virtual hard disk that is at least 12 GB in size (I recommend that you select ‘Fixed size’ under ‘Virtual disk storage details’, it’s faster).
  4. Select your new virtual machine fron the VirtualBox Manager window, and click on ‘Settings’.
  5. Select ‘Display’ from the ‘Settings’ window for your virtual machine (screenshot).
    • Under the ‘Video’ tab, set ‘Video Memory’ to at least 32 MB (I recommend using the maximum setting of 128 MB).
    • Under the ‘Video’ tab, next to ‘Extended Features’ check ‘Enable 3D Acceleration’ and ‘Enable 2D Video Acceleration’.
  6. Click ‘OK’.

Installing Windows

  1. Insert the Windows install disc into your CD/DVD drive.
  2. In the VirtualBox Manager window, select your virtual machine and click ‘Start’.
  3. Since this is the first run, the ‘First Run Wizard’ will be launched.
  4. On the ‘Select Installation Media’ page, select the drive that contains your Windows install disc; for most people, this will be the D:\ drive (screenshot).
  5. Complete the ‘First Run Wizard’.
  6. The virtual machine will start and you must install Windows on the virtual machine, in the same manner you would a physical computer.
    • A virtual machine simulates a real computer in almost every aspect. You will need to install Windows on the virtual machine the same way you would on a normal computer. This includes running Windows Update.
    • After you have installed Windows (and all necessary updates) on the virtual machine: install VirtualBox Guest Additions on the virtual machine by selecting Devices > Install Guest Additions (or [Right CTRL] + [D]). This step must be done in Safe Mode.
    • To boot the virtual machine in Safe Mode: run msconfig. Under the BOOT.INI tab, check /SAFE, and click ‘OK’. (To undo this later, repeat this step, and uncheck /SAFE).

Preventing Detection of VirtualBox

These steps must be done from inside your virtual machine.

  • Method 1 (Make registry changes manually, you will need to do this at each logon)
    1. Go to Start > Run (or [Win Key] + [R]) and run regedit.exe
    2. Navigate and expand to sub-key HKEY_LOCAL_MACHINE\HARDWARE\ACPI\DSDT (screenshot).
    3. Rename sub-key VBOX__ to NOBOX__
    4. Navigate and expand to sub-key HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION (screenshot).
    5. Select sub-key System.
    6. Right-click value SystemBiosVersion and select ‘Modify‘.
    7. Change the text part “VBOX” to “NOBOX” and click ‘OK‘ (screenshot).
    8. Close the registry editor.
  • Method 2 (Make registry changes through HideVirtualBox.bat)
    1. Download HideVirtualBox.bat (download). Save it to your desktop.
      @echo off
      @reg delete HKLM\HARDWARE\ACPI\DSDT\VBOX__ /f
      @reg add HKLM\HARDWARE\DESCRIPTION\System /v SystemBiosVersion /t REG_MULTI_SZ /d "NOBOX - 1" /f

      What’s happening in the code above?

      • Themida (and most system that detect virtualization) attempts to use the system registry to determine if the current environment is a virtual one. This technique is a lazy one, and thus why it is so easy to circumvent.
      • First, we’re copying the sub-key (and all the keys/values under it) HKLM\HARDWARE\ACPI\DSDT\VBOX__ to the new key HKLM\HARDWARE\ACPI\DSDT\NOBOX__.
      • Then, we’re deleting the original sub-key HKLM\HARDWARE\ACPI\DSDT\VBOX__.
      • Finally, we change the value of ‘SystemBiosVersion‘ located under the sub-key HKLM\HARDWARE\DESCRIPTION\System to ‘NOBOX - 1‘ (It’s original value will have been ‘VBOX   - 1‘).
      • The last line, exits the script.
    2. Run HideVirtualBox.bat each time you log in to your virtual machine (VirtualBox resets certain registry values each time the virtual machine is started). The script will, as the name suggests, hide VirtualBox from games protected with Themida/WinLicense. This includes most Nexon games, the most popular one being MapleStory.

Installing MapleStory

These steps must be done from inside your virtual machine.

  1. Go to your regional MapleStory website.
  2. Download the MapleStory game client installer.
    • You can download the MapleStory (Global) game client directly, here. Or use the Nexon-provided MapleStory Downloader (download). In my experience, if you’re on a broadband connection, a direct download is faster.
    • Install the MapleStory game client.

Playing MapleStory

  • Start the game as you would normally. MapleStory will no longer detect that you’re running the game client in a virtual machine. You can also multi-client, running an instance of MapleStory on your computer, and one in your virtual machine.
  • Your virtual machine will likely execute very fast, but MapleStory may be occasionally laggy in the virtual machine due to your bandwidth. I recommend you set the virtual machine’s version of MapleStory to use the ‘Fast’ settings from the game’s System settings dialog.

It works! Here’s proof!

Running multiple MapleStory (v.103) on my normal Windows 7 64-bit computer, and running a second MapleStory inside my virtual Windows XP 32-bit machine.

  1. Brian
    December 8, 2011 at 4:44 pm

    Hi, I’ve done everything stated here, but each time I try to run Maplestory in the VirtualMachine, I end up with error code: -2147467259 (Unsepcifed error). Google searches revealed that this is usuallya problem with the registry values… Help please!

    • markhanultra
      December 11, 2011 at 4:41 pm

      Brian, that error usually occurs for MapleStory inside VirtualBox when it cannot load the correct display drivers or Direct3D layer. Make sure you have the most recent version of DirectX installed on your computer; make sure you’ve installed VirtualBox Guest Additions inside your virtual machine; and then make sure you have the most recent version of DirectX installed on your virtual machine.

      Sorry for my late reply.

  2. Faze Aziz
    December 8, 2011 at 10:27 pm

    Great job on the guide! Haha.

    • markhanultra
      December 11, 2011 at 4:50 pm

      Thanks Faze! ❤

  3. elchele
    December 12, 2011 at 11:18 am

    Worked, also this is how i solved the error -21 bla bla bla, went on safe mode, uninstalled guest additions becouse i had installed it without the 3d option, and if you want to install that option you go to safe mode.
    On safe mode i clicked and nothing happend but the iso (yea the guest addition is an iso inside vbox) was mounted so i looked for the setup file (the one with the shortest name vboxguest bla bla) and it got installed.
    Maple runs takes forever to start, then when i try to log or do anyting vbox just shuts down -_- now wath?. Vmware was same ass slow but it didnt closed it.
    Let me know how to fix this ill post this same question on Sleepywood.

    • markhanultra
      December 12, 2011 at 8:14 pm

      Make sure you allocate the max (128MB) video memory to your virtual machine (and that your graphics card is powerful enough for that). MapleStory is a bit slow when virtualized but it all depends on how powerful your own computer actually is. So play with the settings of the VM and see what gives you the best speeds.

  4. MaplestoryPlayer1
    December 13, 2011 at 4:42 am

    I’m doing everything as the guide says to do but I’m getting this;
    “error code : -2147467259 (Unspecified error)”
    Tried uninstalling guest addition, didn’t help.

  5. MaplestoryPlayer1
    December 13, 2011 at 4:52 am

    I played around and found the issue.
    When installin Guest addition, do it in SafeMode because you need to tick the 3D option too, can only be ticked on SafeMode. Hope this helps people.

  6. Josh
    December 13, 2011 at 6:16 pm

    Very cool. I’m going to give this a try.

    The hacks to run MS in VMware were very unstable and I got disconnected often because of timing issues, even with a ‘monster’ computer. Hopefully VirtualBox is more lightweight.

  7. Josh
    December 13, 2011 at 8:27 pm

    Unfortunately I can’t get it to work. I get to the part where I can select a character and type in my PIC, then the screen fades to black and loads (?) forever. I let it sit for about 15 minutes twice before giving up. Oh well.

    • Lisa
      September 20, 2012 at 10:36 am

      I’m having this problem – did anyone ever find a solution?

  8. chim
    December 13, 2011 at 8:34 pm

    Even when installing the Guest Additions in safe mode and ticking the 3D option, I get this: error code : -2147221000 (DLL for class not found). I have installed the latest Direct X per your guide, but nothing works. I checked Direct X components in dxdiag and found two DLLs that had errors:

    d3d8.dll: 4.01.0006.0000 English Final Retail 11/4/2011 04:19:40 78128 bytes (problem)
    d3d9.dll: 4.01.0006.0000 English Final Retail 11/4/2011 04:19:42 78128 bytes (problem)

    I think this is the problem, but how do I fix it? I tried reinstalling Guest Additions, but the above DLL issue persists. If I uninstall Guest Additions, the DLL problem is fixed, but MS still will not work.

  9. David
    December 15, 2011 at 2:46 am

    Did everything listed here. I can get the game to load, login, and char select. The screen whites out like usual when loading, music goes from character select music to the overworld music for about 2 seconds, and then it closes with no warning or notification.

    So close ><. Any suggestions?

      February 19, 2012 at 6:21 pm


  10. Kimmy
    December 15, 2011 at 4:04 pm

    Thank you for the awesome guide!

    However, I got to run Maplestory but I can’t play it past the PIC entry. After that, Maple is just stuck on a black screen.

    Common problems I encountered while following this walkthrough were :

    error code: -2147467259 ( Unspecifed error )
    — forgot to install Direct3D in Safe Mode when adding Guest Additions
    — also important to install WinUpdates but it didnt cause much of a problem if it wasnt installed.

    error code: -2147221000 ( DLL for class not found )
    — has to update some DLL’s regarding Microsoft .Net Framework

    error code: 11001 ( no such host is known )
    — depends which is your default web browser. I installed Google Chrome and used that to log on instead of IE7. Maplestory made IE7 its ‘host’ browser, thats why I got this error when I logged in using Chrome.

    You can Log in but cant Play
    — self explanatory. I made my RAM 3GB, Video is 128MB and my HD to a fixed 50GB. 3D and 2D acceleration were enabled. Im not sure if this tutorial was also meant to work on a laptop, but I used those settings.

  11. chim
    December 16, 2011 at 10:27 pm

    Well, I got it to work the other day by increasing the amount of ram to 1.5GB and playing in fullscreen mode. I dropped the amount of ram down to 1GB and it still works fine. A little laggy, but it works. For some reason, windows mode doesn’t work (stuck on black screen soon after PIC entry). Try fullscreen mode!

    In case it helps, my specs:
    Host Laptop: Windows 7 Home Premium 64-Bit, 4 GB Ram
    Guest VM: Windows XP SP3 32-Bit, given 1 GB Ram, 128MB video memory, Guest Additions + Direct3D files installed, 15GB Fixed HD

  12. to
    January 19, 2012 at 8:34 pm

    Hey I though I leave my thank you here, it worked great.

  13. Aaron
    January 20, 2012 at 5:13 am

    Hey there.

    Unfortunately, nothing’s working for me. Both before and after going through everything on this guide (as well as those on other forums), I’ve been getting the “We are unable to connect to the login server, due to a server check, a firewall block or other network issues. Please check the MapleStory homepage as well as your firewall settings” error every time. I even turned my firewall off to avoid getting this error, so I presume it has something to do with running on the virtual machine.

    Any ideas?

  14. Gal
    February 14, 2012 at 3:46 pm

    i have the same issue with as few above
    after entering the PIC the screen goes black and nothing ever happend


  15. justin
    February 19, 2012 at 3:34 am

    When I try to install the guest additions in safe mode I click devices and then install but nothing happens. I tried this without safe mode and it came up fine but then I couldn’t go any further since it told me I must be in safe mode in order to have the directx. I have downloaded the latest directx and I am sure that I have all of the other requirements. please help.

  16. Marco
    May 17, 2012 at 12:55 pm

    When I’m trying to install windows xp and choosing partition, it keeps telling me the partition is damaged and cannot be formatted. Any thoughts on this?

  17. Win
    May 21, 2012 at 7:29 am

    I had a hackshield error: 0x00000207
    Anyways to fix that?

  18. Name
    May 26, 2012 at 4:54 pm

    When I start Maplestory my screen just turns black, and then it says ‘maplestory doesn’t work anymore’… Any ideas? 😛

  19. terry
    September 18, 2012 at 9:34 pm

    Umm for me when maple turns on i log in the Virtual box stops reposnding..and close…any solutions here?

  20. Mapler
    October 3, 2012 at 5:34 am

    Great work on the guide! What is the equivalent for DirectX for Mac? I just found out that I can’t play maplestory without DirectX and I was so gutted 😦 Please reply quickly!

  21. Japheth Yeung
    November 23, 2012 at 2:30 am

    I get an error -40 while installing Maplestory..

  22. anonymous
    February 1, 2013 at 1:38 am

    Seems like this isn’t working anymore with the latest MapleStory. Getting a Runtime Error message when starting up. Tried to install the C++ runtime library 2010, but no luck.

    Tested with Win7 64bit, and WinXP 32bit.

  23. Jeffrey
    May 13, 2013 at 8:02 am

    Hey man,

    I Really need your help.
    When i try to launch my MapleStory game launcer it loads.
    When i play “start”. i get this error:

    Hackshield initialization Error: 0x00000207(519)
    Another copy of MapleStory is already running. Please close all instances and try launching again.
    Please send the detailed information througj AhnReport

    Please help me

  24. Jeffrey
    May 14, 2013 at 3:41 pm

    Please answer my question above.
    Really wanna play MapleStory

    • anonymous
      May 14, 2013 at 3:47 pm

      Jeffrey, it isn’t working anymore. I would suggest to multiboot with Windows, or try a private server without the hack shield.

  25. Jeffrey
    May 15, 2013 at 1:31 am

    Hmmm allright than.
    Thank you.

  26. Frederik
    May 20, 2013 at 11:10 am

    I’m trying do make this work on my mac, I just need 1 maplestory running but I keep getting the runtime error C++ when I want to start the game. I did everything as told above.. Anyone?

  27. Ramon
    July 12, 2013 at 6:15 pm

    Do you know how to fix the device choice not found error?

  28. Nolan
    February 20, 2014 at 5:18 pm

    Hello. I know this guide is old however i followed all the instructions. The game downloaded fine but when it gets to the last part of the patch an error pops up telling me the game isnt for windows. The error is listed as an Image error. I have the latest version of DirectX and everything

  29. April 10, 2014 at 4:52 am

    Its like you read my mind! You seem to know so much about this,
    like you wrote the book in it or something. I think that
    you can do with some pics to drive the message home a bit,
    but other than that, this is magnificent blog. A fantastic read.
    I’ll definitely be back.

  30. Ari
    May 2, 2014 at 9:53 pm

    I can’t get the hidevirtualbox to run. I saved it on my desktop and when I click for it to run, it appears and disappears quickly and then nothing happens. What am I doing wrong?

  31. Justin
    June 11, 2014 at 1:08 am

    When I press start I got the Hackshield initialization Error: 0×00000207(519) Please help me I really want to play maplestory

  32. July 30, 2014 at 8:15 am

    I know this if off topic but I’m looking into starting my own blog and was curious
    what all is required to get set up? I’m assuming having a blog like yours would
    cost a pretty penny? I’m not very internet smart so I’m not 100% certain. Any suggestions or advice would be
    greatly appreciated. Thanks

    • Helper
      December 1, 2017 at 12:00 am

      To start a blog like this one is free. Just YouTube videos

  33. July 19, 2017 at 12:12 pm

    I’m getting the error of this program is not running at a virtual machine…

  34. Helper
    November 30, 2017 at 9:41 pm

    @echo off
    @reg add HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System /v SystemBiosVersion /t REG_MULTI_SZ /d “NOBOX – 1” /f
    @reg add HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System /v VideoBiosVersion /t REG_MULTI_SZ /d “” /f

    I updated the code for the bat file. If anyone needs help, I will help you asap

    • Helper
      November 30, 2017 at 11:58 pm

      Also, for the above to work, you need to run the bat file as admin.

      If you don’t know what you’re doing, follow this guide, updated for 2017: https://www.youtube.com/watch?v=qsxwedwGswg.

      Be reminded that you must do this EVERY time you login your virtual machine.

      If I were you, I would learn how to make a bat file (Super easy)

  1. December 29, 2011 at 4:47 pm

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

%d bloggers like this: