Kontrol Cihazları

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Karakter Kontrol Cihazı Kütüphanesi'nde (Character Controller Library, CCL), bir ana ControllerManager örneği, karakterin fiziksel simülasyonunu ve çevre ile etkileşimini yönetir. Bu, eski Humanoid tutarsızlıklarını çözmek için tasarlanmış hareket/his üzerinde birkaç kasıtlı değişiklik ile karakterin zıplarken doğrusal ve açısal momentumu koruması gibi fiziksel iyileştirmeleri içerir.

CCL'yi Etkinleştir

CCL, Studio'nun Avatar Ayarları penceresindeki isteğe bağlı bir özelliktir. Etkinleştirmek için:

  1. Avatar sekmesinden Avatar Ayarları seçeneğini açın.

    Studio'nun araç çubuğunda belirtilen Avatar Ayarları
  2. Pendenin sol tarafındaki Hareket sekmesini seçin ve Yetenekler bölümünde Karakter Kontrol Kütüphanesi seçeneğini işaretleyin.

    Avatar Ayarları penceresindeki Karakter Kontrol Kütüphanesi geçişi
  3. Koşma, Zıplama ve Tırmanma gibi standart yeteneklerin hepsi varsayılan olarak etkindir. Bunlardan herhangi birini çalışma zamanında devre dışı bırakmak için, ilgili kutucuğu işaretini kaldırın.

Yapı

Karakter modelindeki ana ControllerManager örneğinin altında, hareketin karaktere nasıl uygulandığını tanımlamak için GroundController ve AirController gibi bireysel kontrol cihazları bulunmaktadır. Yetenekler ardından, kontrol cihazı davranışlarını değiştirmek veya kontrol cihazları arasında geçiş yapmak için ControllerManager ve onun alt sınıflarıyla etkileşime girer.

Konfigürasyon

Oyununuz çalışırken (veya ServerScriptService içinden çalışan bir betik aracılığıyla), ana ControllerManager ve yerleşik kontrol cihazlarıyla denemeler yapabilirsiniz.

Çalışma Zamanı

Çalışma zamanı sırasında kontrol cihazı yapılandırmaları ile denemeler yapmak için:

  1. Bir oyun testi başlatın.

  2. Explorer'da, Workspace içindeki karakter modelini bulun ve ardından ControllerManager ağacını genişletin:

  3. ControllerManager veya onun kontrol cihazı alt öğelerinden birini seçin ve Properties penceresinde, aşağıdaki tabloların özetlediği gibi özellikleri özelleştirin (bu tabloların kapsamlı olmadığını unutmayın; lütfen ek özellik seçenekleri için API sınıfları belgelerine başvurun).

    ÖzellikAçıklama
    BaseMoveSpeedTüm kontrol cihazları tarafından kullanılan temel doğrusal hareket hızı. Kontrol cihazları, kendi MoveSpeedFactor özelliği aracılığıyla hareket hızını özelleştirir.
    BaseTurnSpeedTüm kontrol cihazları tarafından karakterin istenen yöne dönmesi için kullanılan temel açısal dönüş hızıdır. Bazı kontrol cihazları, kendi TurnSpeedFactor özellikleri aracılığıyla dönüş hızını özelleştirir.
    UpDirectionBelirtilen ControllerManager.RootPart için yukarıyı gösteren Vector3.

Betik Tabanlı

Tüm karakterler için bir betikle kontrol cihazı yapılandırmaları ayarlamak için:

  1. ServerScriptService içinde yeni bir sunucu tarafı Script oluşturun ve adını ControllerScript olarak değiştirin.

  2. Yeni betiğe aşağıdaki kodu kopyalayıp yapıştırın. Bu örnek, yer tabanlı hareket ve dönüş hızını artırır ve biraz hızlanma ve yavaşlama süresi ekler. Lütfen yukarıdaki tablolarda veya her sınıf için belgelenmiş olan diğer özellikleri ayarlamakta isteğiniz gibi değişiklik yapın (ControllerManager; GroundController; AirController; ClimbController; SwimController).

    Script in ServerScriptService

    local Players = game:GetService("Players")
    local function onCharacterAdded(character)
    local ControllerManager = character:FindFirstChildWhichIsA("ControllerManager")
    if ControllerManager then
    local GroundController = ControllerManager:FindFirstChild("GroundController")
    if GroundController then
    -- Hareket ve dönüş hızlarını iki katına çıkar
    GroundController.MoveSpeedFactor *= 2
    GroundController.TurnSpeedFactor *= 2
    -- Hafif hızlanma ve yavaşlama ekle
    GroundController.AccelerationTime = 0.2
    GroundController.DecelerationTime = 0.4
    end
    end
    end
    local function onPlayerAdded(player)
    if player.Character then
    onCharacterAdded(player.Character)
    end
    player.CharacterAdded:Connect(onCharacterAdded)
    end
    Players.PlayerAdded:Connect(onPlayerAdded)
©2026 Roblox Corporation. Roblox, the Roblox logo and Powering Imagination are among our registered and unregistered trademarks in the U.S. and other countries.