└── README.md /README.md: -------------------------------------------------------------------------------- 1 | # GameMaker Studio PS Vita Port Instructions 2 | 3 | Hi! You must be here to play the games I ported on your Vita. 4 | Follow this guide then. 5 | 6 | NOTE: If you want to request a game, please either make a issue and add the "request" label on it or contect me on Twitter. 7 | @hatoving 8 | 9 | Credits to m1s3ry and Grossleymoo for making this possible! 10 | 11 | WARNING!!! 12 | These instructions will be obsolete, kind of. From now on, I will make batch files that patch the files themselves rather than yourself, similar to how m1s3ry does it. 13 | 14 | ## Step One: Getting the files 15 | In order for the game you want to play to work properly, you'll need the game files. 16 | 17 | ### Android ports 18 | Go ahead, pay and download the game you want to play on your Vita (example: Fran Bow). 19 | 20 | #### Game without `OBB` 21 | If the game doesn't have a `.obb` file to make the game work on Android, then you can proceed. 22 | 23 | Go to `Your Phone Storage/Android/com.gamename.company/assets` and copy-paste all files in it in a in a safe folder where you can come back to (I'll reference it as a Patch Folder). 24 | 25 | ##### Note, the `com.gamename.company` is the "App ID" of your game. You can find that in the app's Play Store URL after 'id'. 26 | 27 | ![image](https://user-images.githubusercontent.com/64536760/114278434-27192880-9a30-11eb-9f9e-7fdf8cc1311e.png) 28 | 29 | #### Game with `OBB` 30 | If the game does have a `.obb` file, you won't find anything in the assets folder. 31 | Instead, all assets will be located in the `.obb` file. 32 | Find said `.obb` file in `Your Phone Storage/Android/obb/com.gamename.company` and extract it. Then, go its assets folder. 33 | Copy-Paste all files from the `.obb` file and put them in a Patch Folder. 34 | 35 | ### PC ports 36 | Nothing fancy, go to game's directory and copy and paste all of the game's assets. 37 | 38 | ##### Note, some games I port may have a marking on them, example: GAMENAME_Device. This is important because Game Maker names the `data.win` file differently specific to other devices. Another example: Windows: `data.win`, Mac OS: `game.ios`, Linux: `game.unx`, Android: `game.droid` and so on. 39 | 40 | ## Step Two: Patching the files 41 | Now it's time to patch the files. 42 | 43 | ### Older patches 44 | First, get the `data.win`/`game.droid` file and rename it to `game.win`. 45 | Then, go back here to the repo and go to the Releases page. Pick the game you want to play on your Vita and save the `.zip` file (not the source code) to your Patch Folder. 46 | 47 | Extract the `.zip` file and delete the `.zip` file afterwards. 48 | Now, go to the DeltaPatcher folder and execute `DeltaPatcher.exe`. 49 | 50 | ##### Note, DeltaPatcher is a patching tool for `.xdelta` files. The program is for Windows only sadly, so if you're using Mac or Linux, try to launch it with Wine. 51 | 52 | After you opened the `.exe` file, you will see a GUI. Select the "Original file" as the `game.win` file you renamed and the "XDelta patch" as the `.xdelta` from the `.zip` file you extracted. Wait a few seconds and presto! The `game.win` file has been patched for your PS Vita. 53 | 54 | ### Newer patches 55 | Unzip the `.zip` you downloaded from the Releases page in the Patch Folder. 56 | Copy the game assets including the `game.win` file in the `PatchedFiles/games` folder. 57 | 58 | Execute the batch file from the `.zip`and let it do its job. 59 | 60 | ## Step Three: Installing the game and replacing the files 61 | It's time! Now it's only a matter of time to actually play the game. 62 | 63 | First, install the VPK included in the Releases page or in the `.zip` file you downloaded for the game trough VitaShell. 64 | Go to the game's directory page on your Vita in `ux0:app/GAMEID`. 65 | 66 | ##### Note, you can find the port's game ID by looking at the `INFO.txt` file from .zip file you extracted. 67 | 68 | ### Older patches 69 | Now, grab the patched `game.win` and its contents from the Patch folder and put it in `ux0:app/GAMEID/games` through FTP or USB. 70 | ### Newer patches 71 | Just copy everything from the folder in the .zip file (`.zip file/PatchedFiles/ganes`) and paste it into `ux0:app/GAMEID/games`. 72 | 73 | ## Step Four: There is no Step Four. 74 | Congrats! Now, you can launch the game and play it! Have fun! 75 | 76 | -@hatoving 77 | --------------------------------------------------------------------------------