
Unity'de Engebeli Zeminler İçin Dinamik Ayak IK Sistemi (Foot IK, Adım Adım)
Oyun geliştirirken görsel kaliteyi ve gerçekçiliği artıran en kritik unsurlardan biri, karakterin çevreyle kurduğu fiziksel etkileşimdir. Düz bir zeminde mükemmel çalışan yürüme animasyonları, karakter engebeli bir araziye, merdivene veya eğimli bir yola geldiğinde birdenbire yapay durmaya başlar. Karakterin bir ayağı havada süzülürken diğeri kayanın içine gömülüyorsa, bu oyuncunun oyuna dalmışlığını anında kırar.
İşte bu noktada imdadımıza IK (Inverse Kinematics / Ters Kinematik) sistemleri yetişiyor. Bu yazıda Unity'nin yerleşik OnAnimatorIK altyapısını kullanarak engebeli arazilere, eğimlere ve merdivenlere dinamik olarak uyum sağlayan; ayakların yere tam basmasını ve kalça (pelvis) yüksekliğinin doğal şekilde ayarlanmasını sağlayan bir Foot IK sistemi geliştireceğiz.
IK (Inverse Kinematics) Nedir ve Neden Kullanmalıyız?
Geleneksel animasyon mantığı FK (Forward Kinematics) üzerine kuruludur. İskelet hiyerarşisinde üstteki kemik döner, alttakiler onu takip eder: kalça döner, uyluk hareket eder, baldır şekil alır ve en son ayak konumlanır. Ancak ayak tabanının bir kayanın eğimine tam oturması gerektiğinde FK yetersiz kalır.
IK ise bu süreci tersine işletir. "Ayak şu noktada durmalı ve yüzeyin eğimi şu açıda" dersiniz; IK çözücüsü (solver) bu hedefe ulaşmak için diz ve kalçanın ne kadar bükülmesi gerektiğini otomatik olarak hesaplar. Unity'de Humanoid karakterler için Animator bileşeni bu matematiği bizim yerimize yapıyor.
Kurulum: Animator ve Rig Hazırlığı
Kodlamaya geçmeden önce Unity tarafında yapmamız gereken üç ayar var:
1. Avatar yapısı: Modelin import ayarlarında Rig sekmesindeki Animation Type değerinin Humanoid olduğundan emin olun. Generic rig'lerde Animator'ın dahili IK çözücüsü çalışmaz.
2. IK Pass: Animator penceresini açın, kullandığınız katmanın (genellikle Base Layer) yanındaki çark simgesine tıklayın ve IK Pass kutucuğunu işaretleyin. Bu işaretlenmeden OnAnimatorIK() hiç çağrılmaz.
3. Layer'lar: Raycast'lerin karakterin kendi collider'ına çarpmasını önlemek için karaktere ayrı bir Layer (ör. Player), zemine ve basılabilir objelere ise başka bir Layer (ör. Ground) atayın.
Animator penceresinin ve Inspector'ın nerede olduğundan emin değilseniz önce Unity arayüzünü anlattığım yazıya göz atabilirsiniz.
Kodlama Zamanı: DynamicFootIK.cs
Aşağıdaki script'i Animator bileşeninin bulunduğu GameObject'e ekleyin (OnAnimatorIK yalnızca Animator ile aynı objedeki script'lerde çağrılır). Script her karede iki ayaktan aşağıya ışın atar, zemini bulur, ayakların yüksekliğini ve açısını eğime göre hizalar; ardından alçakta kalan ayağın yetişebilmesi için kalçayı aşağı çeker.
using UnityEngine;
[RequireComponent(typeof(Animator))]
public class DynamicFootIK : MonoBehaviour
{
[Header("IK Ayarları")]
[SerializeField] private bool enableIK = true;
[SerializeField] private LayerMask groundLayer;
[SerializeField] private float raycastUp = 0.5f; // Işın ayağın ne kadar üstünden başlasın
[SerializeField] private float raycastDown = 0.8f; // Ayağın ne kadar altına kadar baksın
[SerializeField, Range(-0.1f, 0.1f)] private float footOffset = 0f;
[Header("Yumuşatma")]
[SerializeField] private float ikSpeed = 15f;
[SerializeField] private float pelvisSpeed = 8f;
[Header("Pelvis (Kalça)")]
[SerializeField] private bool usePelvisOffset = true;
[SerializeField] private float maxPelvisDrop = 0.4f;
// Karakter havadayken false yapın (ör. CharacterController.isGrounded)
public bool IsGrounded { get; set; } = true;
private const string LeftWeightParam = "LeftFootWeight";
private const string RightWeightParam = "RightFootWeight";
private Animator animator;
private bool hasLeftCurve, hasRightCurve;
private float leftWeight, rightWeight;
private float leftFootY, rightFootY;
private float pelvisOffset;
private void Awake()
{
animator = GetComponent<Animator>();
hasLeftCurve = HasParameter(LeftWeightParam);
hasRightCurve = HasParameter(RightWeightParam);
leftFootY = rightFootY = transform.position.y;
}
private void OnAnimatorIK(int layerIndex)
{
// IK Pass birden fazla katmanda açıksa hesap iki kez yapılmasın
if (layerIndex != 0) return;
float t = 1f - Mathf.Exp(-ikSpeed * Time.deltaTime);
bool active = enableIK && IsGrounded;
// 1) Animasyonun ürettiği ayak pozlarını hiçbir şeyi değiştirmeden önce oku
Vector3 leftAnimPos = animator.GetIKPosition(AvatarIKGoal.LeftFoot);
Vector3 rightAnimPos = animator.GetIKPosition(AvatarIKGoal.RightFoot);
Quaternion leftAnimRot = animator.GetIKRotation(AvatarIKGoal.LeftFoot);
Quaternion rightAnimRot = animator.GetIKRotation(AvatarIKGoal.RightFoot);
// 2) Zemini tara
bool leftHit = SampleGround(leftAnimPos, out RaycastHit leftGround);
bool rightHit = SampleGround(rightAnimPos, out RaycastHit rightGround);
// 3) Ağırlıklar: zemin yoksa ya da karakter havadaysa IK kapanır
float leftTarget = active && leftHit ? GetCurveWeight(hasLeftCurve, LeftWeightParam) : 0f;
float rightTarget = active && rightHit ? GetCurveWeight(hasRightCurve, RightWeightParam) : 0f;
leftWeight = Mathf.Lerp(leftWeight, leftTarget, t);
rightWeight = Mathf.Lerp(rightWeight, rightTarget, t);
// 4) Kalçayı alçakta kalan ayağa göre indir
if (usePelvisOffset)
{
float leftDelta = leftHit ? leftGround.point.y - transform.position.y : 0f;
float rightDelta = rightHit ? rightGround.point.y - transform.position.y : 0f;
float target = active ? Mathf.Clamp(Mathf.Min(leftDelta, rightDelta), -maxPelvisDrop, 0f) : 0f;
pelvisOffset = Mathf.Lerp(pelvisOffset, target, 1f - Mathf.Exp(-pelvisSpeed * Time.deltaTime));
Vector3 body = animator.bodyPosition;
body.y += pelvisOffset;
animator.bodyPosition = body;
}
// 5) Ayakları zemine yerleştir
PlaceFoot(AvatarIKGoal.LeftFoot, leftAnimPos, leftAnimRot, leftHit, leftGround, leftWeight, ref leftFootY, t);
PlaceFoot(AvatarIKGoal.RightFoot, rightAnimPos, rightAnimRot, rightHit, rightGround, rightWeight, ref rightFootY, t);
}
private bool SampleGround(Vector3 footPos, out RaycastHit hit)
{
Vector3 origin = footPos + Vector3.up * raycastUp;
return Physics.Raycast(origin, Vector3.down, out hit, raycastUp + raycastDown,
groundLayer, QueryTriggerInteraction.Ignore);
}
private void PlaceFoot(AvatarIKGoal foot, Vector3 animPos, Quaternion animRot,
bool hasHit, RaycastHit hit, float weight, ref float smoothedY, float t)
{
animator.SetIKPositionWeight(foot, weight);
animator.SetIKRotationWeight(foot, weight);
if (!hasHit)
{
smoothedY = animPos.y; // Bir sonraki temasta sıçrama olmasın
return;
}
// Animasyondaki "kök seviyesinden yükseklik" korunur, sadece zemin seviyesi değişir
float heightAboveRoot = animPos.y - transform.position.y;
float targetY = hit.point.y + heightAboveRoot + footOffset;
smoothedY = Mathf.Lerp(smoothedY, targetY, t);
animator.SetIKPosition(foot, new Vector3(animPos.x, smoothedY, animPos.z));
// Animasyonun kendi ayak açısı korunur, üzerine zeminin eğimi eklenir
Quaternion slope = Quaternion.FromToRotation(Vector3.up, hit.normal);
animator.SetIKRotation(foot, slope * animRot);
}
private float GetCurveWeight(bool hasCurve, string param)
{
return hasCurve ? Mathf.Clamp01(animator.GetFloat(param)) : 1f;
}
private bool HasParameter(string paramName)
{
foreach (AnimatorControllerParameter p in animator.parameters)
{
if (p.name == paramName) return true;
}
return false;
}
}
Karakter havadayken (zıplama, düşme) ayakların zemine uzanmaya çalışmaması için hareket script'inizde IsGrounded değerini her karede güncelleyin:
// Örn. PlayerMovement.cs içinde, Update sonunda
footIK.IsGrounded = characterController.isGrounded;
Sistem Nasıl Çalışıyor? Adım Adım İnceleyelim
1. Animasyon pozunu en başta okuyoruz. GetIKPosition ve GetIKRotation, o karede animasyonun ayağı nereye koymak istediğini söyler. Bu değerleri kalçaya ya da ayaklara dokunmadan önce bir kez okuyup saklıyoruz; böylece sonraki tüm hesaplar temiz, animasyondan gelen poz üzerinden yapılıyor.
2. Raycasting (zemin tespiti). Her ayağın raycastUp kadar yukarısından aşağıya ışın atıyoruz. Yukarıdan başlatmamızın sebebi, ayak zemine biraz gömülmüş olsa bile zemini yakalayabilmek. QueryTriggerInteraction.Ignore ile trigger collider'ları da yok sayıyoruz; aksi halde ayak bir ses alanının ya da kontrol noktasının görünmez sınırına basmaya çalışabilir.
3. Animasyondaki yüksekliği koruyoruz. Sık görülen yaklaşım hedef yüksekliği doğrudan hit.point.y + offset yapmaktır; ancak bu, yürürken havaya kalkan ayağı da her karede zemine yapıştırır ve adımlar sürükleniyor gibi görünür. Bunun yerine ayağın animasyonda kök seviyesinden ne kadar yukarıda olduğunu (heightAboveRoot) hesaplayıp yeni zemin seviyesinin üzerine ekliyoruz. Düz zeminde sonuç animasyonun birebir aynısı olur; engebede ise sadece zemin seviyesi değişir.
4. Rotasyon hizalaması. Quaternion.FromToRotation(Vector3.up, hit.normal) dik duran yukarı yönünü yüzeyin normaline çeviren dönüşü verir. Bunu transform.rotation ile değil, animasyondan gelen ayak rotasyonuyla çarpıyoruz. Böylece animasyondaki topuk kaldırma ve parmak ucu açıları kaybolmadan ayak eğime oturuyor.
5. Pelvis (kalça) offset. Birçok geliştiricinin atladığı ama en önemli adım budur. Sadece ayakları taşırsanız, çukura denk gelen ayak yere yetişmek için bacağı aşırı gerer (leg-stretching). Kod, iki ayağın altındaki zeminden hangisinin daha alçakta olduğunu bulur ve animator.bodyPosition değerini o kadar aşağı çeker; diğer bacak doğal şekilde bükülür. maxPelvisDrop ile bu inişi sınırlayarak uçurum kenarında karakterin yere çökmesini engelliyoruz.
6. Kare hızından bağımsız yumuşatma. Mathf.Lerp(a, b, Time.deltaTime * speed) pratik ama kare hızına bağlıdır: 30 FPS ile 144 FPS'te farklı hissettirir ve düşük FPS'te katsayı 1'i aşıp hedefi geçebilir. Bunun yerine 1f - Mathf.Exp(-speed * Time.deltaTime) katsayısını kullanıyoruz; her FPS'te aynı tepki süresini verir ve asla hedefi aşmaz.
Animasyon Curve'leri ile Ayak Ağırlığı
Koşu gibi hızlı animasyonlarda ayakların her karede yere yapışmasını istemezsiniz. Bunun için animasyon kliplerinizin Import Settings > Animation > Curves bölümüne LeftFootWeight ve RightFootWeight adında iki curve ekleyin ve Animator'a aynı isimde iki Float parametre tanımlayın. Ayağın yere bastığı karelerde değeri 1, havada olduğu karelerde 0 yapın; Animator bu parametreleri her karede curve'den otomatik doldurur.
Script bu parametrelerin var olup olmadığını Awake içinde bir kez kontrol edip sonucu saklıyor; parametre yoksa ağırlık varsayılan olarak 1 olur. Bu küçük ama önemli bir detay: Animator'da olmayan bir parametreyi GetFloat ile okumak her karede Console'a uyarı basar, animator.parameters dizisini her karede gezmek ise gereksiz yere bellek ayırır.
Sık Karşılaşılan Sorunlar ve Çözüm İpuçları
• OnAnimatorIK hiç çalışmıyor: IK Pass işaretli mi, Avatar Humanoid mi ve script Animator ile aynı GameObject'te mi kontrol edin. Script bir alt objedeyse çağrılmaz.
• Ayak yere gömülüyor ya da havada kalıyor: footOffset değerini küçük adımlarla ayarlayın. Ayak kemiğinin pivotu tabanda değil bilekte olduğu için ideal değer her modelde biraz farklıdır.
• Işın karakterin kendisine çarpıyor: groundLayer içinde karakterin Layer'ı seçili olmamalı. Bu hata genelde ayakların sürekli yukarı kaçması şeklinde görünür.
• Zıplarken bacaklar uzuyor: IsGrounded değerini hareket script'inizden güncellemeyi unutmayın. Havadayken ağırlıklar 0'a iner ve animasyon olduğu gibi oynar.
• Titreme (jittering): ikSpeed ve pelvisSpeed değerlerini çok yüksek tutmayın. CharacterController kullanıyorsanız Step Offset değerinin basamak yüksekliğinize uygun olduğundan emin olun; kök sürekli zıplıyorsa IK da onunla birlikte titrer.
Performans Notu
Karakter başına karede iki raycast oldukça ucuzdur; tek bir oyuncu karakteri için performans endişesi taşımanıza gerek yok. Kalabalık NPC sahnelerinde ise uzaktaki karakterlerde enableIK değerini kapatın ya da Animator'ın Culling Mode ayarını Cull Update Transforms yapın. Ekranda görünmeyen karakterlerde IK hesabının bir farkı zaten görülmez.
Karakteriniz Generic rig kullanıyorsa ya da IK'yı kod yerine bileşenlerle yönetmek istiyorsanız Unity'nin Animation Rigging paketindeki Two Bone IK Constraint iyi bir alternatif. Aynı raycast mantığını bu kez constraint'in Target objelerini konumlandırmak için kullanabilirsiniz.
Geliştirdiğimiz bu dinamik Foot IK sistemi küçük bir script olmasına rağmen karakterinizin dünyaya gerçekten bastığını hissettiren en etkili dokunuşlardan biri. Farklı eğimlerde, merdivenlerde ve engebeli arazilerde test ederek parametreleri kendi karakterinize göre ayarlayabilirsiniz.
— Mert Kıyak
