fault tolerance

.idea/artifacts/firestar_jar.xml

@@ -0,0 +1,13 @@
+<component name="ArtifactManager">
+  <artifact type="jar" build-on-make="true" name="firestar:jar">
+    <output-path>$PROJECT_DIR$/out/artifacts/firestar_jar</output-path>
+    <root id="archive" name="firestar.jar">
+      <element id="directory" name="META-INF">
+        <element id="file-copy" path="$PROJECT_DIR$/bin/META-INF/MANIFEST.MF" />
+      </element>
+      <element id="module-output" name="firestar" />
+      <element id="extracted-dir" path="$MAVEN_REPOSITORY$/net/lingala/zip4j/zip4j/2.11.5/zip4j-2.11.5.jar" path-in-jar="/" />
+      <element id="extracted-dir" path="$MAVEN_REPOSITORY$/org/json/json/20240303/json-20240303.jar" path-in-jar="/" />
+    </root>
+  </artifact>
+</component>

README.md

@@ -1,8 +1,19 @@
 ![](https://files.worlio.com/users/bonkmaykr/http/git/embed/firestar.png)
 
-# about 50% complete (I/O in progress)
-
 Firestar is a mod manager for WipEout 2048 which automatically handles sorting mods by priority and repacking game assets based on selected add-on packs. It runs on a desktop/laptop computer and aims to allow easy installation of mods for users who have only a surface level understanding of hacking the PSVita.  
+  
+# about 85% complete
+**What works:**
+- Importing & deleting mods
+- Repacking (installing) mods
+- config loading
+- Cross-platform support
+
+**What doesn't work yet:**
+- change load order, toggle
+- settings screen
+- misc. tools (pack creator, soundtrack mod generator...)
+
 ![](https://files.worlio.com/users/bonkmaykr/http/git/embed/firestar_window.png)
   
 # System Requirements
@@ -13,15 +24,23 @@ Firestar is a mod manager for WipEout 2048 which automatically handles sorting m
 # Mod File Structure
 Mod files are contained inside of ZIP archives with the metadata being stored inside of the archive's embedded comments. The "data" folder inside contains the actual game assets for repacking.  
 Next to it at root level a pack.png will be supplied for displaying your mod's icon in later versions of Firestar. This feature is currently unimplemented.  
+Later versions of Firestar will have a built-in tool to handle these for you, since some archive programs don't make it easy enough to do by hand.  
   
-TODO: More details will be provided once I/O routines are completed.
+Typical mod metadata will look something like this:
+```json
+{
+  "version": 1,
+  "friendlyName": "Custom soundtrack",
+  "loaderversion": 0,
+  "author": "bonkmaykr",
+  "description": "I need sugar"
+}
+```
 
 # FAQ
-## What is the difference between Compatibility Mode and Fast Mode?
-Fast Mode is the most intuitive solution. It simply unpacks all of the assets into a folder for the game to read. This makes it trivial to go back and modify it later without repacking anything and it means you don't need stolen Sony-confidential equipment. However, PSVita and PSTV memory cards use the exFAT filesystem which really does not play nice with WipEout assets and causes all sorts of glitches, so using a genuine PSARC is an absolute necessity when playing on a real console. Compatibility mode uses a real PSARC tool to try and create mod files as similar to the original game files as possible and create minimal friction with the game engine. 
-
 ## (Non-Windows) Do I need WINE? And why?
-Only if you use Compatibility Mode. psp2psarc.exe is a Windows-only tool so we call WINE internally when needed, but Firestar itself will run on any desktop platform with a compliant Java runtime.
+Yes. psp2psarc.exe is a Windows-only tool. Firestar can run natively on the system but it needs WINE in order to pack the game assets.
+**If you are on Mac OS X you will need an older OS version that is still compatible with 32-bit applications.**
 
 ## Why do I need a leaked Playstation SDK?
 Because many third-party programs for opening PSARC files either have no ability to create new ones or are prone to corruption bugs. Using the one made by the developers of the file format is the best option as it's what the game developers would have used. Obviously this creates all kinds of legal grey areas so I can't distribute Sony's proprietary software next to my code. It's downloaded separately.
@@ -30,4 +49,7 @@ Because many third-party programs for opening PSARC files either have no ability
 Cross-platform support with no hassle, a built-in UI framework, and I don't need to sell my soul like every Electron or React 'Native' developer is doing these days.  
   
 ## Why the name "Firestar"?
-Firestar was a secret track in the original WipEout which you unlocked after beating the game at least once, the mod manager is just named after that. Major versions are named after pilots or tracks. Internal class names are named after Muppets characters as this is the same naming convention that Sony used to codename parts inside the PSVita's SOC.
+Firestar was a secret track in the original WipEout which you unlocked after beating the game at least once, the mod manager is just named after that. Major versions are named after pilots or tracks. Internal class names are named after Muppets characters as this is the same naming convention that Sony used to codename parts inside the PSVita's SOC.
+
+## Fast Mode vs. Compatibility Mode
+"Fast Mode" was a legacy option that was scrapped before it could be developed. It skipped the creation of a PSARC file and simply dumped the final game assets to their destination folder. This works great for emulators, and doesn't require proprietary stolen SDKs from SCE. However the filesystem on the Playstation Vita really hated this method and would glitch out when this was done, causing textures to be corrupted once placed on the memory card. The WipEout engine has no fault tolerance for malformed or missing assets, so it just crashes instantly when it encounters one. This is where Compatibility mode comes from, which is the default setting for 2048.

src/Gonzo.java

@@ -17,7 +17,6 @@
  */
 
 import net.lingala.zip4j.ZipFile;
-import net.lingala.zip4j.util.FileUtils;
 
 import javax.imageio.ImageIO;
 import javax.swing.*;
@@ -87,17 +86,17 @@ public class Gonzo {
         final Thread managerThread = new Thread() {
             @Override
             public void run() {
-                if (!Main.wine) {
+                if (Main.repatch) {
-                    POSIXRoutine();
+                    CompatibilityRoutine();
                 } else {
-                    Win32Routine();
+                    FastRoutine();
                 }
             }
         };
         managerThread.start();
     }
 
-    private void POSIXRoutine() {
+    private void CompatibilityRoutine() {
         // create temporary working area for asset dump
         new File(System.getProperty("user.home") + "/.firestar/temp/").mkdirs();
 
@@ -115,7 +114,9 @@ public class Gonzo {
                 System.out.println("Firestar is extracting " + s);
                 consoleDisplay.append("Firestar is extracting " + s + "\n");
                 //Process p = Runtime.getRuntime().exec(new String[]{"bash","-c","aplay /home/bonkyboo/kittens_loop.wav"}); // DEBUG
-                Process p = Runtime.getRuntime().exec(new String[]{"bash","-c","cd " + System.getProperty("user.home") + "/.firestar/temp/" + ";wine ../psp2psarc.exe extract -y ../" + s});
+                Process p;
+                if (!Main.windows) {p = Runtime.getRuntime().exec(new String[]{"bash","-c","cd " + System.getProperty("user.home") + "/.firestar/temp/" + ";wine ../psp2psarc.exe extract -y ../" + s});}
+                else {p = Runtime.getRuntime().exec(new String[]{new String(System.getProperty("user.home") + "\\.firestar\\psp2psarc.exe"), "extract", "-y", "..\\" + s}, null, new File(new String(System.getProperty("user.home") + "/.firestar/temp/").replace("/", "\\")));}
                 final Thread ioThread = new Thread() {
                     @Override
                     public void run() {
@@ -127,7 +128,7 @@ public class Gonzo {
                                 System.out.println(line);
                                 consoleDisplay.append(line + "\n");
                                 try {scrollPane.getVerticalScrollBar().setValue(scrollPane.getVerticalScrollBar().getMaximum());}
-                                catch (Exception e) {System.out.println("WARNING: Swing failed to paint window due to race condition.\n" + e.getMessage());}
+                                catch (Exception e) {System.out.println("WARNING: Swing failed to paint window due to race condition. You can safely ignore this.\n" + e.getMessage());}
                             }
                             reader.close();
                         } catch (final Exception e) {
@@ -139,9 +140,11 @@ public class Gonzo {
                 p.waitFor();
             } catch (IOException | InterruptedException e) {
                 System.out.println(e.getMessage());
+                consoleDisplay.append("CRITICAL FAILURE: " + e.getMessage());
+                JOptionPane.showMessageDialog(this.frame, "CRITICAL FAILURE: " + e.getMessage(), "Fatal Error", JOptionPane.ERROR_MESSAGE);
                 frame.setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE);
                 AllowExit();
-                break;
+                return;
             }
         }
 
@@ -158,6 +161,7 @@ public class Gonzo {
                     consoleDisplay.append("Firestar is deleting files that conflict with " + m.friendlyName + " by " + m.author + "\n");
 
                     String deleteQueue = new String(Files.readAllBytes(Paths.get(System.getProperty("user.home") + "/.firestar/temp/delete.txt")));
+                    if (Main.windows) {deleteQueue = new String(Files.readAllBytes(Paths.get(System.getProperty("user.home") + "\\.firestar\\temp\\delete.txt")));} // might be unnecessary
                     String[] dQarray = deleteQueue.split("\n");
                     Arrays.sort(dQarray);
                     System.out.println("The deletion queue is " + dQarray.length + " files long!"); //debug
@@ -167,17 +171,29 @@ public class Gonzo {
                             System.out.println("WARNING: Firestar skipped a potentially dangerous delete command. Please ensure the mod you're installing is from someone you trust!");
                             consoleDisplay.append("WARNING: Firestar skipped a potentially dangerous delete command. Please ensure the mod you're installing is from someone you trust!\n");
                         } else {
-                            System.out.println("Deleting " + System.getProperty("user.home") + "/.firestar/temp/data/" + file);
+                            if (!Main.windows) {
-                            consoleDisplay.append("Deleting " + System.getProperty("user.home") + "/.firestar/temp/data/" + file + "\n");
+                                System.out.println("Deleting " + System.getProperty("user.home") + "/.firestar/temp/data/" + file);
-                            new File(System.getProperty("user.home") + "/.firestar/temp/data/" + file).delete();
+                                consoleDisplay.append("Deleting " + System.getProperty("user.home") + "/.firestar/temp/data/" + file + "\n");
+                                new File(System.getProperty("user.home") + "/.firestar/temp/data" + file).delete();}
+                            else {
+                                System.out.println("Deleting " + new String(System.getProperty("user.home") + "\\.firestar\\temp\\data" + file).replace("/", "\\"));
+                                consoleDisplay.append("Deleting " + new String(System.getProperty("user.home") + "\\.firestar\\temp\\data" + file).replace("/", "\\") + "\n");
+                                new File(new String(System.getProperty("user.home") + "\\.firestar\\temp\\data" + file).replace("/", "\\")).delete();
+                            }
                         }
                     }
+
+                    // cleanup so we don't run it again for the next mod unless needed
+                    // this is not necessary but good practice
+                    new File(System.getProperty("user.home") + "/.firestar/temp/delete.txt").delete();
                 }
-            } catch (IOException e) {
+            } catch (Exception e) {
                 System.out.println(e.getMessage());
+                consoleDisplay.append("CRITICAL FAILURE: " + e.getMessage());
+                JOptionPane.showMessageDialog(this.frame, "CRITICAL FAILURE: " + e.getMessage(), "Fatal Error", JOptionPane.ERROR_MESSAGE);
                 frame.setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE);
                 AllowExit();
-                break;
+                return;
             }
         }
 
@@ -190,7 +206,8 @@ public class Gonzo {
                 // We need to clean up the path here on Linux to avoid psp2psarc getting confused about where the hell "/" is.
                 // In WINE it should see it as Z: by default, but if it's somewhere else then I don't have an elegant way of knowing what drive letter it's on, so
                 // relative paths are kind of the only choice here. This can be extended to Windows too as it works there, though completely unnecessary.
-                oFilesList2.add(p.replace("\\", "/").split(System.getProperty("user.home") + "/.firestar/temp/data/")[1]);
+                if (!Main.windows) {oFilesList2.add(p.replace("\\", "/").split(new String(System.getProperty("user.home") + "/.firestar/temp/"))[1]);}
+                else {oFilesList2.add(p.split(new String(System.getProperty("user.home") + "\\.firestar\\temp\\").replace("\\", "\\\\"))[1]);} // path wont match regex unless adjusted for windows here
             }
             //oFilesList2.forEach(System.out::println); //debug
             File oFilesListO = new File(System.getProperty("user.home") + "/.firestar/temp/list.txt");
@@ -205,17 +222,22 @@ public class Gonzo {
                 i++;
             }
             oFilesListWr.close();
-        } catch (IOException e) {
+        } catch (Exception e) {
             System.out.println(e.getMessage());
+            consoleDisplay.append("CRITICAL FAILURE: " + e.getMessage());
+            JOptionPane.showMessageDialog(this.frame, "CRITICAL FAILURE: " + e.getMessage(), "Fatal Error", JOptionPane.ERROR_MESSAGE);
             frame.setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE);
             AllowExit();
+            return;
         }
 
         // invoke psp2psarc.exe one final time to reconstruct the assets
         try {
             System.out.println("Firestar is compiling the final build");
             consoleDisplay.append("Firestar is compiling the final build" + "\n");
-            Process p = Runtime.getRuntime().exec(new String[]{"bash","-c","cd " + System.getProperty("user.home") + "/.firestar/temp/data" + ";wine ../../psp2psarc.exe create --skip-missing-files -j12 -a -i --input-file=../list.txt -o ../" + oArcTarget});
+            Process p;
+            if (!Main.windows) {p = Runtime.getRuntime().exec(new String[]{"bash","-c","cd " + System.getProperty("user.home") + "/.firestar/temp" + ";wine ../psp2psarc.exe create --skip-missing-files -j12 -a -i --input-file=list.txt -o " + oArcTarget});}
+            else {p = Runtime.getRuntime().exec(new String[]{new String(System.getProperty("user.home") + "\\.firestar\\psp2psarc.exe"), "create", "--skip-missing-files", "-j12", "-a", "-i", "--input-file=list.txt", "-o" + oArcTarget}, null, new File(new String(System.getProperty("user.home") + "/.firestar/temp/").replace("/", "\\")));}
             final Thread ioThread = new Thread() {
                 @Override
                 public void run() {
@@ -239,15 +261,32 @@ public class Gonzo {
             p.waitFor();
         } catch (IOException | InterruptedException e) {
             System.out.println(e.getMessage());
+            consoleDisplay.append("CRITICAL FAILURE: " + e.getMessage());
+            JOptionPane.showMessageDialog(this.frame, "CRITICAL FAILURE: " + e.getMessage(), "Fatal Error", JOptionPane.ERROR_MESSAGE);
             frame.setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE);
             AllowExit();
+            return;
         }
 
         // cleanup
-        new File(Main.outpath).mkdirs();
+        boolean one = new File(Main.outpath).mkdirs();
-        new File(System.getProperty("user.home") + "/.firestar/temp/" + oArcTarget).renameTo(new File(Main.outpath + oArcTarget));
+        boolean two;
+        System.out.println("created export folder: " + one);
+        if (!Main.windows) {two = new File(System.getProperty("user.home") + "/.firestar/temp/" + oArcTarget).renameTo(new File(Main.outpath + oArcTarget));}
+        else {two = new File(System.getProperty("user.home") + "\\.firestar\\temp\\" + oArcTarget).renameTo(new File(Main.outpath + oArcTarget));}
+        System.out.println("moved file to destination: " + two);
+        if (two) {System.out.println("file should be located at " + Main.outpath + oArcTarget);} else {
+            System.out.println("CRITICAL FAILURE: Please check that your output path is correct and that you have write permissions!");
+            consoleDisplay.append("CRITICAL FAILURE: Please check that your output path is correct and that you have write permissions!");
+            JOptionPane.showMessageDialog(this.frame, "CRITICAL FAILURE: Please check that your output path is correct and that you have write permissions!", "Fatal Error", JOptionPane.ERROR_MESSAGE);
+            frame.setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE);
+            AllowExit();
+            return;
+        }
         try {
-            Process p = Runtime.getRuntime().exec(new String[]{"bash","-c","rm -rf " + System.getProperty("user.home") + "/.firestar/temp/"}); // Scary!
+            Process p;
+            if (!Main.windows) {p = Runtime.getRuntime().exec(new String[]{"bash","-c","rm -rf " + System.getProperty("user.home") + "/.firestar/temp/"});} // Scary!
+            else {p = Runtime.getRuntime().exec(new String[]{"rmdir", new String(System.getProperty("user.home") + "/.firestar/temp/").replace("/", "\\").replace("\\", "\\\\"), "/s", "/q"});}
             //new File(System.getProperty("user.home") + "/.firestar/temp/").delete();
         } catch (IOException e) {
             System.out.println("WARNING: Temporary files may not have been properly cleared.\n" + e.getMessage());
@@ -271,14 +310,15 @@ public class Gonzo {
         AllowExit();
     }
 
-    private void Win32Routine() {
+    private void FastRoutine() {
 
     }
 
     public void AllowExit() {
-        scrollPane.getVerticalScrollBar().setValue(scrollPane.getVerticalScrollBar().getMaximum());
         System.out.println("\n\nYou may now close the pop-up window.");
         consoleDisplay.append("\n\n\nYou may now close the pop-up window.");
+        try {TimeUnit.MILLISECONDS.sleep(200);} catch (InterruptedException e) {} //ignore
+        scrollPane.getVerticalScrollBar().setValue(scrollPane.getVerticalScrollBar().getMaximum());
         frame.addWindowListener(new WindowAdapter() {
             @Override
             public void windowClosing(WindowEvent e)

src/Kermit.java

@@ -26,10 +26,6 @@ import java.math.BigInteger;
 import java.net.URL;
 import java.nio.file.*;
 import java.security.*;
-import java.util.concurrent.TimeUnit;
-
-import static javax.swing.WindowConstants.DISPOSE_ON_CLOSE;
-import static javax.swing.WindowConstants.EXIT_ON_CLOSE;
 
 // handles setup window
 public class Kermit implements ActionListener {
@@ -99,7 +95,7 @@ public class Kermit implements ActionListener {
                     button.setVisible(false);frame.remove(button);
                     button2.setVisible(false);frame.remove(button2);
                     dialogText.setVisible(false);frame.remove(dialogText);
-                    changePage(Pages.EXPORT_MODE);
+                    changePage(Pages.SDK_INSTALL); // EXPORT_MODE
                     break;
                 case EXPORT_MODE:
                     button.setVisible(false);frame.remove(button);
@@ -176,10 +172,10 @@ public class Kermit implements ActionListener {
             Main.repatch = false;
             button.setEnabled(true);
         } else if (actionEvent.getSource() == buttonHaveWine) {
-            Main.wine = true;
+            Main.windows = true;
             button.setEnabled(true);
         } else if (actionEvent.getSource() == buttonNoWine) {
-            Main.wine = false;
+            Main.windows = false;
             button.setEnabled(true);
         }else if (actionEvent.getSource() == openconfigfolderbutton) {
             try {
@@ -345,8 +341,8 @@ public class Kermit implements ActionListener {
                 dialogText.setVisible(false);frame.remove(dialogText);
 
                 //check if this is windows or not
-                if(System.getProperty("os.name").contains("Windows")) {Main.wine = false;System.out.println("Assuming we should NOT use WINE based on known system variables.");changePage(Pages.EXPORT_LOCATION);}
+                if(System.getProperty("os.name").contains("Windows")) {Main.windows = true;System.out.println("Assuming we should NOT use WINE based on known system variables.");changePage(Pages.EXPORT_LOCATION);}
-                else {Main.wine = true;System.out.println("Assuming we should use WINE based on known system variables.");changePage(Pages.EXPORT_LOCATION);}
+                else {Main.windows = false;System.out.println("Assuming we should use WINE based on known system variables.");changePage(Pages.EXPORT_LOCATION);}
 
             case EXPORT_LOCATION:
                 page = Pages.EXPORT_LOCATION;

src/Main.java

@@ -18,16 +18,14 @@
 
 import org.json.*;
 
-import java.awt.event.ActionEvent;
-import java.awt.event.ActionListener;
 import java.io.*;
 import java.nio.file.*;
 import java.util.*;
-import javax.swing.*;
+import javax.swing.JOptionPane;
 
 public class Main {
     // Build Information
-    public static final String vstr = "PREALPHA";
+    public static final String vstr = "Beta 1";
     public static final String vcode = "Natasha";
     public static final int vint = 0;
 
@@ -37,7 +35,7 @@ public class Main {
     public static String outpath = System.getProperty("user.home") + "/.firestar/out/"; //game assets location
     public static String inpath = System.getProperty("user.home") + "/.firestar/"; //game assets location
     public static boolean repatch; //are we in compat mode?
-    public static boolean wine; //are we on Linux, MINIX, BSD?
+    public static boolean windows; //True = windows
     //public static String psarc; //sdk location
 
     public class Mod {
@@ -90,7 +88,7 @@ public class Main {
         container.put("2048path", outpath);
         container.put("HDpath", "TODO"); // proposed hd/fury support for ps3, will use very simplified Fast Mode due to less difficulty installing
         container.put("safemode", repatch);
-        container.put("isUnix", wine);
+        container.put("isWin32", windows);
         container.put("currentPlaylist", "TODO"); // proposed feature: store separate mod lists in lists/ to load/save later?
 
         try {
@@ -101,6 +99,32 @@ public class Main {
     }
 
     public static void loadConf(){
+        try {
+            JSONObject container = new JSONObject(new String(Files.readAllBytes(Paths.get(System.getProperty("user.home") + "/.firestar/firestar.conf"))));
+            System.out.println(container.toString()); // debug
+            int confvint = (int) container.get("version"); // used for converting configs between program versions later down the line
+            outpath = container.get("2048path").toString();
+            repatch = (boolean) container.get("safemode");
+            windows = (boolean) container.get("isWin32");
+        } catch (IOException e) {
+            System.out.println("ERROR: Failed to load firestar.conf");
+            System.out.println(e.getMessage());
+        }
+        return;
+    }
 
+    public static void loadConf(MissPiggy w){
+        try {
+            JSONObject container = new JSONObject(new String(Files.readAllBytes(Paths.get(System.getProperty("user.home") + "/.firestar/firestar.conf"))));
+            System.out.println(container.toString()); // debug
+            int confvint = (int) container.get("version"); // used for converting configs between program versions later down the line
+            outpath = container.get("2048path").toString();
+            repatch = (boolean) container.get("safemode");
+            windows = (boolean) container.get("isWin32");
+        } catch (Exception e) {
+            JOptionPane.showMessageDialog(w.frame, "Firestar couldn't load your config file. Tread lightly.\n\n" + e.getMessage(), "Critical Error", JOptionPane.ERROR_MESSAGE);
+            System.out.println("ERROR: Failed to load firestar.conf");
+            System.out.println(e.getMessage());
+        }
     }
 }

src/MissPiggy.java

@@ -19,21 +19,28 @@
 import javax.imageio.ImageIO;
 import javax.swing.*;
 import javax.swing.event.ListSelectionListener;
+import javax.swing.filechooser.FileNameExtensionFilter;
 import java.awt.*;
 import java.awt.event.ActionEvent;
 import java.awt.event.ActionListener;
 import java.awt.image.BufferedImage;
+import java.io.BufferedWriter;
 import java.io.File;
+import java.io.FileWriter;
 import java.io.IOException;
 import java.math.RoundingMode;
 import java.nio.file.*;
 import java.text.DecimalFormat;
+import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Random;
 import java.util.regex.Pattern;
-
 import net.lingala.zip4j.*;
 import net.lingala.zip4j.exception.ZipException;
 import org.json.JSONObject;
+import static java.nio.file.StandardCopyOption.*;
 
 import static javax.swing.WindowConstants.EXIT_ON_CLOSE;
 
@@ -62,13 +69,17 @@ public class MissPiggy implements ActionListener {
     private JButton deployButton;
     private JTextPane descriptionField;
 
-    private int selectedItem;
+    //private int selectedItem;
 
     public String priorityList;
 
+    public boolean listenersAlreadySet = false; // was written to troubleshoot a bug but this wasn't actually the cause
+
     // Initialize the main window
     public void Action(/*Main entryPoint*/) {
         System.out.println("Main window created");
+        System.out.println("Loading program configuration");
+        Main.loadConf(this);
 
         // populate menu bar
         menuBar = new JMenuBar();
@@ -110,39 +121,15 @@ public class MissPiggy implements ActionListener {
         toolsMenu.getItem(1).addActionListener(this);
         helpMenu.getItem(0).addActionListener(this);
 
+        deployButton.addActionListener(this);
+        importButton.addActionListener(this);
+        deleteButton1.addActionListener(this);
+        optionsButton.addActionListener(this);
+        moveUpButton.addActionListener(this);
+        moveDownButton.addActionListener(this);
+        toggleButton.addActionListener(this);
+
         descriptionField.getDocument().putProperty("filterNewlines", Boolean.FALSE);
-        modList.addListSelectionListener(e -> {
-            String authorDisplay;
-            File pathReference = new File(System.getProperty("user.home") + "/.firestar/mods/" + Main.Mods.get(modList.getSelectedIndex()).path);
-            DecimalFormat df = new DecimalFormat("##.##");
-            df.setRoundingMode(RoundingMode.UP);
-            float modFileSize = pathReference.length(); //precise units
-            String modFileSizeStr = String.valueOf(modFileSize);
-            String modFileSizeUnits = "bytes"; //todo: don't show decimals for bytes
-            if (pathReference.length() >= 1024) {
-                modFileSizeStr = String.valueOf(df.format(modFileSize / 1024));
-                modFileSizeUnits = "Kilobytes";
-            }
-            if (pathReference.length() >= 1024 * 1024) {
-                modFileSizeStr = String.valueOf(df.format(modFileSize / (1024 * 1024)));
-                modFileSizeUnits = "Megabytes";
-            }
-            if (pathReference.length() >= 1024 * 1024 * 1024) {
-                modFileSizeStr = String.valueOf(df.format(modFileSize / (1024 * 1024 * 1024)));
-                modFileSizeUnits = "Gigabytes";
-            }
-            if (Main.Mods.get(modList.getSelectedIndex()).author == null) {
-                authorDisplay = "an Unknown Author";
-            } else {
-                authorDisplay = Main.Mods.get(modList.getSelectedIndex()).author;
-            }
-            descriptionField.setText(
-                "\"" + Main.Mods.get(modList.getSelectedIndex()).friendlyName + "\"\n" +
-                "by " + authorDisplay + "\n\n" +
-                "Version " + Main.Mods.get(modList.getSelectedIndex()).version + "\n" +
-                        modFileSizeStr + " " + modFileSizeUnits + " in size" +
-                "\n\n" + Main.Mods.get(modList.getSelectedIndex()).description
-        );});
 
         // display window
         try {
@@ -191,8 +178,11 @@ public class MissPiggy implements ActionListener {
             Do nothing if the index number is not valid.
             there probably is not a practical reason to do this, but I want to eliminate any undefined behaviors while we're here.
             we'll also eliminate any syntax errors caused by the lack of a = sign
+
+            06/29/24 - also skip files that were manually removed but remain in the list
             */
-            if (s.split("=")[0].matches("[0-9]+=*")) {
+            if (s.split("=")[0].matches("[0-9]+=*") &&
+                    new File(System.getProperty("user.home") + "/.firestar/mods/" + s.substring(s.indexOf("=") + 1)).exists()) {
                 //append mod to list from substring
                 Main.Mod m = new Main().new Mod();
                 m.path = s.substring(s.indexOf("=") + 1);
@@ -202,24 +192,27 @@ public class MissPiggy implements ActionListener {
                 JSONObject metadata;
                 try {
                     metadata = new JSONObject(new ZipFile(System.getProperty("user.home") + "/.firestar/mods/" + m.path).getComment());
-                } catch (ZipException e) {
+                    if (metadata.has("friendlyName")) {m.friendlyName = metadata.get("friendlyName").toString();} else {m.friendlyName = m.path;}
-                    throw new RuntimeException(e); //todo: fault tolerance
+                    if (metadata.has("description")) {m.description = metadata.get("description").toString();}
-                }
+                    if (metadata.has("version")) {m.version = Integer.parseInt(metadata.get("version").toString());}
-                if (metadata.has("friendlyName")) {m.friendlyName = metadata.get("friendlyName").toString();} else {m.friendlyName = m.path;}
+                    if (metadata.has("author")) {m.author = metadata.get("author").toString();}
-                if (metadata.has("description")) {m.description = metadata.get("description").toString();}
+                    if (metadata.has("loaderversion")) {m.loaderversion = Integer.parseInt(metadata.get("loaderversion").toString());}
-                if (metadata.has("version")) {m.version = Integer.parseInt(metadata.get("version").toString());}
+                    if (metadata.has("game")) {m.game = metadata.get("game").toString();}
-                if (metadata.has("author")) {m.author = metadata.get("author").toString();}
-                if (metadata.has("loaderversion")) {m.loaderversion = Integer.parseInt(metadata.get("loaderversion").toString());}
-                if (metadata.has("game")) {m.game = metadata.get("game").toString();}
 
-                //send to list
+                    //send to list
-                Main.Mods.add(m);
+                    Main.Mods.add(m);
+                } catch (Exception e) {
+                    System.out.println("WARNING: mod entry for " + s + " was found but does not contain valid JSON metadata. skipping");
+                }
+            } else {
+                if (!s.isEmpty()) {System.out.println("WARNING: mod entry for " + s + " doesn't actually exist. skipping");}
             }
         }
     }
 
-    public void InitializeModListInGUI() { // i really wanted this to be "lights, camera, action" but the code organizing kept getting stupider and stupider so i gave up
+    public void InitializeModListInGUI() {
         // cleanup
+        if (listenersAlreadySet) {modList.removeListSelectionListener(modList.getListSelectionListeners()[0]);} // was written to troubleshoot a bug but this wasn't actually the cause
         descriptionField.setText("Select a mod from the list on the right to view more details, or to make changes to your installation.");
         modList.clearSelection();
         modList.removeAll();
@@ -241,6 +234,7 @@ public class MissPiggy implements ActionListener {
             i++;
         }
         modList.setListData(contents);
+        createSelectionEventListener();
     }
 
     private ListSelectionListener whenItemSelected() {
@@ -251,9 +245,19 @@ public class MissPiggy implements ActionListener {
     public void actionPerformed(ActionEvent actionEvent) {
         if (actionEvent.getSource() == fileMenu.getItem(5)) {System.exit(0);} else
         if (actionEvent.getSource() == fileMenu.getItem(0)) {deployModGUI();} else
+        if (actionEvent.getSource() == deployButton) {deployModGUI();} else
+        if (actionEvent.getSource() == importButton) {importModGUI();} else
         if (actionEvent.getSource() == fileMenu.getItem(1)) {importModGUI();} else
         if (actionEvent.getSource() == fileMenu.getItem(2)) {removeAllGUI();} else
+        if (actionEvent.getSource() == optionsButton) {optionsGUI();} else
         if (actionEvent.getSource() == fileMenu.getItem(4)) {optionsGUI();} else
+
+        if (actionEvent.getSource() == moveUpButton) {moveUp(modList.getSelectedIndex());} else
+        if (actionEvent.getSource() == moveDownButton) {moveDown(modList.getSelectedIndex());} else
+
+        if (actionEvent.getSource() == toggleButton) {throwUnimplemented();} else // todo
+        if (actionEvent.getSource() == deleteButton1) {deleteSelected();} else
+
         if (actionEvent.getSource() == helpMenu.getItem(0)) {new Rowlf().displayAboutScreen();}
     }
 
@@ -275,26 +279,186 @@ public class MissPiggy implements ActionListener {
     }
 
     public void importModGUI() {
-        // todo call system shell to request file picker
+        JFileChooser fileChooser = new JFileChooser();
+        fileChooser.setCurrentDirectory(new File(System.getProperty("user.home")));
+        //fileChooser.addChoosableFileFilter(new FileNameExtensionFilter("All", "zip", "agr", "agrc", "agrf", "fstar"));
+        fileChooser.addChoosableFileFilter(new FileNameExtensionFilter("ZIP Archive", "zip"));
+        fileChooser.addChoosableFileFilter(new FileNameExtensionFilter("Firestar Mod Package", "agr", "agrc", "agrf", "fstar")); //what about fstar?
+
+        int result = fileChooser.showOpenDialog(frame);
+
+        if (result == JFileChooser.APPROVE_OPTION) {
+            File selectedFile = fileChooser.getSelectedFile();
+            System.out.println("Importing selected mod file \"" + selectedFile.getName() + "\"");
+
+            ZipFile zipImporterHandler = new ZipFile(selectedFile.getPath());
+            if (zipImporterHandler.isValidZipFile()) {
+                try {
+                    Path importDestination = Paths.get(System.getProperty("user.home") + "/.firestar/mods/"
+                            + selectedFile.getName() + "_" + Main.Mods.size() + ".zip");
+                    Files.copy(Paths.get(selectedFile.getPath()), importDestination, StandardCopyOption.REPLACE_EXISTING);
+                    String importDestinationName = importDestination.toFile().getName();
+
+                    BufferedWriter bw = new BufferedWriter(new FileWriter(System.getProperty("user.home") + "/.firestar/mods/index", true));
+                    bw.write(Main.Mods.size() + "=" + importDestinationName);
+                    bw.newLine();
+                    bw.close();
+
+                    InitializeModListStructure();
+                    InitializeModListInGUI();
+                } catch (Exception e) {
+                    System.out.println(e.getMessage());
+                    JOptionPane.showMessageDialog(frame, "An error has occured.\n" + e.getMessage(), "Error", JOptionPane.ERROR_MESSAGE);
+                }
+            } else {
+                System.out.println("ERROR: File is not a valid ZIP archive. Aborting.");
+                JOptionPane.showMessageDialog(frame, "Whoops, that's not a valid ZIP archive.", "Error", JOptionPane.ERROR_MESSAGE);
+            }
+        }
     }
 
     public void removeAllGUI() {
         // todo warning dialog that nukes list when Yes is clicked
+        int result = JOptionPane.showConfirmDialog(frame, "Do you really want to delete all mods?", "Remove All", JOptionPane.YES_NO_OPTION, JOptionPane.WARNING_MESSAGE);
+
+        if (result == JOptionPane.YES_OPTION) {
+            for (Main.Mod entry : Main.Mods) {
+                new File(System.getProperty("user.home") + "/.firestar/mods/" + entry.path).delete();
+            }
+        }
+        new File(System.getProperty("user.home") + "/.firestar/mods/index").delete();
+        Main.Mods.clear();
+
+        InitializeModListStructure();
+        InitializeModListInGUI();
     }
 
     public void optionsGUI() {
         // todo settings page w/ reset switch
+        throwUnimplemented();
+    }
+
+    public void deleteSelected() {
+        File file = new File(System.getProperty("user.home") + "/.firestar/mods/" + Main.Mods.get(modList.getSelectedIndex()).path);
+        file.delete();
+        System.out.println("Deleted " + Main.Mods.get(modList.getSelectedIndex()).friendlyName); //debug
+        Main.Mods.remove(modList.getSelectedIndex());
+        regenerateModIndex(true);
     }
 
     public void generatorGUI() {
         // todo mod packer
+        throwUnimplemented();
     }
 
     public void metaEditorGUI() {
         // todo tag editor
+        throwUnimplemented();
     }
 
-    public void aboutGUI() {
+    private void moveUp(int index) {
-        // todo about page
+        if (index > 0) {
+            Collections.swap(Main.Mods, index, index - 1);
+            System.out.println("Items moved, redeploying list");
+            InitializeModListInGUI();
+            regenerateModIndex(false);
+        }
+    }
+
+    private void moveDown(int index) {
+        if (index < (Main.Mods.size() - 1)) {
+            Collections.swap(Main.Mods, index, index + 1);
+            System.out.println("Items moved, redeploying list");
+            InitializeModListInGUI();
+            regenerateModIndex(false);
+        }
+    }
+
+    public void throwUnimplemented() {
+        JOptionPane.showMessageDialog(frame, "Unimplemented.\nSee README at https://git.worlio.com/bonkmaykr/firestar", "Unimplemented", JOptionPane.INFORMATION_MESSAGE);
+    }
+
+    public void createSelectionEventListener() { // moved incase needs to be removed and re-added
+        listenersAlreadySet = true; // was written to troubleshoot a bug but this wasn't actually the cause
+        modList.addListSelectionListener(e -> {
+            if (modList.getSelectedIndex() >= 0 && modList.getModel().getSize() >= 1) { // avoid race OOB when reinitializing mod list
+            String authorDisplay;
+
+            try { //debug
+
+            File pathReference = new File(System.getProperty("user.home") + "/.firestar/mods/" + Main.Mods.get(modList.getSelectedIndex()).path);
+            DecimalFormat df = new DecimalFormat("##.##");
+            df.setRoundingMode(RoundingMode.UP);
+            float modFileSize = pathReference.length(); //precise units
+            String modFileSizeStr = String.valueOf(modFileSize);
+            String modFileSizeUnits = "bytes"; //todo: don't show decimals for bytes
+            if (pathReference.length() >= 1024) {
+                modFileSizeStr = String.valueOf(df.format(modFileSize / 1024));
+                modFileSizeUnits = "Kilobytes";
+            }
+            if (pathReference.length() >= 1024 * 1024) {
+                modFileSizeStr = String.valueOf(df.format(modFileSize / (1024 * 1024)));
+                modFileSizeUnits = "Megabytes";
+            }
+            if (pathReference.length() >= 1024 * 1024 * 1024) {
+                modFileSizeStr = String.valueOf(df.format(modFileSize / (1024 * 1024 * 1024)));
+                modFileSizeUnits = "Gigabytes";
+            }
+            if (Main.Mods.get(modList.getSelectedIndex()).author == null) {
+                authorDisplay = "an Unknown Author";
+            } else {
+                authorDisplay = Main.Mods.get(modList.getSelectedIndex()).author;
+            }
+            descriptionField.setText(
+                    "\"" + Main.Mods.get(modList.getSelectedIndex()).friendlyName + "\"\n" +
+                            "by " + authorDisplay + "\n\n" +
+                            "Version " + Main.Mods.get(modList.getSelectedIndex()).version + "\n" +
+                            modFileSizeStr + " " + modFileSizeUnits + " in size" +
+                            "\n\n" + Main.Mods.get(modList.getSelectedIndex()).description
+            );}
+
+            catch (IndexOutOfBoundsException ex) {
+                System.out.println(ex.getMessage());
+                System.out.println("mods " + Main.Mods.size());
+                System.out.println("mod display " + modList.getModel().getSize());
+                System.out.println("selection index " + modList.getSelectedIndex());
+
+                int result = JOptionPane.showConfirmDialog(frame, "Firestar encountered an internal error.\n" + ex.getMessage(), "Fatal Error", JOptionPane.DEFAULT_OPTION, JOptionPane.ERROR_MESSAGE);
+                if (result == JOptionPane.OK_OPTION) {System.exit(1);} //user safety
+            }
+
+            }
+        });
+    }
+
+    public void regenerateModIndex(boolean reload) {
+        try {
+            System.out.println("Regenerating index..."); //debug
+
+            new File(System.getProperty("user.home") + "/.firestar/mods/index").delete();
+            File priorityListFileHandle = new File(System.getProperty("user.home") + "/.firestar/mods/index");
+            priorityListFileHandle.createNewFile();
+
+
+            BufferedWriter bw = new BufferedWriter(new FileWriter(System.getProperty("user.home") + "/.firestar/mods/index", true));
+            int i = 0;
+            for (Main.Mod m : Main.Mods) {
+                bw.write(i + "=" + m.path);
+                bw.newLine();
+                i++;
+            }
+            bw.close();
+
+            if(reload) {
+                Main.Mods.clear(); //cleanup
+                priorityList = "";
+                InitializeModListStructure();
+                InitializeModListInGUI();
+            }
+            System.out.println("Mod index file regenerated.");
+        } catch (Exception e) {
+            System.out.println(e.getMessage());
+            JOptionPane.showMessageDialog(frame, "An error has occured.\n" + e.getMessage(), "Error", JOptionPane.ERROR_MESSAGE);
+        }
     }
 }

src/Rowlf.java

@@ -47,12 +47,13 @@ public class Rowlf {
         picLabel.setIcon(new ImageIcon(logo));picLabel.setText("");
 
         informationText.getDocument().putProperty("filterNewlines", Boolean.FALSE);
-        informationText.setText("Created by bonkmaykr\n" +
+        informationText.setHorizontalAlignment(JTextField.CENTER);
-                "a.k.a. \"Downforce Agent\"\n" +
+        informationText.setText("Created by bonkmaykr, a.k.a. \"Downforce Agent\"\n" +
                 "\n" +
                 "Special thanks to:\n" +
-                "ThatOneBonk, for almost beating me to it\n" +
+                "ThatOneBonk, for Thallium and for modding help\n" +
-                "Wirlaburla, for web hosting and code help\n" +
+                "Wirlaburla, for web hosting and being awesome\n" +
+                "Psygnosis, for making our favorite game ever\n" +
                 "and to all the PSVita hackers who made this possible");
         informationText.setHighlighter(null);
         informationText.getCaret().setVisible(false);