ChestLootOverride - MegaLadder Edition

A comprehensive mod for Megabonk that allows you to override chest loot based on chest number, with full integration and support for MegaLadder.

📦 What's Included

This package includes:

• ChestLootOverride - Main mod for overriding chest loot
• MegaLadderPatches - Patches for MegaLadder compatibility
• ChestLootOverride.MegaLadder.Integration - Integration between the main mod and MegaLadder

🚀 Installation

1. Make sure you have BepInEx installed (and MegaLadder if you want to use competitive features)
2. Download the latest package version
3. Extract the archive to the BepInEx\plugins folder
4. Launch the game once to generate the configuration file
5. Close the game and edit the config

⚙️ Configuration

After the first launch, the configuration file will be created at:
BepInEx\config\com.Rofliex.ChestLootOverride.cfg

Core Concepts

Builds

A build is a set of items that will be used to replace loot from chests in a specific chest range.

Build structure:

• Name - Build name (for identification in logs)
• Range - Chest range (e.g., 1-5 means chests 1 through 5)
• OrderRandomize - Whether to randomize the order of items in the build
• Items - List of items for replacement

Item Alternatives

For each item, you can specify multiple alternatives separated by |:

Build1Item1 = CreditCardGreen|SoulHarvester|Anvil

If the first item is banned (e.g., in MegaLadder), the mod will automatically try the next one in the list.

Skip Conditions

You can configure conditions under which replacement will not occur:

• SkipIfLegendary - Skip replacement if the original item is Legendary
• SkipIfEpic - Skip replacement if the original item is Epic
• SkipIfRare - Skip replacement if the original item is Rare
• SkipIfItem - Skip replacement if the original item matches any of the specified items

Configuration Example

[General]
## Enable/disable the mod
# Setting type: Boolean
# Default value: true
EnableMod = true

[Builds]
## Build configurations for chest loot sequences
## 
## Each build covers a range of chests (e.g., 1-5, 5-10)
## Format:
##   Build<number>Name = "Build Name"  (optional, for identification in logs)
##   Build<number>Range = <start>-<end>  (e.g., Build1Range = 1-5)
##   Build<number>OrderRandomize = true/false  (optional, randomize item order, default: false)
##   Build<number>Item<index> = <primary>|<alternative1>|<alternative2>|...  (multiple alternatives supported)
##                              If primary is banned, try alternative1, then alternative2, etc.
##                              First non-banned item in the list will be used.
##   
##   Optional conditions (only specify if you need them):
##   Build<number>Item<index>SkipIfLegendary = true/false  (skip replacement if original is Legendary, default: false)
##   Build<number>Item<index>SkipIfEpic = true/false  (skip replacement if original is Epic, default: false)
##   Build<number>Item<index>SkipIfRare = true/false  (skip replacement if original is Rare, default: false)
##   Build<number>Item<index>SkipIfItem = Item1, Item2, ...  (skip replacement if original matches any item, default: empty)
##
## If a build contains banned items (and no alternatives), it will be filtered out.
## If multiple valid builds exist for a range, one will be randomly selected.
##
## Note: All SkipIf* conditions are optional. If not specified, they default to false/empty
##       and replacement will always happen (unless the item itself is banned).

# Build 1: Early game build (chests 1-5)
Build1Name = "Early Game Build"
Build1Range = 1-5
Build1OrderRandomize = false
Build1Item1 = CreditCardGreen|SoulHarvester|Anvil
Build1Item1SkipIfLegendary = true

Build1Item2 = CursedDoll|MoldyCheese|BobDead
Build1Item2SkipIfLegendary = true

Build1Item3 = MoldyCheese|Anvil|EchoShard|HolyBook

Build1Item4 = EchoShard|HolyBook|Key
Build1Item4SkipIfLegendary = true
Build1Item4SkipIfItem = CreditCardGreen, Anvil

Build1Item5 = Key|GloveCurse|SuckyMagnet
Build1Item5SkipIfLegendary = true 

# Build 2: Alternative early game build (chests 1-5)
Build2Name = "Alternative Early Game"
Build2Range = 1-5
Build2OrderRandomize = true
Build2Item1 = SoulHarvester|CreditCardGreen|Anvil|MoldyCheese
Build2Item2 = BobDead|Anvil|EchoShard
Build2Item3 = Anvil|MoldyCheese|BobDead
Build2Item4 = HolyBook|EchoShard|Key|GloveCurse
Build2Item5 = GloveCurse|Key|SuckyMagnet 

# Build 3: Mid game build (chests 6-10)
Build3Name = "Mid Game Build"
Build3Range = 6-10
Build3OrderRandomize = false
Build3Item1 = LightningOrb|SpicyMeatball|Kevin|GrandmasSecretTonic
Build3Item1SkipIfLegendary = true

Build3Item2 = Kevin|GrandmasSecretTonic|LightningOrb
Build3Item2SkipIfLegendary = true
Build3Item2SkipIfEpic = true

Build3Item3 = GoldenShield|OverpoweredLamp|Kevin

Build3Item4 = OverpoweredLamp|GoldenShield|LightningOrb
Build3Item4SkipIfItem = Kevin, LightningOrb

Build3Item5 = SuckyMagnet|Bonker|Anvil
Build3Item6 = Bonker|SuckyMagnet|MoldyCheese 

# Build 4: End game build (chests 18-20)
Build4Name = "End Game Build"
Build4Range = 18-20
Build4OrderRandomize = false
Build4Item1 = OverpoweredLamp|GoldenShield
Build4Item2 = EMPTY
Build4Item3 = EMPTY

Important Points

1. Empty Items (EMPTY): Use EMPTY as a value to skip a chest (don't replace loot):

   Build4Item2 = EMPTY
   

2. Multiple Builds for One Range: If you have multiple builds covering the same chest range, the mod will randomly select one of them at the start of the run.

3. Item Bans in MegaLadder: The mod automatically accounts for banned items in MegaLadder and uses alternatives if the primary item is banned.

4. Order Randomization: If OrderRandomize = true, the order of items in the build will be random each time the build is applied.

5. Skip Conditions: SkipIf* conditions are checked before replacement. If a condition is met, the item from the build queue is moved to the end of the queue, and the original chest loot is used.

🔧 Available Items

Use exact item names from the EItem enum, for example:

• Key,
• Beer,
• SpikyShield,
• Bonker,
• SlipperyRing,
• CowardsCloak,
• GymSauce,
• Battery,
• PhantomShroud,
• ForbiddenJuice,
• DemonBlade,
• GrandmasSecretTonic,
• GiantFork,
• MoldyCheese,
• GoldenSneakers,
• SpicyMeatball,
• Chonkplate,
• LightningOrb,
• IceCube,
• DemonicBlood,
• DemonicSoul,
• BeefyRing,
• Dragonfire,
• GoldenGlove,
• GoldenShield,
• ZaWarudo,
• OverpoweredLamp,
• Feathers,
• Ghost,
• SluttyCannon,
• TurboSocks,
• ShatteredWisdom,
• EchoShard,
• SuckyMagnet,
• Backpack,
• Clover,
• Campfire,
• Rollerblades,
• Skuleg,
• EagleClaw,
• Scarf,
• Anvil,
• Oats,
• CursedDoll,
• EnergyCore,
• ElectricPlug,
• BobDead,
• SoulHarvester,
• Mirror,
• JoesDagger,
• WeebHeadset,
• SpeedBoi,
• Gasmask,
• ToxicBarrel,
• HolyBook,
• BrassKnuckles,
• IdleJuice,
• Kevin,
• Borgar,
• Medkit,
• GamerGoggles,
• UnstableTransfusion,
• BloodyCleaver,
• CreditCardRed,
• CreditCardGreen,
• BossBuster,
• LeechingCrystal,
• TacticalGlasses,
• Cactus,
• CageKey,
• IceCrystal,
• TimeBracelet,
• GloveLightning,
• GlovePoison,
• GloveBlood,
• GloveCurse,
• GlovePower,
• Wrench,
• Beacon,
• GoldenRing,
• QuinsMask,
• and others...

Note: If you use an incorrect item name, the mod will log a warning and skip that item.

Special for Pukich

Надеюсь вы по-быстрее усложните жизнь абузерам. Ждем легит ладдер всем табором