cheat-menu-cotl

Version 1.2.0 - Major Update 🎉🐑

A comprehensive cheat menu mod for Cult of the Lamb that provides an easily accessible compact GUI with 150+ cheats, full controller support, and extensive quality-of-life features.

🎮 What's New in v1.2.0 - MAJOR UPDATE

🗂️ Complete Menu Reorganization

• Reorganized all categories into a logical flow: Health → Combat → Resources → Cult → Follower → Farming → Weather → DLC → Splitscreen → Misc
• Fixed misplaced items: Souls, Black Souls, and Arrows moved from Health → Resources; Player Speed and Stop Time moved from Combat → Misc
• Removed unused categories (Rituals, Structures) that had no cheats assigned
• Consistent category ordering - categories now always appear in the same order

🌦️ Weather Menu Overhaul

• Logically grouped weather items: Clear → Rain (Light/Heavy) → Wind (Light/Heavy) → Snow (Dusting/Light/Medium/Heavy/Blizzard) → Heat (Light/Heavy) → Seasons
• Cleaned up names - removed redundant "Weather:" prefix for cleaner display
• Custom sort ordering ensures related weather types stay together instead of being scattered alphabetically

⚔️ Combat Category (Refined)

• Focused on combat-specific cheats: Kill All Enemies, One Hit Kill, Unlimited Relics/Ammo/Fervour
• Dungeon tools: Auto Reveal Map, Reveal Map, Clear Status Effects
• Unlock progression: Weapons, Tarot Cards, Fleeces, Crown Abilities, EVERYTHING
• Removed non-combat items (Player Speed, Stop Time) to proper categories

🔧 Technical Improvements

• New SortOrder system for precise item ordering within categories via CheatDetails attribute
• Deterministic category rendering - enum order controls category button order
• Cleaner codebase - removed dead enum values and properly separated concerns

🚀 Features & Usage

Press the M key to activate the cheat menu and click any button to enable/disable specific cheats or enter that category. N key goes back from a category. Both keys can be changed in the BepInEx config folder.

Controller Support

Full gamepad/controller support via Rewired (the game's native input system)! Navigate the menu using:

• Right Stick - Navigate between options (highlighted with red glow)
• R3 (Right Stick Click) - Open/close menu
• B/Circle Button - Go back to previous menu (or close menu from main)
• A/Cross Button - Select/activate option

Works with Xbox, PlayStation, Nintendo Switch Pro, Steam Deck, and generic controllers!

📋 Complete Cheat Categories

Health

• Godmode, Demigod Mode, Immortal Mode (toggles)
• Heal x1, Full Heal
• Add hearts: Red, Blue, Black, Spirit, Fire, Ice
• Unlimited HP (toggle)
• Die

Combat

• Kill All Enemies, One Hit Kill (toggle)
• Unlimited Relics, Unlimited Ammo, Unlimited Fervour (toggles)
• Auto Reveal Dungeon Map, Reveal Dungeon Map
• Clear Status Effects
• Unlock All Weapons, Tarot Cards, Fleeces, Crown Abilities
• Enable Tarot Building, Enable Black Souls
• Unlock EVERYTHING

Resources (40+ items)

• Basic Resources, Seeds, Fish (11 types), Food, All Meals (18 types)
• Necklaces (all 18 types including DLC)
• Materials, Refined Materials, Flowers, Trinkets
• Crystals, Bones, Lumber, Stone, Silk Thread
• God Tears, Relics, Talisman, Gold Coins
• Souls, Black Souls, Arrows
• Ability Points, Disciple Points
• Give ALL Items

Cult (20+ options)

• Teleport, Rename Cult, Allow Shrine Creation
• Building management: Free Building, Build All, Unlock All, Repair All
• Cleanup: Rubble, Trees, Landscape, Vomit, Poop, Dead Bodies, Outhouses
• Farming: Harvest All, Grow All Crops
• Rituals: Change Rituals (GUI), Clear Doctrines, All Rituals toggle
• Clothing: Unlock All, Give All Clothing Items
• Auto Clear Ritual Cooldowns

Followers (15+ options)

• Spawn (Worker, Worshipper, Arrived, Child)
• Kill All, Kill Random, Revive All
• Remove Sickness, Remove Hunger, Remove Exhaustion
• Convert Dissenting, Max Faith, Clear Faith
• Level Up All, Increase Loyalty, Make Immortal
• Max All Stats, Give Follower Tokens
• Age manipulation (Young/Old)
• Reset All Outfits (emergency fix)

Farming (20+ options)

• Spawn animals: Goat, Cow, Llama, Turtle, Crab, Spider, Snail
• Give x5 All Animals, All Wool, Eggs & Yolks, Special Poop, Milk
• Collect Products, Feed All, Clean All Pens, Force Grow
• Add Hearts to Animals, Ascend All Animals
• Friendly Wolf: Spawn, Dismiss, Pet, Dungeon Combat toggle

Weather (14 options)

• Clear Weather
• Rain (Light, Heavy)
• Wind (Light, Heavy)
• Snow (Dusting, Light, Medium, Heavy), Blizzard
• Heat (Light, Heavy)
• Season: Spring, Winter

DLC (15+ options)

• Seeds, Drinks, Brewing Ingredients, Forge Materials
• Sin Items, Broken Weapons, Legendary Fragments
• Collectibles, Necklace, Flockade Pieces, Story Items
• Reset DLC Dungeon, Fill/Empty Furnace
• Make Spies Leave, Finish Missions, Unlock Winter Mode

Splitscreen

• Full Player 2 support: Heal, Hearts, Godmode, Die

Misc

• Noclip, FPS/Follower/Structure Debug
• Hide/Show UI, Skip Hour/Day, Skip To Night/Dawn
• Complete All Quests, End Knucklebones
• Game Speed x2/x4, Pause Simulation
• Player Speed x2, Stop Time In Crusade

For detailed cheat descriptions, see: Available Cheats

🔄 Migration from Previous Versions

From v1.1.x to v1.2.0

1. Backup your config (optional): Copy BepInEx/config/org.xunfairx.cheat_menu.cfg
2. Delete old files: Remove old CheatMenu files from BepInEx/plugins/CheatMenu
3. Install v1.2.0: Extract the new version to BepInEx/plugins/
4. Menu changes: Categories are reorganized - some cheats moved to different categories:
   • Souls/Black Souls/Arrows are now in Resources (were in Health)
   • Player Speed x2 and Stop Time In Crusade are now in Misc (were in Combat)
   • Weather items renamed (no more "Weather:" prefix)
5. Config compatible: No config changes required

From v1.0.x to v1.1.x

1. Backup your config (optional): Copy BepInEx/config/org.xunfairx.cheat_menu.cfg
2. Delete old files: Remove old CheatMenu files from BepInEx/plugins/CheatMenu
3. Install v1.1.2: Extract the new version to BepInEx/plugins/
4. Config updates: New options will auto-generate with defaults
5. Controller users: Enable controller support in config if needed (enabled by default)
6. Keybind check: Previous keybinds may need reconfiguration in the config file

From v1.1.0/v1.1.1 to v1.1.2

• Simple drop-in replacement - just replace the DLL
• No config changes required
• Fixes additional follower scene-awareness issues

From v1.1.0 to v1.1.1

• Simple drop-in replacement - just replace the DLL
• No config changes required
• Fixes follower costume bug that was causing log spam

What Changed

• Weather cheats now use different API calls - old saves compatible
• Controller input completely rewritten - test your controller after update
• New categories added - explore the menu to find new features
• Some resource items have increased quantities (e.g., materials now give x50)
• Follower operations now have proper null checking and error handling

📦 Installation & Requirements

Dependencies

• BepInEx 5.4.21+ (Mod loader framework)
• Cult of the Lamb v1.5.16.1000+ (Latest game version recommended)

Installation Steps

1. Install BepInEx 5.4.21+ if not already installed
2. Extract CheatMenu.dll to BepInEx/plugins/CheatMenu/
3. Launch the game
4. Press M (or R3 on controller) to open the menu once in-game

Configuration

Config file location: BepInEx/config/org.xunfairx.cheat_menu.cfg

Key settings:

[Controller]
Enable Controller Support = true

[Keybinds]
GuiKeybind = M
BackCategory = N
CloseGuiOnEscape = true

🐛 Known Issues & Troubleshooting

🚨 LOADING SCREEN FREEZE (v1.1.2 Issue - FIXED in v1.1.3)

If your game hangs on the loading screen after using "Give All Clothing Items":

1. Install v1.1.3 (this version)
2. Start the game - It should reach the main menu
3. Load your save - Even if it hangs at loading screen
4. Wait ~10 seconds at the frozen loading screen
5. Press M (or R3 on controller) to open the cheat menu
6. Navigate to Followers category
7. Click "Reset All Follower Outfits"
8. Save and reload your game

Your game should now load normally! Follower clothing will be reset to default but all unlocks are preserved.

Controller Issues

• Controller not detected: Ensure controller is connected before launching game
• Wrong buttons: Some generic controllers may have different button mappings
• Navigation too sensitive: Built-in 150ms delay should prevent this, but you can navigate carefully

Menu Issues

• Menu won't open: Make sure you're in-game (not main menu)
• Animation stuck: Press ESC to force close, then reopen
• Window position wrong: Delete config file to reset

Game Compatibility

• Weather not working: Ensure game is updated to latest version
• Crashes on specific cheats: Some cheats may not work if game updates change APIs
• Mod not loading: Check BepInEx console for errors

Report issues on GitHub Issues

📝 Changelog

Version 1.2.0 (Current - MAJOR UPDATE 🎉)

• Menu Reorganization: All categories reordered logically (Health → Combat → Resources → Cult → Follower → Farming → Weather → DLC → Splitscreen → Misc)
• Fixed misplaced items: Souls/Black Souls/Arrows moved Health → Resources; Player Speed/Stop Time moved Combat → Misc
• Weather overhaul: Items grouped by type (Clear → Rain → Wind → Snow → Heat → Seasons) with custom sort ordering
• Removed unused categories: Rituals and Structures enums removed (cheats live inside Cult category)
• New SortOrder system: CheatDetails attribute now supports sortOrder parameter for precise menu ordering
• Consistent category display: Categories render in enum declaration order instead of arbitrary dictionary order
• Cleaned up names: Weather items no longer have redundant "Weather:" prefix
• 150+ cheats across 10 well-organized categories

Version 1.1.5 (Cheaters Edition 🐑)

• Easter Egg: Game version displays as "Cheaters Edition 🐑" in main menu
• Added: Automatic DLC authentication for all packs (Cultist, Sinful, Pilgrim, Heretic, Woolhaven)
• Fixed: "Clear Poop" cheat now properly grants XP to cleaning tool/hat
• Fixed: Janitor station clearing increments SoulCount to match game implementation
• Improved: DLC authentication now runs when DataManager is ready (not too early)
• Improved: Version text patching with better error handling and logging
• Benefit: All cheats work regardless of DLC ownership including Woolhaven content
• Fun: Playful "Cheaters Edition" label shows you're using the mod!

Version 1.1.4 (ENHANCED PROTECTION)

• Added: Defensive patch on Follower.Init() to validate skeleton data before outfit application
• Protection: Automatically resets outfits to safe defaults if skeleton isn't initialized
• Assembly-Verified: Fix based on actual decompiled game code showing missing null checks
• Scope: Protects against crashes from ANY mod or game bug, not just CheatMenu
• Benefit: Extra layer of protection on top of all v1.1.3 fixes
• Technical: Uses HarmonyLib Traverse to avoid spine-unity assembly dependency

✅ This release provides maximum protection against follower loading issues!

Version 1.1.3 (CRITICAL PATCH)

• CRITICAL FIX: Game hanging at loading screen after using "Give All Clothing Items"
• Fixed: NullReferenceException in FollowerBrain.SetFollowerCostume during spawn
• Fixed: GiveAllClothing now ONLY affects followers currently loaded in scene
• Added: "Reset All Follower Outfits" emergency fix cheat in Follower category
• Changed: GiveAllClothing description now accurately states it only affects loaded followers
• Improved: Better error messages and follower count in clothing cheat notification

⚠️ If you used "Give All Clothing Items" in v1.1.2 and can't load your save, see troubleshooting above!

Version 1.1.2 (Patch Release)

• Fixed: FollowerBrainInfo.Protection NullReferenceException for followers not in scene
• Fixed: GiveAllClothing now only updates followers active in the current scene
• Fixed: SpawnFollower checks if follower is active before calling CheckChangeState()
• Improved: Scene-awareness checks prevent accessing unloaded follower data
• Improved: Deferred outfit updates for followers not in scene

Version 1.1.1 (Patch Release)

• Fixed: Follower costume NullReferenceException spam in BepInEx logs
• Fixed: SpawnFollower now properly validates follower components
• Fixed: GiveAllClothing safely handles outfit updates with null checks
• Fixed: TurnFollowerYoung/Old functions handle outfit changes gracefully
• Improved: Comprehensive error handling for all follower operations

Version 1.1.0

• Complete weather system rewrite with proper API integration
• 30+ new resource items
• New Combat/QOL category with 8 major features
• Full Rewired-based controller support with bug fixes
• R3 suppression to prevent double-action with in-game bahhh
• Slide animation with smooth easing
• UI improvements and visual polish
• Assembly-verified API compatibility
• Better error handling and logging
• Multiple controller-related bug fixes

For full changelog history: doc/changelogs/

🙏 Credits

• Original Author: Wicked7000
• Current Maintainer: XUnfairX / firebirdjsb
• Contributors: Community bug reports and suggestions
• Repository: https://github.com/firebirdjsb/cheat-menu-cotl

📜 License

This mod is provided as-is for educational and entertainment purposes. Use at your own risk. Not affiliated with Massive Monster or Devolver Digital.

Enjoy the most comprehensive Cult of the Lamb cheat menu! 🐑✨

Compatible with Cult of the Lamb v1.5.16.1000+ | 150+ cheats across 10 categories