Functional Changes from FilterTool to BLCMM

NOTE: This page is pre-release, details are subject to change, and BLCMM has not been released yet. This may just get folded into a main documentation page for BLCMM when that eventually happens, just wanted to get this down and in the wiki for the time being...

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.

• 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.

• Users who use the "Import mods folder" functionality should note that the names used to import mods have changed slightly since FilterTool, and re-importing 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.)

• The native file format that BLCMM saves in 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 can still export into the FilterTool-style format if desired, and BLCMM can read FilterTool-style patches with no problems.

• 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.

• Color highlighting has been added to the main tree. (Need to post examples of these)

  • Cyan: top-level folder, and "mods" folder.
  • 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

• 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 from the "tools" menu to the "Settings" dialog.