457 ratings
XBox 360 Controller Fix
By ThunderPeel2001
A simple patch to make your XBox 360 Controller work properly with Final Fantasy VII
Download Link
IMPORTANT NOTE: At present this mod only works with the ENGLISH Steam version of FF7. Localizations are NOT supported. Sorry!


Note: You MUST run FF7 with an XBox 360 Controller connected once BEFORE you run this mod. (But make sure to quit the launcher before installing the mod.) You have to do this because the first time the launcher detects a controller, it automatically overwrites any existing configurations.

If you've accidentally not done this, then just: Uninstall the mod and then reinstall it. Simple!

Make sure you're using the English version. If you are, go to the Manual Installation in the Troubleshooting section below. (It's super easy.)

October 12, 2012 - Version 2.1
- Previous version (1.0) is now uninstalled correctly
- Additional check for existing controller configuration

October 6, 2013 - Version 2.0 is here!
- This new version alters the way the patching is done, resulting in a much smaller file. It also has a lot more checks in place to (hopefully) identify any problems.
What does this mod do?
The Steam re-release of Final Fantasy VII introduced some great new features: Higher quality videos, fixed script, better music (especially through a mod), cloud saves, achievements, etc. It also featured support for the Xbox 360 controller out of the box. Unfortunately, the way the buttons were mapped for the controller was extremely bizarre.

And worse still, it retained the confusing names for each of the buttons. Which button is "ASSIST", "TARGET", "PAGEUP", "SWITCH", etc? There are mini-games where you need to know exactly which button to press at a specific time, and it doesn't help if you don't know what button is being referred to.

Let's look at the first problem:

Take a look at the original PlayStation controller mapping:

Then look at what you get with a 360 Controller by default (seriously!):

Here's PART of what this mod does:

You could do this yourself, of course, so here's the main part of the mod...
Is that it? What about the button names?
No, we're not done yet. This is where this mod gets special.

First an explanation: When FFVII was being converted to the PC, they couldn’t refer to the button names, because they didn’t know what controller you would have. For example, on the original PlayStation, the game would tell you to press the “L1” button on your PS controller, but on the PC version it would say press “PAGEUP” – leaving you to guess which button that was.

This mod changes all references to confusing terms like “SWITCH”, “ASSIST”, “TARGET”, “MENU”, etc. and replaces them with the names of the actual buttons on your Xbox 360 Controller, matching the above config perfectly.

So before mod is installed:

After mod is installed:

Every reference throughout the game has been changed, so you never have to get confused about what button the game wants you to press!

Note: This only works with the ENGLISH language version of FF7!
Sounds good. Anything I should be aware of?
I’m glad you asked. There are only a few small caveats:
  • At present this mod only works with the Steam version of the game.
  • If you’ve installed any previous mod that alters the game’s script, this will undo those changes until you uninstall it.
  • The original PlayStation game used the old Japanese button configuration: “X” was CANCEL and “O” was OK – completely backwards to all Western games. If this was preserved, it would mean that “A” would be CANCEL and “B” would be OK. For the sake of everyone’s sanity, I’ve changed these two buttons to their normal Western configuration – “A” is OK and “B” is CANCEL.

Note: There may be some problems with Chocobo racing with this configuration, too. This is because FFVII uses an old version of DirectX and so doesn't allow mapping of the RT and LT buttons (these have been moved to LS and RS button in this config). It may be very difficult to race while holding down the PSX equivalent for R1/R2 (RB and RS) at the same time for a boost :-/

Looking for a solution to this.
Will this break my saves, stop me from getting achievements, etc.?
Nope. This won’t affect any of those things. It’s a very simple mod that only alters one game file: flevel.lgp
So what if I want to uninstall this mod?
Simply go to your Control Panel, click Add/Remove Programs, and double click on “FF7 XBox 360 Controller Fix (Steam)”. This will return your copy of FF7 to how it was before you installed the mod.
Troubleshooting/I've spotted a problem!
As stated, this is still a Beta version of the patch, so there may be some issue now and then. Here's how to solve the most common problems:


Just press X on your keyboard. This is a quirk with FF7, and always happens, even if you're using a controller. Nothing to do with this mod.

Please ensure that your controller is set to the "Preferred Device" in the Windows Control Panel! This is a common problem and will likely fix things for you.

If the installer states that it can't find the Steam version of the game, you can manually apply the patch using the instructions below.

This should always work fine, so if you have a problem with manual installation, it's almost certainly because you already have a mod installed which conflicts with this one in some way.


1. Download VPatch.exe from here: and the Installer .bat from here:

2. Go to where the game is installed and copy VPatch.exe and PatchFF7Script.bat into the data\field\. The directory should already contain a file called flevel.lgp - if it doesn't, you're in the wrong directory. Final Fantasy VII is typically installed here: C:\Program Files (x86)\Steam\steamapps\common\FINAL FANTASY VII\data\field but the location may will be different for you.

Your folder should now look like this:

3. Now just double click on PatchFF7Script.bat and select YES to the prompt that appears.

That's it! You're pretty much done! Just update the controller config below to finish...

4. Download the new controller config:

This needs to be placed over your existing FF7 Config file your Documents folder (look for "Square Enix > Final Fantasy VII" in your Documents folder -- if it's not there, make sure you've run the game at least once -- this will create the directory for you).

The folder you're looking for should look like this:

Copying this over your existing config will update your controller config for the game to match the new script.

Congrats! You're done!

Note: This manual installation is compatible with the SquareEnix version of FF7, too.

This appears to happen if the game is not installed in its default directory. (Thanks to Neu-Neu for pointing this out.) Just manually install the patch by following the instructions above. Sorry for the inconvenience!

Thanks a lot!
< >
ThunderPeel2001  [author] Jul 24 @ 9:38am 
@FinalValkyrie Uhuh. What "didn't work" exactly?
FinalValkyrie Jul 19 @ 9:42pm 
I did all the steps, but it didnt work. Help?
lesican Jul 13 @ 1:53pm 
Thankyou, this is amazing :)
Hynikan Jul 12 @ 4:01pm 
@ThunderPeel2001 Thanks I overlooked one I had to ensure my controller is set to the "Preferred Device" in the Windows Control Panel. I assumed as it worked out of the game it was fine. But in the control panel it was set to none. Changed that and it worked.

Thanks again.
ThunderPeel2001  [author] Jul 12 @ 3:02pm 
@Hynikan The TROUBLESHOOTING section (above) has two things for you to try. Make sdure it's not one of those. Good luck.
Hynikan Jul 12 @ 1:24pm 
I have the English version on Steam. I have just freshly installed this game and went for this mod. I ran the game and started a new game then quit.
I installed the mod but it came up with the "STEAM VERSION NOT FOUND". So I followed the manual install instructions.
I can then go to the settings on the FF7 launch menu and I can change the joypad controls to anything on the joypad (just to see if it works). But after loading into the game the joypad does not do anything.

Any idea what else to try?

Many thanks.
ThunderPeel2001  [author] Jul 9 @ 6:18pm 
@djyoda Sorry but this patch only works for the English version of the game. It literally changes the game script (as that's where the descriptions of the buttons are written). There's absolutely zero way it works in any other language. Sorry! (You can use the controller config, if you prefer it however.)
djyoda Jul 9 @ 5:24pm 
i installed the mod on my steam (french) version it worked. But i had to changed my HDD. I re-installed the game on a different hdd and now the mod can't find the new place where it is.
I tried to install it manually but i don't have a file called "flevel.lgp". Mine is called "fflevel.lgp" so it doesn't work it still says it can't find it. Any solution ? Any update to support other language ? :)
ThunderPeel2001  [author] Jul 9 @ 5:17pm 
@DaJutetsu Thanks for sharing that. Glad it worked well for you!
DaJutetsu Jul 8 @ 3:51am 
Thank you for this, made my day. The installer did not work for me had the "cannot find " message pop up, but thanks to your excellent manual installation guide i have it working like a charm now!