Projelere dön

Unity eklentisi · Figma → uGUI

Regalia

Bu eklenti oyununuzun arayüzünü Figma’dan Unity’ye taşır. Renk ve metin stilleri uGUI ve TextMeshPro’da palet ve metin stilleri olur; ic- ve img- bileşenleri sprite, bileşenler prefab, ekranların tamamı çalışan prototip bağlantılı bir Unity sahnesi olur. Projeye sessizce hiçbir şey girmez: her senkron, inceleyip kabul ettiğiniz bir değişiklik listesi olarak gelir

Neler senkronize edilebilir

  • Proje bileşenleri, değiştirilebilir durumlu prefab olarak Auto layout, Boolean, Instance, Grid, Lock aspect ratio ve kaydırma ile. Varyantların köşe yarıçapları ve kontürleri farklı olabilir
  • Opaklık, büyük/küçük harf ve aralıklı renk ve metin stilleri Dolgu, stroke ve metindeki gradyanlar, gölgeler ve farklı stroke türleri dahil
  • Prototip bağlantıları ve geçiş animasyonları Tıklamalar, tuşlar, hover, overlay’ler, Scroll to, Dissolve, Move, Push, Slide ve Smart animate
  • Vektör ikonlar (SVG) ve raster görseller (PNG x2) Addaki ic- ve img- öneklerine göre
  • Google Fonts’tan tek tıkla font, veya yerel klasörden
  • Katman dolgusundaki görseller Fill, Fit, Crop ve Tile, yuvarlatılmış şekiller dahil. Token modunda indirilir
  • Vektörler, çizgiler ve boolean şekiller SVG sprite olarak gelir ve renk stilini korur
  • Bileşenlerin Boolean ve metin özellikleri Her instance’tan aktarılır, oyunda FigmaProperties.Set ile değiştirilir

Neler senkronize edilemez

  • Bulanıklıklar, blend mode’lar ve bazı gölgeler Layer blur, Background blur, Normal dışındaki blend mode’lar, metindeki iç gölge ve ikondaki ya da dolgusuz frame’deki gölge aktarılmaz; eklenti uyarır
  • calc() ve yüzdeli Grid Bu track’ler eşit olur. px, fr ve Hug grid’ler olduğu gibi aktarılır
  • Renk stilindeki görsel veya video Böyle bir stil aktarılmaz — görseli img- bileşeni yapın
  • Token ile Variables ve ajan üzerinden görsel dolgular REST Variables’ı yalnızca Enterprise planda verir; bu yüzden ajan üzerinden gelir. Ajan görsel dolguları indirmez — yer boş kalır

Eklenti nasıl kullanılır

Eklentiyi bağlama, senkronu kabul etme ve prefab üzerindeki elle düzenlemeleri koruma

Hızlı başlangıç

Demo zaten projede: Samples/Demo/Scenes/Startscreen.unity. Play, Figma ve token olmadan çalışır. Senkron denemek için Starter Kit’i çoğaltıp kopyayı bağlayın veya doğrudan kendi projenize gidin

  • BöyleStartscreen’i açıp Play’e basın
  • Böyle değilTMP Essential Resources olmadan demoyu çalıştırmak

İki çalışma modu

Varsayılan olarak eklenti kişisel token ile Figma’yı kendisi okur; ajan ve MCP yok. Diğer yol: Figma MCP ve MCP for Unity üzerinden ajanınız. Her iki modda da değişiklikleri siz kabul edersiniz

Token’ın ihtiyaç duyduğu scope’lar

  • current_user:read
  • file_content:read
  • library_content:read
  • BöyleToken yalnızca sizin makinenizde kalır
  • Böyle değilView / Collab koltuğunda her düzenlemeden sonra ajanla senkron

Proje ayarları

Eklentinin ihtiyacı olan her şey tek bir ayar asset’inde: Figma dosyası, bileşen kaydı, hariç stiller ve proje klasörleri. Assets → Create → Regalia → Settings ile oluşturun; eklenti klasörleri yanında belirir

  • BöyleProje UI’sinin yanında tutun, git’te
  • Böyle değilAyarları Assets kökünde oluşturmak

Renkler ve fontlar

Görsele veya metne UiColorRef, TMP’ye UiTextStyleRef koyun. Figma stillerinden renk ve font alırlar; senkron sonrası arayüz kendini yeniden boyar

// dark theme in one line
variables.SetMode("Theme", "Dark");
  • BöyleFigma’da rengi değiştirip senkron edin
  • Böyle değilRengi inspector’da elle vermek

Senkron

Synchronize, Assets dışında UserSettings’te bir taslak oluşturur. Projeye ancak Accept the updates sonrası girer

  • BöyleYeni, değişen ve silineni gözden geçirin
  • Böyle değilDeğişikliklerin kendiliğinden projeye girmesini beklemek

Bileşenler · beta

Bir variant set, durumlu tek prefab olur. Prefab Figma’dan yeniden kurulur; içindeki elle düzenlemeler silinir

buttonVariants.Set("Size", "Large");
  • BöyleDüğme mantığı prefab üstünde Prefab Variant’ta
  • Böyle değilOluşturulan düğme prefab’ını elle düzenlemek

Bileşen özellikleri

Bir bileşenin Boolean ve metin özellikleri, bağlı katmanlarıyla birlikte prefab kökündeki FigmaProperties’e gider. Bir instance kendi değerlerini getirir

properties.Set("Show icon", false);
properties.Set("Label", "Play");
  • BöyleVaryant değişimi değerleri korur
  • Böyle değilHer varyant değişiminden sonra değerleri yeniden atamak

Durumlar

Default, Hover, Pressed, Disabled, Focused seti fare, klavye ve gamepad ile varyantı değiştirir

  • BöyleState = Default / Hover / Pressed
  • Böyle değilOn / Off gibi kendi değer adlarınız

Ekranlar

Screens sekmesi token modunda çalışır. İşaretli bölümler ekran olur; Move the screen önce bileşenlerini taşır. Build a scene kamera, Canvas ve prototip bağlantılarına göre geçişler ekler

  • BöyleKopyalar için «[» karakterine kadar aynı ad
  • Böyle değilAynı ekranın kopyalarında farklı adlar

Kaynaklar ve fontlar

ic- ikonlar SVG, img- görseller PNG ×2 gelir. Eksik font Google Fonts’tan indirilir veya klasörden bağlanır

  • Böyleic-lockClose-28 ve img-PlayerCard-bg
  • Böyle değilicon-lock veya image 12

Katman bulma

Kodda Figma nesnesi mi lazım? FigmaNodeRef.Find katman id’siyle bulur. İç içe ve düz ekran için aynı çağrı

var title = FigmaNodeRef.Find(root, "857:470");
  • BöyleKatman bağlantısındaki id: node-id=857-470 → 857:470
  • Böyle değilNesneyi ada göre aramak — uzun metinler yeniden adlandırılır

Tam kılavuz ve eklenti yapısı şurada: Documentation/DeveloperGuide.en.md ve Documentation/README.md

SSS

Stilim neden Unity’ye gelmedi

Styles sekmesinde içe aktarma kutusu kapalı. Token modunda bir durum daha: stil hiçbir katmanda yok, REST onu döndürmez

Pencerede «node missing» yazıyor

Katman silinip yeniden çizildi; yeni id’si var. Bileşeni yeniden içe aktarın, sonra mevcut katmanları düzenleyin

Eklenti Figma kotasını harcar mı

Token modunda hayır. Ajan modunda senkron, bileşen aktarımı veya görsel indirme bir çağrıdır. İkonlar 10–20’lik paketlerle gider

Oluşturulan prefab’ı düzenleyebilir miyim

Yeniden kurulum Figma’dan gelir ve elle düzenlemeleri siler. Mantığı prefab üstündeki Prefab Variant’a koyun

Game görünümünde metin bulanık

macOS’ta Game görünümü aspect menüsünde Low Resolution Aspect Ratios’u kapatın. Bu önizleme; font veya aktarım değil

Demo metinleri görünmüyor

TextMeshPro kaynaklarını içe aktarın: Window → TextMeshPro → Import TMP Essential Resources. Onlarsız demoda TMP_SDF-Mobile shader’ı yoktur

Figma token’ı nerede tutulur

Kullanıcı dosyanızda LocalApplicationData/Regalia/figma-token. Projeyle gitmez. Sızarsa Figma’da iptal edin

Destek

Sorular ve hatalar help@makstorch.com
Mutlaka eklenti sürümü, Unity, OS yazın ve ekran görüntüleri ekleyin