Skip to content

Commit

Permalink
Merge pull request #21 from LittleBigRefresh/autoplugin2
Browse files Browse the repository at this point in the history
Refactor PSP and Vita guides
  • Loading branch information
jvyden authored Jul 1, 2024
2 parents e8f3952 + a8b9ac8 commit 384be8c
Show file tree
Hide file tree
Showing 6 changed files with 77 additions and 114 deletions.
Binary file added Docs/images/patching/autoplugin-qr-code.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed Docs/images/patching/refresher-psp.png
Binary file not shown.
10 changes: 9 additions & 1 deletion Docs/topics/Library.topic
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,15 @@

<snippet id="final-patching-message">
<p>
When all is set and ready to go, register an account on <a href="https://lbp.littlebigrefresh.com/">our website</a>, and then open the game!
When all is set and ready to go, register an account on <a href="https://lbp.littlebigrefresh.com/">our website</a>,
and then open the game and start browsing levels to activate your account!
</p>
</snippet>

<snippet id="check-lbppsp-version">
<p>Open the game and look at the language selection screen.
The grid paper should be purple if you are using the latest release. If it is not, please follow the following instructions to update.
For a UMD or Playstation Store copy, press triangle on the game in the XMB and select Update.
For a dumped copy of the game, you can use <a href="https://old.reddit.com/r/PSP/wiki/updateiso/">this guide</a> to update your dump.</p>
</snippet>
</topic>
10 changes: 3 additions & 7 deletions Docs/topics/discord/how-to-connect.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,17 +22,13 @@ View this guide on our site: https://docs.littlebigrefresh.com/rpcs3.html

View this guide on our site: https://docs.littlebigrefresh.com/ps3.html

## Patching for LBP PSP (PSP or Vita)

### Refresher (requires PC)
## Patching for PSP

View this guide on our site: https://docs.littlebigrefresh.com/psp.html

### Browser setup (on-console, no PC)

Watch this short video guide: https://www.youtube.com/watch?v=Y0Oj16YzQzY
Or watch this short video guide: https://www.youtube.com/watch?v=Y0Oj16YzQzY

## Patching LBP Vita
## Patching for Vita (LBP Vita/LBP PSP)

View this guide on our site: https://docs.littlebigrefresh.com/vita.html

Expand Down
69 changes: 28 additions & 41 deletions Docs/topics/patching/psp.md
Original file line number Diff line number Diff line change
@@ -1,62 +1,49 @@
# Using Refresher to set up Allefresher PSP on PSP/Vita
# Using the PSP web browser to install Allefresher PSP

<include from="Library.topic" element-id="supported-version-notice"/>

Refresher has support for automatically deploying Allefresher onto a PSP or Vita (via Adrenaline), with the relevant configuration automatically filled out. This will let you connect to a custom server on LittleBigPlanet PSP.
It is possible to install Allefresher PSP using the PSP's built-in web browser.
This will allow you to connect to LittleBigRefresh on a modded PSP.

<note>
It's important to note this does not patch LBP Vita, only LBP PSP. You can find our LBP Vita patching guide <a href="vita.md">here</a>.
</note>
If you prefer a video guide, you can view the video form of this guide [here](https://www.youtube.com/watch?v=Y0Oj16YzQzY).

<include from="Library.topic" element-id="download-refresher"/>

![A Screenshot of Refresher's PSP patching screen](refresher-psp.png)
<warning>This guide is for PSP hardware only! If you are intending to play under Adrenaline, please follow our <a href="vita.md">Vita guide</a>.</warning>

## Step 1: Jailbreak your device and install a CFW

We can't help you with this directly, but there are various guides out there you can go out and find. We personally recommend the guides on [pspunk](https://www.pspunk.com/psp-cfw/) and [vita.hacks.guide](https://vita.hacks.guide/) for PSP and Vita respectively.
We can't help you with this directly, but there are various guides out there you can go out and find. We personally recommend the guides on [pspunk](https://www.pspunk.com/psp-cfw/).

### Notes on Jailbreaking a PSP

Try to use the latest firmware. We recommend PRO-C over other CFWs, as they have not been thoroughly tested with Allefresher yet. It is possible to dual-boot CFWs, so if you need a CFW such as ARK-4 for other homebrew, we'd recommend dual-booting PRO-C as well until Allefresher is guaranteed to work well on ARK-4.

### Notes on Jailbreaking a Vita

You'll need to set up Adrenaline with the latest version of the Adrenaline ePSP firmware (as with PSP, ARK-4 is untested). You'll also need [VitaShell](https://github.com/TheOfficialFloW/VitaShell/releases).

## Step 2: Connect your PSP/Vita or Memory Stick to your computer

Connect your console to your computer over USB, or plug your Memory Stick into a card reader.

### Connecting a PSP

Select USB Mode on the XMB.

### Connecting a Vita

Open VitaShell, and press select to enable USB. You may need press start and switch SELECT from FTP -> USB.

Mount the drive and open it in your file explorer.

## Step 3: Setup Refresher
Try to use the latest firmware (6.61 as of writing).
We recommend PRO-C over other CFWs, as they have not been thoroughly tested with Allefresher yet.
It is possible to dual-boot CFWs, so if you need a CFW such as ARK-4 for other homebrew,
we'd recommend dual-booting PRO-C as well until Allefresher is guaranteed to work well on ARK-4.

Open Refresher, and select "PSP Setup".
## Step 2: Go to the browser on your PSP

Inside Refresher, you should see at a dropdown labeled "PSP Drive". In that dropdown, select the correct path. If your console's drive does not appear there, check to make sure it is mounted, and ensure it contains a `PSP` or `pspemu` folder on it.
<note>If you cannot connect your PSP to your main network, try using a password-less hotspot from your computer or phone.</note>

<note>
On Windows, the `pspemu` folder is marked as hidden by default.
To view it in file explorer, you will need to enable viewing hidden files and system folders.
</note>
On your PSP's XMB, select `Network``Internet Browser`.
Navigate to the `Address` bar at the top of the screen, and type in `http://psp.littlebigrefresh.com:2095`.
Select `Download Allefresher`, then select `Memory Stick`. If `Memory Stick` is unavailable, select `System Storage` instead.
Do the same for `LittleBigRefresh (Domain)` and `LittleBigRefresh (Format)`.
This installs the plugin, and sets it up to connect to LittleBigRefresh.

## Step 4: Fill in the server URL
If you are running PRO-C or ME firmware and cannot edit your plugin list,
you can scroll down on the website and download the `game.txt` file, a pre-setup config file for Allefresher.
Please note that doing this will clear out all of your enabled plugins.
If you *can* easily edit your plugin list, you can add a new line containing `ms0:/SEPLUGINS/Allefresher.prx 1` to your `game.txt` file located in the `ms0:/SEPLUGINS/` folder to enable the plugin.
If the `ms0:/SEPLUGINS/` directory or the `game.txt` file within doesn't exist, you can create them yourself.

<include from="Library.topic" element-id="fill-in-server-url"/>
On ARK-4, you can install the plugin using the built-in file manager.
Navigate to the ARK-4 custom launcher, press <shortcut>△</shortcut>, then go to `Files`.
Select `SEPLUGINS`, find `Allefresher.prx`, select it to install, and then click on `Game`.

## Step 5: Finalize the setup!
## Step 3: Finalizing the setup

Now, click the patch button. It should place the relevant files onto your console.
Now, we need to check the version of the game and update if necessary.

Now, safely eject the drive from your computer.
<include from="Library.topic" element-id="check-lbppsp-version" />

<include from="Library.topic" element-id="final-patching-message" />
102 changes: 37 additions & 65 deletions Docs/topics/vita.md
Original file line number Diff line number Diff line change
@@ -1,96 +1,68 @@
# Using Allefresher Vita to connect LBP Vita to custom servers
# Using Allefresher to connect LBP Vita/LBP PSP to custom servers on Vita

<include from="Library.topic" element-id="supported-version-notice"/>

Allefresher Vita is a CFW plugin which patches LBP Vita to custom servers. This guide aims to show how to set it up on a modded Vita.

To download Allefresher, you must first visit the [Releases Page](https://github.com/LittleBigRefresh/Allefresher/releases/latest).
Once you've opened that in your browser, select `Allefresher_vita.suprx` in the files listed.

![Allefresher Artifacts](allefresher-artifacts.png)

Once you have downloaded the CFW plugin, keep it on hand for later.
Allefresher is a set of CFW plugins which patches LBP to custom servers.
This guide aims to show how to set it up on a modded Vita using AutoPlugin2.

## Step 1: Jailbreak your device and install a CFW

We can't help you with this directly, but there are various guides out there you can go out and find. We personally recommend the guide on [vita.hacks.guide](https://vita.hacks.guide/).
We recommend installing the HENkaku Ensō CFW, as that is what we officially support.

After you have jailbroken your Vita, install [VitaShell](https://github.com/TheOfficialFloW/VitaShell/releases/latest).
## Step 2: Install AutoPlugin2

## Step 2: Start and connect to an FTP server on your Vita
<note>If you already have AutoPlugin2 installed, you can skip right to <a anchor="step-3-install-allefresher">Step 3</a>.</note>

In VitaShell, press "Start", and change the "SELECT button" option to FTP. Press start again and then press select.
This will tell you the IP you need to type into Windows Explorer's address bar. (e.g. `ftp://192.168.0.100:1337/`).
After pressing enter, you should see the list of files on your Vita.
After you have jailbroken your Vita, we need to install [AutoPlugin2](https://github.com/ONElua/AutoPlugin2/releases/latest).
We will be doing this using [VitaShell](https://github.com/TheOfficialFloW/VitaShell/releases/latest), which you can download through VitaDeploy.

![vita-windows-ftp.png](vita-windows-ftp.png)
Open VitaShell, and press <shortcut>← + O</shortcut>, this will open up the camera to scan the QR code below.
After scanning the QR code, it should ask "Do you want to install this package?" with a URL starting with `https`.

## Step 3: Install iTLS

iTLS is a plugin which enables TLS 1.2 (a more modern encryption standard) on Vita CFW. This is required for Allefresher Vita to function.

Download iTLS from [here](https://github.com/SKGleba/iTLS-Enso/releases/latest/) and transfer it to your Vita through VitaShell, then install it.
Alternatively, you can also download it using [VitaDeploy](https://vita.hacks.guide/installing-vitadeploy.html).
<warning>
If it asks if you want to open a URL instead of installing a package, your Vita likely misread the QR code.
Try to scan again after lowering your display's brightness. You can also try placing the QR code on a different display, such as your phone.
</warning>

Run the iTLS installer, and select `Install the full iTLS package`.
<img alt="images/autoplugin-qr-code.png" height="512" src="autoplugin-qr-code.png" width="512" style="block"/>

## Step 4: Setup Allefresher
When it asks you if you want to install this package, say "Yes."
Once it is done downloading, it will ask if you want to allow this app to have extended permissions, say "Yes."

In Windows, double-click on `ur0:`, then on `tai`. Copy the downloaded `Allefresher_vita.suprx` file into this folder.
Next, you want to identify the title ID of your game. This can be done in multiple ways.
- On the stem of the box, you'll see something along the lines of "PCSF00516" (4 letters followed by 5 numbers), this is your title ID.
- Look in `ux0:app/` (or wherever your Vita is configured to install games) for one of the following title IDs. If you see one of these items in that folder, then that is your title ID.
Note that this list is non-exhaustive, if your game's title ID is missing, please let us know!
- PCSA22018 - US Cartridge
- PCSA00017 - US Digital
- PCSA00549 - US Digital (Marvel Super Hero Edition)
- PCSF00021 - EU Cartridge & EU Digital
- PCSF00516 - EU Cartridge (Marvel Super Hero Edition)
- PCSA22106 - Canada Cartridge
- PCSD00006 - Asia Cartridge
- VCAS32010 - Asia Cartridge
- PCSC00013 - JP Digital
- VCJS10006 - JP Cartridge
- VCKS62003 - Korea Cartridge
## Step 3: Install Allefresher

Now that you know your game's title ID, you can go on to the next step. On your Vita,
stop the FTP server and return to VitaShell's menu. Then, navigate to `ur0:tai/` and select `config.txt`.
Close VitaShell and open AutoPlugin2. It should now be in your Live Area. Open it and install any updates it asks you to install.

With the file open, scroll to the bottom using the D-Pad, then press triangle, and select "Insert empty line".
On this new empty line, put an asterisk followed by **your** title ID, this should look something like `*PCSC00013`.
After you have placed that, make a new line again, and put the following text: `ur0:tai/Allefresher_vita.suprx`
### Patching LBP Vita

After you are done, you should see something like this, but with your title ID.
Navigate to the installation menu by selecting `Vita plugins``Miscellaneous Plugins``LittleBigPlanet Custom Server`.

![2024-05-04-210838.png](vitashell-after-config-edit.png)
On this menu, you should see every installed copy of LittleBigPlanet Vita.
Select the one you want to patch.
It will install the plugin for that specific copy only.
Afterward, a green dot should appear at the right of the screen corresponding to the game you patched.
If you don't see your game on this list, make sure the game's updates are installed and then try again.

<warning>
Make sure that you do not place the plugin's name under <code>*main</code> or <code>*KERNEL</code>, this could cause your Vita to not turn on.
If this happens, hold the <code>L</code> button on boot to disable any plugins, then fix the config in VitaShell.
</warning>
### Patching LBP PSP

### Changing the server you are connecting to
Install the plugin by selecting `PSP plugins``PSP plugins for Adrenaline``Allefresher by Beyley`.

If you are connecting to the official LittleBigRefresh instance, you can ignore this segment, and skip to [Step 5](#step-5-finalize-the-setup).
## Step 4: Finalize the setup!

Allefresher Vita allows the user to specify another server to connect to, although it requires a bit more setup.
Exit out of AutoPlugin2 editor by pressing the back button, then select `Exit` on AutoPlugin2's menu.
Finally, restart your Vita.

Allefresher will read from a text file named `allefresher.txt` from `ux0:` on your Vita to get the URL to connect with,
defaulting to the LittleBigRefresh instance if not found.
This file contains the patching URL for the server you want to connect to. You can get this URL from the server owner.
Now, ensure your game is fully up to date.

However, for the game to be able to read this file, you need to install the [ioPlus](https://www.gamebrew.org/wiki/IoPlus_Vita) plugin.
This is because the Vita disallows the game to access files outside its own directory, and Allefresher has the same permissions as the game itself.
ioPlus expands the permissions of the game to allow read/write to arbitrary files, allowing Allefresher to find your config.
### Updating LBP Vita

## Step 5: Finalize the setup!
Press triangle twice with the game's bubble selected in the Live Area.
If the Update History button is present and shows Version 1.22, then your game is fully up to date.
When pressing the refresh button, a yellow arrow button should appear. Press the yellow arrow button to install all the updates for your game.

Exit out of the VitaShell editor by pressing the correct back button for your region, save the file, then exit VitaShell.
Finally, restart your Vita.
### Updating LBP PSP

Ensure your game is fully up-to-date, you can do so by pressing triangle twice with the game's bubble selected in the Live Area.
If the Update History button is present and shows Version 1.22, then your game is fully up-to-date, if not, open the game's live area,
and press the refresh button at the top of the screen, this will install all the updates for your game.
<include from="Library.topic" element-id="check-lbppsp-version" />

<include from="Library.topic" element-id="final-patching-message" />

0 comments on commit 384be8c

Please sign in to comment.