V4.0.5 Trash limit warning and prompt are now fully functional.

The trash limit warning preference now functions.
- "Log" will log a warning in the console.
- "Prompt" will create a JOptionDialog warning the trash limit has been exceeded and prompts to do a clean now.

Fixed ComboBox type QuestionCards not auto-populating their data when given an index instead of a text value. This was done because I prefer to strore the index value of combo boxes for preferences.
This still supports being given a text value. How it works is that if the given value is not in the value options, it will try cast to an Integer and set the selectedIndex to it.

Fixed the quick-trash not actually using the preference values.

Fixed mods not loading for only the **first** attempted on boot. Well, it was loading but it would not re-draw unless something was clicked on.
Now it will always update using a property change listener.

Logs now include seconds.

Updated the README to reflect some new features.
Updated the FAQ to have some more relevant info for modders.

Author: Onberg47

README.md

@@ -51,6 +51,7 @@ The goal is to create a practical project for both real-world usage but also as
   - Verify files Hashes match to detect changes and avoid unnecessary file system operations.
 - In case of final write failures, data stored in temp is recoverable (temp/ cleaning only takes place when no errors occur)
 - Visual feedback (Console) Actions are carefully logged, allowing exact failure pinpointing.
+- Trash utility: Manage the max size and number of days old trash files can be with automatic warnings and prompts to clean or empty trash files.
 
 ### Mods: 
 - Track, add, remove and update Mods deployed into a game.
@@ -63,6 +64,9 @@ The goal is to create a practical project for both real-world usage but also as
   - Version number.
   - Download information. Store a download URL and tag the download source (eg: Nexus, ModDB, Steam, custom...)
   - Add tags to mods for GUI sorting and filtering.
+- Intuative updating. Mods can be updated easily at anytime, handling re-deployment automatically.
+  Updates can provide new files or the exsisting files will be re-compiled.
+  For modders, this makes tweaking/updating mods on the go for testing fast and painless. See the [FAQ](docs/FAQ.md) for more.
 
 ### Games: 
 - Stores a current GameState with the game, all data needed to track and remove deployed Mods is stored within the game directory.
@@ -86,11 +90,11 @@ The goal is to create a practical project for both real-world usage but also as
 ### GUI
 - Tile view of games with icons.
 - Manage Mods with a Card design to display mod info clearly.
-- Download link for mods will be a clickable link.
 - Interactive way to reorder mods by dragging mod tiles.
 - Enable/disable mods by dragging them to and from the deployed/stored containers.
+- Download link for mod are a clickable hyper-link.
 - All file/directory input fields allow Drag-and-Drop.
-- Write changes to a temp GameState or pick from saved profiles. Then Apply the GameState when ready. (TODO)
+- Write changes to a temp GameState or pick from saved profiles. Then Apply the GameState when ready.
 
 ### CLI Usage:
 The CLI offers an interactive interface to perform all the core operations for managing Games and Mods.

docs/FAQ.md

@@ -3,7 +3,7 @@
 - ### What do I need to run FCMM?
     All you need is a Java runtime. Ideally version 25 or newer.<br>
     Changes in version 22 to `Java.nio` for Path handling made this project way cleaner but also not compatible with older runtimes.<br>
-    All dependencies are very small (currently 1) and are hence bundled with the .jar file.
+    All dependencies are very small (currently 1) and are hence bundled with the .jar file so you won't need anything else.
 
 - ### How do I install and run FCMM?
 
@@ -64,8 +64,15 @@
 - ### Should I use this instead of Vortex from Nexus?
     No -well, it depends.<br>
     Vortex uses a virtual file-system (VFS) to deploy games within. In short, this means that when a game want say, file *A* the VFS could point that path to anywhere else, leading it to file *B* without the game necessarily knowing.<br>
-    Why does this matter? It is unquestionably safer, and way faster when running the mod launcher simply because no files are actually moved or replaced. Its simply a different approach with different limitations.
+    Why does this matter? It is unquestionably safer, and way faster when running the mod launcher, simply because no files are actually moved or replaced. Its simply a different approach with different limitations.
 
 - ### But when *should* I use FCMM?
     While using a virtual file-system is "better", its not always supported. Some games cannot run in a VFS or their anti-cheat flags it as a problem. Or Vortex might not have an extension for your game!<br>
     In those cases, I recommend using FCMM, that is what it is made for and what I personally use it for.
+
+- ### I'm a modder, what do I need to know?
+    For modder, FCMM makes it easy to update mods quickly and seamlessly.<br>
+    If you have a custom mod, what you should do is add it to FCMM, so the launcher handles its deployment. Then when you want to make changes to the mod:
+    - Edit the mod-data **inside** your Mod Storage, editting the compiled mod-data for FCMM.
+    - Doing this, to update the mod simply click "Edit", *switch to "Update"* and "Save".
+    - **Done!** The mod will be automatically re-compiled using the exsisting data and re-deployed to the game with the same load order as before.

fcmm/src/core/config/AppConfig.java

@@ -23,7 +23,7 @@ public final class AppConfig {
     /// Core:
     // #region
 
-    private final String AppVersion = "4.0.4"; // Program's version
+    private final String AppVersion = "4.0.5"; // Program's version
 
     private static final Path configPath = defaultConfig.CONFIG_FILE_PATH;
 

fcmm/src/core/config/AppPreferences.java

@@ -26,7 +26,7 @@ public enum properties {
 
         NORMALISE_BY_GROUP("NORMALISE_BY_GROUP", "Normalise mods by groups", true),
 
-        TRASH_SIZE_WARNING("TRASH_SIZE_WARNING", "Trash size limit warning", "off"),
+        TRASH_SIZE_WARNING("TRASH_SIZE_WARNING", "Trash size limit warning", 0),
         TRASH_SIZE_LIMIT("TRASH_SIZE_LIMIT", "Trash size limit", 100),
         TRASH_DAYS_OLD("TRASH_DAYS_OLD", "Trash days old limit", 30);
 

fcmm/src/core/utils/DateUtil.java

@@ -25,7 +25,7 @@ public class DateUtil {
     // For display in GUI: Dec 13, 2024 7:26 PM
     private static final DateTimeFormatter DISPLAY_FORMATTER = DateTimeFormatter.ofPattern("MMM dd, yyyy h:mm a");
 
-    private static final DateTimeFormatter TIMESTAMP_FORMATTER = DateTimeFormatter.ofPattern("MMM dd, yyyy h:mm a");
+    private static final DateTimeFormatter TIMESTAMP_FORMATTER = DateTimeFormatter.ofPattern("MMM dd, yyyy h:mm:ss");
 
     // For JSON (ISO): 2024-12-13T19:26:00Z (keep this for serialization!)
     private static final DateTimeFormatter ISO_FORMATTER = DateTimeFormatter.ISO_INSTANT;

fcmm/src/core/utils/TrashUtil.java

@@ -101,10 +101,15 @@ public static void cleanTrash(long maxMegabytes, LocalDate cutoffDate) {
 
     /// /// /// Utilities /// /// ///
 
-    private static float megabyte(Long bytes) {
+    public static float megabyte(Long bytes) {
         return bytes / (1000000.0f);
     }
 
+    /**
+     * 
+     * @param dir
+     * @return Size in bytes
+     */
     public static long getDiskSize(Path dir) {
         Long size = 0L;
         try {

fcmm/src/gui/App.java

@@ -120,12 +120,15 @@ private JMenuBar createMenuBar() {
     ///
 
     private void quickCleanTrash() {
+        int daysOld = AppConfig.getInstance().preferences.getAsInt(properties.TRASH_DAYS_OLD);
+        int trashLimit = AppConfig.getInstance().preferences.getAsInt(properties.TRASH_SIZE_LIMIT);
+
         int result = JOptionPane.showConfirmDialog(
                 mainFrame,
                 "Permanently delete all files in trash older than "
-                        + AppConfig.getInstance().preferences.get(properties.TRASH_DAYS_OLD).toString()
+                        + daysOld
                         + " days and trim to under "
-                        + AppConfig.getInstance().preferences.get(properties.TRASH_SIZE_LIMIT).toString()
+                        + trashLimit
                         + "MB?",
                 "Clean Trash",
                 JOptionPane.YES_NO_OPTION,
@@ -140,7 +143,7 @@ private void quickCleanTrash() {
                 SwingWorker<Void, String> worker = new SwingWorker<Void, String>() {
                     @Override
                     protected Void doInBackground() throws Exception { // long-running task
-                        TrashUtil.cleanTrash(2000, LocalDate.now().minusDays(30));
+                        TrashUtil.cleanTrash(trashLimit, LocalDate.now().minusDays(daysOld));
                         return null;
                     }
 

fcmm/src/gui/components/QuestionCard.java

@@ -278,7 +278,15 @@ public void setValue(String value) {
                     return;
                 }
             }
-            // If not found, try to add it
+            // If not found, check if its a number (index)
+            try {
+                combo.setSelectedIndex(Integer.parseInt(value));
+                return;
+            } catch (Exception e) {
+                // Do nothing
+            }
+
+            // if still not found, try to add it
             try {
                 setComboBoxValue(combo, value);
                 combo.setSelectedItem(value);

fcmm/src/gui/views/ModManagerView.java

@@ -6,6 +6,7 @@
 
 import javax.swing.*;
 import java.awt.*;
+import java.time.LocalDate;
 import java.util.*;
 import java.util.List;
 import java.util.stream.Collectors;
@@ -18,11 +19,13 @@
 import gui.components.ModCard;
 import gui.components.DividerCard;
 import core.config.AppConfig;
+import core.config.AppPreferences;
 import core.config.AppPreferences.properties;
 import core.managers.ModManager;
 import core.objects.GameState;
 import core.objects.Mod;
 import core.utils.Logger;
+import core.utils.TrashUtil;
 
 /**
  * This is the primary view responsible for displaying and managing Mods.
@@ -35,6 +38,7 @@ public class ModManagerView extends BaseView {
     // Globals
     private final ModManager manager;
     private boolean modsLoading = false;
+    private final Logger log = Logger.getInstance();
 
     // UI Components
     private JPanel utilityPanel;
@@ -260,30 +264,35 @@ private void loadMods() {
         if (allMods == null) {
             modsLoading = true;
             // Async / background loading of all Mods when needed.
-            SwingWorker<Void, List<Mod>> worker = new SwingWorker<>() {
+            SwingWorker<List<Mod>, Void> worker = new SwingWorker<>() {
                 @Override
-                protected Void doInBackground() throws Exception {
-                    Logger.getInstance().info(0, null, "Fetching all mods...");
+                protected List<Mod> doInBackground() throws Exception {
+                    return manager.getAllMods();
+                }
+
+                @Override
+                protected void done() {
                     try {
-                        allMods = manager.getAllMods();
+                        allMods = get();
                     } catch (Exception e) {
-                        allMods.clear();
-                        showError("Failed to load mods", e);
+                        allMods = new ArrayList<>();
                     }
-                    publish(allMods);
-                    return null;
-                }
 
-                @Override
-                protected void process(List<List<Mod>> chunks) {
-                    Logger.getInstance().info(0, null, "Mods retrieved");
-                    SwingUtilities.invokeLater(() -> {
-                        modsLoading = false;
-                        loadMods(); // This will now be called on EDT
+                    // Listen for property changes (including state changes)
+                    addPropertyChangeListener(evt -> {
+                        if ("state".equals(evt.getPropertyName())
+                                && evt.getNewValue() == SwingWorker.StateValue.DONE) {
+
+                            SwingUtilities.invokeLater(() -> {
+                                modsLoading = false;
+                                loadMods();
+                            });
+                        }
                     });
                 }
             };
             worker.execute();
+            modListPanel.removeAll();
             modListPanel.add(new DividerCard("Loading...", Color.GRAY)); // show while loading.
             return; // don't procceed further because of loading
         }
@@ -304,7 +313,7 @@ protected Void doInBackground() throws Exception {
                             .collect(Collectors.toSet());
 
                     // Logging for future testing.
-                    Logger.getInstance().info(0, null,
+                    log.info(0, null,
                             "Filteres aplied: \n\tStatus: " + statusFilter
                                     + "\n\tName: " + nameFilter
                                     + "\n\tTags: " + tagFilters.toString());
@@ -348,7 +357,7 @@ protected Void doInBackground() throws Exception {
 
             @Override
             protected void process(List<List<Mod>> chunks) {
-                displayModList();
+                displayModList(); // This populates modListPanel and repaints once all the processing is done.
             }
 
         };
@@ -512,7 +521,7 @@ private void handleDragEnd(Mod mod) {
             Mod targetMod = findModAtPosition(mousePos);
             if (targetMod == null)
                 return;
-            Logger.getInstance().info(null, "\tDropped on: " + targetMod.getName());
+            log.info(null, "\tDropped on: " + targetMod.getName());
 
             if (targetMod != null && !targetMod.getId().equals(draggedMod.getId())) {
                 moveDraggedMod(draggedMod, targetMod); // Move draggedMod to position before targetMod in allMods
@@ -585,7 +594,7 @@ private void moveDraggedMod(Mod modToMove, Mod targetMod) {
                 modToMove.setLoadOrder(index);
         }
 
-        Logger.getInstance().info(0, null, "Dragger Mod " + modToMove.getId() + " to [" + modToMove.isEnabled()
+        log.info(0, null, "Dragger Mod " + modToMove.getId() + " to [" + modToMove.isEnabled()
                 + "] : " + modToMove.getLoadOrder());
     }
 
@@ -599,7 +608,7 @@ private void normaliseLoadOrder() {
                 .collect(Collectors.toList());
 
         if (AppConfig.getInstance().preferences.is(properties.NORMALISE_BY_GROUP)) {
-            Logger.getInstance().info(null, "Normalising by group");
+            log.info(null, "Normalising by group");
             // this allows duplicate loadorder values. All it does is ensure each group of
             // duplicates is sequential. (1,2,3...) to avoid oddly-high numbers (1,2,8...)
 
@@ -614,7 +623,7 @@ private void normaliseLoadOrder() {
                     enabledModsList.get(i).setLoadOrder(groupCnt);
             }
         } else {
-            Logger.getInstance().info(null, "Normalising sequentially");
+            log.info(null, "Normalising sequentially");
             // simply orders in sequence
             for (int i = 0; i < enabledModsList.size(); i++) {
                 enabledModsList.get(i).setLoadOrder(i + 1);
@@ -662,6 +671,39 @@ private void applyChanges() {
                 @Override
                 protected Void doInBackground() throws Exception { // long-running task
                     manager.deployGameState(gameState);
+
+                    // check for trash size limit warning
+                    int warning = AppConfig.getInstance().preferences
+                            .getAsInt(AppPreferences.properties.TRASH_SIZE_WARNING);
+                    if (warning != 0) {
+
+                        long trashLimit = AppConfig.getInstance().preferences
+                                .getAsInt(AppPreferences.properties.TRASH_SIZE_LIMIT);
+                        float trashSize = TrashUtil
+                                .megabyte(TrashUtil.getDiskSize(AppConfig.getInstance().getTrashDir()));
+
+                        if (trashLimit <= trashSize) {
+
+                            if (warning == 1) { // 1. log warning
+                                log.info(0, "ALERT: Trash Size limit of " + trashLimit + "MB has been reached!");
+                            } else if (warning == 2) { // 2. prompt
+                                // popup with options to clean trash
+
+                                int daysOld = AppConfig.getInstance().preferences.getAsInt(properties.TRASH_DAYS_OLD);
+                                String msg = String.format(
+                                        "Your trash disk-size is %.2fMB out of your limit of %dMB\nWould you like to clean now?",
+                                        trashSize, trashLimit);
+
+                                int result = JOptionPane.showConfirmDialog(
+                                        navigator.getMainFrame(), msg, "Trash Limit warning",
+                                        JOptionPane.YES_NO_OPTION,
+                                        JOptionPane.WARNING_MESSAGE);
+                                if (result == JOptionPane.YES_OPTION) {
+                                    TrashUtil.cleanTrash(trashLimit, LocalDate.now().minusDays(daysOld));
+                                }
+                            }
+                        } // if limit reached
+                    } // if warning not off
                     return null;
                 }
 

mod_manager/config.json

@@ -1,15 +1 @@
-{
-    "preferences": {
-        "TRASH_DAYS_OLD": 20,
-        "TRASH_SIZE_LIMIT": 50,
-        "NORMALISE_BY_GROUP": true,
-        "TRASH_SIZE_WARNING": 0
-    },
-    "MANAGER_DIR": ".mod_manager",
-    "GAME_DIR": "mod_manager/games",
-    "TRASH_DIR": "mod_manager/.temp/trash",
-    "DEFAULT_MOD_DIR": "/home/hdd700/Mods/#_FCMM",
-    "TEMP_DIR": "mod_manager/.temp",
-    "APP_VERSION": "4.0.4",
-    "LOG_DIR": "mod_manager/logs"
-}
+{"preferences":{"TRASH_DAYS_OLD":20,"TRASH_SIZE_LIMIT":50,"NORMALISE_BY_GROUP":true,"TRASH_SIZE_WARNING":2},"MANAGER_DIR":".mod_manager","GAME_DIR":"mod_manager/games","TRASH_DIR":"mod_manager/.temp/trash","DEFAULT_MOD_DIR":"/home/hdd700/Mods/#_FCMM","TEMP_DIR":"mod_manager/.temp","APP_VERSION":"4.0.5","LOG_DIR":"mod_manager/logs"}