File information

Last updated

Original upload

Created by

Hymlock

Uploaded by

hymlock

Virus scan

Safe to use

Tags for this mod

About this mod

Description Symbolic Link Manager for Mod Organizer 2 (MO2) empowers Fallout 4 modders to create and manage symbolic links for mod files and directories seamlessly. This tool is specifically optimized for Fallout 4's modding environment, enabling you to share large mod files across different mod setups.

Permissions and credits
Symbolic Link Manager for Mod Organizer 2 Version: 1.0.2
Author: Hymlock
Description The Symbolic Link Manager is a dedicated plugin for Mod Organizer 2 (MO2) that empowers Fallout 4 modders to create and manage symbolic links for mod files and directories seamlessly. This tool enables you to share large mod files across different mod folders without duplication. By reducing redundant data, it saves disk space and enhances the organization of your Fallout 4 mods for a more efficient and streamlined gaming experience.
Features
  • Create Symlinks: Effortlessly create symbolic links to individual files or entire mod folders.
  • Manage Symlinks: Easily view, sort, and delete your existing symlinks within the Fallout 4 mod structure.
  • Broken Symlink Handling: Automatically detect and repair or remove broken symlinks to maintain mod integrity.
  • Export Symlink List: Generate and export a comprehensive list of all your symlinks for documentation or sharing purposes.
  • Auto Link Functionality: Automatically detect duplicate mod folders and create symlinks to eliminate redundancy.
  • Multi-language Support: Available in English, Spanish, and Chinese to cater to a diverse user base.
  • Enhanced Settings Management: Customize auto-linking preferences and manage user settings effectively.
  • Improved Error Handling and Logging: Robust mechanisms for detecting and logging errors during symlink operations.
Requirements
  • Mod Organizer 2: Ensure you have the latest version of MO2 installed.
  • Python 3: Required for MO2 plugin functionality.
  • PyQt6: Necessary for the plugin's graphical user interface.
Installation Instructions
  • Download the Plugin:
    • Obtain the latest release of the Symbolic Link Manager from the Nexus Mods page.
  • Extract Files:
    • Unzip the downloaded archive to access the plugin files.
  • Copy Files to MO2 Plugins Directory:
    • Navigate to your Mod Organizer 2 installation directory.
    • Locate the plugins folder within the MO2 directory.
    • Copy the entire SymbolicLinkManager folder into the plugins directory.markdown
      Copy codeModOrganizer2/
      └── plugins/
      └── SymbolicLinkManager/
      ├── symlink_plugin.py
      ├── language_support.py
      ├── __init__.py
      └── resources/
      ├── folder_icon.png
      ├── file_icon.png
      ├── plugin_icon.png
      └── ... (other resources)
  • Verify Installation:
    • Ensure that the symlink_plugin.py file and the resources folder are correctly placed within the SymbolicLinkManager directory.
  • Restart Mod Organizer 2:
    • If MO2 is currently running, close and reopen it to load the new plugin.
  • Enable the Plugin:
    • In MO2, navigate to Settings > Plugins.
    • Locate Symbolic Link Manager in the list and ensure it is enabled (checked).

Usage Guide Creating a Symlink
  • Open Symlink Manager:
    • In MO2, go to the Tools menu and select Symbolic Link Manager.
  • Create Symlink:
    • Click on the Create Symlink button.
  • Choose File or Folder:
    • Select whether you want to link a File or a Folder.
  • Select Source:
    • Navigate to and choose the source file or folder you wish to link from your mod directories.
  • Select Destination:
    • Choose the destination directory within your setup where the symlink will be created.
  • Confirm Creation:
    • Review your selections and confirm the creation of the symlink.

Managing Symlinks
  • Open Manage Symlinks:
    • Within the Symlink Manager interface, click on Manage Symlinks.
  • View Symlinks:
    • Browse through the list of all your tracked symlinks, organized by mod structure.
  • Sort Symlinks:
    • Utilize the Sort dropdown menu to organize your symlinks based on various criteria (e.g., name, date created).
  • Symlink Options:
    • Click on any symlink to access additional options:
      • Show Link in Folder: Opens the destination folder where the symlink resides.
      • Show Source in Folder: Opens the source folder of the original mod file or directory.

  • Remove Symlinks:
    • Click the X button next to a symlink to remove it from your setup.

Exporting Symlink List
  • Export List:
    • In the Symlink Manager, navigate to File > Export Symlink List.
  • Choose Sorting Order:
    • Select your preferred sorting order for the exported list.
  • Save File:
    • Choose the destination and save the exported text file for your records or to share with others.

Troubleshooting Symlink Not Created
  • Permissions:
    • Ensure you have the necessary permissions to create symlinks in the destination directory.
    • On Windows, you may need to run MO2 as an administrator. Right-click on the MO2 executable and select Run as administrator.

Broken Symlinks
  • Detection:
    • The plugin automatically detects broken symlinks upon startup.
  • Repair or Remove:
    • Follow the provided prompts to repair or remove any broken symlinks.

Plugin Not Showing in MO2
  • Verify Installation:
    • Double-check that the symlink_plugin.py file and the resources folder are correctly placed in the SymbolicLinkManager directory within the plugins folder.
  • Compatibility:
    • Ensure you are using a compatible version of MO2 and that Python 3 is properly installed on your system.
Changelog Version 1.0.2
  • Added Auto Link Functionality:
    • Automated Duplicate Folder Detection: Automatically scans specified directories to identify exact duplicate folders, streamlining the management of redundant data.
    • Seamless Symlink Creation: Provides the option to automatically create symbolic links, replacing duplicate folders with symlinks pointing to the original source.
    • User-Friendly Warnings: Presents informative warning dialogs before deleting target folders during the auto-linking process to prevent accidental data loss.
    • "Don't Show Again" Options: Allows users to suppress future warning messages by selecting the "Don't show this message again" checkbox.
    • Completion Notifications: Notifies users with confirmation messages upon completing the auto-linking process.
    • Enhanced Settings Management: Saves and manages user preferences related to the auto-linking process for a tailored experience.
    • Improved Error Handling and Logging: Enhances error detection and logging mechanisms for better troubleshooting during the auto-linking process.

Version 1.0.1
  • Added Multi-language Support:
    • Implemented translations for English, Spanish, and Chinese.
    • Users can select their preferred language within the plugin settings.
    • All UI elements, messages, and dialogs support dynamic translation.
  • Improved User Interface:
    • Updated dialogs and menu structures to accommodate language changes.
    • Enhanced the help and about sections with localized content.
  • Bug Fixes and Enhancements:
    • Resolved a ModuleNotFoundError related to the language_support module by adjusting import statements.
    • Fixed issues where certain UI elements did not update after changing the language.
    • Improved error handling and logging for better troubleshooting.

Version 1.0.0
  • Initial Release:
    • Create and manage symbolic links for files and folders within mods.
    • Detect and handle broken symlinks with options to repair or remove.
    • Export symlink lists for record-keeping or sharing.
    • Basic user interface for creating and managing symlinks.

Summary of Changes in Version 1.0.2 The introduction of Auto Link Functionality in Version 1.0.2 significantly enhances the Fallout 4 Symbolic Link Manager. This feature automates the detection and management of duplicate mod folders, providing users with a more efficient and streamlined experience. With user-friendly warnings, suppression options, and comprehensive notifications, the plugin ensures both effectiveness and user control. Additionally, enhanced settings management and improved error handling solidify the plugin's reliability and ease of use, making it an indispensable tool for Fallout 4 mod enthusiasts.
Support and Feedback For support, updates, and to provide feedback, please visit the Nexus Mods page or contact the author directly through the Nexus Mods messaging system.
Enjoy a more organized and efficient modding experience with the Symbolic Link Manager!