- For running PC GameMaker Studios (GMS) games on Vita.
You Will Need:
- UndertaleModTool: https://github.com/krzys-h/UndertaleModTool
- UTMTGetVersionGuesstimate.csx: https://gist.github.com/JohnnyonFlame/fdd79303423392c5911cf44eed9e17cb
- Archive extractor. Example: 7zip: https://www.7-zip.org/
- GMS APK Donor Spreadsheet: https://docs.google.com/spreadsheets/d/10H9lhwsLEO6b80UDT874QCRYq41FqcYqBFbB6QLwCTw/edit#gid=0
- Game files of your GMS PC game.
Setup:
- Extract UndertaleModTool to a directory on your PC
- Place the "UTMTGetVersionGuesstimate.csx" in one of the UndertaleModTool sub folders ending in "scripts".
- For example, "DemoScripts". (It doesn't mater which one).
Step 1: YYC check
- Open the data.win of your PC game in UndertaleModTool
- If there is a pop up that says "This game uses YYC", the PC game CANNOT BE PORTED.
- If there is no YYC pop up, go to step 2.
- All other pop ups can be ignored, unless they result in the failure to load data.win.
- Please note, MacOS/Linux versions of the game may not be YYC. You can check these versions, if the windows version is YYC.
Step 2: Check GMS and Bytecode versions of the PC game
- With your data.win file loaded in UndertaleModTool, do the following.
- Look at the UndertaleModTool program window title bar. The Bytecode version will be stated here (example: bytecode 16).
- Navigate to the "Scripts" tab and find "UTMTGetVersionGuesstimate.csx" and click to run it.
- The GMS version of your game, will be shown in the bottom left of the UndertaleModTool window.(example: Likely: GMS2_2_2_302)
- Make a note of both the GMS and Bytecode versions of your data.win.
Step 3: Identifying a donor APK for asset swap.
- For the asset swap you need a GMS Android game APK, with an equivalent GMS version and Bytecode version.
- You can identify a donor APK yourself, by following steps 1 and 2 on the game.droid within any GMS game APK. Or-
- Find a donor APK by matching against these known GMS and Bytecode versions: https://docs.google.com/spreadsheets/d/10H9lhwsLEO6b80UDT874QCRYq41FqcYqBFbB6QLwCTw/edit#gid=0
- Once identified, download the donor APK that you will use for the asset swap.
Step 4: Swapping the assets
- Open the donor APK in 7zip
- Delete all files and folders in the "asset" subfolder. (EXCEPT splash.png, to retain the "assets" folder in 7zip).
- Rename the "data.win" file of your GMS PC game to "game.droid".
- Drag and drop the "game.droid" file and all other game files into the "assets" folder of the donor APK in 7zip.
- The ".exe" and any ".dll" files are not necessary.
Step 5: Adding the new APK to YoYo loader
- Like all other GMS android games. Rename the new asset swapped APK to "game.apk".
- Transfer it to your Vita and place it within "ux0:data/gms/[named subfolder]/game.apk"
- Open the YoYo Loader app, find your game and open the triangle menu.
- Select the "Optimise APK" button before launching the game.
- For some games it is recommended to choose "Optimise APK with Externalisation" with "compressed textures" selected.
- This option will fix any audio or "out of memory" issues.
- Check the compatability list for game specific adcvice.