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
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.
- 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.
- Download the Plugin:
- Obtain the latest release of the Symbolic Link Manager from the Nexus Mods page.
- 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.
- 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 theplugins
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 theresources
folder are correctly placed within theSymbolicLinkManager
directory.
- Ensure that the
- Restart Mod Organizer 2:
- If MO2 is currently running, close and reopen it to load the new plugin.
- 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).
- Open Symlink Manager:
- In MO2, go to the Tools menu and select Symbolic Link Manager.
- In MO2, go to the Tools menu and select Symbolic Link Manager.
- Create Symlink:
- Click on the Create Symlink button.
- Click on the Create Symlink button.
- Choose File or Folder:
- Select whether you want to link a File or a 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.
- 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.
- 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.
- Review your selections and confirm the creation of the symlink.
- Open Manage Symlinks:
- Within the Symlink Manager interface, click on 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.
- 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).
- 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.
- Click on any symlink to access additional options:
- Remove Symlinks:
- Click the X button next to a symlink to remove it from your setup.
- Click the X button next to a symlink to remove it from your setup.
- Export List:
- In the Symlink Manager, navigate to File > Export Symlink List.
- In the Symlink Manager, navigate to File > Export Symlink List.
- Choose Sorting Order:
- Select your preferred sorting order for the exported list.
- 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.
- Choose the destination and save the exported text file for your records or to share with others.
- 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.
- Detection:
- The plugin automatically detects broken symlinks upon startup.
- The plugin automatically detects broken symlinks upon startup.
- Repair or Remove:
- Follow the provided prompts to repair or remove any broken symlinks.
- Follow the provided prompts to repair or remove any broken symlinks.
- Verify Installation:
- Double-check that the
symlink_plugin.py
file and theresources
folder are correctly placed in theSymbolicLinkManager
directory within theplugins
folder.
- Double-check that the
- Compatibility:
- Ensure you are using a compatible version of MO2 and that Python 3 is properly installed on your system.
- Ensure you are using a compatible version of MO2 and that Python 3 is properly installed on your system.
- 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.
- 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 thelanguage_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.
- Resolved a
- 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.
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!