
Unity'de ScriptableObject ile Modüler Diyalog Sistemi Nasıl Yapılır?
Oyuncunun dünyayla ve karakterlerle kurduğu en güçlü bağlardan biri diyaloglardır. Ancak proje büyüdükçe diyalog metinlerini kodun içine gömmek ya da devasa JSON/XML dosyalarıyla uğraşmak tam bir kâbusa dönüşebilir. Kod karmaşasını önlemek, yazarlara kod yazmadan içerik üretebilecekleri bir alan sunmak ve sürdürülebilir bir mimari kurmak için ihtiyacımız olan şey: ScriptableObject.
Bu yazıda veri odaklı tasarım (data-driven design) mantığıyla sahneden bağımsız, seçenekli ve genişletilebilir bir diyalog sistemini adım adım kuracağız. Sonunda NPC'ye yaklaşıp E tuşuyla konuşabileceğiniz, diyalog sırasında oyuncuyu kilitleyen ve seçimlere göre dallanan çalışır bir sisteminiz olacak.
ScriptableObject Nedir ve Neden Diyalog İçin Uygundur?
ScriptableObject (SO), sahnedeki bir GameObject'e bağlı olmak zorunda olmayan, projenin Assets klasöründe bir veri dosyası (asset) olarak saklanan özel bir sınıftır. Diyalog sistemlerinde size sağladığı avantajlar şunlar:
• Bellek verimliliği: Aynı diyalog asset'ini on farklı NPC kullansa bile veri bellekte tek kopya olarak durur.
• Modülerlik: Bir diyaloğu başka bir karakterde ya da farklı bir sahnede tek bir sürükle-bırakla yeniden kullanabilirsiniz.
• Tasarımcı dostu: Yazar ya da tasarımcı C# koduna dokunmadan Inspector üzerinden yeni diyaloglar ve dallanan seçenekler ekleyebilir.
ScriptableObject'i daha önce Unity'de Envanter Sistemi yazısında item verileri için kullanmıştık; burada aynı yaklaşımı konuşma verisine uyguluyoruz.
1. Veri Yapısını Tasarlama
Bir diyalog adımı; konuşanın adını, portresini, metni, opsiyonel bir seslendirme dosyasını ve oyuncunun seçebileceği yanıtları içermeli. Önce düğüm (node) ve seçenek sınıflarını yazalım:
using System.Collections.Generic;
using UnityEngine;
[System.Serializable]
public class DialogueChoice
{
[TextArea(2, 5)]
public string choiceText; // Butonda görünecek metin
public DialogueData nextDialogue; // Seçilince başlayacak diyalog (boşsa diyalog biter)
}
[System.Serializable]
public class DialogueNode
{
public string speakerName;
public Sprite speakerAvatar;
[TextArea(3, 10)]
public string dialogueText;
public AudioClip voiceLine; // Opsiyonel seslendirme
public List<DialogueChoice> choices = new List<DialogueChoice>();
public bool HasChoices => choices != null && choices.Count > 0;
}
Şimdi bu düğümleri bir arada tutan ve projede asset olarak oluşturabileceğimiz ScriptableObject sınıfını yazalım:
using System.Collections.Generic;
using UnityEngine;
[CreateAssetMenu(fileName = "NewDialogueData", menuName = "Dialogue System/Dialogue Data")]
public class DialogueData : ScriptableObject
{
public List<DialogueNode> nodes = new List<DialogueNode>();
public bool IsValid => nodes != null && nodes.Count > 0;
}
Project penceresine sağ tıklayıp Create > Dialogue System > Dialogue Data yolunu izleyerek dilediğiniz kadar diyalog dosyası oluşturabilirsiniz. HasChoices ve IsValid yardımcıları, aynı null ve boş liste kontrolünü kodun her yerinde tekrar yazmamızı engelliyor.
2. Arayüz ve Mantık Katmanı: DialogueManager
Sahnede bir Canvas oluşturun ve içine bir diyalog paneli ekleyin. Panelin içinde isim metni, diyalog metni (TextMeshPro), avatar Image'ı ve seçenek butonlarının dizileceği bir konteyner (Vertical Layout Group) olsun. Seçenek butonu için de içinde TMP_Text bulunan bir Button prefab'ı hazırlayın. Ardından aşağıdaki script'i panelin dışında, sahnede her zaman aktif kalan boş bir GameObject'e ekleyin:
using System;
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;
using TMPro;
public class DialogueManager : MonoBehaviour
{
public static event Action OnDialogueStarted;
public static event Action OnDialogueEnded;
[Header("UI Elemanları")]
[SerializeField] private GameObject dialoguePanel;
[SerializeField] private TMP_Text nameText;
[SerializeField] private TMP_Text dialogueText;
[SerializeField] private Image avatarImage;
[SerializeField] private Transform choiceButtonContainer;
[SerializeField] private Button choiceButtonPrefab;
[SerializeField] private AudioSource voiceSource;
[Header("Ayarlar")]
[SerializeField] private float typingSpeed = 0.03f; // Harf başına bekleme
private DialogueData currentDialogue;
private int currentNodeIndex;
private bool isTyping;
private Coroutine typingCoroutine;
private WaitForSeconds typingDelay;
public bool IsActive => currentDialogue != null;
private DialogueNode CurrentNode => currentDialogue.nodes[currentNodeIndex];
private void Awake()
{
typingDelay = new WaitForSeconds(typingSpeed); // Her harfte yeni nesne üretmemek için önbellek
dialoguePanel.SetActive(false);
}
public void StartDialogue(DialogueData dialogue)
{
if (dialogue == null || !dialogue.IsValid)
{
Debug.LogWarning("Boş ya da atanmamış bir DialogueData başlatılmaya çalışıldı.");
return;
}
bool wasActive = IsActive;
currentDialogue = dialogue;
currentNodeIndex = 0;
dialoguePanel.SetActive(true);
if (!wasActive) OnDialogueStarted?.Invoke(); // Dallanmada tekrar tetiklenmesin
DisplayNode();
}
private void DisplayNode()
{
ClearChoices();
DialogueNode node = CurrentNode;
nameText.text = node.speakerName;
avatarImage.sprite = node.speakerAvatar;
avatarImage.enabled = node.speakerAvatar != null; // Portre yoksa beyaz kutu görünmesin
if (voiceSource != null)
{
voiceSource.Stop();
if (node.voiceLine != null) voiceSource.PlayOneShot(node.voiceLine);
}
StopTyping();
typingCoroutine = StartCoroutine(TypeSentence(node.dialogueText));
}
private IEnumerator TypeSentence(string sentence)
{
isTyping = true;
dialogueText.text = sentence;
dialogueText.maxVisibleCharacters = 0;
dialogueText.ForceMeshUpdate(); // characterCount'un güncel olması için
int total = dialogueText.textInfo.characterCount;
for (int i = 1; i <= total; i++)
{
dialogueText.maxVisibleCharacters = i;
yield return typingDelay;
}
typingCoroutine = null;
FinishTyping();
}
private void StopTyping()
{
if (typingCoroutine != null) StopCoroutine(typingCoroutine);
typingCoroutine = null;
}
private void FinishTyping()
{
StopTyping();
isTyping = false;
dialogueText.maxVisibleCharacters = 99999; // Tüm metni göster
if (CurrentNode.HasChoices) ShowChoices(CurrentNode.choices);
}
public void OnNextTextClicked()
{
if (!IsActive) return;
if (isTyping) // Yazılırken tıklanırsa metni anında tamamla
{
FinishTyping();
return;
}
if (CurrentNode.HasChoices) return; // Seçim yapılmadan ilerlenmesin
if (currentNodeIndex < currentDialogue.nodes.Count - 1)
{
currentNodeIndex++;
DisplayNode();
}
else
{
EndDialogue();
}
}
private void ShowChoices(List<DialogueChoice> choices)
{
foreach (DialogueChoice choice in choices)
{
Button btn = Instantiate(choiceButtonPrefab, choiceButtonContainer);
btn.GetComponentInChildren<TMP_Text>().text = choice.choiceText;
btn.onClick.AddListener(() => OnChoiceSelected(choice));
}
}
private void OnChoiceSelected(DialogueChoice choice)
{
ClearChoices(); // Çift tıklamayla iki kez seçilmesini engeller
if (choice.nextDialogue != null && choice.nextDialogue.IsValid)
StartDialogue(choice.nextDialogue);
else
EndDialogue();
}
private void ClearChoices()
{
for (int i = choiceButtonContainer.childCount - 1; i >= 0; i--)
{
Transform child = choiceButtonContainer.GetChild(i);
if (child.TryGetComponent(out Button btn)) btn.onClick.RemoveAllListeners();
Destroy(child.gameObject);
}
}
private void EndDialogue()
{
StopTyping();
isTyping = false;
ClearChoices();
if (voiceSource != null) voiceSource.Stop();
currentDialogue = null;
dialoguePanel.SetActive(false);
OnDialogueEnded?.Invoke();
}
}
Bu yöneticide dikkat ettiğimiz birkaç nokta var:
• maxVisibleCharacters ile daktilo efekti: Metne her harfte text += letter eklemek her seferinde yeni bir string üretir (GC yükü) ve <b> gibi rich text etiketlerini yarım harf harf ekrana basar. Metni bir kez atayıp görünen karakter sayısını artırmak hem daha performanslı hem de etiket dostudur.
• Önbelleklenmiş WaitForSeconds: Her harfte new WaitForSeconds oluşturmak yerine tek bir nesneyi tekrar kullanıyoruz.
• Ayrı panel referansı: Yönetici kendi GameObject'ini kapatırsa üzerindeki coroutine'ler durur ve kapalı objede StartCoroutine hata verir. Bu yüzden script her zaman aktif kalan bir objede, yalnızca panel açılıp kapanıyor.
• Güvenlik kontrolleri: Boş ya da atanmamış bir DialogueData verildiğinde sistem çökmez; boş bir dallanma da diyaloğu temiz şekilde kapatır, oyuncu seçeneksiz bir ekranda takılı kalmaz.
• Listener temizliği: Butonlar silinmeden önce onClick dinleyicileri kaldırılıyor ve seçime tıklanır tıklanmaz butonlar temizleniyor; böylece aynı karede iki kez seçim yapılamıyor.
Diyalog panelinin tamamını kaplayan görünmez bir Button ekleyip onClick'ine OnNextTextClicked metodunu bağlarsanız, oyuncu panele tıklayarak da ilerleyebilir.
3. NPC ile Konuşmayı Başlatmak
Sistemi oyuna bağlamak için NPC'ye bir Collider (Is Trigger açık) ve aşağıdaki script'i ekleyin. Oyuncu objenizin "Player" tag'ine ve bir Rigidbody'ye sahip olduğundan emin olun, aksi halde trigger olayları tetiklenmez:
using UnityEngine;
public class DialogueTrigger : MonoBehaviour
{
[SerializeField] private DialogueData dialogue;
[SerializeField] private DialogueManager manager;
[SerializeField] private KeyCode interactKey = KeyCode.E;
private bool playerInRange;
private void OnTriggerEnter(Collider other)
{
if (other.CompareTag("Player")) playerInRange = true;
}
private void OnTriggerExit(Collider other)
{
if (other.CompareTag("Player")) playerInRange = false;
}
private void Update()
{
if (!playerInRange || !Input.GetKeyDown(interactKey)) return;
if (manager.IsActive) manager.OnNextTextClicked();
else manager.StartDialogue(dialogue);
}
}
Projenizde yeni Input System kullanıyorsanız Input.GetKeyDown yerine bir InputAction'ın WasPressedThisFrame() metodunu kullanın; mantık aynı kalır.
4. Diyalog Sırasında Oyuncuyu Kilitlemek
DialogueManager'daki statik olaylar sayesinde yöneticiye hiçbir referans vermeden oyuncunun hareketini durdurabilirsiniz. Tek kural: abone olduğunuz olaydan mutlaka çıkın. Statik olaylar sahne değişse bile yaşamaya devam eder; OnDisable'da abonelik kaldırılmazsa yok edilmiş bir objeye çağrı gider ve MissingReferenceException alırsınız.
using UnityEngine;
public class PlayerDialogueLock : MonoBehaviour
{
[SerializeField] private MonoBehaviour movementScript; // Oyuncunun hareket script'i
private void OnEnable()
{
DialogueManager.OnDialogueStarted += Lock;
DialogueManager.OnDialogueEnded += Unlock;
}
private void OnDisable()
{
DialogueManager.OnDialogueStarted -= Lock;
DialogueManager.OnDialogueEnded -= Unlock;
}
private void Lock() => movementScript.enabled = false;
private void Unlock() => movementScript.enabled = true;
}
5. Modüler Dallanma Mantığı
Sistemin asıl gücü dallanmadan gelir: bir seçenek (DialogueChoice) başka bir DialogueData asset'ini tetikler. Örneğin:
1. NPC_Karsilama adında bir diyalog asset'i oluşturun.
2. Son düğüme iki seçenek ekleyin: "Sana yardım edebilirim." ve "Şimdi vaktim yok."
3. İlk seçeneğin nextDialogue alanına Gorev_Kabul asset'ini sürükleyin.
4. İkinci seçeneğe Gorev_Red asset'ini bağlayın ya da alanı boş bırakın; boş alan diyaloğu bitirir.
Böylece karmaşık bir graf editörüne ihtiyaç duymadan, tamamen Inspector üzerinden birbirine bağlanan diyalog ağaçları kurabilirsiniz.
Sık Yapılan Hatalar
• Runtime'da SO verisini değiştirmek: Play modunda bir DialogueData'yı kodla değiştirirseniz Editor'de bu değişiklik kalıcı olur, build'de ise kalıcı olmaz. "Bu konuşma okundu" gibi durumları asset'te değil, ayrı bir kayıt sisteminde tutun.
• Çıkışsız döngüler: A diyaloğu B'ye, B de tekrar A'ya bağlanıyorsa en az bir seçeneğin boş nextDialogue ile konuşmayı bitirdiğinden emin olun.
• Butonların tıklanmaması: Sahnede EventSystem yoksa ya da üstte görünmez bir Image raycast'i yutuyorsa seçenekler tepki vermez. Dekoratif görsellerde Raycast Target'ı kapatın.
• UnityEvent ile sahne objesine referans: ScriptableObject sahnedeki objeleri referans alamaz. Diyalogdan olay tetiklemek istiyorsanız düğüme bir olay ID'si (string) ya da event kanalı SO'su ekleyin ve sahnedeki dinleyici bu ID'ye göre işlem yapsın.
Sistemi Bir Adım Öteye Taşımak
• Yerelleştirme: Metni doğrudan yazmak yerine bir String Table anahtarı tutarak Unity Localization paketiyle entegre edebilirsiniz.
• Koşullu seçenekler: Seçeneğe "gereken görev" veya "gereken item" alanı ekleyip ShowChoices içinde koşulu sağlamayanları gizleyebilirsiniz.
• Görsel düğüm editörü: Diyaloglar yüzlerce asset'e ulaştığında Editor scripting ile bu verileri graf olarak düzenleyebileceğiniz bir pencere yazmak işinizi çok hızlandırır.
Sonuç
ScriptableObject mimarisi sayesinde sahneden bağımsız, kolayca taşınabilen ve genişletilebilen bir diyalog sistemi kurduk. Artık NPC'lere yeni konuşmalar eklemek için kod yazmanıza gerek yok; yeni asset'ler oluşturup aralarındaki bağlantıları kurmanız yeterli. Unutmayın, iyi bir oyun mimarisi içerik üretmeyi kolaylaştıran mimaridir.
— Mert Kıyak
