Regalia 1.0.0
🛠️ Geliştiriciler içinUnity 6000.0 ve üzeri, uGUI + TextMeshPro, Built-in, URP ve HDRP. İsteğe bağlı: Vector Graphics ve ajan modu için MCP for Unity 10+. Pencere ve kılavuzlar 7 dilde
Terminal
Unity eklentisi · Figma → uGUI
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
Regalia 1.0.0
🛠️ Geliştiriciler içinUnity 6000.0 ve üzeri, uGUI + TextMeshPro, Built-in, URP ve HDRP. İsteğe bağlı: Vector Graphics ve ajan modu için MCP for Unity 10+. Pencere ve kılavuzlar 7 dilde
Starter Kit
🎨 Tasarımcılar içinTemiz aktarım kurallarını içeren ücretsiz şablon: stil kurulumu, UI kit, kaynak hazırlığı ve örnek ekranlar
Eklentiyi bağlama, senkronu kabul etme ve prefab üzerindeki elle düzenlemeleri koruma
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
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:readfile_content:readlibrary_content:readEklentinin 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
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");
Synchronize, Assets dışında UserSettings’te bir taslak oluşturur. Projeye ancak Accept the updates sonrası girer
Bir variant set, durumlu tek prefab olur. Prefab Figma’dan yeniden kurulur; içindeki elle düzenlemeler silinir
buttonVariants.Set("Size", "Large");
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");
Default, Hover, Pressed, Disabled, Focused seti fare, klavye ve gamepad ile varyantı değiştirir
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
ic- ikonlar SVG, img- görseller PNG ×2 gelir. Eksik font Google Fonts’tan indirilir veya klasörden bağlanır
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");
Tam kılavuz ve eklenti yapısı şurada: Documentation/DeveloperGuide.en.md ve Documentation/README.md
Oyunun Figma ile eşleşmesi için dosyayı nasıl hazırlayacağınız
1920×1080’de tasarlayın. Başka bir oran, referans birimlerinde kendi frame’idir: yükseklik veya genişlik 1080 ya da 1920’ye yakın kalır
Constraints çapa dönüşür. Tam ekran öğe Left & Right ve Top & Bottom ister. Auto layout içinde Fill, Hug ve Fixed karar verir
Yön, padding, gap, Fill, Hug, Fixed ve Absolute position aktarılır. Space between, Wrap, Grid ve kaydırma da. 12.5 → 13 olur
Font, boyut, aralık ve büyük/küçük harf Text Style’dan; renk Color Style’dan gelir. Her run’ın stili varsa karışık run’lar da aktarılır
Renkler Color Styles’ta yaşar; temalar için Variables’a bağlayın. Stil gradyanı dolgu, stroke ve metne aktarılır
Varyant katmanları ada göre eşleşir. Boolean, metin ve ikon, görsel veya bileşen değişimi aktarılır
Değerler: Default, Hover, Pressed, Disabled, Focused. Beşini de çizmek gerekmez: Pressed yoksa basışta Hover görünür
Tıklama, tuş, hover ve press, navigate, varyant değiştirme, Back, bağlantı, overlay ve Scroll to çalışır. Dissolve, Move, Push, Slide ve Smart animate oynar
ic- ve ic_ SVG’dir. img- ve img_ frame boyutunun iki katı PNG’dir. Kaynak bir bileşen olmalıdır. Öneksiz vektörler ve şekiller de SVG sprite gelir
Geliştirici bölümleri işaretler; frame’leri ekran olur. Aynı ekranın kopyalarını «[» karakterine kadar aynı adlandırın
Katman oyuna id ile bağlıdır. Silip yeniden çizerseniz yeni id olur; eklenti penceresinde «node missing» görünür
Metin stilinin fontu projede olmalı: Google Fonts düğmesi veya RobotoSlab-Black.ttf gibi adlı .ttf / .otf
Tam kılavuz ve eklenti yapısı şurada: Documentation/DesignerGuide.en.md ve Documentation/README.md
Styles sekmesinde içe aktarma kutusu kapalı. Token modunda bir durum daha: stil hiçbir katmanda yok, REST onu döndürmez
Katman silinip yeniden çizildi; yeni id’si var. Bileşeni yeniden içe aktarın, sonra mevcut katmanları düzenleyin
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
Yeniden kurulum Figma’dan gelir ve elle düzenlemeleri siler. Mantığı prefab üstündeki Prefab Variant’a koyun
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
TextMeshPro kaynaklarını içe aktarın: Window → TextMeshPro → Import TMP Essential Resources. Onlarsız demoda TMP_SDF-Mobile shader’ı yoktur
Kullanıcı dosyanızda LocalApplicationData/Regalia/figma-token. Projeyle gitmez. Sızarsa Figma’da iptal edin
Sorular ve hatalar
help@makstorch.com
Mutlaka eklenti sürümü, Unity, OS yazın ve ekran görüntüleri ekleyin