JPCSP PSP Tutorial

From Team XLink Wiki
Jump to navigation Jump to search

XLink Kai is a multi-platform and peer-to-peer LAN tunneling service which enables users to play local area network and ad-hoc multiplayer games on their consoles online with people all over the world. XLink Kai was first released in 2003, supporting the Xbox, PS2, and Gamecube at launch, with PSP, PS3, Xbox 360 and others support arriving soon after. Now, as of Nov 21st 2020, the PlayStation Portable (PSP) emulator JPCSP has added support for XLink Kai which allows cross-play between emulated PSP and real PSP hardware for the first time!

XLink Kai Home Page - https://teamxlink.co.uk
XLink Kai Status Page - https://status.teamxlink.co.uk/
Popular on XLink Twitter Bot - https://twitter.com/PopularOnXLink
Team XLink Official Discord - https://discord.gg/UyyjNpa
Supported Games List - https://www.teamxlink.co.uk/supported-games

Creating an Account and Installing Kai

To begin, you'll need to first create an XLink Kai account and download the program. Click on 'Sign Up' at the top of the XLink Kai home page and fill in your details, click hit submit. You'll then need to verify your email address and consent to the XLink Kai data collection policy (GDPR compliance). Be sure to also read the Acceptable Use Policy.

Afterwards, head to the downloads section and download the version of XLink Kai available for your operating system. (Remember that XLink Kai version 7.4.37 or higher is required for JPCSP!). Windows and Mac users, simply follow the instructions in your installer. Linux users will receive a binary inside a zip file or use the use the package repository

Windows users will be prompted to install WinPcap if they do not have it, or NPcap already installed. This is required for XLink to function.

Once XLink is launched, the Web UI will auto launch on the computer running the engine by default, in your default browser. This can also be accessed by typing in 'http://127.0.0.1:34522' into the address bar of any browser on the computer, or http://[IP address of computer running Kai]:34522 on any other device.

The rest of the tutorial will assume you are using the cross-platform Web UI, as opposed to the classic Windows GUI.

Need a bit more detail? Check out the install guides:


Downloading JPCSP and Java

JPCSP version d9de312 or newer is required

Download the latest version of Java 8 for your operating system from https://www.java.com/en/download/

Download the latest release of JPCSP for your operating system from https://github.com/jpcsp/jpcsp/releases/

You should now have two files downloaded; the Java 8 installer, and a compressed JPCSP release.

JPCSP downloads.jpg

This guide assumes you are running Windows so some steps will be windows specific.

Installing Java (Windows)

Double click the java installer and when the installer starts click Install

JPCSP java startup.jpg

Java will now be installed.

JPCSP java installing.jpg

When the installation is complete click Close.

JPCSP java install complete.jpg

PSP System Files

For online play with JPCSP and XLink Kai a few files are required from a real PSP's system flash. You will need the following:

flash0/kd/ifhandle.prx
flash0/kd/memab.prx
flash0/kd/pspnet.prx
flash0/kd/pspnet_adhoc.prx
flash0/kd/pspnet_adhoc_auth.prx
flash0/kd/pspnet_adhoc_discover.prx
flash0/kd/pspnet_adhoc_download.prx
flash0/kd/pspnet_adhoc_matching.prx
flash0/kd/pspnet_adhoc_transfer_int.prx
flash0/kd/pspnet_adhocctl.prx
flash0/kd/pspnet_apctl.prx
flash0/kd/pspnet_inet.prx
flash0/kd/pspnet_resolver.prx
flash0/kd/pspnet_upnp.prx
flash0/kd/pspnet_wispr.prx
flash0/kd/utility.prx
flash0/vsh/module/*    (all files)
flash0/vsh/resource/*  (all files)

If you already have these files from your PSP you can skip the next step explaining how to extract them.

This extraction/dumping process varies depending on your model of PSP so it is not covered here. Use the program "6.60 PSARDumper by Proxima" to dump flash0 contents from your PSP.

Preparing JPCSP

Now that you have a copy of the flash0 files from your PSP it is time to extract the JPCSP download and put the files in place.

Using 7-zip.org extract the JPSCP download to its own folder.

JPCSP extracted.jpg

Now copy these files from the flash0 from your PSP into the flash0 folder of JPCSP.

flash0/kd/ifhandle.prx
flash0/kd/memab.prx
flash0/kd/pspnet.prx
flash0/kd/pspnet_adhoc.prx
flash0/kd/pspnet_adhoc_auth.prx
flash0/kd/pspnet_adhoc_discover.prx
flash0/kd/pspnet_adhoc_download.prx
flash0/kd/pspnet_adhoc_matching.prx
flash0/kd/pspnet_adhoc_transfer_int.prx
flash0/kd/pspnet_adhocctl.prx
flash0/kd/pspnet_apctl.prx
flash0/kd/pspnet_inet.prx
flash0/kd/pspnet_resolver.prx
flash0/kd/pspnet_upnp.prx
flash0/kd/pspnet_wispr.prx
flash0/kd/utility.prx
flash0/vsh/module/*    (all files)
flash0/vsh/resource/*  (all files)

When done you are now ready to start JPCSP!

JPCSP Settings

Double click the start script for JPCSP.

JPCSP start.jpg

If you get a warning about a Windows Security Alert check the box for Private networks and then click Allow access

JPCSP windows security alert.jpg

From JPCSP's main screen click Options then Settings

JPCSP main screen.jpg

Select the Network tab. Then select the box for XLink Kai support. If you will be running XLink Kai on a different computer than JPCSP enter the LAN IP address of that computer in the XLink Kai Server box. Click Ok to save the settings.

JPCSP settings network.jpg

JPCSP is now set up for playing on XLink Kai!

Playing a game on XLink Kai

  1. Start XLink and log in.
  2. Start JPCSP and load the Supported Game you want to play.
  3. Click Game Arenas at the top.
  4. Navigate to the PSP game arena for the game you're playing where your friends are hopefully waiting for you to join the fun.
    JPCSP in arena.jpg
  5. To make sure JPCSP is talking to XLink Kai properly click Metrics and scroll down. You should see JPCSP connected, and a PSP detected.
    JPCSP metrics.jpg
  6. Join a match and play! Happy gaming!

Finding players

If you are having trouble finding other players to game with please join our Discord chat and use the various game-specific channels. There are also several fan-run discords that host regular game nights.

Troubleshooting

  • XLink doesn't start

On Windows, this is usually due to WinPcap/Npcap not being installed. On any OS, this can also be due to you not being connected to the internet.

  • Nothing happens when activating adhoc mode in game

Your 'flash0' dump may be bad. Check the logger in JPCSP's debugging menu and compare your flash0 files with a friend.

  • Other users have 'No connection' under their names

This indicates that Kai cannot make a P2P connection to the user, and that either your port or the user's is closed. If both users have port forwarding set up correctly, try restart kaiengine. If that fails, restart your router. Ensure that you also do not have DMZ enabled on your router for any IP address. UPnP as a protocol can be rather unreliable so if this happens a lot for you, try switching to manual port forwarding.

  • I've manually port forwarded but I still get 'No connection'

If you have two or more routers on your network (you are double NATted), you should set one of them to bridge mode so only one router is performing NAT. If you only have one router, double check that port forwarding has been done correctly: the rule needs to be applied to the IP address of your computer running Kai, UDP selected as the protocol, and the port then manually set in Kai's configuration menu.

  • I can see my console and establish a ping to all other users but I can't see matches

Get any other user in your arena to search for matches while you have the metrics tab open, then check if broadcast traffic inbound flashes a 1 or some other value. If it remains 0, double check there are no firewalls on your network that Kai has not been set as an exception in. If you can detect other users' consoles, read on.