Mewgenics Patcher

Mewgenics Patcher

This tool is a lightweight, Python-based save editor for Mewgenics designed to provide a safe and accessible way to modify save data. It includes automatic backup functionality and implements reliable methods for editing abilities and passives without corrupting the save file.

Overview

The patcher allows users to:

• View active in-house cats (those assigned to rooms or currently on adventures).

• Modify base stats, including STR, DEX, CON, INT, SPD, CHA, and LUCK.

• Delete or replace mutations.

• Adjust cat age or remove the “Retired” status.

• Safely delete or replace abilities and passives, including problematic ones such as BloodFrenzy.

• Automatically generate a backup of the save file prior to any modifications.

This tool is intended for users who prefer a structured and reliable alternative to manual hex editing or unstable save editors.

Key Features

• User-friendly interface: Operates through an interactive command-line wizard that guides users step by step.

• Cross-platform support: Compatible with Linux (including Proton and Flatpak environments) and Windows systems, with automatic detection of common save file locations.

• Automatic backup system: Creates a backup file before applying any changes, allowing easy restoration if needed.

• Safe passive removal: Abilities and passives are removed using a structured, length-prefixed rewrite method to maintain file integrity and prevent common issues such as crashes or corrupted saves.

Editable Elements

Current functionality includes:

• Base stats: Users can directly assign values to all primary attributes.

• Abilities and passives: The tool detects ability records for each selected cat, allowing users to delete or replace them using internal ability identifiers (e.g., TakeAim).

Limitations

• Not all save file fields are currently supported.

• Primary targeting focuses on cats identified as “active in house,” though fallback options may display all detected cats if needed.

Requirements

• Python 3.10 or newer is recommended.

• Required dependencies:

  • lz4

  • rich

Installation:

• Windows: py -m pip install lz4 rich

• Linux: pip install lz4 rich

Usage

Basic command:

python mewgenics_patcher.py –scan –verify

• –scan initiates the interactive wizard.

• –verify performs post-edit validation checks (recommended).

If automatic save detection fails, a specific save file can be provided manually:

python mewgenics_patcher.py –scan –sav /path/to/steamcampaign01.sav –verify

Execution Process

When the tool is run:

• It locates available save files and prompts the user to select one.

• A backup file (.savbak) is created automatically.

• Active cats are listed with basic details.

• The user selects one or more cats to modify.

• Selected changes are applied directly to the save file.

Troubleshooting

• If save files are not detected, use the –sav parameter to specify the file path manually.

• If unexpected or unclear ability entries appear, avoid modifying them unless certain of their function.

• If the game crashes after patching, restore the backup file and report the issue with relevant details, including game version, changes made, and the affected cat.

Safety Notice

This tool modifies save files directly. Users should exercise caution when editing data, including avoiding invalid stat values or incorrect ability identifiers. Backup files are created automatically and should be used to restore data in case of errors.