
Unity Animation Rigging ile Silah Nişan Alma Sistemi (Multi-Aim ve Two Bone IK)
Oyun geliştirirken en çok karşılaştığımız zorluklardan biri, karakterin çevresiyle ve elindeki nesnelerle doğal bir şekilde etkileşime girmesini sağlamaktır. Özellikle bir TPS (Third-Person Shooter) ya da FPS oyunu yapıyorsanız, karakterin silahla nişan alması sabit bir animasyon klibini oynatmakla çözülmez; oyuncunun baktığı her açıya (yukarı, aşağı, sağa, sola) uyum sağlayan esnek bir sisteme ihtiyacınız var. Bu yazıda Unity'nin Animation Rigging paketiyle, kamera nereye bakarsa oraya akıcı şekilde dönen bir silah nişan alma sistemini adım adım kuracağız.
Eskiden bunun için onlarca farklı nişan animasyonunu Blend Tree ile birleştirmekle uğraşırdık. Animation Rigging ise prosedürel IK (Inverse Kinematics) kısıtlamalarıyla bu işi çalışma anında, mevcut animasyonların üzerine bindirerek yapıyor. Daha önce engebeli zeminler için ayak IK sistemi yazısında Animator'ün kendi IK'sını kullanmıştık; bu sefer üst gövde için çok daha esnek bir araçla çalışacağız.
Animation Rigging Paketini Kurma ve Temel Yapı
İlk olarak paketi projeye dahil edelim. Üst menüden Window > Package Manager yolunu izleyin, "Unity Registry" sekmesinde "Animation Rigging" araması yapıp paketi yükleyin.
Paket yüklendikten sonra rig katmanını hazırlayalım:
1. Karakterin ana GameObject'ini seçin (üzerinde Animator bileşeni olan obje).
2. Aynı objeye Rig Builder bileşenini ekleyin. Bu bileşen, oluşturacağımız tüm rig katmanlarını yöneten merkezdir ve mutlaka Animator ile aynı objede olmalıdır.
3. Karakterin altında boş bir GameObject oluşturup adını "Rig Layer - Aim" koyun.
4. Bu objeye Rig bileşenini ekleyin.
5. Rig Builder bileşenindeki "Rig Layers" listesine "Rig Layer - Aim" objesini sürükleyip bırakın.
İskeleti sahnede rahat görebilmek için karakter objesine Bone Renderer bileşenini ekleyebilirsiniz (Component > Animation Rigging > Bone Renderer). Transforms listesine karakterin kemiklerini atadığınızda iskelet sahnede çizgilerle belirginleşir; kısıtlamaları yapılandırırken hangi kemiği seçtiğinizi görmek için çok işe yarar.
Nişan Alma İçin Constraint Yapılandırması
Nişan alma sistemimizin iki temel ayağı var: gövdenin (Spine/Chest) bakış yönüne dönmesi ve sol elin silahın ön kabzasını (front grip) tutmaya devam etmesi. Bunun için "Rig Layer - Aim" altında iki alt obje oluşturacağız.
1. Multi-Aim Constraint (Gövde ve Baş Yönelimi)
Bu kısıtlama, belirlediğiniz kemiğin dünyadaki bir hedef noktaya (Aim Target) bakmasını sağlar.
• "Rig Layer - Aim" altında "SpineAim" adında boş bir obje oluşturup Multi-Aim Constraint bileşenini ekleyin.
• Constrained Object alanına göğüs kemiğini (Spine2 veya Chest) atayın.
• Source Objects listesine sahnede ayrı duran bir AimTarget objesi ekleyin. Bu objeyi karakterin altına değil, sahnenin köküne koyun; aksi halde karakter döndükçe hedef de onunla döner ve kendi kendini takip eden bir döngü oluşur.
• Aim Axis değerini modelinize göre ayarlayın (çoğu insansı rigde kemiğin ileri ekseni Z veya Y'dir). Yanlış eksen seçilirse gövde hedefe bakmak yerine yan döner; Scene görünümünde kemiğin eksenlerini kontrol ederek doğru ekseni bulun.
2. Two Bone IK Constraint (Sol El Tutuşu)
Karakter silahı sağ eliyle tutarken gövde döndükçe sol el silahtan kayabilir. Sol elin her zaman silahın üzerinde kalması için Two Bone IK Constraint kullanırız.
• "Rig Layer - Aim" altında "LeftHandIK" adında bir obje oluşturup Two Bone IK Constraint bileşenini ekleyin.
• Root: Sol üst kol (LeftArm / LeftUpperArm). Omuz (LeftShoulder) kemiğini değil, üst kolu verin; zincir üst kol, ön kol ve elden oluşur.
• Mid: Sol ön kol (LeftForeArm).
• Tip: Sol el (LeftHand).
• Target: Silah modelinin altına, ön kabzanın üzerine yerleştireceğiniz boş bir Transform (LeftHandTarget). Silahın çocuğu olduğu için silah nereye giderse el de onu takip eder.
• Hint: Dirseğin hangi yöne büküleceğini belirleyen bir Transform'u karakterin sol arka tarafına koyun. Hint vermezseniz dirsek bazı açılarda içe doğru kırılabilir.
C# ile Nişan Alma Kontrolü
Şimdi sistemi kod tarafında canlandıralım. Kameranın ekran ortasına (crosshair) doğru gönderdiği ışınla AimTarget konumunu güncelleyecek, oyuncu sağ tıka bastığında Rig ağırlığını 0'dan 1'e yumuşakça çıkaracağız. Orijinal versiyona göre birkaç önemli iyileştirme yaptım: ışın artık karakterin hizasından başlıyor (kamera ile karakter arasındaki duvar ve objeler hedefi bozmuyor), yumuşatma kare hızından bağımsız, Rig ağırlığı gerçekten 0 ve 1'e ulaşıyor ve geri tepme (recoil) desteği eklendi.
using UnityEngine;
using UnityEngine.Animations.Rigging;
public class CharacterAimController : MonoBehaviour
{
[Header("Rig Settings")]
[SerializeField] private Rig aimRig;
[SerializeField] private float rigBlendSpeed = 6f; // saniyede ağırlık değişimi
[Header("Aim Target Settings")]
[SerializeField] private Transform aimTarget;
[SerializeField] private LayerMask aimLayerMask = ~0;
[SerializeField] private float maxAimDistance = 100f;
[SerializeField] private float targetFollowSpeed = 20f;
[Header("Camera Reference")]
[SerializeField] private Camera mainCamera;
[Header("Recoil")]
[SerializeField] private float recoilRecoverySpeed = 12f;
private bool isAiming;
private Vector3 smoothedTarget;
private Vector2 recoil; // x: yatay, y: dikey sapma (mesafe başına)
public bool IsAiming => isAiming;
private void Awake()
{
if (mainCamera == null) mainCamera = Camera.main;
if (aimRig == null || aimTarget == null || mainCamera == null)
{
Debug.LogError($"{name}: CharacterAimController referansları eksik.", this);
enabled = false;
return;
}
smoothedTarget = aimTarget.position;
aimRig.weight = 0f;
}
private void Update()
{
// Sağ tık basılı tutulduğunda nişan al
isAiming = Input.GetMouseButton(1);
UpdateAimTargetPosition();
UpdateRigWeight();
}
private void UpdateAimTargetPosition()
{
Ray ray = mainCamera.ViewportPointToRay(new Vector3(0.5f, 0.5f, 0f));
// Işını karakterin hizasından başlat: kamera ile karakter arasındaki objeler hedefi bozmasın
float startOffset = Mathf.Max(0f, Vector3.Dot(transform.position - ray.origin, ray.direction));
Vector3 rayStart = ray.origin + ray.direction * startOffset;
Vector3 targetPosition = rayStart + ray.direction * maxAimDistance;
if (Physics.Raycast(rayStart, ray.direction, out RaycastHit hit, maxAimDistance,
aimLayerMask, QueryTriggerInteraction.Ignore))
{
targetPosition = hit.point;
}
// Kare hızından bağımsız yumuşatma
float t = 1f - Mathf.Exp(-targetFollowSpeed * Time.deltaTime);
smoothedTarget = Vector3.Lerp(smoothedTarget, targetPosition, t);
// Geri tepmeyi zamanla sıfıra çek
recoil = Vector2.Lerp(recoil, Vector2.zero, 1f - Mathf.Exp(-recoilRecoverySpeed * Time.deltaTime));
// Sapmayı hedef mesafesiyle ölçekle: yakında da uzakta da aynı açısal tepme
Transform cam = mainCamera.transform;
float distance = Vector3.Distance(cam.position, smoothedTarget);
Vector3 recoilOffset = (cam.right * recoil.x + cam.up * recoil.y) * distance;
aimTarget.position = smoothedTarget + recoilOffset;
}
private void UpdateRigWeight()
{
float targetWeight = isAiming ? 1f : 0f;
// MoveTowards hedefe tam ulaşır; Lerp ise 1'e asla tam varmaz
aimRig.weight = Mathf.MoveTowards(aimRig.weight, targetWeight, rigBlendSpeed * Time.deltaTime);
}
// Silah scripti ateş ettiğinde çağırır. Değerler küçük olmalı (ör. 0.02 - 0.05).
public void AddRecoil(float vertical, float horizontal)
{
recoil += new Vector2(horizontal, vertical);
}
}
Silah tarafında ateş edildiği anda sadece şu çağrıyı yapmanız yeterli:
// Silah scriptinizdeki Fire() metodu içinde
aimController.AddRecoil(0.03f, Random.Range(-0.01f, 0.01f));
Bu yöntemle tepme, Animation Rigging sistemini bozmadan doğrudan hedef noktası üzerinden çalışır: gövde ve silah hafifçe yukarı kalkar, ardından kendiliğinden nişan noktasına geri döner. Silah verilerini ScriptableObject ile tutuyorsanız tepme değerlerini modüler silah sistemi yazısındaki silah verisine alan olarak ekleyip her silaha ayrı his verebilirsiniz.
Not: Örnekte basitlik için eski Input Manager'ı (Input.GetMouseButton) kullandım. Yeni Input System kullanıyorsanız isAiming değerini bir "Aim" action'ının IsPressed() sonucundan almanız yeterli.
Pürüzsüz Geçişler ve İnce Ayarlar
Sistemi kurduktan sonra tek bir Multi-Aim Constraint eklemenin bazen omurgayı doğal olmayan şekilde büktüğünü fark edeceksiniz. Daha iyi bir his için şu detaylara dikkat edin:
1. Ağırlığı omurgaya dağıtın: Her Multi-Aim Constraint tek bir kemiği kısıtlar. Tüm dönüşü göğüs kemiğine yüklemek yerine Spine, Spine1 ve Spine2 için ayrı ayrı Multi-Aim Constraint objeleri oluşturup hepsine aynı AimTarget'ı verin ve ağırlıkları kademeli ayarlayın (ör. 0.2, 0.4, 0.8). Gövde böylece tek noktadan kırılmak yerine doğal bir kavisle döner.
2. Silah ofseti: Nişan alırken silahı göz hizasına biraz yaklaştırmak isterseniz sağ el için ikinci bir Two Bone IK Constraint veya silah kökü için Multi-Position Constraint ekleyerek küçük bir pozisyon kaydırması yapabilirsiniz.
3. Baş gövdeden önce dönsün: Kafa kemiğine ayrı bir Multi-Aim Constraint ekleyin ve ağırlığını yüksek tutun. Baş hedefe gövdeden bir an önce döndüğünde karakter çok daha canlı görünür. Rig Builder'da ayrı bir "Rig Layer - Look" katmanı açarsanız kafayı nişan almadan bağımsız olarak da çalıştırabilirsiniz.
4. Sıralama önemli: Rig içindeki constraint'ler hiyerarşideki sırayla çalışır. Önce gövdeyi döndüren Multi-Aim'ler, en son sol el Two Bone IK gelmeli; aksi halde el, gövde dönmeden önceki silah konumunu takip eder ve kabzadan kayar.
Sık Yapılan Hatalar
• Karakter kendine nişan alıyor: Raycast karakterin kendi collider'ına çarpıyorsa hedef göğsün içine düşer ve gövde titrer. Karakteri ayrı bir "Player" katmanına alıp aimLayerMask'ten çıkarın.
• Rig hiç çalışmıyor: Rig Builder Animator ile aynı objede değilse ya da Rig, "Rig Layers" listesine eklenmemişse kısıtlamalar uygulanmaz. Çalışma anında rig hiyerarşisini değiştirirseniz rigBuilder.Build() çağırmayı unutmayın.
• Gövde yan dönüyor ya da ters bakıyor: Neredeyse her zaman yanlış Aim Axis seçiminden kaynaklanır. Kemiğin yerel eksenlerini kontrol edin; gerekirse Multi-Aim içindeki Offset ile birkaç derecelik düzeltme yapın.
• Dönüş sınırsız: Karakter tam arkasına nişan alırken omurga 180 derece bükülebilir. Multi-Aim Constraint'teki Min Limit / Max Limit değerlerini (ör. -60, 60) ayarlayın ve hedef çok arkada kaldığında karakterin tüm gövdesini kamera yönüne döndürün.
Sonuç
Animation Rigging paketi, geleneksel animasyon sınırlamalarını aşarak dinamik ve etkileşimli karakter mekanikleri kurmanın en pratik yollarından biri. Bu yazıda kurduğumuz sistem sayesinde karakter, farklı kamera açılarında ve dar alanlarda bile bozulmadan oyuncunun nişan aldığı noktaya odaklanıyor, ateş ettiğinde tepiyor ve kendiliğinden toparlanıyor.
Üstelik aynı yapıyı sadece silah için değil; kapı koluna uzanan el, ilgi çekici nesnelere bakan kafa veya duvara dayanan karakter gibi pek çok mekanikte de kullanabilirsiniz. Kısıtlamaları çeşitlendirip ağırlıklarla oynayarak kendi projenize en uygun hissi yakalamayı deneyin.
— Mert Kıyak
