Playing Maplestory with a Controller (JoyToKey)


New member
Feb 13, 2020
amine worl
Playing Maplestory with a Controller (JoyToKey)
Hey, everyone! I’m mlemon. This tutorial will tell you how to play Maplestory with a controller. This guide should work for both Xbox and PS4 USB controllers (I have personally used both).

I originally made this guide for a v62 private server years ago. Maplestory now has built in controller support, however it’s crappy and does not support bumpers and buttons like the start button, options button, or the touchpad button on a PS4 controller. So, yes, you can use Maplestory’s built in controller support if you’d like but using one of the two following programs will allow you a much wider variety of options.

This tutorial is specifically for JoyToKey, but I will be releasing an addition tutorial for another program called xPadder. Both programs are fantastic. There isn’t an astronomical difference between the two. The most important thing to note is that JoyToKey is free while xPadder is a $15 one-time fee. I’ve had xPadder for several years with no issues. You have unlimited downloads and there’s also a support forum. JoyToKey is free but has a much more difficult setup that can be confusing and sometimes frustrating. I, personally, use xPadder, but I realize not everyone can put down $15. Because of this, I wanted to cover the free version first.

* Before I begin, please note that neither of these two programs can manipulate your ability to spam skills in game and will also not work by themselves. You cannot bot with these and using them will not allow you to cheat in any way whatsoever in game. Regardless, use at your own risk.



As I mentioned before, JoyToKey is the free option between the two. The downside is that it’s quite a bit more complex in terms of setup. The link above will direct you to the download page. Choose your mirror under the ‘Download the Latest Version.’ The setup download is very small (2.0MB, which you can delete afterwards) and the program itself only takes 4.5MB once fully installed. It should only take a few seconds to fully install.

Once downloaded, you should see a menu like this.

Simply click okay. If you’d like to explore the program by yourself for a little, feel free. If not, continue reading to learn how to setup your controller.

Editing Your Buttons
The left menu of JoyToKey lists your saved profiles. Each profile can be fully customized. Each profile also has two built in sub-profiles which you can switch between by macroing it to any button on your controller. Profile 1 is the default blank profile. Joystick 1 and Joystick 2 are the sub-profiles.

To create a game-specific profile for Aries, click one File > New. A menu will pop up asking you to name your new profile. We’ll go with ‘Aries’ for this tutorial.

Once you have name it what you would like, click okay. You will see the new profile show up on the left above Profile 1. Make sure that ‘Aries’ is selected before continuing.
If you’ve scrolled through the blank profile, you’ll have noticed that some buttons are missing. This can be fixed with a quick .cfg file.

Go to File > Open Config Data Folder in Explorer. Then, completely exit out of JoyToKey. Sometimes hitting the x doesn’t work as it will just minimize to your tray, so make sure to do File > Exit to ensure that it is closed.

In the file folder that you opened in the previous step, locate your Aries.cfg file and open it with notepad or another basic text editor. Delete any contents inside and replace with the following code snippit. Make sure to save the file before closing it.

[Joystick 1]
Axis1n=1, 41:00:00, 0
Axis1p=1, 44:00:00, 0
Axis2n=1, 57:00:00, 0
Axis2p=1, 53:00:00, 0
Axis3n=1, 46:00:00, 0
Axis3p=1, 09:00:00, 0
Axis4n=1, 25:00:00, 0
Axis4p=1, 27:00:00, 0
Axis5n=1, 26:00:00, 0
Axis5p=1, 28:00:00, 0
POV1-1=1, 31:00:00, 0
POV1-2=1, 34:00:00, 0
POV1-3=1, 33:00:00, 0
POV1-4=1, 32:00:00, 0
POV1-5=1, 33:00:00:00, 0.000, 0, 0
POV1-7=1, 32:00:00:00, 0.000, 0, 0
Button01=1, 20:00:00, 0
Button02=1, 47:00:00, 0
Button03=1, 52:00:00, 0
Button04=1, 58:00:00, 0
Button05=1, 11:00:00, 0
Button06=5, 1
Button07=1, 50:00:00, 0
Button08=1, 49:00:00, 0
Button09=1, 35:00:00, 0
Button10=1, 36:00:00, 0
[Joystick 2]
Axis1n=1, 11:41:00, 0
Axis1p=1, 11:44:00, 0
Axis2n=1, 11:57:00, 0
Axis2p=1, 11:53:00, 0
Axis3n=1, 46:00:00, 0
Axis3p=1, 5A:00:00, 0
Axis4n=2, -50, 0, 0, 0, 0, 0, 0
Axis4p=2, 50, 0, 0, 0, 0, 0, 0
Axis5n=2, 0, -50, 0, 0, 0, 0, 0
Axis5p=2, 0, 50, 0, 0, 0, 0, 0
POV1-1=1, 37:00:00, 0
POV1-2=1, 30:00:00, 0
POV1-3=1, 39:00:00, 0
POV1-4=1, 38:00:00, 0
POV1-5=1, 39:00:00:00, 0.000, 0, 0
POV1-7=1, 38:00:00:00, 0.000, 0, 0
Button01=1, 0D:00:00, 0
Button02=1, 1B:00:00, 0
Button03=1, 70:00:00, 0
Button04=1, 48:00:00, 0
Button05=1, 4C:00:00, 0
Button07=1, 4D:00:00, 0
Button08=1, 43:00:00, 0
Button09=2, 0, 0, 0, 1, 0, 0, 0
Button10=2, 0, 0, 0, 0, 0, 1, 0
Doing this will add any buttons that were left out. This profile is for PS4 controller, but it will cover any Xbox buttons as well. Using the .cfg settings above will assign a fairly simple setup for your controller. I put this together kind of on the fly. Feel free to of course edit any of them to your usual setup.

If you’re not sure which button is which, press it on your controller. The associated button will highlight yellow in the program. To edit it, click on the button you wish to change and then click ‘Edit Button Assignment’ at the bottom of the program towards the middle. There are a variety of settings inside, so play around with them to your heart’s content.

Associating Your Profile With AriesMS
Reopen your JoyToKey program. Our next step is to associate your profile to recognize AriesMS. To do this, go to Settings > Associate profiles with applications…

Another menu will popup. Click ‘Add’ in the lower left corner of the menu. These are the following settings that I have. Your location for Aries might be different from mine. If you have Aries open while you’re setting this up, you also have the option to click ‘Capture Application Info’ to then select the already opened client instead of pasting in the program’s directory.

The application name can be whatever you’d like. Make sure to select the Aries profile that we created earlier from the drop down. Once you have these settings, click okay to go back to the Association between Applications and Profile menu. Click okay again to return to the program. Once you have done this, you should be free to use your controller in Aries.

SHIFT Function for Sub-Profile Switching
One of the bonuses to uses JoyToKey are there are a few neat options that I haven’t found available in xPadder (though I honestly haven’t tried looking for a while as I don’t use these options anymore)

Some classes in Maplestory just have a LOT of buffs, and I know some people don’t want to use a hybrid format of controller and keyboard. I mentioned before that you have two sub-profiles called Joystick 1 and Joystick 2. This is where these two sub-profiles come in handy. In your buttons, you can assign one of them to switch between the profiles, acting somewhat like a Shift button. Select the button you’d like to use for this. I’d suggest using your least used button for this so you don’t sacrifice comfortability for switching between attacks and buffs.

Click on the button you wish to use as a Shift button > Edit Button Assignment > Special. Under SHIFT Function, select Joystick 2

You should now be able to hold that button down to temporarily switch to your Joystick 2 sub-profile. You will, of course, need to set up any buttons in the Joystick 2 Profile so that they can be used with this.

Trackpad Function

JoyToKey offers another interesting feature. You can also turn your joystick into your mouse to use in-game. This can be used if you’re wanting to just lay back and relax, but don’t want to get up and spend your 5AP or increase your skills. I recommend using this as a shift function so you’re not sacrificing all of your left or right joystick for this.
On your Joystick 2 sub-profile, you will see buttons named Stick1 with left, right, up, and down arrows. This is your left joystick. Starting with the Stick 1 Left, click ‘Edit Button Assignment,’ and then go over to the mouse Tab. Check the ‘Left box under Mouse Movement, and keep the slider at 50. Your settings should look like this:

Do this for all four, selecting their appropriate direction.

Lastly, set up your left and right mouse clicks. Pick the button you would like to use and then click Edit Button Assignment. Under the Keyboard tab, look for ‘Assign Special Key Codes.’ In the drop down menu, select Mouse L-Button and then click assign, then OK. Do the same for the Right click by selecting the Mouse R-Button on your preferred button.

Thank you for taking the time to read my tutorial. I hope it helped. If you have any questions or comments, don't hesitate to post below. I will be making the tutorial for xPadder fairly soon for those who are interested. This tutorial was written by me, mlemon. Please do not repost without permission. .CFG settings from Red Eagle LXIX on Steam.