When using Linux (Steamdeck for example), you first need to run the game once before using the Installer. This is because Steam first needs to generate the Proton-Prefix which then automatically gets configured by the BepInEx Installer to work on Linux.

Harmony Patches

These patches are automatically applied when the mod loads:

Core Patches

• Editor Mode Enabler

  • Enables Unity Editor mode features
  • Always active

• Instant Baby Birth

  • Makes dwellers ready to give birth instantly
  • Toggleable via /instababy command
  • Patches: Dweller.get_BabyReady

• Instant Child Growth

  • Makes children grow to adults instantly
  • Toggleable via /instaadult command
  • Patches: DwellerParameters.get_ChildhoodDuration

Population & Capacity Overrides

• Maximum Dweller Count Override

  • Removes dweller population limit (sets to 2,147,483,647)
  • Configuration: Plugin.patchOverrideMaxDwellers
  • Patches: DwellerManager.get_MaximumDwellerCount, DwellerManager.get_VaultIsWithMaxPopulation

• Living Quarters Override

  • Allows adding dwellers beyond living quarters capacity
  • Configuration: Plugin.patchOverrideLivingQuarters
  • Patches: Vault.CanAddDwellers

Season Pass Features

• Premium Plus Season Pass
  • Automatically enables Premium Plus features
  • Configuration: Plugin.overridePremiumPlusPass
  • Patches: BaseSeasonDataManager.ImportSaveData

Visual Enhancements

• Card Color Customization
  • Legendary Card Glow & Border: Magenta
  • Normal Card Glow & Border: Green
  • Rare Card Glow & Border: Cyan
  • Patches: ItemParameters (6 patches for glow and border colors)

Tracking & Logging

• Dweller Tracking

  • Automatically tracks all dwellers, experiences, stats, and training slots
  • Used by cheat commands to manipulate dweller data
  • Patches: Dweller.Awake, DwellerExperience constructor, DwellerStats constructor, TrainingSlot constructor

• Encryption Key Logging

  • Logs encryption keys and vectors for save file manipulation
  • Patches: StringCipher methods, PersistenceManager.Decrypt

Cheat Commands

Dweller Cheats

/maxdwel - Max Level Dwellers

• Description: Levels all dwellers to maximum level (50)
• Category: Dwellers
• Effect: Gradually applies LevelUP() and max experience to all dwellers

/maxspec - Max Special Stats

• Description: Sets all dweller SPECIAL stats to 10
• Category: Dwellers
• Effect: Sets Strength, Perception, Endurance, Charisma, Intelligence, Agility, and Luck to maximum

/fintrain - Finish All Trainings

• Description: Instantly completes all ongoing dweller training
• Category: Dwellers
• Effect: Calls FinishTraining() on all training slots

/resdwlvl - Reset Dweller Levels

• Description: Resets all dwellers to level 1
• Category: Dwellers
• Effect: Sets level and experience to minimum values

/genlegenddweller - Create Random Legendary Dweller

• Description: Spawns a random legendary dweller at the vault entrance
• Category: Dwellers
• Effect: Creates a legendary dweller of random gender

/instababy - Instant Baby Cheat (Toggle)

• Description: Makes pregnant dwellers give birth instantly
• Category: Dwellers
• Type: Toggle
• Effect: Overrides pregnancy timer

/instaadult - Instant Adult Cheat (Toggle)

• Description: Makes children grow into adults instantly
• Category: Dwellers
• Type: Toggle
• Effect: Sets childhood duration to 0

Resource Cheats

/maxres - Max Resources

• Description: Sets power, water, and food to maximum values
• Category: Resources
• Effect: Sets all three resources to 2,147,483,600

/setres <amount> - Set Resources

• Description: Sets power, water, and food to a specific value
• Category: Resources
• Usage: /setres 1000

/nuka <amount> - Set Nuka Cola

• Description: Sets Nuka Cola to specified amount
• Category: Resources
• Usage: /nuka 9999

/quantum <amount> - Set Nuka Quantum

• Description: Sets Nuka Cola Quantum to specified amount
• Category: Resources
• Usage: /quantum 500

/pokerchip <amount> - Set Poker Chips

• Description: Sets Poker Chip currency to specified amount
• Category: Resources
• Usage: /pokerchip 10000

/setstimrad <amount> - Set Stimpacks & Radaways

• Description: Sets both Stimpacks and Radaways to specified amount
• Category: Resources
• Usage: /setstimrad 999

/setboxes <amount> - Set Lunchboxes

• Description: Adds specified number of lunchboxes
• Category: Resources
• Usage: /setboxes 50
• Note: Omit amount to add just 1

/setmrhandy <amount> - Set Mr. Handy Boxes

• Description: Adds specified number of Mr. Handy boxes
• Category: Resources
• Usage: /setmrhandy 10
• Note: Omit amount to add just 1

/setpetboxes <amount> - Set Pet Carrier Boxes

• Description: Adds specified number of Pet Carrier boxes
• Category: Resources
• Usage: /setpetboxes 20
• Note: Omit amount to add just 1

Weapon & Pet Cheats

/overridedamage - Override Weapon Damage (Toggle)

• Description: Sets all weapon damage to 1000-1001
• Category: Weapons
• Type: Toggle
• Effect: Prefixes weapon names with “OP” and overrides damage values
• Patch: DwellerWeaponItem.GetName

/overpoweredpets - Overpowered Pets (Toggle)

• Description: Sets all pet bonus effects to 1000
• Category: Pets
• Type: Toggle
• Effect: Massively increases all pet bonuses
• Patch: Pet.GetFollowerBonusForEffect

Storage & Limit Overrides

/overridestoragelimit - Override Storage Limit (Toggle)

• Description: Removes storage limits for resources and items
• Category: Resources
• Type: Toggle
• Default: Enabled
• Effect: Sets max storage to 1,073,741,823
• Patches: Inventory.SetMaxItems, VaultStorage.AddModifier

/setstoragelimit <amount> - Set Storage Limit

• Description: Sets custom storage limit (requires /overridestoragelimit active)
• Category: Resources
• Usage: /setstoragelimit 500000
• Note: Must be used with Override Storage Limit enabled

/overridepetlimit - Override Pet Limit (Toggle)

• Description: Removes pet storage limits
• Category: Resources
• Type: Toggle
• Default: Enabled
• Effect: Sets max pet storage to maximum values
• Patches: Inventory.SetMaxItems, VaultStorage.AddModifier
• Note: Currently commented out in active cheats list

Save File Management

/decryptsaves [file_path] - Decrypt Game Saves

• Description: Decrypts Fallout Shelter save files to JSON format
• Category: Saves
• Usage: /decryptsaves or /decryptsaves C:\Custom\Path\output
• Default Location: %LocalAppData%\FalloutShelter\decrypted_Vault{n}.json
• Effect:
  • Finds all .sav files in save directory
  • Decrypts using game’s cipher
  • Pretty-prints JSON output
  • Creates numbered files for each save

/encryptsaves [file_path] - Encrypt Game Saves

• Description: Re-encrypts modified JSON files back to .sav format
• Category: Saves
• Usage: /encryptsaves or /encryptsaves C:\Custom\Path\input
• Default Location: Reads from %LocalAppData%\FalloutShelter\decrypted_Vault{n}.json
• Effect:
  • Reads decrypted JSON files
  • Minifies JSON
  • Encrypts using game’s cipher
  • Creates backup of original saves
  • Writes encrypted data back to .sav files

Recipes (Currently Disabled, WIP/Experimental)

/unlockallrecipes - Unlock All Recipes

• Description: Unlocks all crafting recipes in the game
• Category: Recipes
• Status: ⚠️ Currently commented out in active cheats list, as it is not working yet.
• Effect: Calls Items.UnlockAllRecipes()

Configuration Options

The following boolean flags can be configured in the Plugin’s config-file:

• instaBabyCheatEnabled - Controls instant baby birth
• instaAdultCheatEnabled - Controls instant child growth
• overrideWeaponDamageEnabled - Controls weapon damage override
• overridePremiumPlusPass - Controls season pass override
• patchOverrideMaxDwellers - Controls max dweller limit removal
• patchOverrideLivingQuarters - Controls living quarters limit override

Technical Notes

Tracking Systems

The mod maintains several lists to track game objects:

• dwellers - All Dweller instances
• dwellerExperiences - All DwellerExperience instances
• dwellerStats - All DwellerStats instances
• trainingSlots - All TrainingSlot instances
• dwellerChildren - All DwellerChild instances

Encryption Details

The mod captures encryption keys and initialization vectors used by the game:

• keyBytes - AES encryption key
• ivBytes - AES initialization vector
• decryptPassphrase - String passphrase used for encryption

These are logged and used for save file manipulation.