Home

BLCMods Wiki

sniff sniff... Smells like... an off-worlder. How are you liking our wiki, anyways?

the wiki is always under heavy development, if you have any knowledge to share, please do so

This wiki attempts to serve as a central documentation point for dealing with Borderlands modding, specifically for Borderlands 2, The Pre-Sequel, and 3. (For BL1, you'll have to look elsewhere, alas.) There's information for people who just want to run mods, but the majority of the info is more geared towards folks who want to write mods themselves.

Borderlands 3 modding is still in a very nascent state, but we've been developing documentation for that as well. To prevent confusion, BL3 modding information is being kept on its own page, at Borderlands 3 Modding Info. The remainder of this page primarily just deals with Borderlands 2 and TPS.

User Resources

Get started by installing the Borderlands Community Mod Manager (BLCMM), which is the new replacement for FilterTool!

• Functional Changes from FilterTool to BLCMM
• Unofficial Community Patch Setup / Installation FAQ
• Linux and Mac Setup Gotchas
• Patching FaQ
• Randomizer PythonSDK FaQ

Tools

General-Purpose Tools

• Borderlands Community Mod Manager (BLCMM) - Highly recommended mod management tool. You want to be using this to manage your mods, both for authors and users.
• Borderlands Hex Multitool - Patches Borderlands to do things like raise the maximum character level, backpack size, money, etc.
• BL2 Gibbed save editor - savegame editor for BL2 saves
• TPS Gibbed save editor - savegame editor for TPS saves

Modder's Tools

• Unreal Package Decompressor - Required if you want to dig into Borderlands's UPK content directly
• UE Explorer - Lets you browse around Borderlands UPK files directly; very useful if the data you're looking for isn't already bundled with FilterTool. Requires that the UPKs be decompressed with the Unreal Package Decompressor first.
• FilterTool Explorer - Provides a tree-like view into BLCMM's bundled object information, like UE Explorer does, but without needing to deal with UPKs.
• Balanced Items Generator - Little utility to help visualize BalancedItems probabilities, and assist in figuring out the values you might want to change, for a mod.

Deprecated Tools

• Behavior Parser - Utility to help parse BehaviorProviderDefinition structures inside Borderlands data.
• Hotfix Converter
• Hotfix Unconverter
• Borderlands 2 exe Patcher

Resources

Modder's Resources: Information/HOWTOs/Tutorials

• Tutorial: Enabling Console
• Tutorial: Getting Started Making Mods
• Tutorial: Map merging by LightChaosman
• Tutorial: DAVE'S BL2 SKIN MODDING GUIDE
• Tutorial: How to commit a mod to github
• Tutorial: Text Formatting
• Anatomy of a Patch/Mod File
• Understanding Borderlands Weight and Probability Values
• Understanding Item and Weapon Parts Definitions

Registry Pages / Data Lookups

• BL2 Registry Pages:
  • Custom Skin and Head Pool Registry
    • Issues with Skinpools and Ingame Rewards
  • Custom SkinCOM/SkinGrenade/SkinRelic/SkinShield Registry
• TPS Registry Pages:
  • TPS Custom Skin and Head Pool Registry
• Data Reference Pages
  • Level Name Reference (for use in SparkLevelPatchEntry hotfixes)
  • GameStage Scheduling Reference
  • Container Reference
    • Borderlands 2 Container Reference
    • Pre-Sequel Container Reference
  • Skinpool/Headpool Usage
    • Borderlands 2 Skinpool Usage
    • Pre-Sequel Skinpool Usage
• Resource Lists
  • Always loaded resources
    • Always Loaded: ParticleSystem
    • Always Loaded: FiringModeDefinition
    • Always Loaded: Textures
  • Raw Resources
    • Resource: WeaponAttributeDefinitions
    • Resource: WeaponPartDefinition
• Archived Unreal Engine 3 Documentation
  • Unreal Engine 3 Console Commands
  • Unreal Engine 3 Kismet User Guide

BehaviorProviderDefinition/Kismet Documentation

(If you don't know what this is already, it's not for you. They're quite complex. Get used to modding other stuff first, and then come back here once you've levelled up a few times.)

• Kismet Sequence and BehaviorProviderDefinition Basics
• BPD Classroom
• apocalyptech's BPD/Kismet graph generator (sourcecode)

Borderlands 3

See Borderlands 3 Modding Info for our current BL3 documentation.