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, Borderlands 3, and Tiny Tina's Wonderlands. (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.

Most of the links down below are BL2/TPS-specific; we've got pages set up for Borderlands 3 and Tiny Tina's Wonderlands here:

• Borderlands 3 Modding Info
• Wonderlands Modding Info

Finding Mods

• borderlandsmodding.com has a page on finding and downloading BL2/TPS mods.

Or you can jump straight to the mod cabinets here:

• Borderlands 2/TPS Cabinet.
• Borderlands 3 Cabinet.
• Wonderlands Cabinet.

User Modding Resources

Get started by installing Python SDK to set up the game for modding and allow the use of SDK mods. If you need to configure text mods you want to use the Borderlands Community Mod Manager (OpenBLCMM), which is the new replacement for FilterTool!

• Functional Changes from FilterTool to BLCMM
• Text Mod Setup Guide
• Linux and Mac Setup Gotchas
• Patching FaQ
• Randomizer PythonSDK FaQ
• Hex Edits (mostly unnecessary since PythonSDK exists)

Tools

General-Purpose Tools

• Borderlands Community Mod Manager (OpenBLCMM) - 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 OpenBLCMM'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: TOFU'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
  • Skill HUD Slot 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.

Wonderlands

See Wonderlands Modding Info for our current Wonderlands documentation.