spiritedusual

Better PC Game Importer This plugin automates the process of adding PC games to LaunchBox by intelligently identifying titles and executables while offering bulk folder renaming and shortcut management for titles already imported. It is designed to replace the tedious manual importing process with a smart, heuristic-driven workflow. Can link to my other plugin "The Game Scraper" to help sync folder names. Why does this exist? LaunchBox excels at automatically importing games purchased from major storefronts, but adding independent or DRM-free titles manually often requires navigating deep folder structures to find the correct executable. While some users create shortcuts and house them in a single folder to speed up the process, managing those shortcuts is still a tedious, manual task. This plugin automates that entire workflow—scanning your folders, identifying the best executables, and managing your library with minimal effort. 🚀 Key Features Effortless Bulk Importing: Add dozens of PC games to your LaunchBox library at once instead of one by one. Smart Library Matching: Automatically connects your folders to the correct game titles already in your LaunchBox collection, even if the folder names are messy. Automatic File Selection: Identifies the actual game executable while skipping over "junk" files like installers, setup tools, and uninstallers. Physical Folder Renaming: Renames your game folders on your hard drive to match the clean, professional titles found in your LaunchBox library. Centralized Shortcuts: Automatically creates and stores game shortcuts in a single folder, keeping your library paths organized and easy to move. High-Speed Scanning: Uses a "self-healing" cache to remember your folders, so re-scanning large collections takes only seconds. 📋 Requirements LaunchBox: 13.26 WindowsShortcutFactory: Required for the plugin to generate and manage desktop-style shortcuts. (INCLUDED) 🛠 Installation Instructions Extract the archive to your root Launchbox folder. 📖 How to Use 1. Open the Plugin Open the Tools menu in LaunchBox and click Better PC Game Importer. 2. Configure the Scan Select Folder(s): Choose the folder(s) where your PC games are stored. Both Imported and Non-Imported. Your folder names should match the game titles as close as possible. Platform: Select the LaunchBox platform you are importing into (e.g., "Windows"). 3. Scan and Review Run Scan: Click Scan Folders to begin the analysis. Check Status: Review the Status column. The plugin identifies games as "New Game," "In Library (Locked)," or "Update Link". Fix Matches: If a folder is labeled "New Game" but it is actually already in your library, manually select the corrected title from the game title dropdown. This instantly changes the status to Update Link. The plugin can now match imported titles to mismatched folders via .exe and shortcut paths. Meaning if a folder does not match the launchbox title but that launchbox title has a launch path that is either to a direct .exe or to a shortcut (.lnk) that launches that .exe it will match and let you know that the folder can be updated. Auto-Rescore: Changing a title triggers the plugin to re-score the folder's executables, often finding a better match based on the updated name. Manual Overrides: Use the Selected EXE dropdown or the Browse button if you need to manually pick a specific file. 4. Execute Import Select the games you want to process (Shift + Click works for bulk selection). Rename Folders: Check this box to physically rename your folders on your hard drive to match the corrected titles. Create Shortcuts: Check this to generate .lnk files in your designated shortcut folder. Unlock 'In Library' Games for Editing: Unlocks In Library games for editing. Click Import Selected to update the LaunchBox database and process your files. 🔄 Real-World Workflow Example Imagine you are cleaning up a directory with a mix of new downloads and existing library entries: 1. The New Game: You have a folder named Super_Racing_2024. Since this isn't in your library, it appears in the grid as a New Game with the title defaulting to the folder name Super_Racing_2024. You can leave it as-is or click the field and manually correct it to Super Racing to keep your library clean. 2. The False Positive (clos2): You have a folder named clos2. Because it doesn’t match any games in your library, it shows as a New Game titled clos2. You think this is Castlevania: Lords of Shadow 2 so you go to the title field and either start typing or drop down and find and select Castlevania: Lords of Shadow 2. The status instantly changes to Update Link. Because you changed the title, the plugin re-scores the folder—now recognizing that CLOS2.exe is a high-score match because it fits the acronym of your new title. 3. Fixing Broken Links: You notice Portal in your library is currently pointing to a configuration tool instead of the game. You check Unlock In Library, which scans your existing games and makes them editable. You can now use the Selected EXE dropdown on the Portal row to switch the executable from config.exe to portal.exe. 4. The Cleanup (Rename & Shortcut): Before finishing, you check the Rename Folders and Create Shortcuts boxes. Rename Folders: The physical folder Super_Racing_2024 will be renamed to Super Racing on your hard drive to match your corrected title. Create Shortcuts: Instead of pointing LaunchBox to an EXE buried deep in subfolders, the plugin creates a Super Racing.lnk in your central shortcut folder. LaunchBox will now launch through that shortcut, making your library paths clean and portable. 5. The Result: You click Import Selected. The plugin physically renames the folders, generates the shortcuts, updates your existing Portal path, and adds Super Racing to your LaunchBox database all at once. TIPS: This plugin works best when your folders are named correctly. If you use this you should check out my other plugin, "The Game Scraper". You can download metadata, media, and hltb data. It also integrates nicely with this plugin to help you sync folder names after The Game Scraper changes the title to match Steam. Any bugs or questions please feel free to ask. I'm also in the Discord. Thanks to 7nseccmem for helping test this.

Project Merger Plugin for LaunchBox The Project Merger Plugin is a high-performance utility designed to integrate massive retro-gaming collections—including the eXo collections, C64 Dreams, and Flashpoint—directly into your LaunchBox library. Rather than moving or duplicating terabytes of data, this plugin utilizes symbolic links (symlinks) and surgical XML injection to make external collections behave as if they were natively installed within your LaunchBox directory 🛠 Requirements LaunchBox Version: 13.26 or higher If merging Flashpoint and you want the images then download the Flashpoint image archive from the flashpoint site (https://download.unstable.life/ultimate-direct/14_packed/) and extract them to your flashpoint directory. This is only required if you have Flashpoint Infinite. Flashpoint Ultimate comes with the images. ❓ Why This Plugin Exists When you know how Launchbox works the concept of merging installs is not difficult. However, it is a pain to do and can cause issues if you mess things up. I wanted a way to automate the process and merge the projects in to an existing launchbox install in a way that would not change the users existing library, be neatly organized, have a small storage footprint, and be non destructive to the original project files. 📂 Supported Projects The plugin is fingerprinted to recognize and process the following specific directory structures: eXo Collections: eXoDOS. exoDOS Lite, eXoWin3x, eXoWin9x, eXoAppleIIGS, eXoScummVM, eXoDREAMM, eXoDemoScn, and eXoIF. Can be merged in either individual projects or if you've already merged exo projects. C64 Dreams Flashpoint: Support for both Ultimate and Infinite. 📖 How to Use Extract the content of the archive to your /plugins/ folder. Download and follow the instructions to install/unpack your desired projects (exo, c64, and/or flashpoint). Start launchbox and go to the tools menu and select the plugin. In the plugin window browse to your source project folder. If you have multiple projects select the root folder that contains the project sub folders. The plugin will auto populate with the projects available for import. There is a "Dry Run" option enabled by default if you'd like to see get an idea of whats about to happen otherwise uncheck that option. Click start import. The plugin will create a backup of your parents and platform xml files prior to making changes. These can be found in the plugin directory. You will get a UAC prompt about half through the process. This is required to create symlinks. A full import of all the projects on a destination NVME takes about 10 minutes. If you run in to issues or want to remove a project the second tab is for you. You can get a very basic idea of what the condition of the install is in, repair it, or uninstall one or multiple projects. Additionally, If there is ever an update you simply update the project at the source and select repair on the second tab. 💻 How does it work? Retro Exo and C64 Dreams are simply just highly curated Launchbox libraries by themselves. They both utilize a custom project folders at the root of their Launchbox folders. With this in mind and remembering our goal of small storage footprint and wanting to keep the source intact we can move over dependencies and symlink anything else. In broard terms the games and media themselves are all still at their source while things like emulators and config files are copied over. You could technically play a game on exodos and then pick it back up where you left off on your merged launchbox folder. There are also dependent plugins for C64 Dreams and Retro Exo that get added in as well. I include these in the plugin folder because depending on which version of the project you are importing you may have an out of date version so the plugin contains the most up to date for you. Flashpoint is a little different. It looks similar to Launchbox but it is not Launchbox thus we must convert it to something Launchbox can understand. There are over 200k titles in Flashpoint. The plugin scans the source Flashpoint directory finds the sql database and converts it in to a Flashpoint.xml. It does the same for the playlist json files converting them to xml files. Additionally, the images folder is nothing like what Launchbox needs. Thus it finds all images in the Flashpoint folder and creates symlinks of them to your destination Launchbox directory. Finally, we extract ClifP from the plugin folder to bridge Flashpoint and Launchbox and actually run the games. To get the archive imported without conflicting with the users current library we rename the platforms to identify them as purely the project they represent, ie MS-DOS = eXoDOS, AppleIIGS = exo AppleIIGS, etc... Additionally, to keep it clean we create "master platform categories" such as "Retro Exo" and nest all the projects/platforms under the master platform category. IE: Retro Exo (Master Category)>eXo DOS (Project Category)> "exo dos platform and playlists go here". The plugin does all the xml injections and edits in the background. ⚠️ WARNING Flashpoint Scale: Flashpoint is incredibly resource-intensive, featuring approximately 200,000 titles and nearly 500,000 images. It's recommended you use an SSD as your destination Launchbox install for best performance. StableBit DrivePool Incompatibility: During development, it was identified that StableBit DrivePool does not handle large volumes of individual files and symbolic links effectively. Attempting to use this plugin on a pooled drive can and will cause system crashes that wont resolve after a restart. I spent about 24 hours in windows recovery and physically unplugging drives to get my system to boot again. Please ensure you are targeting a standard physical drive to maintain system stability. A final word on compatibility. While I tested several games across all the projects during the course of development I cannot guarantee that this is truly 100% working. Thus any and all feedback is appreciated. Eventually I plan on creating a custom media pack for this plugin so everything has, icons, clear logos, and videos.