Grognak's Mod Manager
NOTE - Grognak's Mod Manager is no longer in development and has been succeded by Slipstream Mod Manager
Please restore your game to vanilla using GMM, and install Slipstream to install/uninstall mods from now on. Slipstream or SMM has fewer bugs, is faster and is required by a few newer mods. It is highly recommended that you use SMM instead of GMM, if for no other reason then because GMM is no longer developed.
- UltraMantis
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
What is this?
GMM is compatible with Windows, Mac OS X, and Linux.
How do I install and use this?
You can unzip the archive anywhere and it will (hopefully) auto-detect where FTL is located.
Mods come in .ftl files. To make one available to GMM, simply drag it into the /mods folder.
To install mods, open GMM, select the mods you want to be installed, and hit Patch. Please note that you need to re-select mods that you already have installed, otherwise they will uninstall themselves.
In order to completely uninstall all mods, simply start the patching process with nothing selected.
I patched the game and now everything is replaced with exclamation marks!
1) Delete your /resources/ folder in the FTL directory (this will not affect your saves)
2a) If you have steam, verify your game cache.
2b) Otherwise, if you use the DRM free version, re-download the ZIP file and copy it's fresh /resources/ in.
3) Try using GMM again. Everything should work.
Help! It's giving me an error.
Try deleting modorder.txt from your /mods folder and relaunching GMM. If you bought FTL via Steam, make sure that you haven't moved the base game's folder. Also, make sure that your resource.dat and data.dat files are not read-only.
If all else fails, try asking on this thread.
Download links:
Version 1.7.0 - [Windows] - [Mac/Linux]
Version 1.6.0 - [All Platforms]
Version 1.5.0 - [All Platforms]
Version 1.4.1 - [All Platforms]
Version 1.4.0 - [All Platforms]
Version 1.3.0 - [All Platforms]
Version 1.2.0 - [All Platforms]
Version 1.1.0 - [All Platforms]
Version 1.0.0 - [All Platforms]
Source code:
The latest, greatest main.py version can be found on Github.
Modman.exe's source is available separately here.
Change list:
Credits:
For developers:
How do I create a .ftl file?
A .ftl file is simply a renamed .zip with a specific file structure. For an example, try renaming and unpacking the example .ftl file that comes with the program.
The root of your ZIP file should contain one, multiples of, or all of the following folders:
You should ONLY put in the files that you have modified. This helps keep mod sizes low and prevents major mod conflict.
Don't worry about data.dat or resource.dat, GMM will automatically move the files to the right spot.
What is the .append extension for?
Any file in your .ftl archive with the extension .append will be appended to its respective vanilla file. For an example, check out the mod that comes with the program.
It is highly recommended that you take advantage of this as much as possible. As a rule of thumb, if you're editing an event xml file, you're going to want to append your changes rather then flat out replace the file. Keep in mind that you can override vanilla events to your pleasure by having the same event name, and using .append helps prevent mod conflict.
Donations:
If this program has helped you and you feel so inclined, I can accept donations via Flattr. Thank you.
NOTE: If you get the ordinal error, turn off the NVidia Overlay as that isn't an issue directly with the mod manager. v1.8.9 is fix to the sorting and profile problems with the mod manager. I'll do a major cleanup of the readme and add a lot more FAQ/instructions with the. To enable a mod: From the pre-game Options window, select the Mod Manager tab. The name of the mod will appear on an icon in the Mod Manager. Click on the red Off button next to the name of the mod. The next time you launch the game, the mod will be enabled. The built-in auto-sorting system manages your load order and helps you to resolve mod conflicts with powerful, yet easy to use plugin management features. MOD PROFILES Easily set up, switch between, and manage independent mod profiles enabling you to use exactly the combination of mods that you want for a particular playthrough. Software for installing World of Warships mods. References to specific designs, models, manufacturers, and/or modifications of ships and aircraft are used only for the purpose of historical consistency and do not assume any funding or other involvement in the project on the part of the holders of trademarks.
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *NOTE - Grognak's Mod Manager is no longer in development and has been succeded by Slipstream Mod Manager
Please restore your game to vanilla using GMM, and install Slipstream to install/uninstall mods from now on. Slipstream or SMM has fewer bugs, is faster and is required by a few newer mods. It is highly recommended that you use SMM instead of GMM, if for no other reason then because GMM is no longer developed.
- UltraMantis
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
What is this?
Mod Manager For Mac
Grognak's Mod Manager, or GMM for short, is a program designed to make it easy to install multiple mods at the same time. No longer do you have to pack and unpack files or swap out each mod you want to use one at a time.GMM is compatible with Windows, Mac OS X, and Linux.
How do I install and use this?
You can unzip the archive anywhere and it will (hopefully) auto-detect where FTL is located.
Mods come in .ftl files. To make one available to GMM, simply drag it into the /mods folder.
To install mods, open GMM, select the mods you want to be installed, and hit Patch. Please note that you need to re-select mods that you already have installed, otherwise they will uninstall themselves.
In order to completely uninstall all mods, simply start the patching process with nothing selected.
I patched the game and now everything is replaced with exclamation marks!
1) Delete your /resources/ folder in the FTL directory (this will not affect your saves)
2a) If you have steam, verify your game cache.
2b) Otherwise, if you use the DRM free version, re-download the ZIP file and copy it's fresh /resources/ in.
3) Try using GMM again. Everything should work.
Help! It's giving me an error.
Try deleting modorder.txt from your /mods folder and relaunching GMM. If you bought FTL via Steam, make sure that you haven't moved the base game's folder. Also, make sure that your resource.dat and data.dat files are not read-only.
If all else fails, try asking on this thread.
Download links:
Version 1.7.0 - [Windows] - [Mac/Linux]
Version 1.6.0 - [All Platforms]
Version 1.5.0 - [All Platforms]
Version 1.4.1 - [All Platforms]
Version 1.4.0 - [All Platforms]
Version 1.3.0 - [All Platforms]
Version 1.2.0 - [All Platforms]
Version 1.1.0 - [All Platforms]
Version 1.0.0 - [All Platforms]
Source code:
The latest, greatest main.py version can be found on Github.
Modman.exe's source is available separately here.
Change list:
1.7:
- Lowered the required Python version to 2.6
- Added a Linux/Mac launcher (modman.command) to guarantee a terminal
- Added forum-scraped metadata for most mod files (based on their md5)
- Added a right-click clipboard menu to the text area.
- Added ini setting: never_run_ftl
- The ini's ftl_dats_path is ignored if it's invalid
- Added graceful exit on ctrl-c or Windows terminal closing
- Fixed data.dat/FTL.app file chooser, which sometimes left files hidden
- Fixed TclError for non-US locales with commas for decimal points
- Moved dat backups to GMM/backup/ (bak's in the old location will be deleted)
- Made the code tolerable by Python 3.x (hopefully without new 2.x bugs)
- Made the Patch/Toggle/Forum buttons expand to accomodate their text
- Added 'Validate' button to check mods for problems
- Added support for appending xml files with unicode UTF-8 BOMs
- Added FTL launching under OSX
- Updated backend (un)packer to ftldat r7 (plus changes for Python 2.6/3.x)
- Massively shrinked download
- New, custom GMM launcher
1.6:
- GMM no longer needs to be placed in the FTL directory
- Added ini setting: ftl_dats_path
- Added drag-and-drop mod reordering
- Added 'Toggle All' button
- Dats are unpacked to temp folders and deleted after patching.
- Added logging
- Deprecated ini setting: macmodsdir
- Deprecated ini setting: highlightall
1.5:
- Add option to select all mods automatically (on by default, changeable in .ini)
- .ini finding improvement (by Jocelyn)
- Minor edit in readme for Mac OS X users
1.4.1:
- Fixed Mac and Linux support
- Fixed slight error in readme (no longer called the OK button)
1.4:
- New custom GUI
- No longer reliant on EasyGUI
- Better ZIP file support
- More relevant error messages
- Now offers the option of running the game after you're done patching (Windows only)
- Now removes deleted mods from modorder.txt
- Now supports .append.xml as well as .xml.append
- Improved Mac OS X support
(Thanks to ser_aerochorro for his contributions!)
1.3:
- Added custom subdirectory support
- Added an option to be able to use .zip files
- Integrated Icehawk78's stability patch
- Now includes modman.ini
- The Scrap Advantage example mod is now functional
1.2:
- Added missing files required for Mac/Linux users
1.1:
- Fixed critical issue with sub-folders
- Experimental Mac/Linux support
1.0:
- Initial release
- Lowered the required Python version to 2.6
- Added a Linux/Mac launcher (modman.command) to guarantee a terminal
- Added forum-scraped metadata for most mod files (based on their md5)
- Added a right-click clipboard menu to the text area.
- Added ini setting: never_run_ftl
- The ini's ftl_dats_path is ignored if it's invalid
- Added graceful exit on ctrl-c or Windows terminal closing
- Fixed data.dat/FTL.app file chooser, which sometimes left files hidden
- Fixed TclError for non-US locales with commas for decimal points
- Moved dat backups to GMM/backup/ (bak's in the old location will be deleted)
- Made the code tolerable by Python 3.x (hopefully without new 2.x bugs)
- Made the Patch/Toggle/Forum buttons expand to accomodate their text
- Added 'Validate' button to check mods for problems
- Added support for appending xml files with unicode UTF-8 BOMs
- Added FTL launching under OSX
- Updated backend (un)packer to ftldat r7 (plus changes for Python 2.6/3.x)
- Massively shrinked download
- New, custom GMM launcher
1.6:
- GMM no longer needs to be placed in the FTL directory
- Added ini setting: ftl_dats_path
- Added drag-and-drop mod reordering
- Added 'Toggle All' button
- Dats are unpacked to temp folders and deleted after patching.
- Added logging
- Deprecated ini setting: macmodsdir
- Deprecated ini setting: highlightall
1.5:
- Add option to select all mods automatically (on by default, changeable in .ini)
- .ini finding improvement (by Jocelyn)
- Minor edit in readme for Mac OS X users
1.4.1:
- Fixed Mac and Linux support
- Fixed slight error in readme (no longer called the OK button)
1.4:
- New custom GUI
- No longer reliant on EasyGUI
- Better ZIP file support
- More relevant error messages
- Now offers the option of running the game after you're done patching (Windows only)
- Now removes deleted mods from modorder.txt
- Now supports .append.xml as well as .xml.append
- Improved Mac OS X support
(Thanks to ser_aerochorro for his contributions!)
1.3:
- Added custom subdirectory support
- Added an option to be able to use .zip files
- Integrated Icehawk78's stability patch
- Now includes modman.ini
- The Scrap Advantage example mod is now functional
1.2:
- Added missing files required for Mac/Linux users
1.1:
- Fixed critical issue with sub-folders
- Experimental Mac/Linux support
1.0:
- Initial release
Credits:
- bas: For his brilliant ftldat, which this program couldn't exist without.
- Vhati: For contributing so much towards the latest versions. Seriously, Vhati deserves major props.
For developers:
How do I create a .ftl file?
A .ftl file is simply a renamed .zip with a specific file structure. For an example, try renaming and unpacking the example .ftl file that comes with the program.
The root of your ZIP file should contain one, multiples of, or all of the following folders:
- data
audio
fonts
img
You should ONLY put in the files that you have modified. This helps keep mod sizes low and prevents major mod conflict.
Don't worry about data.dat or resource.dat, GMM will automatically move the files to the right spot.
What is the .append extension for?
Any file in your .ftl archive with the extension .append will be appended to its respective vanilla file. For an example, check out the mod that comes with the program.
It is highly recommended that you take advantage of this as much as possible. As a rule of thumb, if you're editing an event xml file, you're going to want to append your changes rather then flat out replace the file. Keep in mind that you can override vanilla events to your pleasure by having the same event name, and using .append helps prevent mod conflict.
Nexus Mod Manager Mac
Please note, both 'file.xml.append' and 'file.append.xml' will work, but the former may cause problems with some text editors. Use whichever works for you.Donations:
If this program has helped you and you feel so inclined, I can accept donations via Flattr. Thank you.
To use any of these key combinations, press and hold the keys immediately after pressing the power button to turn on your Mac, or after your Mac begins to restart. Keep holding until the described behavior occurs.
- Command (⌘)-R: Start up from the built-in macOS Recovery system. Or use Option-Command-R or Shift-Option-Command-R to start up from macOS Recovery over the Internet. macOS Recovery installs different versions of macOS, depending on the key combination you use while starting up. If your Mac is using a firmware password, you're prompted to enter the password.
- Option (⌥) or Alt: Start up to Startup Manager, which allows you to choose other available startup disks or volumes. If your Mac is using a firmware password, you're prompted to enter the password.
- Option-Command-P-R:Reset NVRAM or PRAM. If your Mac is using a firmware password, it ignores this key combination or starts up from macOS Recovery.
- Shift (⇧): Start up in safe mode. Disabled when using a firmware password.
- D: Start up to the Apple Diagnostics utility. Or use Option-Dto start up to this utility over the Internet. Disabled when using a firmware password.
- N: Start up from a NetBoot server, if your Mac supports network startup volumes. To use the default boot image on the server, hold down Option-N instead. Disabled when using a firmware password.
- Command-S: Start up in single-user mode. Disabled in macOS Mojave or later, or when using a firmware password.
- T: Start up in target disk mode. Disabled when using a firmware password.
- Command-V: Start up in verbose mode. Disabled when using a firmware password.
- Eject (⏏) or F12 or mouse button or trackpad button: Eject removable media, such as an optical disc. Disabled when using a firmware password.
If a key combination doesn't work
If a key combination doesn't work at startup, one of these these solutions might help:
- Be sure to press and hold all keys in the combination together, not one at a time.
- Shut down your Mac. Then press the power button to turn on your Mac. Then press and hold the keys as your Mac starts up.
- Wait a few seconds before pressing the keys, to give your Mac more time to recognize the keyboard as it starts up. Some keyboards have a light that flashes briefly at startup, indicating that the keyboard is recognized and ready for use.
- If you're using a wireless keyboard, plug it into your Mac, if possible. Or use your built-in keyboard or a wired keyboard. If you're using a keyboard made for a PC, such as a keyboard with a Windows logo, try a keyboard made for Mac.
- If you're using Boot Camp to start up from Microsoft Windows, set Startup Disk preferences to start up from macOS instead. Then shut down or restart and try again.
Total War Rome 2 Mod Manager Mac
Snapchat messenger for mac. Remember that some key combinations are disabled when your Mac is using a firmware password.
Learn more
- Learn what to do if your Mac doesn't turn on.
- Learn about Mac keyboard shortcuts that you can use after your Mac has started up.