Unity Assets Patcher

Documentation · 简体中文

Unity Assets Patcher is a terminal application for inspecting Unity assets files and installing or uninstalling assets mods. It is intended for games where runtime mod frameworks such as BepInEx are impractical, using a manifest.json inside each mod package to describe file copies and assets modifications.

Features

• An interactive terminal UI for inspecting assets files and installing or uninstalling zip-based mod packages.
• A non-interactive CLI with text and JSON output.
• Manifest validation with JSON Schema and semantic rules.
• Backups and install records for safe uninstallation and interrupted-operation recovery.
• Validation of mod ZIP entries, file paths, directory traversal, and unsafe file operations.

Documentation

• Get started
• Frequently asked questions
• Mod manifest guide

Download

Download the latest Windows executable from GitHub Releases. The current release supports win-x64 and is distributed as a self-contained single file.

.\UnityAssetsPatcher.exe

Development and Contributing

Development requires the .NET 10 SDK. Run the following commands from the repository root:

dotnet run --project src\UnityAssetsPatcher\UnityAssetsPatcher.csproj
dotnet build UnityAssetsPatcher.slnx
dotnet test UnityAssetsPatcher.slnx

Project source code is located under src/, and test projects are located under tests/.

Issues and Pull Requests are welcome!

License

This project is licensed under the MIT License.

Changelog

See the CHANGELOG.

Credits

• AssetsTools.NET
• AssetsRipper TPK