
Unity'de ScriptableObject ile Modüler Silah Sistemi: Raycast, Mermi ve Silah Değiştirme
Oyun geliştirirken en sık karşılaştığımız problemlerden biri, sistemlerin zamanla karmaşıklaşması ve esnekliğini kaybetmesidir. Özellikle silah sistemleri gibi bol değişkenli yapılarda, her yeni silah türü eklendiğinde kod tabanının kaosa sürüklenmesi işten bile değildir. Bir tabanca, bir tüfek ve bir roketatar düşünün; hepsinin atış hızı, şarjör kapasitesi, çıkardığı sesler, görsel efektleri ve hatta hasar verme şekilleri birbirinden tamamen farklıdır. Tüm bu verileri tek bir MonoBehaviour bileşeninde tutmaya çalışmak, bakımı imkansız bir "spagetti kod" yığınına yol açar. İşte bu noktada yardımımıza Unity'nin en güçlü mimari araçlarından biri olan ScriptableObject yetişiyor.
Bu yazıda ScriptableObject mimarisini kullanarak tamamen modüler, genişletilebilir ve oyun tasarımcısı dostu bir silah sistemini adım adım kuracağız: veri sınıfı, değiştirilebilir atış davranışları (Raycast ve mermi), silahı yöneten controller ve silah değiştirme.
ScriptableObject Nedir ve Neden Tercih Etmeliyiz?
ScriptableObject, sahnede bir GameObject'e bağlı olmak zorunda olmayan, verileri birer "asset" olarak Project penceresinde saklamamıza olanak tanıyan özel bir Unity sınıfıdır.
Geleneksel MonoBehaviour yaklaşımında sahnede 50 düşman varsa ve her biri aynı silaha sahipse, silahın tüm istatistikleri (hasar, atış hızı vb.) her düşman için ayrı ayrı kopyalanır. ScriptableObject kullandığımızda ise bu veriler tek bir merkezde saklanır; sahnede 1000 düşman bile olsa hepsi aynı veri varlığına referans verir. Bu hem bellek tasarrufu sağlar hem de mantığı (logic) veriden (data) tamamen ayırır.
Ayrıca oyun içi dengeleme (game balancing) yaparken kod bilmeyen bir tasarımcı, koda hiç dokunmadan Inspector üzerinden silah değerlerini değiştirebilir. Üstelik Play Mode'da yapılan bu değişiklikler oyunu durdurduğunuzda kaybolmaz. Daha önce envanter sistemi yazısında eşya verileri için kullandığımız yaklaşımın aynısını burada silahlara uyguluyoruz.
Adım 1: Temel Silah Veri Yapısını Oluşturma
İlk olarak silahımızın istatistiklerini ve görsel/işitsel referanslarını barındıracak veri sınıfını oluşturalım. Projede yeni bir C# script'i açıp adına WeaponData diyelim.
using UnityEngine;
[CreateAssetMenu(fileName = "NewWeaponData", menuName = "Modular Weapon System/Weapon Data")]
public class WeaponData : ScriptableObject
{
[Header("Genel Bilgiler")]
public string weaponName;
public GameObject weaponPrefab;
[Header("Atış Özellikleri")]
public float damage = 10f;
[Min(0.01f)] public float fireRate = 0.2f; // İki atış arasındaki süre (saniye)
public float range = 100f;
[Min(1)] public int maxAmmo = 30;
public float reloadTime = 1.5f;
[Header("Atış Davranışı")]
public ShootBehavior shootBehavior;
[Header("Görsel ve İşitsel Efektler")]
public GameObject muzzleFlashPrefab;
public GameObject impactEffectPrefab;
public AudioClip shootSound;
public AudioClip reloadSound;
}
Burada dikkat etmeniz gereken en önemli detay [CreateAssetMenu] özniteliğidir. Bu sayede Project penceresinde sağ tıklayıp Create > Modular Weapon System > Weapon Data yolunu izleyerek dilediğiniz kadar silah varyasyonu (tabanca, tüfek, keskin nişancı vb.) oluşturabilirsiniz. [Min] öznitelikleri ise tasarımcının yanlışlıkla 0 atış aralığı ya da 0 şarjör kapasitesi girmesini engeller. shootBehavior alanını birazdan oluşturacağımız atış davranışları için ekledik.
Adım 2: Hasar Arayüzü (IDamageable)
Silahın neye ateş ettiğini bilmesine gerek yok; sadece "hasar alabilen bir şey mi?" diye sormalı. Bunun için küçük bir arayüz tanımlayalım:
public interface IDamageable
{
void TakeDamage(float amount);
}
Düşman, kırılabilir kutu ya da oyuncu fark etmeksizin hasar alması gereken her bileşen bu arayüzü uygular. Can tarafını nasıl göstereceğinizi merak ediyorsanız can barı yazısına göz atabilirsiniz.
Adım 3: Polimorfizm ile Değiştirilebilir Atış Davranışları
Bazı silahlar anında isabet eden Raycast kullanırken bazıları fizik tabanlı bir mermi ya da roket fırlatır. Tek bir Shoot() metodunun içini if-else bloklarıyla doldurmak yerine, atış davranışlarını da ScriptableObject tabanlı birer "strateji" nesnesine dönüştürüyoruz. Önce soyut temel sınıf:
using UnityEngine;
public abstract class ShootBehavior : ScriptableObject
{
public abstract void Shoot(Transform firePoint, WeaponData weaponData);
}
Şimdi bu sınıftan türeyen Raycast atış davranışını yazalım. İsabet efekti ve hasar verme işi de burada yapılıyor:
using UnityEngine;
[CreateAssetMenu(fileName = "RaycastShootBehavior", menuName = "Modular Weapon System/Behaviors/Raycast Shoot")]
public class RaycastShootBehavior : ShootBehavior
{
[SerializeField] private LayerMask hitMask = ~0; // Oyuncunun kendi katmanını hariç tutun
public override void Shoot(Transform firePoint, WeaponData weaponData)
{
if (!Physics.Raycast(firePoint.position, firePoint.forward, out RaycastHit hit,
weaponData.range, hitMask, QueryTriggerInteraction.Ignore))
return;
if (hit.collider.TryGetComponent<IDamageable>(out var damageable))
{
damageable.TakeDamage(weaponData.damage);
}
if (weaponData.impactEffectPrefab != null)
{
GameObject impact = Instantiate(weaponData.impactEffectPrefab, hit.point, Quaternion.LookRotation(hit.normal));
Destroy(impact, 2f);
}
}
}
Ardından mermi fırlatan davranışı yazalım. Merminin kendisi de hasarı taşıyan küçük bir bileşen olacak:
using UnityEngine;
[CreateAssetMenu(fileName = "ProjectileShootBehavior", menuName = "Modular Weapon System/Behaviors/Projectile Shoot")]
public class ProjectileShootBehavior : ShootBehavior
{
[SerializeField] private Projectile projectilePrefab;
[SerializeField] private float projectileSpeed = 40f;
public override void Shoot(Transform firePoint, WeaponData weaponData)
{
if (projectilePrefab == null)
{
Debug.LogWarning("ProjectileShootBehavior: projectilePrefab atanmamış.", this);
return;
}
Projectile bullet = Instantiate(projectilePrefab, firePoint.position, firePoint.rotation);
// Mermi, silahın menzili kadar yol aldığında kendini yok eder
bullet.Launch(firePoint.forward * projectileSpeed, weaponData.damage, weaponData.range / projectileSpeed);
}
}
using UnityEngine;
[RequireComponent(typeof(Rigidbody))]
public class Projectile : MonoBehaviour
{
private float damage;
public void Launch(Vector3 velocity, float damage, float lifeTime)
{
this.damage = damage;
GetComponent<Rigidbody>().AddForce(velocity, ForceMode.VelocityChange);
Destroy(gameObject, lifeTime);
}
private void OnCollisionEnter(Collision collision)
{
if (collision.collider.TryGetComponent<IDamageable>(out var damageable))
{
damageable.TakeDamage(damage);
}
Destroy(gameObject);
}
}
Orijinal yaklaşımda AddForce(firePoint.forward * 500f) varsayılan ForceMode.Force ile kullanılıyordu; bu mod sürekli bir kuvvet varsayıp tek bir fizik adımı süresiyle çarptığı için merminin çıkış hızı hem kütleye hem de Fixed Timestep ayarına bağlı hale gelir ve tahmin etmesi zorlaşır. ForceMode.VelocityChange ise kütleden bağımsız olarak doğrudan istediğimiz hızı verir. Ayrıca mermi artık hasarı kendisi taşıyor ve bir yere çarpınca ya da menzilini aşınca yok oluyor.
Adım 4: Mantığı Veriden Ayırmak: WeaponController
Şimdi bu verileri okuyup işleyecek MonoBehaviour sınıfını hazırlayalım. WeaponController karakterin elindeki silaha bağlanır, girdileri dinler, mermi ve şarjör durumunu yönetir; atışın nasıl yapılacağını ise tamamen atanmış ShootBehavior'a bırakır.
using System.Collections;
using UnityEngine;
[RequireComponent(typeof(AudioSource))]
public class WeaponController : MonoBehaviour
{
[SerializeField] private WeaponData currentWeaponData;
[SerializeField] private Transform firePoint;
private float nextTimeToFire;
private int currentAmmo;
private bool isReloading;
private Coroutine reloadRoutine;
private AudioSource audioSource;
public WeaponData CurrentWeapon => currentWeaponData;
public int CurrentAmmo => currentAmmo;
private void Awake()
{
audioSource = GetComponent<AudioSource>();
}
private void Start()
{
if (currentWeaponData != null)
{
EquipWeapon(currentWeaponData);
}
}
public void EquipWeapon(WeaponData newWeaponData)
{
if (newWeaponData == null) return;
// Şarjör değiştirilirken silah değişirse eski reload iptal edilmeli
if (reloadRoutine != null)
{
StopCoroutine(reloadRoutine);
reloadRoutine = null;
}
isReloading = false;
currentWeaponData = newWeaponData;
currentAmmo = newWeaponData.maxAmmo;
nextTimeToFire = 0f;
}
private void Update()
{
if (isReloading || currentWeaponData == null) return;
if (Input.GetButton("Fire1") && Time.time >= nextTimeToFire)
{
if (currentAmmo > 0)
{
nextTimeToFire = Time.time + currentWeaponData.fireRate;
Shoot();
}
else
{
StartReload();
}
}
if (Input.GetKeyDown(KeyCode.R) && currentAmmo < currentWeaponData.maxAmmo)
{
StartReload();
}
}
private void Shoot()
{
currentAmmo--;
if (currentWeaponData.shootSound != null)
{
audioSource.PlayOneShot(currentWeaponData.shootSound);
}
if (currentWeaponData.muzzleFlashPrefab != null)
{
GameObject flash = Instantiate(currentWeaponData.muzzleFlashPrefab, firePoint.position, firePoint.rotation, firePoint);
Destroy(flash, 0.1f);
}
if (currentWeaponData.shootBehavior != null)
{
currentWeaponData.shootBehavior.Shoot(firePoint, currentWeaponData);
}
else
{
Debug.LogWarning($"{currentWeaponData.weaponName} için ShootBehavior atanmamış!", this);
}
}
private void StartReload()
{
if (isReloading) return;
reloadRoutine = StartCoroutine(Reload());
}
private IEnumerator Reload()
{
isReloading = true;
if (currentWeaponData.reloadSound != null)
{
audioSource.PlayOneShot(currentWeaponData.reloadSound);
}
yield return new WaitForSeconds(currentWeaponData.reloadTime);
currentAmmo = currentWeaponData.maxAmmo;
isReloading = false;
reloadRoutine = null;
}
private void OnDisable()
{
// Obje kapanınca coroutine durur; isReloading true olarak takılı kalmasın
isReloading = false;
reloadRoutine = null;
}
}
Bu mimarinin güzelliği şurada: WeaponController bir tabanca mı yoksa roketatar mı kullandığını önemsemez. Sadece WeaponData içinde ne tanımlandıysa onu uygular. İlk versiyona göre birkaç önemli düzeltme yaptık:
• Reload takılması: Şarjör değiştirilirken silah değiştirilir ya da obje kapatılırsa coroutine yarıda kalıyor, isReloading sonsuza kadar true kalıyordu ve silah bir daha ateş etmiyordu. EquipWeapon ve OnDisable artık bu durumu temizliyor.
• Namlu alevi sızıntısı: Her atışta oluşturulan namlu alevi hiç yok edilmiyordu; dakikada yüzlerce obje sahnede birikiyordu. Artık 0.1 saniye sonra siliniyor.
• Çifte reload: Reload başlatma tek bir StartReload metodundan geçiyor, böylece aynı anda iki coroutine çalışamıyor.
Adım 5: Silah Değiştirme
Silahı değiştirmek için yapmanız gereken tek şey EquipWeapon(newWeaponData) metodunu çağırmaktır. Klavyedeki 1-9 tuşlarıyla silah seçen basit bir örnek:
using UnityEngine;
public class WeaponSwitcher : MonoBehaviour
{
[SerializeField] private WeaponController controller;
[SerializeField] private WeaponData[] weapons;
private void Update()
{
for (int i = 0; i < weapons.Length && i < 9; i++)
{
if (Input.GetKeyDown(KeyCode.Alpha1 + i) && weapons[i] != controller.CurrentWeapon)
{
controller.EquipWeapon(weapons[i]);
}
}
}
}
Bu örnek sadelik için eski Input Manager'ı kullanıyor. Yeni Input System kullanıyorsanız aynı mantığı bir Input Action'a bağlamanız yeterli. Bu yapıyla yeni bir silah eklemek kod yazmadan şu adımlardan ibaret:
1. Create > Modular Weapon System > Behaviors altından bir atış davranışı oluşturun (ya da var olanı kullanın).
2. Create > Modular Weapon System > Weapon Data ile yeni silahı oluşturup değerlerini girin.
3. Davranışı shootBehavior alanına sürükleyin ve silahı WeaponSwitcher listesine ekleyin.
Sık Yapılan Hatalar
Runtime durumunu ScriptableObject'e yazmak. En yaygın tuzak budur. WeaponData içine bir currentAmmo alanı koyup ateş ettikçe onu azaltırsanız, Editor'de oyunu durdurduğunuzda bile değer öyle kalır ve asset dosyanız kalıcı olarak değişir. Üstelik aynı silahı kullanan tüm düşmanlar tek bir şarjörü paylaşır. ScriptableObject'ler sabit veriyi tutmalı; anlık mermi miktarı, ısınma oranı, reload durumu gibi değişen veriler WeaponController gibi MonoBehaviour'larda saklanmalıdır.
Davranış asset'lerinde silaha özel durum tutmak. Aynı RaycastShootBehavior asset'i onlarca silah tarafından paylaşılır. İçine "son atış zamanı" gibi bir alan koyarsanız bütün silahlar o değeri ortak kullanır. Davranışları durumsuz (stateless) tutun; gereken her şeyi parametre olarak alsınlar.
Raycast'in oyuncunun kendisine çarpması. firePoint karakterin collider'ının içinde kalıyorsa ışın ilk olarak oyuncunun kendisine isabet eder. hitMask alanından oyuncu katmanını hariç tutun.
Hızlı mermilerin duvarın içinden geçmesi. Yüksek hızlı mermiler bir fizik adımında duvarın bir yanından öbür yanına atlayabilir (tunneling). Mermi prefab'ındaki Rigidbody'nin Collision Detection ayarını Continuous Dynamic yapın ya da çok hızlı silahlar için Raycast davranışını tercih edin.
Performans Notu
Bu örnekte anlaşılır olsun diye namlu alevi, isabet efekti ve mermiler Instantiate/Destroy ile yönetiliyor. Saniyede 10 atış yapan bir makineli tüfek, birkaç düşmanla birlikte saniyede onlarca obje oluşturup siler ve bu da Garbage Collector'ı yorar. Gerçek bir projede bu nesneleri havuzdan çekmeniz gerekir; nasıl yapılacağını Object Pooling yazısında anlattım. Davranış sınıfları sayesinde bu değişikliği tek bir yerde, silah kodlarına dokunmadan yapabilirsiniz.
Son Sözler
Unity'de modüler bir silah sistemi kurmak, projenin geleceği için yapabileceğiniz en mantıklı mimari yatırımlardan biridir. ScriptableObject kullanarak kod tekrarının önüne geçebilir, yeni silahları dakikalar içinde ekleyebilir ve oyun tasarımcılarına kod yazmak zorunda kalmadan geniş bir özgürlük alanı sunabilirsiniz. Aynı yaklaşımı görev sistemleri, düşman tipleri ya da yetenek ağaçları için de rahatlıkla genişletebilirsiniz. Silah değerlerini Inspector'da daha düzenli göstermek isterseniz Custom Editor yazısı iyi bir sonraki adım olacaktır.
— Mert Kıyak
