PSDToUGUI

Key Features

Visual PSD Editor

- Open any `.psd` file directly in the Unity Editor — no Python dependency required

- Three-panel layout: Layer Tree | Canvas Preview| Per-Layer Properties

- Real-time composite preview with layer visibility toggling

- Inline layer rename (F2 / long-press), arrow-key navigation

- Canvas click-through: click on the preview to select the corresponding layer

- Optional: modify layer names/visibility and save back to the PSD

⚡ One-Click Export Pipeline

Open PSD → Configure per-layer options → Click Export → Done.

The full pipeline runs automatically:

PSD Parse → Layer Rasterisation → Local Dedup → Nine-Slice Detection

→ Common-Directory Dedup → PNG Export → Sprite Import → Prefab Generation

Three export modes:

Full Export : Slices + Dedup + Nine-Slice + Prefab (main + per-node standalone Prefabs)

Textures Only:All image processing, no Prefab generation

Subtree Export: Export a single node and its children; ideal for iterating on one screen

🧹 Intelligent Image Deduplication

Duplicate images waste memory and increase build size. This plugin eliminates them automatically.

Two dedup scopes:

Local Dedup: within the current export — identical button backgrounds, repeated icons, etc.

Common-Directory Dedup: against pre-existing images in shared asset folders across your project — no duplicate across your entire UI.

All parameters are tunable: fingerprint size, aspect-ratio tolerance, MAE threshold.

🔲 Automatic Nine-Slice Detection & Compression

Manually setting `spriteBorder` on hundreds of slices is tedious and error-prone. This plugin does it automatically.

🎭 Clipping Mask Support

PSD clipping groups are automatically composited:

- The base layer's alpha acts as a mask.

- Clipped layers are blended in premultiplied-alpha space.

- Result: one merged image, one Prefab node.

✏️ Text Layer Support (Text & TextMeshPro)

- Type layers export as `Text` or `TextMeshProUGUI` components with correct:

- Font size, text content, colour

- Outline (Stroke) effect → `Outline` / TMP outline

- Drop Shadow effect → `Shadow` / TMP underlay

- Gradient Overlay → per-vertex colour gradient

- **Font Mapping Config**: map PSD font names to Unity font assets (Text + TMP) via a dedicated editor window (`Tools → PSD → Font Mapping`)

- Unrecognised fonts are auto-logged and stub entries are created for you to fill in later

🧩 UI Component Auto-Attachment

Assign UI component types per layer in the editor. On export, the correct Unity component is added and wired:

| Component | Auto-Wired Properties |

|-----------|----------------------|

| **Button** | Click target |

| **ScrollBar** | Direction, handle child |

| **Slider** | Direction, fill rect, handle rect |

| **ScrollRect** | Viewport, content, scrollbars, direction |

| **Toggle** | Graphic child |

| **InputField** (Legacy & TMP) | Text, placeholder, viewport |

| **Dropdown** (Legacy & TMP) | Template, caption, item text |

Child references are resolved **by name from the PSD layer tree** — no manual drag-and-drop.

📁 Common Directory & Cross-PSD Asset Sharing

- Define shared asset folders (e.g. `Assets/UI/Common/`).

- Layers marked "Save to common directory" export their image there instead of the per-PSD folder.

- Other PSD exports automatically **dedup against common directories** — shared buttons, icons, and backgrounds are never duplicated.

🔧 Per-Layer Export Control

Every layer can be individually configured:

| Option | Description |

|--------|-------------|

| Exported | Include or exclude from export |

| Merge Export | Flatten a group into one image |

| Export Prefab | Generate a standalone Prefab for this subtree |

| External Prefab | Replace this node with an existing Prefab asset |

| Slice (Nine-Slice) | Enable/disable nine-slice per layer |

| Custom Nine-Slice Params | Override global params per layer |

| Primary Dedup Node | Prefer this layer's pixels in a dedup group |

| Custom Image | Use a hand-picked Sprite instead of slicing |

| Local / Common Dedup | Opt in or out per layer |

Quick Start

1. Import the package into your Unity project.

2. Open `Tools → PSD → PSD Editor`.

3. Click **Open PSD File** and select your `.psd`.

4. Browse the layer tree. Configure per-layer options in the right panel.

5. Set image and Prefab output folders in the bottom panel.

6. Click **Export** — your sliced PNGs and ready-to-use Prefab are generated instantly.