Functional Changes from FilterTool to BLCMM - BLCM/BLCMods GitHub Wiki

In general, BLCMM works just like FilterTool did, and the differences in functionality should be mostly obvious and straightforward. There's a few differences which may bear pointing out for people already familiar with FilterTool who are migrating to BLCMM, though:

• BLCMM does not get installed into BL2 or TPS's binaries folder. It lives in whatever directory you want to put it, and the same BLCMM install can be used to manage both BL2 and TPS patch files/mods.

• BLCMM now auto-updates (though most auto-updates can be disabled). At the launch screen, it will check for new versions and download them automatically, so you'll always have the latest bugfixes and features.

• There is no longer a "default" patch file configured in BLCMM's settings. Instead, the app will remember up to ten files which were opened in the past, and provide those via a "Recent" menu.

• The native file format that BLCMM uses has been updated considerably. The file is still directly executable by Borderlands, but it will look rather different to anyone looking at the saved file in a text editor. BLCMM will still open/import FilterTool-style patches with no problems, and can still export into the FilterTool-style format if desired.

• When saving a file, or exporting a category as a mod, if you don't specify an extension yourself, BLCMM will automatically use a .blcm extension.

• Escaping quotes with \ is no longer required. BLCMM should do the right thing just having the quotes on their own.

• Users who use the "Import mods folder" functionality should note that the imported folder names have changed slightly since FilterTool, and re-importing to the same mods folder as before may result in duplicate mods. To prevent this, when transitioning to BLCMM for the first time, it's recommended to start with a fresh patch file, or delete your "mods" category inside the app once, before using "Import mods folder" for the first time in BLCMM. (Subsequent uses of "Import mods folder" will work fine without having to do anything special.)

• Original-style Hotfix files, of the sort that can be processed by adudney's hotfix converter can now be imported directly into BLCMM, rather than having to convert them.

• Moved functionality:

  • "Import single mod", "Import mods folder", and "Import zip folder" have been moved to the File menu
  • The Content and Structural edit checkboxes have been moved into the Tools -> Settings dialog.

• Color highlighting has been added to the main tree.

  • Cyan: top-level folder, and "mods" folder.
  • Yellow: Comments
  • Brighter Yellow: say/exec commands
  • Blue: hotfixes
  • Purple: "mutually exclusive" category, in which only a single option can be active at a time
  • Dark Green: A statement which is overwritten by another statement later in the file
  • Light Green: The statement which is overwriting a previous one.
  • Red: syntax errors which will not be processed correctly by Borderlands
  • Orange: Content errors which might not be processed correctly by Borderlands
  • Magenta: Style warnings which work in Borderlands but are not recommended

Example of highlighting in dark mode:

Example of highlighting in light mode: