Add How to Use Firestar

How-to-Use-Firestar.md

@@ -0,0 +1,42 @@
+Before you get started, make sure you have the following ready:
+- Playstation Vita/TV or the Vita3K emulator
+    - On real consoles, you will need to have Ensō custom firmware installed to load HENkaku at startup.  
+If you don't, complete the [Vita Hacks Guide](https://vita.hacks.guide/), then come back here.
+- The extracted PSARC files from your copy of WipEout 2048 **(very important)**
+    - You can grab these [here](Decrypting-Original-PSARC-Files).
+- A PC or Mac with Java installed, version 17 at least.
+- A way to transfer files between your computer and your hacked console
+    - **The [Filezilla](https://filezilla-project.org/) FTP client is the recommended way to do this.**
+    - You can also use your Vita's included USB charging cable, though this can cause corruption on Mac/Linux systems.
+- Repatch Reloaded installed on your Vita
+    - If you do not have Repatch Reloaded, follow the installation guide for it [here](Setting-Up-Repatch-Reloaded).
+
+# Installing Firestar
+Download the latest Portable ZIP from [Releases](https://git.worlio.com/bonkmaykr/firestar/releases), and extract it, then run the JAR file inside.  
+  
+Alternatively, if you are on Linux, you may install one of the package files using your package manager and it will automatically add Firestar to your /usr/bin and to your desktop's Start menu.  
+![](https://files.worlio.com/users/bonkmaykr/http/git/embed/2024-07-02_15-12.png)  
+  
+During the initial setup, Firestar will ask you where you want to export your mods to. This can be any folder as long as you have write permissions to it.  
+Make sure to write the full path. Something like "C:/Users/(your name)/Desktop/WipEout/" or "/home/(your name)/Desktop/WipEout/" will work fine.  
+![](https://files.worlio.com/users/bonkmaykr/http/git/embed/2024-07-02_15-15.png)  
+  
+The last step is to open your ~/.firestar/ folder (there is a convenient button on this screen to open it for you) and drop in your original PSARC files that you extracted before starting this guide. If you don't have these files, you should [get them now](Decrypting-Original-PSARC-Files) before continuing. *If you want, you can just insert the last-loading PSARC that you have (data2.psarc for the base game, or dlc2.psarc if you own the HD Fury Add-On Pack)*, this will save a lot of space and reduce transfer times.  
+![](https://files.worlio.com/users/bonkmaykr/http/git/embed/2024-07-02_15-30.png)
+
+# Using Firestar  
+## Adding a mod to the mod list
+Press the "Import" button and select an .FSTAR file to copy it to your list of mods.  
+This file will be copied to ~/.firestar/mods/, so if you delete or move the originals it will still remain in your list until you remove it.
+![](https://files.worlio.com/users/bonkmaykr/http/git/embed/2024-07-02_15-33.png)  
+  
+## Installing the mods to your Vita
+Press the "Deploy" button and Firestar will automatically generate a new PSARC file that you can inject into your game:  
+![](https://files.worlio.com/users/bonkmaykr/http/git/embed/2024-07-02_15-37.png)  
+  
+You can then open VitaShell and copy the new PSARC file to your Repatch Reloaded folder.
+- If you got a data.psarc, data1.psarc or data2.psarc, move it to `ux0:/repatch/(your Title ID)/PSP2/`
+- For dlc1.psarc, move it to `ux0:/readdcont/(your Title ID)/DLC1W2048PACKAGE/PSP2/`
+- And if you have dlc2.psarc, move it to `ux0:/readdcont/(your Title ID)/DLC2W2048PACKAGE/PSP2/`  
+  
+![](https://files.worlio.com/users/bonkmaykr/http/git/embed/2024-07-02-154348.png)