changed version string

.gitignore

@@ -28,3 +28,5 @@ bin/
 ### Mac OS ###
 .DS_Store
 /firestar.zip
+/run-linux.sh
+/run-win32.bat

README.md

@@ -1,43 +1,25 @@
 ![](https://files.worlio.com/users/bonkmaykr/http/git/embed/firestar.png)
 
 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 95% complete
-**What works:**
-- Managing mods (install, add, delete, toggle on/off)
-- Cross-platform support
-
-**What doesn't work yet:**
-- settings screen
-- misc. tools (pack creator, soundtrack mod generator...)
-- initial setup screen can still be a bit arduous for vita newbies
 
+## Video Tutorial: [>> CLICK HERE <<](https://www.youtube.com/watch?v=Bi9fpqR2Ulw)
 ![](https://files.worlio.com/users/bonkmaykr/http/git/embed/firestar_window.png)
   
+# Installation
+- **Windows & Mac:** Grab the Portable ZIP from the [Releases](https://git.worlio.com/bonkmaykr/firestar/releases) page and run the JAR file.
+- **Linux:** Install one of the packages from the [Releases](https://git.worlio.com/bonkmaykr/firestar/releases) page:
+    - Ubuntu, Mint, PopOS: `sudo dpkg -i firestar_ver_arch.deb` or `gdebi firestar_ver_arch.deb`
+    - Fedora, Mageia, OpenSUSE, AlmaLinux: `sudo rpm -i firestar-ver-arch.rpm`
+    - Arch, EndeavourOS, CachyOS, Steam Deck: `sudo pacman -U firestar-ver-arch.pkg.tar.zst`
+
 # System Requirements
 - You will need a computer running Microsoft Windows, or any POSIX-compliant desktop operating system such as Mac OS X, Linux, BSD, or MINIX (Firestar does not run directly on the PSVita). ***Wayland support has not been tested.***
 - You will also need the Java Runtime Environment installed, at least version 17 or newer. Non-Windows systems will require WINE to be installed for some functionality.
 - Please run Firestar on an EXT or NTFS partition as some of the larger file operations it performs may cause glitches in certain filesystems used on memory cards. Do NOT install Firestar directly to your PSVita's storage.
 
-# 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.  
-  
-Typical mod metadata will look something like this:
-```json
-{
-  "version": 1,
-  "friendlyName": "Custom soundtrack",
-  "loaderversion": 0,
-  "author": "bonkmaykr",
-  "description": "I need sugar"
-}
-```
-
 # FAQ
 ## (Non-Windows) Do I need WINE? And why?
-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.
+Yes. psp2psarc.exe is a Windows-only tool (also like super proprietary... sorry). 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?

src/Clifford.form

@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<form xmlns="http://www.intellij.com/uidesigner/form/" version="1" bind-to-class="Clifford">
+  <grid id="27dc6" binding="frameContainer" layout-manager="GridLayoutManager" row-count="5" column-count="2" same-size-horizontally="false" same-size-vertically="false" hgap="-1" vgap="-1">
+    <margin top="0" left="0" bottom="0" right="0"/>
+    <constraints>
+      <xy x="20" y="20" width="500" height="400"/>
+    </constraints>
+    <properties/>
+    <border type="none"/>
+    <children>
+      <component id="3294c" class="javax.swing.JLabel">
+        <constraints>
+          <grid row="0" column="0" row-span="1" col-span="1" vsize-policy="0" hsize-policy="0" anchor="4" fill="0" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <text value="Name"/>
+        </properties>
+      </component>
+      <component id="2e9e" class="javax.swing.JLabel">
+        <constraints>
+          <grid row="1" column="0" row-span="1" col-span="1" vsize-policy="0" hsize-policy="0" anchor="4" fill="0" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <text value="Author"/>
+        </properties>
+      </component>
+      <component id="e22ba" class="javax.swing.JTextField" binding="fName">
+        <constraints>
+          <grid row="0" column="1" row-span="1" col-span="1" vsize-policy="0" hsize-policy="6" anchor="8" fill="1" indent="0" use-parent-layout="false">
+            <preferred-size width="150" height="-1"/>
+          </grid>
+        </constraints>
+        <properties/>
+      </component>
+      <component id="9a381" class="javax.swing.JTextField" binding="fAuthor">
+        <constraints>
+          <grid row="1" column="1" row-span="1" col-span="1" vsize-policy="0" hsize-policy="6" anchor="8" fill="1" indent="0" use-parent-layout="false">
+            <preferred-size width="150" height="-1"/>
+          </grid>
+        </constraints>
+        <properties/>
+      </component>
+      <component id="c443e" class="javax.swing.JLabel">
+        <constraints>
+          <grid row="2" column="0" row-span="1" col-span="1" vsize-policy="0" hsize-policy="0" anchor="4" fill="0" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <text value="Version"/>
+        </properties>
+      </component>
+      <component id="d7be8" class="javax.swing.JTextField" binding="fVersion">
+        <constraints>
+          <grid row="2" column="1" row-span="1" col-span="1" vsize-policy="0" hsize-policy="6" anchor="8" fill="1" indent="0" use-parent-layout="false">
+            <preferred-size width="150" height="-1"/>
+          </grid>
+        </constraints>
+        <properties/>
+      </component>
+      <component id="e6d9e" class="javax.swing.JLabel">
+        <constraints>
+          <grid row="3" column="0" row-span="1" col-span="1" vsize-policy="0" hsize-policy="0" anchor="4" fill="0" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <text value="Description"/>
+        </properties>
+      </component>
+      <component id="4c6b" class="javax.swing.JTextPane" binding="fDescription">
+        <constraints>
+          <grid row="3" column="1" row-span="1" col-span="1" vsize-policy="6" hsize-policy="6" anchor="0" fill="3" indent="0" use-parent-layout="false">
+            <preferred-size width="150" height="50"/>
+          </grid>
+        </constraints>
+        <properties/>
+      </component>
+      <component id="9d8aa" class="javax.swing.JButton" binding="savebtn">
+        <constraints>
+          <grid row="4" column="1" row-span="1" col-span="1" vsize-policy="0" hsize-policy="3" anchor="0" fill="1" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <text value="Save"/>
+        </properties>
+      </component>
+      <component id="8ded9" class="javax.swing.JButton" binding="cancelbtn">
+        <constraints>
+          <grid row="4" column="0" row-span="1" col-span="1" vsize-policy="0" hsize-policy="3" anchor="0" fill="1" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <text value="Cancel"/>
+        </properties>
+      </component>
+    </children>
+  </grid>
+</form>

src/Clifford.java

@@ -0,0 +1,194 @@
+/*
+ *     Firestar Mod Manager
+ *     Copyright (C) 2024  bonkmaykr
+ *
+ *     This program is free software: you can redistribute it and/or modify
+ *     it under the terms of the GNU General Public License as published by
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     This program is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *     GNU General Public License for more details.
+ *
+ *     You should have received a copy of the GNU General Public License
+ *     along with this program.  If not, see https://www.gnu.org/licenses/.
+ */
+
+import net.lingala.zip4j.ZipFile;
+import net.lingala.zip4j.exception.ZipException;
+import org.json.JSONObject;
+
+import javax.swing.*;
+import javax.swing.filechooser.FileFilter;
+import javax.swing.filechooser.FileNameExtensionFilter;
+import java.awt.*;
+import java.awt.event.ActionEvent;
+import java.awt.event.ActionListener;
+import java.awt.event.WindowAdapter;
+import java.awt.event.WindowEvent;
+import java.io.File;
+
+import static javax.swing.WindowConstants.DO_NOTHING_ON_CLOSE;
+
+public class Clifford implements ActionListener {
+    private JFrame frame = new JFrame();
+    private JPanel frameContainer;
+    private JTextField fName;
+    private JTextField fAuthor;
+    private JTextField fVersion;
+    private JTextPane fDescription;
+    private JButton savebtn;
+    private JButton cancelbtn;
+
+    MissPiggy invoker;
+    Main.Mod mod;
+    int index;
+    File directory;
+
+    boolean creating;
+
+    public void Action(MissPiggy inv, int modindex) { // Editor
+        invoker = inv;
+        mod = Main.Mods.get(modindex);
+        index = modindex;
+        creating = false;
+
+        frame.add(frameContainer);
+        frame.setSize(600, 200); // 1280 800
+        frame.setMinimumSize(new Dimension(200,100));
+        frame.setTitle("Options");
+        frame.setResizable(false);
+        frame.setDefaultCloseOperation(DO_NOTHING_ON_CLOSE);
+        frame.setLayout(new GridLayout());
+        frame.setLocationRelativeTo(null);
+        frame.setAlwaysOnTop(true);
+
+        fName.setText(mod.friendlyName);
+        fAuthor.setText(mod.author);
+        fVersion.setText(String.valueOf(mod.version));
+        fDescription.setText(mod.description);
+
+        cancelbtn.addActionListener(this);
+        savebtn.addActionListener(this);
+
+        frame.setVisible(true);
+        frame.addWindowListener(new WindowAdapter() {
+            @Override
+            public void windowClosing(WindowEvent e)
+            {
+                invoker.frame.setEnabled(true);
+                e.getWindow().dispose();
+            }
+        });
+    }
+
+    public void Action(MissPiggy inv, File dir) { // Generator
+        invoker = inv;
+        directory = dir;
+        creating = true;
+
+        frame.add(frameContainer);
+        frame.setSize(600, 200); // 1280 800
+        frame.setMinimumSize(new Dimension(200,100));
+        frame.setTitle("Options");
+        frame.setResizable(false);
+        frame.setDefaultCloseOperation(DO_NOTHING_ON_CLOSE);
+        frame.setLayout(new GridLayout());
+        frame.setLocationRelativeTo(null);
+        frame.setAlwaysOnTop(true);
+
+        cancelbtn.addActionListener(this);
+        savebtn.addActionListener(this);
+
+        frame.setVisible(true);
+        frame.addWindowListener(new WindowAdapter() {
+            @Override
+            public void windowClosing(WindowEvent e)
+            {
+                invoker.frame.setEnabled(true);
+                e.getWindow().dispose();
+            }
+        });
+    }
+
+    @Override
+    public void actionPerformed(ActionEvent actionEvent) {
+        if (actionEvent.getSource() == cancelbtn) {
+            invoker.frame.setEnabled(true);
+            frame.dispose();
+        } else if (actionEvent.getSource() == savebtn && !creating) {
+            try {
+                mod.version = Integer.parseInt(fVersion.getText());
+            } catch (NumberFormatException e) {
+                JOptionPane.showMessageDialog(frame, "Mod version must be a valid integer.", "Error", JOptionPane.ERROR_MESSAGE);
+                return;
+            }
+            mod.friendlyName = fName.getText();
+            mod.author = fAuthor.getText();
+            mod.description = fDescription.getText();
+
+            JSONObject container = new JSONObject();
+            container.put("version", mod.version);
+            container.put("friendlyName", mod.friendlyName);
+            container.put("author", mod.author);
+            container.put("description", mod.description);
+            container.put("loaderversion", mod.loaderversion);
+            container.put("game", mod.game);
+
+            try {
+                new ZipFile(System.getProperty("user.home") + "/.firestar/mods/" + mod.path.trim()).setComment(container.toString());
+            } catch (ZipException e) {
+                System.out.println(e.getMessage());
+                JOptionPane.showMessageDialog(frame, "An error has occured.\n" + e.getMessage(), "Error", JOptionPane.ERROR_MESSAGE);
+            }
+
+            Main.Mods.set(index, mod);
+            invoker.frame.setEnabled(true);
+            invoker.InitializeModListInGUI();
+            frame.dispose();
+        } else if (actionEvent.getSource() == savebtn && creating) {
+            try {
+                Integer.parseInt(fVersion.getText());
+            } catch (NumberFormatException e) {
+                JOptionPane.showMessageDialog(frame, "Mod version must be a valid integer.", "Error", JOptionPane.ERROR_MESSAGE);
+                return;
+            }
+
+            JFileChooser fileChooser = new JFileChooser();
+            fileChooser.setFileFilter(new FileNameExtensionFilter("Firestar Mod Package", "fstar"));
+            if (fileChooser.showSaveDialog(frame) == JFileChooser.APPROVE_OPTION) {
+                ZipFile zip = new ZipFile(fileChooser.getSelectedFile());
+                try {
+                    zip.addFolder(new File(directory.getAbsolutePath() + "/data"));
+                    if (new File(directory.getAbsolutePath() + "/delete.txt").exists()) {
+                        zip.addFile(new File(directory.getAbsolutePath() + "/delete.txt"));
+                    }
+                    if (new File(directory.getAbsolutePath() + "/pack.png").exists()) {
+                        zip.addFile(new File(directory.getAbsolutePath() + "/pack.png"));
+                    }
+
+                    JSONObject container = new JSONObject();
+                    container.put("version", Integer.parseInt(fVersion.getText()));
+                    container.put("friendlyName", fName.getText());
+                    container.put("author", fAuthor.getText());
+                    container.put("description", fDescription.getText());
+                    container.put("loaderversion", 0); // TODO for later versions: Change depending on features inside of mod folder
+                    container.put("game", "2048");
+
+                    zip.setComment(container.toString());
+                    zip.close();
+                } catch (Exception e) {
+                    fileChooser.getSelectedFile().delete(); //cleanup
+                    System.out.println(e.getMessage());
+                    JOptionPane.showMessageDialog(frame, "An error has occured.\n" + e.getMessage(), "Error", JOptionPane.ERROR_MESSAGE);
+                    return;
+                }
+                JOptionPane.showMessageDialog(frame, "Mod file created", "Success", JOptionPane.INFORMATION_MESSAGE);
+                invoker.frame.setEnabled(true);
+                frame.dispose();
+            }
+        }
+    }
+}

src/Kermit.java

@@ -210,9 +210,8 @@ public class Kermit implements ActionListener {
                 document.setParagraphAttributes(0, document.getLength(), align, false);
                 //dialogText.setText("Aww Fiddlesticks, what now?");
                 dialogText.setText("WELCOME TO FIRESTAR\n\n" +
-                        "This initial setup guide will help you prepare your Playstation Vita, Playstation TV, or Vita3K emulator to play WipEout mods. You will be asked a series of questions to help Firestar decide the most optimal installation method for you.\n\n" +
-                        "If you encounter any issues while using Firestar you may contact the author at bonkmaykr@screwgravity.net\n\n" +
-                        "DISCLAIMER: This program is free software licensed under the GNU General Public License version 3.0. You may share this program and it's source code so long as you extend the same rights to others. The developers of this software are never responsible for any damage to your game console and Firestar is provided to you without any warranty or legal guarantee. By using Firestar, you agree to these terms. For more information, visit https://www.gnu.org/licenses/gpl-3.0.en.html");
+                        "This initial setup guide will help you prepare your Playstation Vita, Playstation TV, or Vita3K emulator to play WipEout mods.\n\n Before continuing, please read the decryption guide at:\nhttps://git.worlio.com/bonkmaykr/firestar/wiki/Decrypting-Original-PSARC-Files\nsince you will need these files in order to use Firestar.\n\n" +
+                        "If you encounter any issues while using Firestar you may contact the author at bonkmaykr@screwgravity.net");
                 frame.add(dialogText);
 
                 frame.setSize(600, 400);
@@ -231,7 +230,7 @@ public class Kermit implements ActionListener {
                 button.setBounds(292, 343, 300, 30);
                 frame.add(button);
 
-                button3.setVisible(true);
+                button3.setVisible(false);
                 button3.setBounds(0, 343, 292, 30);
                 frame.add(button3);
 
@@ -351,7 +350,7 @@ public class Kermit implements ActionListener {
                 button.setBounds(292, 343, 300, 30);
                 frame.add(button);
 
-                button3.setVisible(true);
+                button3.setVisible(false);
                 button3.setBounds(0, 343, 292, 30);
                 frame.add(button3);
 
@@ -391,7 +390,7 @@ public class Kermit implements ActionListener {
                 button.setBounds(292, 343, 300, 30);
                 frame.add(button);
 
-                button3.setVisible(true);
+                button3.setVisible(false);
                 button3.setBounds(0, 343, 292, 30);
                 frame.add(button3);
 
@@ -405,7 +404,7 @@ public class Kermit implements ActionListener {
                 dialogText.setText("You're almost done!\n\n" +
                         "Please move all of your original PSARC files for WipEout (base game, patches, and HD Fury DLC) to the config folder and press Next when you are done.\n" +
                         "Firestar will use these to generate new PSARCs in place of the old ones.\n\n" +
-                        "If you play on a real console, you will need to use VitaShell (remember to \"Open Decrypted\"). Check /app, /patch, and /addcont. Getting all of them is important since WipEout always loads them in a specific order and which ones you have determines where Firestar can compress the modified files to.");
+                        "If you do not already have these files, please read:\nhttps://git.worlio.com/bonkmaykr/firestar/wiki/Decrypting-Original-PSARC-Files\nto acquire them.");
                 frame.add(dialogText);
 
                 //pathInput.setVisible(true);
@@ -449,7 +448,7 @@ public class Kermit implements ActionListener {
                 StyleConstants.setAlignment(align, StyleConstants.ALIGN_CENTER);
                 document.setParagraphAttributes(0, document.getLength(), align, false);
                 dialogText.setText("Firestar is ready!\n\n" +
-                        "For technical support, email\nbonkmaykr@screwgravity.net.");
+                        "For technical support, see Help > Manual.");
                 frame.add(dialogText);
 
                 button.setVisible(true);

src/Main.java

@@ -18,15 +18,17 @@
 
 import org.json.*;
 
+import java.awt.*;
 import java.io.*;
 import java.nio.file.*;
 import java.util.*;
+import java.util.List;
 import javax.swing.JOptionPane;
 
 public class Main {
     // Build Information
-    public static final String vstr = "Beta 4";
-    public static final String vcode = "Natasha";
+    public static final String vstr = "Release 1.1";
+    public static final String vcode = "Dekka";
     public static final int vint = 0;
 
     // User Settings
@@ -54,9 +56,12 @@ public class Main {
     // Mods
     public static List<Mod> Mods = new ArrayList<Mod>();
 
+    // UI Global Assets
+    public static Font fExo2;
+
     public static void main(String[] args) {
         // license string
-        System.out.printf("FIRESTAR MOD MANAGER for WipEout 2048\nversion " + vstr + " (codename " + vcode + ")\n" +
+        System.out.printf("FIRESTAR MOD MANAGER for WipEout 2048\nversion " + vstr + " (codename " + vcode + ") major " + vint + "\n" +
                 "JVM host appears to be " + System.getProperty("os.name") +
                 "\nRunning from " + System.getProperty("user.dir") +
                 "\nCopyright (C) 2024  bonkmaykr\n\nThis program is free software: you can redistribute it and/or modify\n" +
@@ -73,6 +78,14 @@ public class Main {
                 "along with this program.  If not, see https://www.gnu.org/licenses/.\n\n\n\n");
 
         //begin
+        // load global assets
+        try {
+            fExo2 = Font.createFont(Font.TRUETYPE_FONT, new File(System.getProperty("user.dir") + "/resources/exo2.ttf"));
+        } catch (Exception e) {
+            System.out.println("Font \"Exo 2\" is missing!");
+            fExo2 = new Font("Arial", Font.PLAIN, 12);
+        }
+
         // check and load configs
         File fConf = new File(System.getProperty("user.home") + "/.firestar/firestar.conf");
         if (!fConf.isFile()) {

src/MasterWindowLayout.form

@@ -5,7 +5,10 @@
     <constraints>
       <xy x="20" y="20" width="500" height="400"/>
     </constraints>
-    <properties/>
+    <properties>
+      <background color="-1"/>
+      <foreground color="-592129"/>
+    </properties>
     <border type="none"/>
     <children>
       <grid id="6cdb1" binding="descriptionContainer" layout-manager="GridLayoutManager" row-count="1" column-count="1" same-size-horizontally="false" same-size-vertically="false" hgap="-1" vgap="-1">
@@ -17,7 +20,10 @@
             <maximum-size width="300" height="-1"/>
           </grid>
         </constraints>
-        <properties/>
+        <properties>
+          <background color="-526337"/>
+          <foreground color="-592129"/>
+        </properties>
         <border type="line" title="Description"/>
         <children>
           <component id="a9cee" class="javax.swing.JTextPane" binding="descriptionField">
@@ -38,7 +44,10 @@
         <constraints>
           <grid row="0" column="1" row-span="2" col-span="1" vsize-policy="7" hsize-policy="7" anchor="0" fill="3" indent="0" use-parent-layout="false"/>
         </constraints>
-        <properties/>
+        <properties>
+          <background color="-526337"/>
+          <foreground color="-526337"/>
+        </properties>
         <border type="line" title="Mods List" title-justification="1" title-position="2">
           <font/>
         </border>
@@ -64,7 +73,10 @@
             <maximum-size width="300" height="200"/>
           </grid>
         </constraints>
-        <properties/>
+        <properties>
+          <background color="-526337"/>
+          <foreground color="-657921"/>
+        </properties>
         <border type="line" title="Actions"/>
         <children>
           <component id="3cd60" class="javax.swing.JButton" binding="toggleButton" default-binding="true">
@@ -75,6 +87,10 @@
               </grid>
             </constraints>
             <properties>
+              <background color="-15128227"/>
+              <borderPainted value="false"/>
+              <font name="Exo 2" style="1"/>
+              <foreground color="-657921"/>
               <text value="Toggle"/>
             </properties>
           </component>
@@ -86,6 +102,10 @@
               </grid>
             </constraints>
             <properties>
+              <background color="-15128227"/>
+              <borderPainted value="false"/>
+              <font name="Exo 2" style="1"/>
+              <foreground color="-657921"/>
               <text value="Move Up"/>
             </properties>
           </component>
@@ -98,6 +118,11 @@
               </grid>
             </constraints>
             <properties>
+              <alignmentX value="0.0"/>
+              <background color="-15128227"/>
+              <borderPainted value="false"/>
+              <font name="Exo 2" style="1"/>
+              <foreground color="-657921"/>
               <text value="Delete"/>
             </properties>
           </component>
@@ -110,6 +135,10 @@
               </grid>
             </constraints>
             <properties>
+              <background color="-15128227"/>
+              <borderPainted value="false"/>
+              <font name="Exo 2" style="1"/>
+              <foreground color="-592129"/>
               <text value="Move Down"/>
             </properties>
           </component>
@@ -120,6 +149,10 @@
               </grid>
             </constraints>
             <properties>
+              <background color="-15128227"/>
+              <borderPainted value="false"/>
+              <font name="Exo 2" style="1"/>
+              <foreground color="-592129"/>
               <text value="Options"/>
             </properties>
           </component>
@@ -130,6 +163,10 @@
               </grid>
             </constraints>
             <properties>
+              <background color="-15128227"/>
+              <borderPainted value="false"/>
+              <font name="Exo 2" style="1"/>
+              <foreground color="-526337"/>
               <text value="Import"/>
             </properties>
           </component>
@@ -141,6 +178,10 @@
               </grid>
             </constraints>
             <properties>
+              <background color="-15128227"/>
+              <borderPainted value="false"/>
+              <font name="Exo 2" style="1"/>
+              <foreground color="-657921"/>
               <text value="Deploy"/>
             </properties>
           </component>

src/MissPiggy.java

@@ -41,6 +41,7 @@ import java.util.Random;
 import java.util.regex.Pattern;
 import net.lingala.zip4j.*;
 import net.lingala.zip4j.exception.ZipException;
+import org.json.JSONException;
 import org.json.JSONObject;
 import static java.nio.file.StandardCopyOption.*;
 
@@ -103,6 +104,8 @@ public class MissPiggy implements ActionListener {
         toolsMenu.add(new JMenuItem("Create Soundtrack Mod..."));
         //toolsMenu.add(new JMenuItem("Download Mod from URL")); // TODO: implement. move option to File menu. should be ez
 
+        helpMenu.add(new JMenuItem("Manual"));
+        helpMenu.add(new JSeparator());
         helpMenu.add(new JMenuItem("Source Code")); //replace with Website 'screwgravity.net' and 'Issue Tracker' gitea later
         helpMenu.add(new JMenuItem("License"));
         helpMenu.add(new JSeparator());
@@ -128,8 +131,9 @@ public class MissPiggy implements ActionListener {
         toolsMenu.getItem(1).addActionListener(this);
         toolsMenu.getItem(2).addActionListener(this);
         helpMenu.getItem(0).addActionListener(this);
-        helpMenu.getItem(1).addActionListener(this);
+        helpMenu.getItem(2).addActionListener(this);
         helpMenu.getItem(3).addActionListener(this);
+        helpMenu.getItem(5).addActionListener(this);
 
         deployButton.addActionListener(this);
         importButton.addActionListener(this);
@@ -148,6 +152,23 @@ public class MissPiggy implements ActionListener {
         } catch (IOException e) {
             System.out.println("ERROR: Failed to find /resources/titleIcon.png. Window will not have an icon.");
         }
+
+        menuBar.setBackground(new Color(25, 41, 93));
+        fileMenu.setForeground(new Color(255, 255, 255));
+        fileMenu.setFont(Main.fExo2.deriveFont(Font.BOLD).deriveFont(12f));
+        toolsMenu.setForeground(new Color(255, 255, 255));
+        toolsMenu.setFont(Main.fExo2.deriveFont(Font.BOLD).deriveFont(12f));
+        helpMenu.setForeground(new Color(255, 255, 255));
+        helpMenu.setFont(Main.fExo2.deriveFont(Font.BOLD).deriveFont(12f));
+
+        toggleButton.setFont(Main.fExo2.deriveFont(Font.BOLD).deriveFont(12f));
+        deleteButton1.setFont(Main.fExo2.deriveFont(Font.BOLD).deriveFont(12f));
+        moveDownButton.setFont(Main.fExo2.deriveFont(Font.BOLD).deriveFont(12f));
+        moveUpButton.setFont(Main.fExo2.deriveFont(Font.BOLD).deriveFont(12f));
+        optionsButton.setFont(Main.fExo2.deriveFont(Font.BOLD).deriveFont(12f));
+        importButton.setFont(Main.fExo2.deriveFont(Font.BOLD).deriveFont(12f));
+        deployButton.setFont(Main.fExo2.deriveFont(Font.BOLD).deriveFont(12f));
+
         frame.setSize(800, 600); // 1280 800
         frame.setMinimumSize(new Dimension(640,480));
         frame.setTitle("Firestar Mod Manager");
@@ -300,11 +321,19 @@ public class MissPiggy implements ActionListener {
         if (actionEvent.getSource() == toggleButton) {toggleSelected(modList.getSelectedIndex());} else
         if (actionEvent.getSource() == deleteButton1) {deleteSelected();} else
 
-        if (actionEvent.getSource() == toolsMenu.getItem(0)) {throwUnimplemented();} else
-        if (actionEvent.getSource() == toolsMenu.getItem(1)) {throwUnimplemented();} else
+        if (actionEvent.getSource() == toolsMenu.getItem(0)) {metaEditorGUI(modList.getSelectedIndex());} else
+        if (actionEvent.getSource() == toolsMenu.getItem(1)) {generatorGUI();} else
         if (actionEvent.getSource() == toolsMenu.getItem(2)) {throwUnimplemented();} else
 
         if (actionEvent.getSource() == helpMenu.getItem(0)) {
+            try {
+                Desktop.getDesktop().browse(new URI("https://git.worlio.com/bonkmaykr/firestar/wiki/"));
+            } catch (Exception e) {
+                System.out.println(e.getMessage());
+                JOptionPane.showMessageDialog(frame, e.getMessage(), "Error", JOptionPane.ERROR_MESSAGE);
+            }
+        } else
+        if (actionEvent.getSource() == helpMenu.getItem(2)) {
             try {
                 Desktop.getDesktop().browse(new URI("https://git.worlio.com/bonkmaykr/firestar"));
             } catch (Exception e) {
@@ -312,7 +341,7 @@ public class MissPiggy implements ActionListener {
                 JOptionPane.showMessageDialog(frame, e.getMessage(), "Error", JOptionPane.ERROR_MESSAGE);
             }
         } else
-        if (actionEvent.getSource() == helpMenu.getItem(1)) {
+        if (actionEvent.getSource() == helpMenu.getItem(3)) {
             try {
                 Desktop.getDesktop().browse(new URI("https://www.gnu.org/licenses/gpl-3.0.en.html"));
             } catch (Exception e) {
@@ -320,7 +349,7 @@ public class MissPiggy implements ActionListener {
                 JOptionPane.showMessageDialog(frame, e.getMessage(), "Error", JOptionPane.ERROR_MESSAGE);
             }
         } else
-        if (actionEvent.getSource() == helpMenu.getItem(3)) {new Rowlf().displayAboutScreen();}
+        if (actionEvent.getSource() == helpMenu.getItem(5)) {new Rowlf().displayAboutScreen();}
     }
 
     // Will likely split the below functions into separate classes to work with intellij GUI designer.
@@ -357,7 +386,7 @@ public class MissPiggy implements ActionListener {
         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?
+        fileChooser.addChoosableFileFilter(new FileNameExtensionFilter("Firestar Mod Package", "fstar"));
 
         int result = fileChooser.showOpenDialog(frame);
 
@@ -365,28 +394,37 @@ public class MissPiggy implements ActionListener {
             File selectedFile = fileChooser.getSelectedFile();
             System.out.println("Importing selected mod file \"" + selectedFile.getName() + "\"");
 
-            ZipFile zipImporterHandler = new ZipFile(selectedFile.getPath());
+            ZipFile zipImporterHandler = new ZipFile(selectedFile.getAbsolutePath());
             if (zipImporterHandler.isValidZipFile()) {
                 try {
-                    Path importDestination = Paths.get(System.getProperty("user.home") + "/.firestar/mods/"
+                    JSONObject json = new JSONObject(new ZipFile(selectedFile.getAbsolutePath()).getComment()); // intentionally trigger exception if file is random BS
+                    if ((int)json.get("loaderversion") <= Main.vint) {
+                        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();
+                        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();
+                        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();
+                        InitializeModListStructure();
+                        InitializeModListInGUI();
+                    } else {
+                        System.out.println("ERROR: This mod requires feature level " + json.get("loaderversion").toString() + ", but you have level " + Main.vint + ".");
+                        JOptionPane.showMessageDialog(frame, "This mod requires feature level " + json.get("loaderversion").toString() + ", but you have level " + Main.vint + ".\nPlease update Firestar to the latest version.", "Error", JOptionPane.ERROR_MESSAGE);
+                    }
+                } catch (JSONException e) {
+                    System.out.println("ERROR: File is not a valid ZIP archive with mod data. Aborting.");
+                    JOptionPane.showMessageDialog(frame, "Whoops, that's not a valid mod file.", "Error", JOptionPane.ERROR_MESSAGE);
                 } 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);
+                System.out.println("ERROR: File is not a valid ZIP archive with mod data. Aborting.");
+                JOptionPane.showMessageDialog(frame, "Whoops, that's not a valid mod file.", "Error", JOptionPane.ERROR_MESSAGE);
             }
         }
     }
@@ -405,8 +443,8 @@ public class MissPiggy implements ActionListener {
     }
 
     public void optionsGUI() {
-        // todo settings page w/ reset switch
-        throwUnimplemented();
+        new Waldorf().Action(this);
+        frame.setEnabled(false);
     }
 
     public void deleteSelected() {
@@ -415,6 +453,7 @@ public class MissPiggy implements ActionListener {
             file.delete();
             System.out.println("Deleted " + Main.Mods.get(modList.getSelectedIndex()).friendlyName); //debug
             Main.Mods.remove(modList.getSelectedIndex());
+            regenerateModBlacklist(false);
             regenerateModIndex(true);
         } else {
             JOptionPane.showMessageDialog(frame, "Please select a mod to delete first.", "Error", JOptionPane.ERROR_MESSAGE);
@@ -422,13 +461,28 @@ public class MissPiggy implements ActionListener {
     }
 
     public void generatorGUI() {
-        // todo mod packer
-        throwUnimplemented();
+        JFileChooser fileChooser = new JFileChooser();
+        fileChooser.setFileSelectionMode(JFileChooser.DIRECTORIES_ONLY);
+        int result = fileChooser.showOpenDialog(frame);
+        if (result == JFileChooser.APPROVE_OPTION) {
+            if (fileChooser.getSelectedFile().isDirectory()
+            && new File(fileChooser.getSelectedFile().getAbsolutePath() + "/data").isDirectory()) {
+                File file = fileChooser.getSelectedFile();
+                new Clifford().Action(this, file);
+                frame.setEnabled(false);
+            } else {
+                JOptionPane.showMessageDialog(frame, "You must select a folder containing a \"data\" directory with game assets.", "Error", JOptionPane.ERROR_MESSAGE);
+            }
+        }
     }
 
-    public void metaEditorGUI() {
-        // todo tag editor
-        throwUnimplemented();
+    public void metaEditorGUI(int index) {
+        if (index >= 0) {
+            new Clifford().Action(this, index);
+            frame.setEnabled(false);
+        } else {
+            JOptionPane.showMessageDialog(frame, "Please select a mod to edit first.", "Error", JOptionPane.ERROR_MESSAGE);
+        }
     }
 
     private void moveUp(int index) {

src/Waldorf.form

@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<form xmlns="http://www.intellij.com/uidesigner/form/" version="1" bind-to-class="Waldorf">
+  <grid id="27dc6" binding="frameContainer" layout-manager="GridLayoutManager" row-count="5" column-count="3" same-size-horizontally="false" same-size-vertically="false" hgap="-1" vgap="-1">
+    <margin top="0" left="0" bottom="0" right="0"/>
+    <constraints>
+      <xy x="20" y="20" width="500" height="400"/>
+    </constraints>
+    <properties>
+      <maximumSize width="50" height="100"/>
+      <minimumSize width="50" height="100"/>
+      <preferredSize width="50" height="100"/>
+    </properties>
+    <border type="none"/>
+    <children>
+      <component id="3d88f" class="javax.swing.JButton" binding="okbtn">
+        <constraints>
+          <grid row="4" column="2" row-span="1" col-span="1" vsize-policy="0" hsize-policy="0" anchor="0" fill="0" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <text value="Save"/>
+        </properties>
+      </component>
+      <component id="86775" class="javax.swing.JTextField" binding="fOutpath">
+        <constraints>
+          <grid row="3" column="1" row-span="1" col-span="2" vsize-policy="0" hsize-policy="7" anchor="0" fill="1" indent="0" use-parent-layout="false">
+            <preferred-size width="150" height="-1"/>
+          </grid>
+        </constraints>
+        <properties/>
+      </component>
+      <component id="db731" class="javax.swing.JLabel">
+        <constraints>
+          <grid row="3" column="0" row-span="1" col-span="1" vsize-policy="0" hsize-policy="0" anchor="4" fill="0" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <text value="Mod Export Path"/>
+        </properties>
+      </component>
+      <component id="50d13" class="javax.swing.JButton" binding="cancelbtn">
+        <constraints>
+          <grid row="4" column="0" row-span="1" col-span="1" vsize-policy="0" hsize-policy="0" anchor="0" fill="0" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <text value="Cancel"/>
+        </properties>
+      </component>
+      <component id="252b3" class="javax.swing.JButton" binding="resetbtn">
+        <constraints>
+          <grid row="4" column="1" row-span="1" col-span="1" vsize-policy="0" hsize-policy="0" anchor="0" fill="0" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <text value="Restore Defaults"/>
+        </properties>
+      </component>
+      <component id="e2cd7" class="javax.swing.JLabel">
+        <constraints>
+          <grid row="0" column="0" row-span="3" col-span="1" vsize-policy="0" hsize-policy="0" anchor="4" fill="0" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <text value=".firestar Folder"/>
+        </properties>
+      </component>
+      <component id="c68f2" class="javax.swing.JButton" binding="bOpenFolder">
+        <constraints>
+          <grid row="0" column="1" row-span="3" col-span="2" vsize-policy="0" hsize-policy="7" anchor="0" fill="1" indent="0" use-parent-layout="false"/>
+        </constraints>
+        <properties>
+          <label value="Browse"/>
+          <text value="Browse"/>
+        </properties>
+      </component>
+    </children>
+  </grid>
+</form>

src/Waldorf.java

@@ -0,0 +1,104 @@
+/*
+ *     Firestar Mod Manager
+ *     Copyright (C) 2024  bonkmaykr
+ *
+ *     This program is free software: you can redistribute it and/or modify
+ *     it under the terms of the GNU General Public License as published by
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     This program is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *     GNU General Public License for more details.
+ *
+ *     You should have received a copy of the GNU General Public License
+ *     along with this program.  If not, see https://www.gnu.org/licenses/.
+ */
+
+import org.json.JSONObject;
+
+import javax.swing.*;
+import java.awt.*;
+import java.awt.event.ActionEvent;
+import java.awt.event.ActionListener;
+import java.awt.event.WindowAdapter;
+import java.awt.event.WindowEvent;
+import java.io.File;
+import java.io.IOException;
+
+import static javax.swing.WindowConstants.DO_NOTHING_ON_CLOSE;
+
+public class Waldorf implements ActionListener {
+    private JFrame frame = new JFrame();
+    private JPanel frameContainer;
+    private JButton okbtn;
+    private JButton cancelbtn;
+    private JTextField fOutpath;
+    private JButton resetbtn;
+    private JButton bOpenFolder;
+    MissPiggy invoker;
+
+    public void Action(MissPiggy inv) {
+        invoker = inv;
+
+        frame.add(frameContainer);
+        frame.setSize(600, 200); // 1280 800
+        frame.setMinimumSize(new Dimension(200,100));
+        frame.setTitle("Options");
+        frame.setResizable(false);
+        frame.setDefaultCloseOperation(DO_NOTHING_ON_CLOSE);
+        frame.setLayout(new GridLayout());
+        frame.setLocationRelativeTo(null);
+        frame.setAlwaysOnTop(true);
+
+        cancelbtn.addActionListener(this);
+        okbtn.addActionListener(this);
+        resetbtn.addActionListener(this);
+        bOpenFolder.addActionListener(this);
+
+        fOutpath.setText(Main.outpath);
+
+        frame.setVisible(true);
+        frame.addWindowListener(new WindowAdapter() {
+            @Override
+            public void windowClosing(WindowEvent e)
+            {
+                invoker.frame.setEnabled(true);
+                e.getWindow().dispose();
+            }
+        });
+    }
+
+    @Override
+    public void actionPerformed(ActionEvent actionEvent) {
+        if (actionEvent.getSource() == cancelbtn) {
+            invoker.frame.setEnabled(true);
+            frame.dispose();
+        } else
+        if (actionEvent.getSource() == okbtn) {
+            Main.outpath = fOutpath.getText();
+            Main.writeConf();
+
+            invoker.frame.setEnabled(true);
+            frame.dispose();
+        } else
+        if (actionEvent.getSource() == resetbtn) {
+            int result = JOptionPane.showConfirmDialog(frame,"Are you sure you want to redo the initial setup?", "Restore Default Settings", JOptionPane.YES_NO_OPTION, JOptionPane.WARNING_MESSAGE);
+            if (result == JOptionPane.YES_OPTION) {
+                new File(System.getProperty("user.home") + "/.firestar/firestar.conf").delete();
+                int result2 = JOptionPane.showConfirmDialog(frame,"Firestar will now close.", "Restore Default Settings", JOptionPane.DEFAULT_OPTION, JOptionPane.INFORMATION_MESSAGE);
+                if (result2 == JOptionPane.OK_OPTION) {
+                    System.exit(0);
+                }
+            }
+        } else
+        if (actionEvent.getSource() == bOpenFolder) {
+            try {
+                Desktop.getDesktop().open(new File(Main.inpath));
+            } catch (IOException e) {
+                throw new RuntimeException(e);
+            }
+        }
+    }
+}