Skip to content

toolsstudio/metaguard-docs

MetaGuard Pro — Unity GUID Integrity Engine



Unity Version Platform Asset Store

This documentation reflects MetaGuard Pro 2.x (current stable). For older versions, see Legacy Version below.


Overview

Unity projects accumulate GUID corruption silently. Broken asset references, duplicate GUIDs, and orphaned .meta files compound over time — surfacing during merges, after directory restructuring, or at release.

MetaGuard Pro scans every asset in the project, builds a directed dependency graph, classifies every GUID integrity issue by risk level, tests every proposed fix against the graph before touching any file, and applies only operations it can verify are safe — with a pre-apply snapshot and 48-hour rollback window on every session.

No file is modified without a recoverable snapshot. No operation reaches Apply without passing simulation.


Pipeline

Scan  ──►  Analyze  ──►  Simulate  ──►  Apply  ──►  Rollback

Quick Start

Tools > MetaGuard Pro > Open
  1. Click Scan + Analyze
  2. Review detected issues in the Issues tab
  3. Click Simulate — confirm all intended operations show Safe
  4. Click Apply or Fix All Safe
  5. If the result is unexpected — click Rollback

Requirements

  • Unity 2020.3 LTS or later (including Unity 6)
  • All render pipelines: Built-in, URP, HDRP
  • Editor-only — zero runtime footprint, excluded from all builds

Documentation

Document Description
Getting Started First scan, first rollback, recommended workflow
Installation Import steps, folder layout, updating, uninstalling
Usage Every button, tab, and control explained
Features Full feature reference
Policy System Per-project rules, team sharing, CI enforcement
CLI & CI Integration Batch mode, JSON reports, exit codes, GitHub Actions
Safety & Rollback Snapshot model, session lifecycle, crash recovery
Cache System When to enable, disable, and reset the scan cache
Demo System Seeding and validating the test environment
Best Practices Team workflows, source control, CI gates
Troubleshooting Common issues and resolutions
FAQ Frequently asked questions
Changelog Full version history

Support

Channel
Discord Discord — primary support channel
Bug Reports Discord
Email Contact us
Asset Store Asset Store

Legacy Version

MetaGuard 1.x (free, end-of-life) documentation is preserved at versions/v1/.


Tools Studio — Professional Unity Tooling

About

Official documentation for MetaGuard — a Unity GUID integrity and safe asset repair tool.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors