BizSim Unity Figma Importer

BizSim-Game-Studios/com.bizsim.unity.figma.importer

Unity package and required Editor companion to the Figma2UnityUIToolkit plugin. Reads the plugin's generated Asset Manifest and downloads images, icons, and fonts from Figma via REST API to produce working UI Toolkit UXML/USS.

com.bizsim.unity.figma.importer

figma ui-toolkit asset-import editor bizsim csharp editor-tool figma-api openupm unity unity-package unity-plugin unity3d upm uxml

Unity Compatibility

Unity 6 Supported

2023.2 Unsupported

2023.1 Unsupported

2022.3 LTS Unsupported

2021.3 LTS Unsupported

2020.3 LTS Unsupported

2019.4 LTS Unsupported

Install via UPM

Add to Unity Package Manager using this URL

https://www.pkglnk.dev/bizsim-game-studios-importer.git

README Markdown

Copy this to your project's README.md

Style

Preview

## Installation

Add **BizSim Unity Figma Importer** to your Unity project via Package Manager:

1. Open **Window > Package Manager**
2. Click **+** > **Add package from git URL**
3. Enter:
```
https://www.pkglnk.dev/bizsim-game-studios-importer.git
```

[![pkglnk](https://www.pkglnk.dev/badge/bizsim-game-studios-importer.svg?style=pkglnk)](https://www.pkglnk.dev/pkg/bizsim-game-studios-importer)

README

Unity Figma Asset Importer

Required companion to the Figma2UnityUIToolkit Figma plugin. This Unity Editor tool reads the Asset Manifest emitted by that plugin and downloads the actual image, icon, and font files from Figma via the REST API — without it, the generated UXML/USS has no assets to reference.

Package: com.bizsim.unity.figma.importer Namespace: BizSim.Unity.Figma.Importer.Editor Author: BizSim Game Studios License: MIT

How It Fits Together

┌────────────────────────────┐       ┌──────────────────────────────────┐
│ Figma2UnityUIToolkit       │       │ com.bizsim.unity.figma.importer  │
│ (Figma Dev Mode plugin)    │       │ (this Unity Editor package)      │
├────────────────────────────┤       ├──────────────────────────────────┤
│ Generates:                 │       │ Reads the Asset Manifest         │
│  • UXML                    │  ──▶  │ Fetches images/icons/fonts from  │
│  • USS                     │       │ Figma via REST API               │
│  • Asset Manifest (JSON)   │       │ Writes them into the project     │
└────────────────────────────┘       └──────────────────────────────────┘

The Figma plugin is a codegen plugin — it can only emit text (UXML/USS/JSON). It cannot download binary assets. This Unity package handles that second half of the pipeline. Using one without the other gives you either unreferenced files or missing assets.

Figma plugin repo: https://github.com/BizSim-Game-Studios/Figma2UnityUIToolkit
Local path (monorepo users): D:\Projects\_tools\Figma2UnityUIToolkit

Installation

Window → Package Manager → + → Add package from git URL...

https://github.com/BizSim-Game-Studios/com.bizsim.unity.figma.importer.git

Or pin a version:

https://github.com/BizSim-Game-Studios/com.bizsim.unity.figma.importer.git#v1.0.0

Or add directly to Packages/manifest.json:

"com.bizsim.unity.figma.importer": "https://github.com/BizSim-Game-Studios/com.bizsim.unity.figma.importer.git"

Quick Start

Install the Figma plugin. In Figma, enable Figma2UnityUIToolkit in Dev Mode.
Generate a manifest. Select a frame, open the Inspect panel, choose Asset Manifest as the codegen output, copy the JSON into a file inside your Unity project.
Open the importer. In Unity: Window → Figma Asset Importer.
Enter your Figma Personal Access Token (stored in EditorPrefs, not checked into version control) and your Figma File Key.
Select the manifest file and click Import. Assets are fetched over the Figma REST API and placed into the paths configured in your importer settings.

Requirements

Unity 6000.0 or newer
A Figma Personal Access Token with read access to the target file
The Figma2UnityUIToolkit plugin installed in Figma to produce the Asset Manifest this importer consumes

License

MIT — see LICENSE.md.

Comments

No comments yet. Be the first!