PS3:PS3XPAD

PS3XPAD is a plugin that allows you to use non-PS3 controllers on your PS3. The plugin is fully supported in DEX and REX firmwares, check compatibility in the README file for CEX compatibility. Cobra or MAMBA must be installed and enabled.


 * If you have issues with PS3 controllers not syncing wirelessly, use your custom controller to hold the button combo Start+Select+R3 to disable PS3XPAD. Alternatively, delete your boot_plugins.txt (or mamba_plugins.txt) via FTP to return it to working order.


 * PS2 and PSP game emulators do not work with PS3XPAD.

Supported Controllers
While you can use your own custom devices, the following are supported by default as of version 0.8:


 * Wired Xbox 360 controller
 * Wired Xbox One controller
 * Wireless Xbox 360 controller with USB wireless adapter
 * Wired DualShock 4
 * Wireless DualShock 4 with USB wireless adapter

The following are also supported as of version 0.8 for REX/DEX only, with desired game EBOOTs converted into debug EBOOTs:


 * Button remapping with DualShock 3 and DualShock 4
 * Wireless DualShock 4 without USB wireless adapter
 * Rumble and Sixaxis Support for DualShock 4

If a supported controller does not work, check the controllers VID and PID values as you may be using a newer revision.

Installation
If you are using HEN you must resign the 2 .sprx files before installation, failure to do so will result in a 'brick' when HEN is enabled. This can be fixed by creating an empty file named `boot_plugins.txt`, placing the file onto the root of a USB, and inserting it into the PS3 before enabling HEN.


 * 1) Copy the downloaded "plugins" folder to `/dev_hdd0/`.
 * 2) Browse to `/dev_hdd0/` and open boot_plugins.txt in a text editor or create it if it doesn't exist. If you are using MAMBA, the file will be called mamba_plugins.txt. Do not create the file inside of the plugins folder.
 * 3) Add `/dev_hdd0/plugins/ps3xpad/xpad_vsh.sprx` to the file and save.
 * 4) Reboot your console. You may get a confirmation message "XPAD Loaded (VSH)", but not necessarily.
 * 5) * At this point, PS3XPAD may work with your new controller. If not, start your game and wait until it has fully booted, and then press START+SELECT+R3, you should see a confirmation message displaying "XPAD Loaded (GAME)". Your controller may disconnect and reconnect.

Using a Custom Device
You can use up to 24 custom devices by editing the xpad_devices.txt file in the plugin folder. Following the template of the other devices in the xpad_devices.txt file, you will need to find the VID and PID for your device, followed by your name for the device, and its XTYPE. You can just copy the line containing your device's information from this PS3XPAD devices list to xpad_devices.txt and save it, or you can create one manually with the process below.


 * Entering the incorrect values will result in an error prompting "Unknown USB Device".

Creating a Config
To create a config, you will need to find the VID and PID of your device, and also choose the closest XTYPE. It is advised to use a powerful text editor such as Notepad++ to create these, as some text editors will add invisible characters that will break the config.


 * 1) To find the VID and PID: On Windows, navigate to Start → Control Panel → Type "Device Manager" in the search bar and select it → Find your device and right click it → Properties → Details tab → Select "Hardware Ids" on the drop down menu. The characters following the underscore after VID or PID are the needed values. Make sure to put "0x" before each value to match the template.
 * 2) For the XTYPE value, choose the closest-matching out of these:
 * 3) * XTYPE_XBOX
 * 4) * XTYPE_XBOX360
 * 5) * XTYPE_XBOX360W (this is a wireless controller, which uses a wireless dongle)
 * 6) * XTYPE_XBOXONE
 * 7) * XTYPE_UNKNOWN
 * 8) * PTYPE_PS3
 * 9) * PTYPE_PS4
 * 10) * PTYPE_BT (this requires a BlueTooth dongle)
 * 11) Enter your found values into this format: `VID, PID, NAME, XTYPE`. An example config would be: `0x045e, 0x028e, Microsoft X-Box 360 pad, XTYPE_XBOX360`.
 * 12) Save and re-upload this file to your PS3 and reboot for it to attempt to re-detect your devices.

Troubleshooting
Most games should work right away. If it doesn't work, you can try the following tips:


 * Reassign your controller to different slots by holding the PS button and browsing to Controller Settings
 * Restart the game and try START+SELECT+R3 again
 * Enable compatibility mode by pressing START+SELECT+DPAD-UP. Note that the controller must be assigned to port 1, and only one controller can be used

DualShock 4 Setup

 * 1) Connect your DualShock 4 through USB.
 * 2) Start up your PS3 with the XPAD plugin loaded.
 * 3) Press (START+SELECT+SQUARE) to open the VSH menu.
 * 4) Go down and enter the Bluetooth options menu.
 * 5) Go down and select the "Set DS4 internal BT address" option.
 * 6) You can now disconnect the DS4 controller and should connect wirelessly to the adapter.

DualShock 4 without USB Dongle

 * 1) Modify xpad_settings.txt and change `XPAD_MODE = 0` to `XPAD_MODE = 1`.
 * 2) Start up your PS3 with XPAD plugin loaded and connect your DS4 controller to the PS3 wirelessly like normal.
 * 3) In the PS3 XMB, go to Settings, scroll down to Accessory Settings, select Reassign Controllers, and set the controller to port 7.
 * 4) Start up your game and wait until it has loaded completely.
 * 5) Press (START+SELECT+R3) to load the plugin into the game. You should now be able to play your game with the option of remapping and emulated pressure sensitivity.

Button Remapping
Press START+SELECT+DPAD-RIGHT to enable button remapping.