✨ AI Oyun Geliştirici — Unity SKILLS, MCP

Unity MCP, Editor & Runtime için yapay zeka destekli oyun geliştirme asistanıdır. Claude, Cursor ve Windsurf'u MCP aracılığıyla Unity'ye bağlayın. İş akışlarını otomatikleştirin, kod oluşturun ve oyunlarınızda AI'ı etkinleştirin.

Diğer araçlardan farklı olarak, bu eklenti derlenmiş oyununuzun içinde çalışır ve gerçek zamanlı AI hata ayıklaması ile oyuncu-AI etkileşimine olanak tanır.

💬 Discord Sunucumuza Katılın - Soru sorun, çalışmalarınızı gösterin ve diğer geliştiricilerle bağlantı kurun!

✔️ AI aracıları - Anthropic, OpenAI, Microsoft veya başka herhangi bir sağlayıcının en iyi aracılarını satıcı bağımlılığı olmaksızın kullanın
✔️ Tools - Unity Editor'de çalışmak için çok çeşitli varsayılan MCP Tools
✔️ Skills - İşletim sistemine, Unity sürümüne, projedeki eklentilere dayalı olarak AI için skills oluşturun
✔️ Kod ve Testler - Oyun mekaniklerini geliştirin ve AI aracıları ile test edin
✔️ Runtime (oyun içi) - Dinamik NPC davranışı veya hata ayıklama için LLM'leri doğrudan derlenmiş oyununuzda kullanın
✔️ Hata ayıklama desteği - AI'ın proje sorunlarını ayıklaması ve düzeltmesine izin verin
✔️ Doğal konuşma - İnsan gibi AI ile sohbet edin
✔️ Esnek dağıtım - Konfigürasyon aracılığıyla yerel (stdio) ve uzaktan (http) olarak çalışır
✔️ Genişletilebilir - Proje kodunuzda özel Tools oluşturun

https://github.com/user-attachments/assets/228baf4d-4f00-4dce-939d-fb985ebdd8dd

YA DA CLI'yi kullanın

# 1. unity-mcp-cli'yi kur
npm install -g unity-mcp-cli

# 2. Unity projesine "AI Game Developer" kur
unity-mcp-cli install-plugin ./MyUnityProject

# 3. Bulut sunucusuna giriş yap
unity-mcp-cli login ./MyUnityProject

# 4. Unity projesini aç (otomatik olarak bağlanır ve skills oluşturur)
unity-mcp-cli open ./MyUnityProject

AI Oyun Geliştirici Windows

AI Oyun Geliştirici — Unity SKILLS ve MCP

Hızlı Başlangıç

Üç adımda başlayın:

Eklentiyi kur — .unitypackage installer'ını indirin veya openupm add com.ivanmurzak.unity.mcp çalıştırın

Alternatif: npx unity-mcp-cli install-plugin ./MyUnityProject — CLI belgelerine bakın
AI aracı seç — Claude Code, Claude Desktop, GitHub Copilot, Cursor veya başkası
AI aracısını konfigüre et — Unity'de Window/AI Game Developer açın ve Auto-generate skills tıklayın (önerilir) veya Configure MCP tıklayın

Alternatif: npx unity-mcp-cli setup-skills claude-code ./MyUnityProject — CLI belgelerine bakın

İşte bu kadar. AI'dan "Yarıçapı 2 olan bir çemberin içinde 3 küp oluştur" isteyin ve bunu olur görmüş olun. ✨

Skills ve Tools Referansı

Eklenti, üç kategoriye yayılmış 100+ yerleşik tool ile gelir. Her tool, AI skill getirir. Tüm tools kurulumdan hemen sonra kullanılabilir — ek konfigürasyon gerekmez. Ayrıntılı açıklamalarla tam referans için docs/default-mcp-tools.md başvurun.

Proje & Varlıklar

assets-copy - Yoldaki varlığı kopyalar ve newPath'e saklar
assets-create-folder - Belirtilen ana klasörde yeni klasör oluşturur
assets-delete - Yollarındaki varlıkları projeden siler
assets-find - Arama filtresi stringini kullanarak asset database'de ara
assets-find-built-in - Unity Editor'ün yerleşik varlıklarında ara
assets-get-data - Varlık dosyasından tüm serialize edilebilir alanlar ve özellikleri içeren varlık verilerini al
assets-material-create - Varsayılan parametrelerle yeni material varlığı oluştur
assets-modify - Projede varlık dosyasını değiştir
assets-move - Projede yollarındaki varlıkları taşı (yeniden adlandırmak için de kullanılır)
assets-prefab-close - Şu anda açılan prefab'ı kapat
assets-prefab-create - Etkin sahnedeki GameObject'ten prefab oluştur
assets-prefab-instantiate - Etkin sahnede prefab'ı örnekle
assets-prefab-open - Belirli GameObject için prefab edit modunu aç
assets-prefab-save - Prefab edit modunda prefab'ı kaydet
assets-refresh - AssetDatabase'i yenile
assets-shader-list-all - Proje varlıklarında ve paketlerde tüm kullanılabilir shader'ları listele
package-add - Unity Package Manager kayıt defterinden, Git URL'sinden veya yerel yoldan paket kur
package-list - Unity projesinde yüklü tüm paketleri listele (UPM paketleri)
package-remove - Paketi Unity projesinden kaldır (kaldır)
package-search - Hem Unity Package Manager kayıt defteri hem de yüklü paketlerde paket ara

Sahne & Hiyerarşi

gameobject-component-add - GameObject'e Component ekle
gameobject-component-destroy - Hedef GameObject'ten bir veya daha fazla component'i yok et
gameobject-component-get - GameObject'teki belirli bir Component hakkında ayrıntılı bilgi al
gameobject-component-list-all - UnityEngine.Component'ten genişletilen C# sınıf adlarını listele
gameobject-component-modify - GameObject'teki belirli bir Component'i değiştir
gameobject-create - Açılan Prefab'da veya Sahne'de yeni GameObject oluştur
gameobject-destroy - GameObject'i ve tüm iç içe GameObjects'i özyinelemeli olarak yok et
gameobject-duplicate - Açılan Prefab'da veya Sahne'de GameObjects'i çoğalt
gameobject-find - Sağlanan bilgilere göre belirli GameObject'i bul
gameobject-modify - GameObjects'i ve/veya ekli component'in alanlarını ve özelliklerini değiştir
gameobject-set-parent - Üst GameObject'i GameObjects listesine ayarla
object-get-data - Belirtilen Unity Object'in verilerini al
object-modify - Belirtilen Unity Object'i değiştir
scene-create - Proje varlıklarında yeni sahne oluştur
scene-get-data - Belirtilen sahnedeki kök GameObjects listesini al
scene-list-opened - Unity Editor'de şu anda açılan sahnelerin listesini döndür
scene-open - Proje asset dosyasından sahne aç
scene-save - Açılan sahneyi asset dosyasına kaydet
scene-set-active - Belirtilen açılan sahneyi etkin sahne olarak ayarla
scene-unload - Unity Editor'de açılan sahnelerden sahneyi kaldır
screenshot-camera - Bir kameradan ekran görüntüsü yakalar ve bunu resim olarak döndürür
screenshot-game-view - Unity Editor Game View'dan ekran görüntüsü yakalar
screenshot-scene-view - Unity Editor Scene View'dan ekran görüntüsü yakalar

Scripting & Editor

console-get-logs - Filtreleme seçenekleriyle Unity Editor günlüklerini al
editor-application-get-state - Unity Editor uygulaması durumu hakkında bilgi döndür (playmode, duraklatıldı, derleme)
editor-application-set-state - Unity Editor uygulaması durumunu kontrol et (playmode'u başlat/durdur/duraklat)
editor-selection-get - Unity Editor'deki mevcut Seçim hakkında bilgi al
editor-selection-set - Unity Editor'deki mevcut Seçimi ayarla
reflection-method-call - Giriş parametreleriyle herhangi bir C# metodunu çağır ve sonuçları döndür
reflection-method-find - C# Reflection'ı kullanarak projede metodu bul (private metodlar bile)
script-delete - Script dosyasını/dosyalarını sil
script-execute - Roslyn kullanarak C# kodu dinamik olarak derle ve çalıştır
script-read - Script dosyasının içeriğini oku
script-update-or-create - Sağlanan C# koduyla script dosyasını güncelle veya oluştur
tests-run - Filtre ve ayrıntılı sonuçlarla Unity testlerini yürüt (EditMode/PlayMode)

Ek Skills ve Tools Kur

Daha fazla tool gerektiğinde uzantı yükleyin veya kendi tool'larınızı oluşturun.

Uzantı	Açıklama
AI Animation	Unity Animations için ek tool seti
AI ParticleSystem	Unity Particle System için ek tool seti
AI ProBuilder	Unity ProBuilder için ek tool seti

AI Oyun Geliştirici — Unity SKILLS ve MCP

İçindekiler

Hızlı Başlangıç
Skills ve Tools Referansı
- Ek Skills ve Tools Kur
İçindekiler
- Daha Fazla Belge
Kurulum
AI İş Akışı Örnekleri
- LLM için Gelişmiş Özellikler
  - Temel Yetenekler
  - Reflection-Destekli Özellikler
Tools'u Özelleştir
- Özel Tool Ekle
- Özel MCP Prompt Ekle
Runtime kullanımı (oyun içi)
- Örnek: AI destekli Satranç oyunu botu
- Runtime kullanımı neden gereklidir?
Unity MCP Server Kurulumu
Unity MCP Mimarisi Nasıl Çalışır?
Katkı 💙💛

Daha Fazla Belge

Belge	Açıklama
Varsayılan MCP Tools	Açıklamalarla tüm yerleşik tool'ların tam referansı
MCP Server Kurulumu	Sunucu konfigürasyonu, ortam değişkenleri, uzaktan barındırma
Docker Dağıtımı	Adım adım Docker dağıtım kılavuzu
Geliştirme Kılavuzu	Mimari, kod stili, CI/CD — katkıda bulunanlar için
Wiki	Başlangıç, öğretici, API referansı, SSS
CLI Tool	Eklenti yükle, konfigüre et ve komut satırı aracılığıyla bağlan

AI Oyun Geliştirici — Unity SKILLS ve MCP

Kurulum

Adım 1: `Unity MCP Plugin` Kur

⚠️ Gereksinimler (tıkla)

[!IMPORTANT] Proje yolu boşluk içeremez

✅ C:/MyProjects/MyProject

❌ C:/My Projects/MyProject

❌ C:/My Projects/My Project

❌ C:/MyProjects/My Project

Seçenek 1 - Installer

⬇️ Installer'ı İndir
📂 Installer'ı Unity projesine aktar
- Dosyaya çift tıklayabilirsiniz - Unity otomatik olarak açılacaktır
- VEYA: Önce Unity Editor'ü açın, Assets/Import Package/Custom Package tıklayın ve dosyayı seçin

Seçenek 2 - CLI (önerilir)

Eklentiyi unity-mcp-cli aracılığıyla kur — Unity Editor'e ihtiyaç yok:

# 1.1 unity-mcp-cli'yi kur                                #  ┌────────────────────┐
npm install -g unity-mcp-cli                               #  │ Kullanılabilir AI  │
                                                           #  │ aracısı            │
# 1.2 (İsteğe bağlı) Unity'yi Kur                         #  ├────────────────────┤
unity-mcp-cli install-unity                                #  │ antigravity        │
                                                           #  │ claude-code        │
# 1.3 (İsteğe bağlı) Unity projesi oluştur                #  │ claude-desktop     │
unity-mcp-cli create-project ./MyUnityProject              #  │ cline              │
                                                           #  │ codex              │
# 2. Unity projesine "AI Game Developer" kur              #  │ cursor             │
unity-mcp-cli install-plugin ./MyUnityProject              #  │ gemini             │
                                                           #  │ github-copilot-cli │
# 3. Bulut sunucusuna giriş yap                            #  │ kilo-code          │
unity-mcp-cli login ./MyUnityProject                       #  │ open-code          │
                                                           #  │ rider-junie        │
# 4. Unity projesini aç (otomatik bağlanır ve skill oluşturur) │ unity-ai           │
unity-mcp-cli open ./MyUnityProject                        #  │ vs-copilot         │
                                                           #  │ vscode-copilot     │
# 5. Unity Editor'ün hazır olmasını bekle                  #  └────────────────────┘
unity-mcp-cli wait-for-ready ./MyUnityProject

Tüm kullanılabilir komutlar için tam CLI belgelerine bakın.

Adım 2: `AI aracısı` Kur

Tercih ettiğiniz tek bir AI aracısı seç - hepsini yüklemenize gerek yok. Bu, LLM'le iletişim kurmak için ana sohbet pencereniz olacak.

Claude Code (önerilir)
Claude Desktop
VS Code'da GitHub Copilot
Antigravity
Cursor
Windsurf
Desteklenen herhangi bir diğer

AI Game Developer oldukça evrenseldir, bu nedenle tercih ettiğiniz herhangi bir AI aracısını kullanabilirsiniz - diğer kadar sorunsuz çalışacaktır. Tek önemli gereklilik, AI aracısının Skills veya dinamik MCP Tool güncellemelerini desteklemesi gerekmesidir.

Adım 3: `AI aracısı` Konfigüre Et

Otomatik konfigürasyon

Unity projesini aç
Window/AI Game Developer açın
Seçenek 1: Auto-generate Skills'i tıklayın (önerilir)
Seçenek 2: Model Context Protocol (MCP) Configure tıklayın

Unity_AI

MCP client'iniz listede yoksa, pencerenin gösterdiği ham JSON'u MCP client'inize enjekte etmek için kullanın. Bunu nasıl yapacağınızı öğrenmek için belirli MCP client'iniz için talimatları okuyun.

Manuel konfigürasyon

Herhangi bir nedenle otomatik konfigürasyon sizin için işe yaramazsa, AI Game Developer (Unity-MCP) penceresinden JSON'u kullanarak herhangi bir MCP Client manuel olarak konfigüre edin.

Komut satırı konfigürasyonu

`command` Oluştur

1. Ortamınız için <command> seç

Platform	`<command>`
Windows x64	`"<unityProjectPath>/Library/mcp-server/win-x64/unity-mcp-server.exe" port=<port> client-transport=stdio`
Windows x86	`"/Library/mcp-server/win-x86/unity-mcp-server.exe" port=<port

IvanMurzak/Unity-MCP

Bu MCP sunucusu hakkında