ImportShield — Quick Start Guide (60-Second Setup)
Welcome to ImportShield — the commercial-grade impulse-buy safety net and reference repair suite for Unity.
1. Installation & Zero-Configuration Activation
ImportShield activates automatically upon package installation.
- Open Tools ▸ ImportShield ▸ ImportShield Window (or press the 🟢 ImportShield pill in the top-right of your Scene View).
- ImportShield automatically indexes your project and establishes a pristine Baseline Snapshot.
- You are now Protected 🟢.
2. Before You Import: Package Preflight
Never import an untrusted .unitypackage blindly again!
- Go to Tools ▸ ImportShield ▸ Preflight Package….
- Drag and drop any
.unitypackageinto the drop zone. - Inspect the instant GREEN / AMBER / RED safety verdict:
- Will Overwrite: Files that replace your existing project assets.
- GUID Collisions: Duplicated metadata that would corrupt references.
- Duplicate Classes: Script names (e.g.
PlayerController.cs) that would cause compile errors.
- Click Import Safely — ImportShield takes an atomic pre-import snapshot, creates file backups, and runs the import.
3. After an Import: The Change Report & Blast Radius Map
If an import replaces meta files or breaks references:
- ImportShield automatically detects the import settle event.
- Open the Changes tab:
- Inspect the Blast Radius Map: Visual node graph radiating outward from the imported package to affected scenes and prefabs.
- Separate New Breaks from Pre-existing Breaks (ImportShield never blames an import for old damage).
- Click any broken reference to inspect its Evidence Card:
- Understand WHY it broke (Cause C1–C8).
- Review ranked Fix Candidates with honest confidence scores (Certain, High, Medium, Low).
- Click ⚡ Fix All High+ Confidence (Preview):
- Review the two-pane diff in the Diff Viewer.
- Click Apply Plan — watch the Blast Radius Map cascade to green!
- Need to undo everything? Click ↩ Undo Import to restore all overwritten and deleted files.
4. Healing Pink Shaders (Material Doctor)
Upgrading to URP or imported materials looking neon magenta?
- Open the Materials tab in the ImportShield Window.
- Inspect all materials with missing or legacy Built-in shaders.
- Click Migrate to URP Lit (Preview) to swap the shader and automatically map legacy properties (
_MainTex→_BaseMap,_Color→_BaseColor,_Glossiness→_Smoothness).
5. Cleaning Dead Scripts (Component Stripper)
- Open the Stripper tab.
- Review all prefabs and scenes with
Missing (MonoBehaviour)components. - Click Strip Missing (Preview) — safely cleans GameObject component arrays with journal backup and 1-click rollback.
6. Safety & Rollback Guarantee
Every repair is journaled to <ProjectRoot>/ProjectDoctorData/Transactions/:
- Go to the History tab at any time to inspect past repairs.
- Click Rollback Transaction to restore byte-identical originals, even after restarting Unity!
“No tool can truthfully guarantee ‘zero risk’ or ‘zero data loss’; ImportShield fails closed and tells you the truth instead of pretending otherwise.”