GitHub - JakLuminth/SenranKaguraAspectMOD: Aspect-ratio patcher for SENRAN KAGURA games. Supports widescreen/ultrawide presets with automatic backups and revert capability. · GitHub
Skip to content

About

Aspect-ratio patcher for SENRAN KAGURA games. Supports widescreen/ultrawide presets with automatic backups and revert capability.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Senran Kagura Aspect Ratio MOD Tool

A Windows desktop utility for applying widescreen and ultrawide aspect-ratio fixes to supported SENRAN KAGURA PC titles.

Supported Games

  • SENRAN KAGURA Estival Versus (EV)
  • SENRAN KAGURA Burst Re:Newal (BrN)
  • SENRAN KAGURA Peach Beach Splash (PBS)
  • SENRAN KAGURA Reflexions
  • SENRAN KAGURA Peach Ball (PB)

Note: Patching support for PBS, Reflexions, and Peach Ball is currently fairly basic. Additional issue fixes and broader patch coverage are being investigated.

Download

Quick Start

  1. Place the tool executable in the root folder of a supported game.
  2. Launch the tool.
  3. Select a game (auto-selected when exactly one supported executable is detected).
  4. Select an aspect ratio preset.
  5. Click Apply and confirm.
  6. Wait for completion.
  7. (Optional) Use Show Log to review detailed patch output.

While Apply or Revert is running, selection controls and action buttons are disabled to prevent overlapping operations.

Features

  • Multi-game support with a single UI
  • Auto-detection when exactly one supported game executable exists in the folder
  • Aspect ratio presets:
    • 16:10
    • 15:9
    • 16:9
    • 21:9 (2560 by 1080)
    • 21:9 (3440 by 1440)
    • 21:9 (3840 by 1600)
    • 32:9
  • Patches executable offsets for the selected game
  • Patches additional binary data files based on game layout:
    • Character camera files (GameData\\Motion\\Player\\*cam.cat)
    • EV beach files (GameData\\Motion\\Beach\\*.cat)
    • EV creative finish files (GameData\\Placement\\plbg\\*.cat)
    • BrN UI files (GameData\\Ui\\*data.cat, including subfolders)
  • Fast binary scanning and parallel file patching for data-file operations
  • Timestamped in-app logging with expandable/collapsible log panel
  • One-click revert using created backups

Backup and Revert Behavior

  • The first time a file is patched, a backup is created and preserved for reuse.
  • Executable backups are created as *.backup beside the game executable.
  • Data-file backups are stored under a Backup subfolder in each patched data directory.
  • Revert restores the executable and any available backed-up data files for the selected game.

By default, Delete backups automatically is enabled. After a successful revert, backup files/folders are removed unless that option is disabled first.

Important: Revert before applying a different ratio. Applying multiple ratios in sequence without revert can leave mixed values.

Apply rejects executables whose patch locations do not contain the verified original bytes. If the executable is already patched, use Revert first. If it is an unsupported build or was modified by another tool, restore the original game files. An existing executable backup must match the original executable before it can be reused; preserve a conflicting backup elsewhere before applying again.

These checks validate the patch locations, not the entire game build. See Executable validation for the configured offsets, expected bytes, and compatibility limitations.

Development checks

Run these from the repository root on Windows with the .NET 10 SDK and PowerShell 7:

dotnet build -c Release
dotnet run --project tests/RegressionTests/RegressionTests.csproj -c Release
pwsh -NoProfile -File tests/PublishReleaseNotes.Tests.ps1

The regression checks use temporary synthetic files and an unshown form. They do not patch installed games, contact GitHub, or publish releases.

Credits

This project is based on the original work and guide by Loggey:

Thanks to Loggey for the original offsets, process, and tool concept.

Disclaimer

  • This tool edits local game files only.
  • Use at your own risk.
  • Keep your own independent backups if needed.
  • AI used for the generation of code.

About

Aspect-ratio patcher for SENRAN KAGURA games. Supports widescreen/ultrawide presets with automatic backups and revert capability.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages