Kısaca
StarterPlayerScripts'e, Sprint eylemini ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3) ile bağlayan tek bir LocalScript koy. Shift basılıyken Humanoid.WalkSpeed'e 10 ekle (16, 26 olur), bırakınca da önceki değeri geri koy. true argümanı dokunmatik ekranlara bir Sprint butonu ekler, bu rehberdeki scriptte de bu buton ve gamepad'deki L3 basılı tutmayla değil, koşuyu açıp kapatarak çalışır.
- 26 yazmak yerine şu anki WalkSpeed'e ekle, böylece bir game pass'ten gelen hız artışı korunur.
- Koşu oyuncunun cihazında çalışır. Sunucu WalkSpeed'i zorla dayatamaz; sadece karakterlerin ne kadar uzağa gittiğini ölçüp koşuyla açıklanamayan bir hızı işaretleyebilir.
- Aynı fikirle stamina çubuğunu, dash'i ve çift zıplamayı Adım 2 ile 4 ekliyor. Ne kadar hızlı ve ne kadar uzun koşulacağını korku, dövüş ve açık dünya için sayılar veren oyun türüne göre preset'ler söylüyor.
Bu sayfada
Roblox'ta koşu nasıl çalışır
Her oyuncunun cihazı kendi karakterini hareket ettirir. Klavye, kontrolcü ya da dokunmatik ekran karakterin nereye gideceğine karar verir, Roblox da sonucu sunucuya ve diğer herkese iletir. Bu yüzden koşu, tuş basılıyken Humanoid.WalkSpeed'i artıran bir LocalScript'tir ve Adım 1'in yaptığı da sadece bu. Rehberin geri kalanı büyük bir oyunun onun etrafında ihtiyaç duyduğu şeyler: bir stamina çubuğu, bir dash, bir çift zıplama ve hileciler için sunucuda bir kontrol.
| Parça | Nerede durur | Ne yapar |
|---|---|---|
LocalScript ShiftToSprint | StarterPlayerScripts | Tek başına Adım 1: klavyede, telefonda ve gamepad'de staminasız koşu. Stamina ve dash eklediğinde yerini MovementClient alır. |
ModuleScript MovementConfig | ReplicatedStorage | Sayılar: koşu bonusu, stamina ve dash. Onları hem LocalScript hem sunucu kontrolü okur. |
LocalScript MovementClient | StarterPlayerScripts | Sprint ve Dash'i bir tuşa, gamepad butonuna ve dokunmatik butona bağlar, stamina döngüsünü çalıştırır, çubuğu çizer ve dash'i yapar. |
LocalScript DoubleJump | StarterCharacterScripts | Havada bir ek zıplama verir. Her yeni karakterde yeni bir kopyası çalışır. |
Script MovementCheck | ServerScriptService | Her karakterin gerçekte ne kadar uzağa gittiğini ölçer ve biri koşu ile dash'in izin verdiğinden uzun süre hızlı hareket ettiğinde Output'a bir uyarı yazar. |
ReplicatedStorage
MovementConfig ModuleScript new
ServerScriptService
MovementCheck Script new
StarterPlayer
StarterCharacterScripts
DoubleJump LocalScript new
StarterPlayerScripts
MovementClient LocalScript new
Script ile LocalScript arasındaki fark senin için yeniyse Script, LocalScript ve ModuleScript her türün nerede ve neden çalıştığını anlatıyor.
Adım 1: tek bir LocalScript'te Shift ile koşma
Sadece Shift basılıyken daha hızlı koşmak istiyorsan bu tek script yeterli. Ayrıca telefonlara ekranda bir Sprint butonu veriyor, gamepad'de de sol çubukla koşmanı sağlıyor.
- Explorer'da StarterPlayer'ı aç, fareyle StarterPlayerScripts üzerine gel, + butonuna tıkla ve
ShiftToSprintadlı bir LocalScript ekle. - İçeriğini aşağıdaki kodla değiştir ve Play'e bas.
-- StarterPlayer > StarterPlayerScripts içinde ShiftToSprint adlı LocalScript.
-- Koşmak için Left Shift'i basılı tut. Gamepad'de koşuyu açıp kapatmak için
-- sol çubuğa bas (L3). Telefonda açıp kapatmak için Sprint butonuna dokun.
local ContextActionService = game:GetService("ContextActionService")
local Players = game:GetService("Players")
-- Ayarlar
local SPRINT_BONUS = 10 -- koşarken WalkSpeed'e eklenir (16, 26 olur)
local TOGGLE_ON_TOUCH_AND_GAMEPAD = true -- false: buton basılı tutulmalı
local player = Players.LocalPlayer
local sprinting = false
local normalSpeed = 16 -- geri dönülecek WalkSpeed
local function getHumanoid(): Humanoid?
local character = player.Character
return character and character:FindFirstChildOfClass("Humanoid")
end
local function setSprinting(on: boolean)
local humanoid = getHumanoid()
if not humanoid or on == sprinting then
return
end
sprinting = on
if on then
-- Şu anki hızı hatırla ve üstüne ekle, böylece başka bir scriptten gelen hız artışı korunur
normalSpeed = humanoid.WalkSpeed
humanoid.WalkSpeed = normalSpeed + SPRINT_BONUS
else
humanoid.WalkSpeed = normalSpeed
end
end
local function onSprint(_name: string, state: Enum.UserInputState, input: InputObject): Enum.ContextActionResult
local isKeyboard = input.UserInputType == Enum.UserInputType.Keyboard
if isKeyboard or not TOGGLE_ON_TOUCH_AND_GAMEPAD then
-- Basılı tutma: tuş ya da buton basılıyken koş
if state == Enum.UserInputState.Begin then
setSprinting(true)
elseif state == Enum.UserInputState.End or state == Enum.UserInputState.Cancel then
setSprinting(false)
end
elseif state == Enum.UserInputState.Begin then
-- Aç kapa: her basış koşuyu açar ya da kapatır
setSprinting(not sprinting)
end
return Enum.ContextActionResult.Pass
end
-- Tek çağrı tuşu, gamepad butonunu ve dokunmatik ekranlarda bir ekran butonunu bağlar
ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3)
ContextActionService:SetTitle("Sprint", "Sprint")
-- Yeni karakter yürüyerek başlar: Humanoid'inde zaten normal WalkSpeed var
player.CharacterAdded:Connect(function()
sprinting = false
end)
Koşuyu hızlandırmak ya da yavaşlatmak için SPRINT_BONUS'u değiştir. Telefondaki buton ve L3 Shift gibi çalışsın, yani sadece basılıyken koşsun istiyorsan TOGGLE_ON_TOUCH_AND_GAMEPAD'i false yap.
BindAction tek bir eylemi Left Shift'e ve gamepad'deki L3 butonuna bağlar, üçüncü argümanı olan true da dokunmatik ekranlara bir buton ekler; SetTitle onun üzerine "Sprint" yazar. İşleyici girdinin kendisini de alır, bu yüzden klavyedeki bir basışı gamepad'den ya da dokunmatik butondan ayırt eder. Koşu başlayınca script şu anki WalkSpeed'i hatırlar ve SPRINT_BONUS ekler; bitince hatırlanan değeri geri koyar. Başka bir scriptin ayarladığı hız, örneğin game pass rehberindeki Speed perk'i, korunur. Yeni bir karakter normal WalkSpeed ile başlar, bu yüzden CharacterAdded işleyicisi sadece bayrağı sıfırlar.
Basılı tutma mı, aç kapa mı?
| Cihaz ve girdi | Şöyle çalışır | Neden |
|---|---|---|
| Klavye: Left Shift | Basılı tutma | Hareket ederken tuşu basılı tutmak kolay, bırakmak da koşuyu hemen durdurur. |
| Gamepad: sol çubuğa basmak (L3) | Aç kapa | Çubuğu basılı tutup aynı anda onunla yön vermek yorucu. |
| Telefon ya da tablet: ekrandaki Sprint butonu | Aç kapa | Butonu tutan baş parmak aynı anda Jump'a basamaz. |
Denemek için Play'e bas ve yürürken Shift'i basılı tut: hız saniyede 16'dan 26 stud'a çıkar, bırakırsan yavaşlarsın. Telefon için Studio'nun Device Simulator'ında bir telefon seç, Play'e bas ve başlamak için Sprint'e bir kez, durmak için bir kez daha dokun. Gamepad için test sırasında Controller Emulator'ı aç ve L3'e bas. Cihazlara göre tam kontrol listesi Adım 6'da.
Adım 2 ve 3 bu scripti stamina çubuğu ve dash'i olan başka bir scriptle değiştiriyor. Adım 4 ve 5 çift zıplamayı ve sunucu kontrolünü ekliyor ve iki scriptten herhangi biriyle çalışıyor.
Adım 2: stamina ve dash sayıları tek bir modülde
Biten bir koşu için Adım 2 ve 3 ShiftToSprint'i stamina çubuğu ve dash'i olan daha büyük bir LocalScript ile değiştiriyor. Önce ShiftToSprint'i sil: iki script de Sprint eylemini bağlıyor.
Tüm sayılar tek bir ModuleScript'te duruyor, bu yüzden hareketin hissi tek bir yerden ayarlanıyor. MovementClient onları her oyuncunun cihazında okuyor, MovementCheck de koşu ve dash hızının ne olması gerektiğini bilmek için aynı modülü sunucuda okuyor.
- Explorer'da fareyle ReplicatedStorage üzerine gel, + butonuna tıkla ve bir ModuleScript ekle.
- Adını
MovementConfigyap ve içeriğini aşağıdaki kodla değiştir.
-- Hareket LocalScript'i ve sunucudaki hız kontrolü için tek bir sayı seti.
local MovementConfig = {
SPRINT_BONUS = 10, -- şu anki WalkSpeed'e eklenir: 16 (Roblox varsayılanı) 26 olur
MAX_STAMINA = 100,
DRAIN_PER_SECOND = 20, -- dolu bir çubukla 5 saniye koşu
REGEN_PER_SECOND = 15,
REGEN_DELAY = 1, -- koşu bittikten sonra stamina dolmaya başlamadan önceki saniye
MIN_TO_START = 20, -- koşuya başlamak için gereken stamina, böylece boş çubuk yanıp sönmez
DASH_SPEED = 60, -- dash sırasında saniyede stud
DASH_SECONDS = 0.2, -- böylece dash yaklaşık 12 stud gider
DASH_COST = 25, -- stamina
DASH_COOLDOWN = 1,
}
return MovementConfig
| Ayar | Değer | Etki |
|---|---|---|
SPRINT_BONUS | 10 | Koşarken WalkSpeed'e eklenir. Roblox'ta varsayılan WalkSpeed 16, bu yüzden koşu saniyede 26 stud hızla olur. |
MAX_STAMINA | 100 | Dolu çubuk. |
DRAIN_PER_SECOND | 20 | Dolu bir çubuk 5 saniye koşuya yeter. |
REGEN_PER_SECOND | 15 | Boş bir çubuk yaklaşık 6.7 saniyede dolar. |
REGEN_DELAY | 1 | Dolma başlamadan önceki dinlenme saniyesi. |
MIN_TO_START | 20 | Koşmaya başlamak için gereken stamina. |
DASH_SPEED | 60 | Dash sırasında saniyede stud. |
DASH_SECONDS | 0.2 | Dash'in ne kadar sürdüğü: saniyede 60 stud'da yaklaşık 12 stud. |
DASH_COST | 25 | Her dash için stamina. |
DASH_COOLDOWN | 1 | İki dash arasındaki saniye. |
Her taraf modülün kendi kopyasını çalıştırır (bir modül her tarafta bir kez çalışır), bu yüzden bu sayıları kendi cihazında değiştiren bir oyuncu sadece kendi kopyasını değiştirir. Ama bu burada hiçbir şeyi korumuyor: onun cihazı zaten karakterini hareket ettiriyor, yani modülde ne olursa olsun kendine sonsuz stamina verebilir. Adım 5'teki sunucu kontrolü bu düşünülerek kuruldu.
Adım 3: staminalı koşu ve dash
Bu LocalScript oyuncuların hissettiği şeyi yapar. Sprint ve Dash'i bağlar, stamina çubuğunu çizer, her karede stamina döngüsünü çalıştırır ve dash'i yapar.
- Explorer'da StarterPlayer'ı aç, fareyle StarterPlayerScripts üzerine gel ve
MovementClientadlı bir LocalScript ekle. - İçeriğini aşağıdaki kodla değiştir.
-- Stamina varken koşmak için Shift'i (ya da L3'ü veya telefonda Sprint butonunu) basılı tut.
-- Hareket yönüne dash yapmak için Q'ya (ya da B'ye veya Dash butonuna) bas.
local ContextActionService = game:GetService("ContextActionService")
local Debris = game:GetService("Debris")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local RunService = game:GetService("RunService")
type Config = {
SPRINT_BONUS: number,
MAX_STAMINA: number,
DRAIN_PER_SECOND: number,
REGEN_PER_SECOND: number,
REGEN_DELAY: number,
MIN_TO_START: number,
DASH_SPEED: number,
DASH_SECONDS: number,
DASH_COST: number,
DASH_COOLDOWN: number,
}
local Config = require(ReplicatedStorage:WaitForChild("MovementConfig")) :: Config
local player = Players.LocalPlayer
local stamina = Config.MAX_STAMINA
local sprintHeld = false
local sprinting = false
local normalSpeed = 16 -- koşu bitince geri dönülecek WalkSpeed
local lastSprintTime = 0
local lastDashTime = -math.huge
-- Stamina çubuğu: genişliği kalan staminaya eşit bir dolgulu çerçeve
local gui = Instance.new("ScreenGui")
gui.Name = "StaminaGui"
gui.ResetOnSpawn = false
local bar = Instance.new("Frame")
bar.AnchorPoint = Vector2.new(0.5, 1)
bar.Position = UDim2.new(0.5, 0, 1, -24)
bar.Size = UDim2.fromOffset(240, 14)
bar.BackgroundColor3 = Color3.fromRGB(30, 26, 40)
bar.Parent = gui
local fill = Instance.new("Frame")
fill.Size = UDim2.fromScale(1, 1)
fill.BackgroundColor3 = Color3.fromRGB(80, 220, 150)
fill.BorderSizePixel = 0
fill.Parent = bar
for _, frame in { bar, fill } do
local corner = Instance.new("UICorner")
corner.CornerRadius = UDim.new(1, 0)
corner.Parent = frame
end
gui.Parent = player:WaitForChild("PlayerGui")
local function getHumanoid(): Humanoid?
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
if humanoid and humanoid.Health > 0 then
return humanoid
end
return nil
end
-- Koşu: burada sadece bir bayrak; aşağıdaki Heartbeat döngüsü her karede koşulup koşulmayacağına karar verir
local function onSprint(_name: string, state: Enum.UserInputState, _input: InputObject): Enum.ContextActionResult
-- Onu sadece basma ve bırakma değiştirir: dokunmatik butonda kayan bir parmak Change gönderir
if state == Enum.UserInputState.Begin then
sprintHeld = true
elseif state == Enum.UserInputState.End or state == Enum.UserInputState.Cancel then
sprintHeld = false
end
return Enum.ContextActionResult.Pass
end
local function dash()
local humanoid = getHumanoid()
local rootPart = humanoid and humanoid.RootPart
local now = os.clock()
-- Otururken dash yok: oturan karakter koltuğa kaynaklıdır, bu yüzden bütün aracı iterdi
if not (humanoid and rootPart) or humanoid.Sit or now - lastDashTime < Config.DASH_COOLDOWN or stamina < Config.DASH_COST then
return
end
local attachment = rootPart:FindFirstChild("RootAttachment")
if not (attachment and attachment:IsA("Attachment")) then
return
end
lastDashTime = now
stamina -= Config.DASH_COST
lastSprintTime = now -- koşunun yaptığı gibi dolmayı duraklat
-- Oyuncunun gittiği yöne, yerinde duruyorsa da baktığı yöne dash
local direction = humanoid.MoveDirection
if direction.Magnitude < 0.1 then
direction = rootPart.CFrame.LookVector
end
direction = Vector3.new(direction.X, 0, direction.Z).Unit
-- Plane modundaki LinearVelocity yatay hızı tutar ve yerçekimine karışmaz
local velocity = Instance.new("LinearVelocity")
velocity.Attachment0 = attachment
velocity.RelativeTo = Enum.ActuatorRelativeTo.World
velocity.VelocityConstraintMode = Enum.VelocityConstraintMode.Plane
velocity.PrimaryTangentAxis = Vector3.xAxis
velocity.SecondaryTangentAxis = Vector3.zAxis
velocity.PlaneVelocity = Vector2.new(direction.X, direction.Z) * Config.DASH_SPEED
velocity.MaxForce = math.huge
velocity.Parent = rootPart
Debris:AddItem(velocity, Config.DASH_SECONDS)
end
local function onDash(_name: string, state: Enum.UserInputState, _input: InputObject): Enum.ContextActionResult
if state == Enum.UserInputState.Begin then
dash()
end
return Enum.ContextActionResult.Pass
end
-- Her çağrı tuşu, gamepad butonunu ve dokunmatik cihazlarda bir ekran butonunu bağlar
ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3)
ContextActionService:BindAction("Dash", onDash, true, Enum.KeyCode.Q, Enum.KeyCode.ButtonB)
ContextActionService:SetTitle("Sprint", "Sprint")
ContextActionService:SetTitle("Dash", "Dash")
-- Her kare: koşarken ve hareket ederken stamina harca, kısa bir dinlenmeden sonra doldur
RunService.Heartbeat:Connect(function(deltaTime: number)
local humanoid = getHumanoid()
if not humanoid then
return
end
local moving = humanoid.MoveDirection.Magnitude > 0
local now = os.clock()
local enoughStamina = if sprinting then stamina > 0 else stamina >= Config.MIN_TO_START
local shouldSprint = sprintHeld and moving and enoughStamina
-- WalkSpeed'i sadece koşunun başında ve sonunda değiştir, böylece başka bir scriptin
-- ayarladığı hız (örneğin bir hız pass'i) korunur ve koşu onun üstüne eklenir
if shouldSprint and not sprinting then
sprinting = true
normalSpeed = humanoid.WalkSpeed
humanoid.WalkSpeed = normalSpeed + Config.SPRINT_BONUS
elseif not shouldSprint and sprinting then
sprinting = false
humanoid.WalkSpeed = normalSpeed
end
if sprinting then
stamina = math.max(0, stamina - Config.DRAIN_PER_SECOND * deltaTime)
lastSprintTime = now
elseif now - lastSprintTime >= Config.REGEN_DELAY then
stamina = math.min(Config.MAX_STAMINA, stamina + Config.REGEN_PER_SECOND * deltaTime)
end
fill.Size = UDim2.fromScale(stamina / Config.MAX_STAMINA, 1)
end)
-- Yeni karakter dolu staminayla başlar ve hiçbir şey basılı değildir
player.CharacterAdded:Connect(function()
stamina = Config.MAX_STAMINA
sprintHeld = false
sprinting = false -- yeni Humanoid normal WalkSpeed ile başlar
end)
Stamina çubuğu kodda ResetOnSpawn false olarak oluşturulur, bu yüzden respawn'dan sonra ekranda kalır, alttaki CharacterAdded işleyicisi de onu her yeni karakter için yeniden doldurur. type Config satırları modülün ne döndürdüğünü tanımlar, böylece katı tür kontrolü bir ayar adındaki yazım hatasını yakalar; oyun sırasında hiçbir şeyi değiştirmezler.
Klavye, gamepad ve telefon butonu tek çağrıyla
ContextActionService:BindAction bir eylem adı, bir işleyici fonksiyon, dokunmatik buton oluşturulup oluşturulmayacağı ve ardından girdileri alır. Üçüncü argüman olarak true verirsen ContextActionService dokunmatik cihazlarda ekrana, oyuncunun PlayerGui'sindeki ContextActionGui adlı bir ScreenGui'nin içine bir buton ekler. SetTitle bu butonlara "Sprint" ve "Dash" yazar. BindAction en fazla 7 dokunmatik buton oluşturabilir, bu yüzden oyundaki başka scriptler de kullanıyorsa sayıya dikkat et.
İşleyici girdinin durumunu alır: basınca Begin, bırakınca End. onSprint sadece Sprint'in basılı olup olmadığını hatırlar. Başka bir bağlama girdiyi aldığında ContextActionService'in gönderdiği Cancel'ı da bırakma sayar ve dokunmatik butonda hareket eden bir parmağın gönderebileceği Change'i görmezden gelir. İki işleyici de Pass döndürür, böylece aynı tuştaki bir sonraki bağlama da girdiyi alır.
Roblox'un ContextActionService referansı çoğu durumda UserInputService.InputBegan yerine onu öneriyor. Örneği: oyuncu chat'e yazarken çalmaması gereken, H tuşundaki bir araba kornası. Bağlama sadece o girdi için en son bağlama olduğu sürece tetiklenir, bu yüzden chat klavyeyi aldığında hiçbir şeyi kontrol etmen gerekmez. Gamepad girdileri: ButtonL3 (sol çubuğa basmak, hareket ederken basılı tutulur) ve ButtonB. Roblox'un kendi koşu örneğinde ButtonY kullanılıyor, oyunun için daha rahatsa BindAction'daki KeyCode'u değiştir.
Stamina döngüsü
RunService.Heartbeat her karede fizik adımından sonra tetiklenir ve önceki kareden bu yana geçen saniye olan deltaTime'ı verir. Harcama ve dolma hızlarını onunla çarparsan oyun saniyede 30 ya da 240 karede çalışsa da dolu çubuk 5 saniye yeter.
Döngü her karede karakterin koşup koşmaması gerektiğine karar verir: Sprint basılı, karakter yürüyor (dururken Humanoid.MoveDirection sıfır vektöre eşittir) ve hâlâ stamina var. Koşmaya başlamak için en az MIN_TO_START (20) gerekir; devam etmek için 0'dan büyük herhangi bir şey yeter. Bu boşluk olmasaydı her karede biraz dolan boş bir çubuk koşuyu her karede açıp kapatırdı. Dolma son koşu ya da dash'ten REGEN_DELAY (1 saniye) sonra başlar, bu yüzden çubuğu boşaltan oyuncu tekrar koşabilmeden önce yaklaşık 2.3 saniye bekler.
WalkSpeed sadece koşunun başladığı ya da bittiği karede değişir. Başta script şu anki WalkSpeed'i hatırlar ve SPRINT_BONUS ekler; sonda hatırlanan değeri geri koyar. Bu yüzden başka bir scriptin ayarladığı hız korunur: game pass rehberindeki Speed perk'i WalkSpeed'i 24 yapar, bu scriptle de sahipleri 34'te koşar. Her karede ya da her bırakışta WalkSpeed = 16 yazan bir script bu perk'i sessizce iptal ederdi.
Dash
Dash karakteri gittiği yöne, yerinde duruyorsa da baktığı yöne iter, yön de asla yukarı ya da aşağı bakmayacak şekilde düzleştirilir. 25 stamina tutar, koşu gibi dolmayı duraklatır ve 1 saniyelik bir bekleme süresi vardır. Zemini kontrol etmez, bu yüzden havada da çalışır, bu da çift zıplamayla iyi gider. Karakter otururken dash hiçbir şey yapmaz: oturan karakter koltuğa kaynaklıdır ve bir araçta itme bütün aracı oynatabilirdi.
İtme, kök part'ın RootAttachment'ındaki bir LinearVelocity constraint'idir. X ve Z eksenleriyle Plane modunda saniyede 60 stud yatay hızı tutar ve dikeye dokunmaz, bu yüzden yerçekimi çalışır ve bir çıkıntıdan yapılan dash normal şekilde düşer. MaxForce math.huge'a eşit, yani itme hiçbir şeyle sınırlı değil. Debris:AddItem constraint'i scripti bekletmeden DASH_SECONDS sonra yok eder, bu yüzden dash 0.2 saniye, bu hızda yaklaşık 12 stud sürer.
Eski eğitimler Roblox'un yerine LinearVelocity kullanılması notuyla kullanımdan kalkmış olarak işaretlediği BodyVelocity'yi kullanır. Onun tek eksende sıfır MaxForce numarasının yerini LinearVelocity'nin Line, Plane ve Vector modları alır. Oyuncunun cihazı kendi karakterini kendisi simüle ettiği için bir LocalScript'in oluşturduğu constraint onu hareket ettirir, diğer oyuncular da dash'i diğer her hareket gibi görür.
Roblox'un kendi UI eğitimi constraint'i tam olarak aynı şekilde humanoid.RootPart.RootAttachment'a bağlıyor. Oyununda kök part'ında RootAttachment adlı bir Attachment olmayan özel bir karakter varsa dash hiçbir şey yapmaz: onu StarterCharacter'ının HumanoidRootPart'ına ekle.
Adım 4: çift zıplama
Çift zıplama StarterCharacterScripts içinde kendi LocalScript'inde yaşar. Roblox spawn anında bu konteynerdeki scriptlerin bir kopyasını her karaktere koyar ve bu kopyalar respawn'dan sağ çıkmaz, bu yüzden her can taze bir scriptle başlar ve öncekinden hiçbir şey taşınmaz.
- Explorer'da StarterPlayer'ı aç, fareyle StarterCharacterScripts üzerine gel ve
DoubleJumpadlı bir LocalScript ekle. - İçeriğini aşağıdaki kodla değiştir.
-- Havada bir ek zıplama verir. Her yeni karakter için yeniden çalışır,
-- bu yüzden respawn'dan sonra hiçbir şey taşınmaz.
local UserInputService = game:GetService("UserInputService")
local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local EXTRA_JUMPS = 1
local MIN_SECONDS_BETWEEN_JUMPS = 0.25 -- JumpRequest bir basışta birkaç kez tetiklenir
local NEW_PRESS_GAP = 0.1 -- basılı tutulan zıplama butonu JumpRequest göndermeye devam eder; bu uzunlukta bir duraklama bırakıldığı anlamına gelir
local jumpsLeft = 0
local lastJump = 0
local lastRequest = 0
humanoid.StateChanged:Connect(function(oldState: Enum.HumanoidStateType, newState: Enum.HumanoidStateType)
if newState == Enum.HumanoidStateType.Jumping and oldState ~= Enum.HumanoidStateType.Freefall then
-- Yerden bir zıplama (havadaki zıplamalarımızdan biri değil) havadaki zıplamaları geri verir
jumpsLeft = EXTRA_JUMPS
lastJump = os.clock()
elseif newState == Enum.HumanoidStateType.Landed then
jumpsLeft = 0
end
end)
-- JumpRequest oyuncu zıplamak istediğinde tetiklenir, örneğin Space ya da telefondaki zıplama butonuyla
UserInputService.JumpRequest:Connect(function()
local now = os.clock()
local newPress = now - lastRequest > NEW_PRESS_GAP
lastRequest = now
-- Sadece yeni bir basış tekrar zıplatır, böylece basılı tutulan buton havadaki zıplamayı harcamaz
if not newPress or jumpsLeft <= 0 or now - lastJump < MIN_SECONDS_BETWEEN_JUMPS then
return
end
if humanoid:GetState() == Enum.HumanoidStateType.Freefall then
jumpsLeft -= 1
lastJump = now
humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
end
end)
Üçlü zıplama için EXTRA_JUMPS'u 2 yap.
Script karakterin durumunu Humanoid.StateChanged ile izler. Freefall'dan gelmeyen bir Jumping geçişi yerden bir zıplamadır, bu yüzden havada bir zıplama verir, Landed da onu yine geri alır. Bir çıkıntıdan inersen karakter zıplamadan Freefall'a girer, bu yüzden havada zıplama almaz. Orada da gerekiyorsa jumpsLeft'i Jumping dışındaki herhangi bir durumdan Freefall'a geçişte de ayarla.
UserInputService.JumpRequest oyuncu zıplamak istediğinde tetiklenir, örneğin Space ya da telefondaki zıplama butonuyla. Roblox referansı onun tek bir zıplama isteğinde birkaç kez tetiklendiği konusunda uyarıyor ve bir debounce öneriyor, bu yüzden script son zıplamadan sonraki 0.25 saniye içindeki istekleri görmezden gelir. Basılı tutulan bir zıplama butonu da zıplama istemeye devam edebilir ve karakter yerden kalktığı anda havadaki zıplamayı harcardı, bu yüzden bir istek ancak 0.1 saniye istek gelmedikten sonra yeni bir basış sayılır.
Havadaki zıplamanın kendisi Humanoid:ChangeState(Enum.HumanoidStateType.Jumping)'dır. Roblox referansı onun karakterin ağ sahipliğine sahip cihazdaki bir LocalScript'ten çağrılması gerektiğini söylüyor, bu da varsayılan olarak sunucu değil oyuncunun kendi cihazı. Referanstaki ChangeState kod örneği de tam olarak bir çift zıplama.
Adım 5: speed hack'i sunucuda yakala
Koşu eğitimleri çoğu zaman client'ta durur. Bir sunucu Script'i oyuncunun WalkSpeed'ine güvenemez, çünkü exploiter'lar onu kendi cihazlarında değiştirir, ama karakterlerinin nereye vardığını görür. MovementCheck bunu saniyede iki kez ölçer ve biri koşu ile dash'in izin verdiğinden uzun süre hızlı hareket edince Output'a bir uyarı yazar. Koşu ve dash sayılarını MovementConfig'den okur, bu yüzden ShiftToSprint'i tutsan bile Adım 2'deki bu modülü ekle.
- Fareyle ServerScriptService üzerine gel ve
MovementCheckadlı bir Script ekle. - İçeriğini aşağıdaki kodla değiştir.
-- Oyuncuların cihazları kendi karakterlerini hareket ettirir, bu yüzden bir exploiter istediği WalkSpeed'i ayarlayabilir.
-- Bu kontrol her karakterin gerçekte ne kadar uzağa gittiğini ölçer ve biri koşu ve dash'in
-- izin verdiğinden uzun süre hızlı hareket edince Output'a yazar. Sadece uyarır:
-- lag, ışınlanmalar ve konveyörler hız aşımı gibi görünebilir, bu yüzden birini cezalandırmadan önce onu ayarla.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local StarterPlayer = game:GetService("StarterPlayer")
type Config = { SPRINT_BONUS: number, DASH_SPEED: number, DASH_SECONDS: number }
local Config = require(ReplicatedStorage:WaitForChild("MovementConfig")) :: Config
local CHECK_EVERY = 0.5 -- saniye
-- Koşu hızı artı lag payı. Hız artışı satıyorsan büyüt.
local SPEED_ALLOWANCE = (StarterPlayer.CharacterWalkSpeed + Config.SPRINT_BONUS) * 1.25
local BURST_ALLOWANCE = Config.DASH_SPEED * Config.DASH_SECONDS * 2 -- bir ya da iki dash için pay
local DRAIN_PER_CHECK = BURST_ALLOWANCE / 8 -- geçmiş dash'lerin ne kadar hızlı affedildiği
local lastPosition: { [Player]: Vector3 } = {}
local lastRoot: { [Player]: BasePart } = {} -- lastPosition'ın ölçüldüğü kök part
local excess: { [Player]: number } = {} -- toleransın üstündeki stud'lar, yavaş yavaş affedilir
Players.PlayerRemoving:Connect(function(player: Player)
lastPosition[player] = nil
lastRoot[player] = nil
excess[player] = nil
end)
while true do
task.wait(CHECK_EVERY)
for _, player in Players:GetPlayers() do
local character = player.Character
local rootPart = character and character:FindFirstChild("HumanoidRootPart")
if rootPart and rootPart:IsA("BasePart") then
local position = rootPart.Position
-- Respawn yeni bir kök part demektir, bir sunucu ışınlanması (raund başı, checkpoint) da
-- aşağıdaki attribute'u ayarlar: sıçramayı işaretlemek yerine ölçmeye baştan başla
local previous = if lastRoot[player] == rootPart then lastPosition[player] else nil
if player:GetAttribute("MovementCheckSkip") then
player:SetAttribute("MovementCheckSkip", nil)
previous = nil
end
lastPosition[player] = position
lastRoot[player] = rootPart
if previous then
-- Sadece yatay hareket: hızlı düşmek hile değil
local moved = Vector3.new(position.X - previous.X, 0, position.Z - previous.Z).Magnitude
local extra = moved - SPEED_ALLOWANCE * CHECK_EVERY
local total = math.max(0, (excess[player] or 0) + extra - DRAIN_PER_CHECK)
excess[player] = total
if total > BURST_ALLOWANCE then
warn(`MovementCheck: {player.Name} moved {math.round(moved / CHECK_EVERY)} studs/s`)
excess[player] = 0
end
end
else
lastPosition[player] = nil
lastRoot[player] = nil
end
end
end
Uyarı Studio'da Output'ta görünür. Yayındaki oyunda oyunun sahibi olarak okuyabildiğin Developer Console sunucu loguna düşer: yayındaki oyunda çıktı bölümüne bak.
Neyi ölçer
Script her yarım saniyede her karakterin kök part'ının konumunu okur ve son kontrolden bu yana yatayda ne kadar kaydığını ölçer. Yükseklik görmezden gelinir, bu yüzden düşüşler ve zıplamalar asla sayılmaz; Roblox'un hareket doğrulama tavsiyesi de yerde yürünen oyunlar için aynı XZ düzlemi izdüşümünü öneriyor. Tolerans varsayılan yürüme hızı artı koşu bonusu ve lag için bir dörtte bir daha: saniyede 32.5 stud. Bunun üstündeki mesafe bir "sızdıran kova"ya düşer; Roblox belgeleri bu biriktiricinin kısa patlamalar için birçok geliştiriciye iyi uyduğunu söylüyor. Kova her kontrolde 3 stud kaybeder, script de içinde 24 stud'dan fazlası olunca uyarır; bu da yaklaşık iki dash'lik bir pay.
| Hileci | MovementCheck ne yapar |
|---|---|
| WalkSpeed'i 100 yapar | Yaklaşık bir saniyelik koşudan sonra uyarır |
| WalkSpeed'i 50 yapar | Yaklaşık 2.5 saniyelik koşudan sonra uyarır |
| Bekleme süresi olmadan art arda dash yapar (saniyede 60 stud) | Yaklaşık 1.5 saniye sonra uyarır |
| Bir seferde 43 stud'dan fazla ışınlanır | Bir sonraki kontrolde uyarır |
| Saniyede 38 stud'a kadar, yani koşudan yaklaşık bir buçuk kat hızlı koşar | Hiçbir şey: saniyede 38.5 stud'un altında kova dolduğu kadar hızlı boşalır |
| Sonsuz stamina için kendi MovementConfig'ini değiştirir | Hiçbir şey: saniyede 26 stud'da koşmaya istediği kadar izin var |
| Uçar, sınırsız zıplar ya da duvarlardan geçer | Hiçbir şey: kontrol yüksekliği görmezden gelir ve çarpışmalara bakmaz |
Yani kontrol, oyuncunun diğer herkesten belirgin şekilde hızlı olduğu kaba hileleri yakalar, dikkatli olanları kaçırır. Bu, mesafeye dayalı bir kontrolün dürüst sınırı ve Roblox'un daha güçlü bir şey yapmasının sebebi (aşağıdaki server authority'ye bak).
Neden sadece uyarır
Roblox belgeleri basit hız kontrollerinin bağlantısı dengesiz dürüst oyuncuları işaretleyebileceğini ve araçlı ya da başka karmaşık hareketli oyunlarda bozulduğunu belirtiyor. Lag sıçramaları, konveyörler, araçlar, karakterleri fırlatan patlamalar ve kendi ışınlanmaların hız aşımı gibi görünebilir, bu yüzden script sadece bir uyarı yazdırır. Sen ve test edenlerin normal oynarken Output'u izle, dürüst oyuncular ona takılıyorsa SPEED_ALLOWANCE'ı büyüt ve oyuncuyu geri almak gibi bir cezayı ancak kontrol normal oyunda sessiz kaldığında ekle. Oyununda patlamalar karakterleri fırlatıyorsa Humanoid'inde can kalmamış oyuncuları da atla.
Respawn'lar ve ışınlanmalar
Respawn yeni bir kök part oluşturur, script de onu görünce ölçmeye baştan başlar, bu yüzden spawn noktasından uzakta ölmek asla hız aşımı sayılmaz. Kendi sunucu scriptlerinin yaptığı ışınlanmalar için, Roblox belgelerinin ışınlanmalı her oyun için söylediği gibi bir istisna gerekir. Bir ışınlanmadan sonra player:SetAttribute("MovementCheckSkip", true) ekle, bir sonraki kontrol de sıçramayı işaretlemek yerine yeni konumdan ölçmeye başlar:
- Raund sisteminde
startRoundiçindekicharacter:PivotTo(...)'dan hemen sonra. - Obby checkpoint scriptinde oyuncuyu checkpoint'ine taşıyan her
character:PivotTo(...)'dan hemen sonra.
Işınlanma rehberindeki pad'ler ve menüler ile ilk oyun rehberindeki Finish pad'i onu zaten her taşımadan sonra ayarlıyor.
Sadece sunucudaki değer sayılır. Oyuncunun kendi cihazında ayarladığı bir attribute o cihazda kalır (bkz. neyin replicate edilip neyin edilmediği), bu yüzden bir hileci kontrolü onunla kapatamaz.
Geleceğin çözümü: server authority
Roblox'un güvenlik belgeleri, yazıldığı sırada beta olan server authority modelini hareket exploit'lerini durdurmanın en güvenilir yolu olarak tanımlıyor. Doğrunun kaynağı sunucu olur, oyuncuların cihazları da sadece girdilerini bildirir; belgelere göre bu speed hack'lerin çalışmasını engeller, çünkü cihaza kendi konumunu bildirme konusunda asla güvenilmez.
Geçiş bir ayar değil, yeniden yazmak demek. Bu modelde hareketi sunucu hesaplar, bu yüzden sadece bir LocalScript'in ayarladığı WalkSpeed ya da LinearVelocity, sunucudan durum gelince iptal olur. Roblox belgeleri ana mantığın hem client'ın hem sunucunun çalıştırdığı bir ModuleScript'teki RunService:BindToSimulation() fonksiyonlarında çalışması gerektiğini söylüyor. Model ayrıca PlayerScriptsUseInputActionSystem dahil birkaç Workspace ayarı istiyor, yani kontrollerin de Input Action System'e taşınacak. Koşuyu, staminayı ve dash'i bu yapıya taşıyana kadar bu rehberdeki sürümü tut. O zamana kadar bunun gibi mesafeye dayalı bir kontrol, Roblox'un hareket doğrulama bölümünün anlattığı şeyin ta kendisi.
Adım 6: her cihazda dene
- Play'e bas ve yürürken Shift'i basılı tut. Hız saniyede 16'dan 26 stud'a çıkar, ekranın altındaki yeşil çubuk da küçülür. Yaklaşık 5 saniye sonra boşalır ve yine yürürsün.
- Shift'i bırak. 1 saniye sonra çubuk dolmaya başlar. Beşte biri dolana kadar Shift hiçbir şey yapmaz.
- Yürürken Q'ya bas: biraz ileri fırlarsın ve çubuğun dörtte biri gider. Hemen tekrar Q'ya bas, bir saniye geçene kadar hiçbir şey olmaz. Dash çok kısa ya da çok uzun geliyorsa MovementConfig'de
DASH_SPEED'i ya daDASH_SECONDS'ı değiştir. - Zıpla, sonra ikinci zıplama için havada zıplamaya bir kez daha bas. Yere in ve tekrar dene: yerden her zıplama havadaki zıplamayı geri verir.
- Tüm zıplama boyunca Space'i basılı tut. İki değil tek zıplama olmalı, çünkü havadaki zıplama yeni bir basış ister.
- Studio'da Device Simulator'ı aç (yazıldığı sırada beta: File, Beta Features, New Device Simulator, sonra Studio'yu yeniden başlat) ya da Test menüsünden eski Device Emulator'ı aç. Bir telefon seç ve Play'e bas. Sprint ve Dash butonları görünür. Yön verirken Sprint'i basılı tut, sonra tüm zıplama boyunca zıplama butonunu basılı tut ve sadece tek zıplama olduğunu kontrol et.
- Controller Emulator'ı aç (Emulation sekmesinde Controller ya da Device Simulator panelinde Virtual controller). Koşmak için hareket ederken L3'ü basılı tut, dash için B'ye, çift zıplama için de iki kez A'ya bas.
- Karakteri oyun menüsünden sıfırla. Çubuk yine dolu, Output'ta MovementCheck uyarısı yok ve hâlâ telefon simüle ediyorsan Sprint ve Dash butonları yerinde.
- Şimdi hileci gibi oyna. Explorer client'ı gösterene kadar Client/Server düğmesine bas, Workspace'te karakterinin Humanoid'ini seç ve Properties penceresinde WalkSpeed'i 60 yap. Birkaç saniye dolaş: Output'ta
MovementCheck: YourName moved 60 studs/sgibi bir uyarı belirir. 16'ya geri döndür, sonra bir dakika boyunca normal şekilde koş ve dash yap, Output'un sessiz kaldığını kontrol et. - Place'inde
Workspace.PlayerScriptsUseInputActionSystemEnabled ise çift zıplamayı bir kez daha dene: Roblox belgeleriJumpRequest'in onunla aynı şekilde davranıp davranmadığını söylemiyor.
Hiçbir şey olmuyorsa Studio'daki Window menüsünden Output penceresini aç ve MovementClient'tan gelen kırmızı bir hata ara ya da sık görülen hatalara bak.
Ne kadar hızlı ve ne kadar uzun: oyun türüne göre preset'ler
Doğru koşu oyuna bağlı. Bir korku kovalamacasının en kötü anda biten kısa ve yavaş bir koşuya ihtiyacı var; büyük bir açık haritanın ise oyuncular onu geçerken sıkılmasın diye uzun bir koşuya. Bu preset'ler aynı scriptleri kullanıyor ve sadece yürüme hızını ve MovementConfig'i değiştiriyor. Bunlar bizim başlangıç noktalarımız, ayarlardan hesaplandı, oyuncular üzerinde ölçülmedi.
| Oyun türü | CharacterWalkSpeed | SPRINT_BONUS (koşu hızı) | DRAIN_PER_SECOND | REGEN_PER_SECOND | Tam koşu | Boştan doluya | Bir çubukla mesafe |
|---|---|---|---|---|---|---|---|
| Bu rehber | 16 | 10 (26) | 20 | 15 | 5 sn | 7.7 sn | 130 stud |
| Korku kovalamacası | 12 | 8 (20) | 25 | 10 | 4 sn | 11 sn | 80 stud |
| Battleground'lar ve dövüş | 16 | 12 (28) | 15 | 20 | 6.7 sn | 6 sn | yaklaşık 187 stud |
| Açık dünya ya da simülatör | 16 | 16 (32) | 10 | 25 | 10 sn | 5 sn | 320 stud |
| Obby ya da parkur | 16 | 8 (24) | stamina yok: ShiftToSprint kullan |
- Yürüme hızı StarterPlayer'da ayarlanır. StarterPlayer'ı seç ve
CharacterWalkSpeed'i ayarla (varsayılan 16). Her yeni karakter bu hızla başlar, koşu onun üstüneSPRINT_BONUSekler, MovementCheck de onu okur, yani sunucu kontrolü senin seçimini takip eder. - MovementCheck kendini uyarlar. Yürüme hızı artı koşu bonusu ve lag için bir dörtte bir daha izin verir: korku preset'i için saniyede 25 stud, açık dünya için 40. Başka hiçbir şeyi değiştirmen gerekmez.
- Obby'de koşu parkuru değiştirir. Daha hızlı koşuyla daha uzun boşluklar atlanır. Zıplamaları kur, sonra her birini koşu hızında dene, yoksa koşu aşamaları fazla kolaylaştırır. Obby checkpoint rehberi ShiftToSprint ile iyi gider.
- Korkuda ölçü katildir. Kovalayanı yürüme hızından biraz hızlı ve koşudan biraz yavaş yap, böylece kaçış çubuğun ne zaman biteceğine bağlı olur. Korku oyunu rehberi döngünün geri kalanını anlatıyor.
Eski koşu scriptlerinin sorunu ne
Koşu, dash ve çift zıplama için eski eğitimler çoğu zaman hâlâ çalışıyor, ama birçoğu Roblox'un o zamandan beri değiştirdiği yöntemleri kullanıyor ya da oyunundaki başka sistemleri bozuyor. Kopyalanmış bir scripti düzeltiyorsan onu bu listeyle karşılaştır.
| Yöntem | Sorun ne | Bu rehber |
|---|---|---|
Dash için BodyVelocity | Kullanımdan kalktı: Roblox yerine LinearVelocity kullanılmasını söylüyor | Plane modunda LinearVelocity |
RunService.RenderStepped üzerinde döngü | Yeni işler için yerini PreRender aldı. Stamina gibi oyun mantığının yeri, Roblox'un can yenileme gibi periyodik görevler için tanımladığı Heartbeat | deltaTime ile Heartbeat |
wait() ile stamina döngüsü | wait() task.wait() lehine kullanımdan kalktı ve yavaşlatılıyor, bu yüzden istenenden uzun bekleyebilir, her wait için sabit bir harcama da staminayı düzensiz tüketir | deltaTime hesaba katılarak her karede harcama ve dolma |
Chat kontrolü olmadan UserInputService.InputBegan | Chat'te mesaj yazarken Shift'e basmak koşuyu başlatır | Telefona buton da ekleyen ContextActionService |
Bırakınca ya da her karede WalkSpeed = 16 | Game pass perk'i gibi başka her hızın üstüne yazar | WalkSpeed'i sadece koşunun başında ve sonunda, şu anki değere ekleyerek değiştirir |
| WalkSpeed'i sunucu ayarlasın diye RemoteEvent ile koşu | Exploiter'lar WalkSpeed'i yine kendileri ayarlar, koşu da gidiş dönüş kadar gecikmeyle başlar | Client'ta koşu artı sunucuda mesafe kontrolü |
Her JumpRequest'te çift zıplama | JumpRequest tek bir zıplama isteğinde birkaç kez tetiklenir, basılı tutulan buton da zıplama istemeye devam edebilir | 0.25 saniyelik duraklama ve yeni basış kontrolü |
"Bu bir telefon" kontrolü olarak UserInputService.TouchEnabled | Dokunmatik ekranlı dizüstülerde true olur | ContextActionService senin kendi cihaz kontrolün olmadan dokunmatik cihazlarda ekrana butonlar ekler |
Koşu animasyonu için Humanoid:LoadAnimation | Animator:LoadAnimation lehine kullanımdan kalktı | Aşağıdaki koşu animasyonu Animator kullanıyor |
Roblox'un yeni yolu: Input Action System
Roblox'un Input Action System sayfası ilk örnek olarak karakter koşusunu alıyor. BindAction çağrıları yerine kontroller Studio'da ayarlanıyor: ReplicatedStorage'daki bir input context'in içinde CharacterSprint adlı bir InputAction, Left Shift için bir InputBinding, gamepad'deki Y butonu için bir tane ve StarterGui'de çizdiğin bir ekran butonuna bağlı bir tane. Sonra bir client scripti eylemin Pressed ve Released event'lerini dinler, basınca WalkSpeed'i ikiye katlar, bırakınca geri koyar.
Kontrolleri kodda değil Studio'da düzenlemek, ContextActionService butonu yerine kendi dokunmatik butonunu ya da örneğin menüler veya araçlar için bütün kontrol setlerini değiştiren context'ler istiyorsan ona geçmeye değer. Sayfa ayrıca Workspace.PlayerScriptsUseInputActionSystem'ı Enabled yapmayı öneriyor, server authority de bunu zorunlu kılıyor.
Bu rehberdeki stamina döngüsü ve dash tek başına Input Action System ile de (server authority olmadan) aynı şekilde çalışır. MovementConfig'i, Heartbeat döngüsünü ve dash()'i tut, iki BindAction çağrısını ve işleyicilerini sil, onların yerine eylemleri bağla: koşu eyleminin Pressed'i sprintHeld'i true yapar, Released'i false yapar, dash eyleminin Pressed'i de dash()'i çağırır. MovementClient'ın yaptığı gibi Humanoid'i her karede aramaya devam et, çünkü belgelerdeki örnek ilk karakterin Humanoid'ini saklıyor ve respawn'dan sonra o artık yok.
Roblox ayrıca Studio'da Beta Features ve Avatar Settings'ten açılan bir beta olan Character Controller Library'yi test ediyor. Onun kendi yetenekleriyle ilgili sayfası örnek olarak 0.2 saniyelik aktif pencereli ve 1 saniyelik bekleme süreli bir dash kuruyor, yani bu rehberdeki dash ile aynı zamanlamayla.
Nasıl genişletilir: animasyon, kamera ve koşu pass'i
Koşu animasyonu
Animation Editor'da bir koşu animasyonu yap, önceliğini Movement yap (Roblox onu yürüme ve koşu animasyonları için öneriyor), yayınla ve asset ID'sini kopyala. MovementClient'ta bu AnimationId ile bir Animation oluştur, karakterin Humanoid'inin içindeki Animator'ı kullanarak Animator:LoadAnimation ile yükle, track'i koşunun başladığı yerde çalıştır ve bittiği yerde durdur. Onu her yeni karakter için yeniden yükle.
Cihazının karakterinde çalıştırdığı animasyonları, Roblox'un oraya koyduğu Animator'ı kullanırsan herkes görür: bir LocalScript'in oluşturduğu Animator'a yüklenen track'ler replicate edilmez. Birçok eski eğitimin kullandığı Humanoid:LoadAnimation kullanımdan kalktı.
Koşarken daha geniş kamera
Biraz daha geniş bir görüş açısı koşuyu daha hızlı hissettirir. Aynı iki yerde workspace.CurrentCamera.FieldOfView'ı koşu başlayınca varsayılan 70'ten yaklaşık 80'e, bitince de geri tween'le, örneğin TweenService:Create(workspace.CurrentCamera, TweenInfo.new(0.25), { FieldOfView = 80 }):Play() ile. Roblox değeri 1 ile 120 arasında sınırlıyor ve çok düşük ya da çok yüksek değerlerin oyuncuların yönünü şaşırtabileceği konusunda uyarıyor. Oyunda görüş açısını değiştiren başka bir script varsa 70'e değil, bulduğun değere geri tween'le.
Game pass olarak hızlı koşu
Game pass rehberi zaten bu scriptle çalışıyor: Speed perk'i sunucuda her yeni karaktere WalkSpeed 24 verir, MovementClient üstüne koşu bonusunu ekler ve saniyede 34 stud, MovementCheck'in izin verdiği sınırlar içinde kalır.
Koşunun kendisini hızlandıran bir pass için o rehberdeki PassConfig.ids'e bir FastSprint pass'i ekle. Onun sunucu scripti de satın alma onaylanır onaylanmaz oyuncuya OwnsPass_FastSprint attribute'unu ayarlar. MovementClient'ta player:GetAttribute("OwnsPass_FastSprint") == true olduğunda Config.SPRINT_BONUS'tan büyük bir bonus kullan. MovementCheck'te bu oyunculara, oyuncunun değiştiremediği sunucuda aynı attribute'u okuyarak daha büyük bir tolerans ver ve yeni en yüksek hızın kontrolün işaretlediği değerin altında kaldığını kontrol et.
Bilmeye değer bir sınır: başka bir script koşunun ortasında WalkSpeed'i değiştirirse bu koşunun sonu, ondan önceki hızı geri koyar. Bir sonraki respawn pass'in hızını yine ayarlar, çünkü game pass scripti onu her yeni karaktere uygular.
Sık yapılan hatalar ve çözümleri
Play'e basmadan önce Output penceresini aç (Window menüsü, sonra Output). Bu scriptlerle ilgili sorunların çoğu orada scriptin adı ve satır numarasıyla bir hata ya da uyarı yazdırır.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("MovementConfig")'
MovementClient ya da MovementCheck tam olarak bu adla olmayan bir modülü bekliyor. Doğrudan ReplicatedStorage'ın içinde MovementConfig adlı bir ModuleScript olmalı. Script hataları rehberi bu uyarıyı ayrıntılı anlatıyor.
Shift hiçbir şey yapmıyor
ShiftToSprint'in ya da MovementClient'ın Script değil LocalScript olduğunu ve StarterPlayerScripts içinde durduğunu kontrol et. MovementClient ile koşuya başlamak için karakterin ayrıca yürüyor olması ve en az 20 staminası olması gerekir, bu yüzden hareket ederken Shift'i basılı tut. Koşu yerine Shift Lock açılıp kapanıyorsa aşağıdaki Shift Lock sorusuna bak.
Koşu birkaç saniye sonra duruyor
Bu stamina bitiyor demek: saniyede 20'den 100 stamina 5 saniye yeter. MovementConfig'de MAX_STAMINA'yı büyüt ya da DRAIN_PER_SECOND'u küçült.
Dash hiçbir şey yapmıyor
Dash 25 stamina ister, öncekinden sonra 1 saniye bekler ve sen otururken hiçbir şey yapmaz. Sorun bu değilse karakterinin kök part'ında RootAttachment adlı bir Attachment olmayabilir, bazı özel karakterlerde böyle olur: onu StarterCharacter'ının HumanoidRootPart'ına ekle.
Çift zıplama çalışmıyor
DoubleJump StarterPlayerScripts'te değil, StarterCharacterScripts'te bir LocalScript olmalı, çünkü script.Parent'ı karakter olarak okur. Yerden kalktıktan sonra zıplamaya ikinci kez bas: basılı tutulan buton yeni bir basış sayılmaz, bir çıkıntıdan inmek de havada zıplama vermez.
Telefonda Sprint ya da Dash butonu yok
ContextActionService butonlarını sadece dokunmatik cihazlarda ekler, bu yüzden dokunmatik ekranı olmayan bir PC'de onları asla görmezsin. Studio'nun Device Simulator'ında bir telefonla dene (bu bir beta: File, Beta Features içinde New Device Simulator'ı aç ve Studio'yu yeniden başlat). BindAction en fazla 7 dokunmatik buton oluşturabilir, bu yüzden oyundaki diğer scriptlerin kaç tane yaptığını say.
MovementCheck dürüst oyunculara uyarı veriyor
Olağan sebepler: başka bir sunucu scriptinden bir ışınlanma, bir konveyör ya da araç veya lag. Kendi ışınlanmalarından sonra MovementCheckSkip attribute'unu ayarla (bkz. Respawn'lar ve ışınlanmalar) ve kontrol normal oyunda hâlâ tetikleniyorsa SPEED_ALLOWANCE'ı büyüt.
Hız artışı koşudan sonra kayboluyor
Koşu sırasında başka bir script WalkSpeed'i değiştirdi, koşu da bitince başta gördüğü hızı geri koydu. Hız artışlarını game pass rehberinin yaptığı gibi karakter spawn olurken ver, böylece respawn doğru hızı yine ayarlar.
RoCode ile yap
Bunların hepsini elle kurmak istemiyorsan RoCode onu açık olan place'inde kurabilir. RoCode Roblox Studio için bağımsız bir yapay zeka ajanı, Roblox'un değil: değişikliği bir web chat'inde anlatırsın, Studio plugin'i de scriptleri Explorer'ında oluşturur, yani kod yapıştırman gerekmez.
Stamina çubuklu Shift ile koşma ekle: Shift basılıyken yürüme hızı artı 10, 100 stamina, saniyede 20 harcama, bir saniyelik dinlenmeden sonra saniyede 15 dolma, telefonlarda bir Sprint butonu, Q ile dash ve çift zıplama.
- WalkSpeed'i değiştiren başka scriptleri (örneğin bir game pass perk'i) bulmak için önce place'ini Search Scripts ve Read Script ile inceleyebilir, böylece koşu onların üstüne eklenir
- ModuleScript'i, LocalScript'leri ve sunucu kontrolünü Create Script ile yazar
- Yazdığı her scriptin derlendiğini, onu çalıştırmadan Studio'da derleyen Check Script ile kontrol etmesi söylenmiştir
- Her değişiklik grubundan önce ve sonra bir geri alma noktası koyar, böylece Ctrl+Z her seferinde bir grubu geri alır
RoCode koşu animasyonu yapamaz: onu Animation Editor'da oluştur ve ID'sini yapıştır. Plugin 3.9.11 ya da üstüyle RoCode oyununu Studio'da test edebilir ve her şeyin çalıştığını kontrol etmek için bir test karakterini yönetebilir, plugin 3.9.15 ya da üstüyle de test karakteri tuşlara basabilir, örneğin Shift'i basılı tutup WalkSpeed'in arttığını kontrol edebilir. Testi ne zaman yapacağına kendisi karar verir, kurulum başına 2'ye kadar artı kendi düzeltmesini kontrol etmek için 1, ve sadece test etmeye karar verdiği şeyi kontrol eder, bu yüzden koşuyu, dash'i ve çift zıplamayı kendin dene, telefon butonlarını da Studio'nun Device Simulator'ında kontrol et. Hareket bir oyundaki birçok sistemden biri; RoCode ile bütün bir oyun yapmak buradaki gibi prompt başına bir sistemle ilerliyor. RoCode Studio'ya nasıl bağlanır.
Sık sorulan sorular
Koşu scripti neden telefonda çalışmıyor?
Telefonda Shift tuşu yok. Koşuyu ContextActionService:BindAction ile bağla ve üçüncü argüman olarak true ver: bu, ShiftToSprint'in de MovementClient'ın da yaptığı gibi dokunmatik cihazlarda ekrana bir buton ekler.
Koşuyu sunucuda mı yapmalıyım?
Hayır. Her cihaz kendi karakterini hareket ettirir, bu yüzden sunucunun ayarladığı WalkSpeed kendi hızını ayarlayabilen bir hileciyi durdurmaz, yeni hız da ancak bir gidiş dönüşten sonra gelir, yani koşu gecikmeyle başlar. Koşuyu client'ta yap, sunucuda da Adım 5'teki gibi karakterlerin gerçekte ne kadar uzağa gittiğini kontrol et. Roblox'un server authority betası farklı çalışıyor ve onun için hareket kodunu yeniden yazman gerekecek.
Shift'i bıraktığımda karakter neden koşmaya devam ediyor?
Script bırakmayı kaçırdı, genelde sadece basmayı dinlediği için. ContextActionService tuş bırakılınca End, başka bir bağlama onu alınca da Cancel gönderir; MovementClient ikisinde de durur, ayrıca stamina bittiğinde ya da karakter hareketi bıraktığında da.
Koşu animasyonu nasıl eklenir?
Koşu animasyonunu aynı LocalScript'te karakterin Humanoid'indeki Animator ile yükle, koşu başlayınca çalıştır ve bitince durdur. Önceliğini Movement yap. Kendi karakterinde çalıştırılan animasyonları herkes görür.
Çift zıplama telefonda neden kendiliğinden tetikleniyor?
Telefondaki basılı tutulan zıplama butonu zıplama istemeye devam eder. Bir zıplamayı ancak istekler bir anlığına kesildiyse yeni say, DoubleJump scriptinin yaptığı gibi.
Roblox'ta varsayılan yürüme hızı ne?
Saniyede 16 stud. Her yeni karakterin Humanoid.WalkSpeed'ini ayarlayan StarterPlayer.CharacterWalkSpeed'ten gelir. Bu rehberdeki koşu 10 ekler, yani koşu 26'da olur.
Roblox'ta koşu ne kadar hızlı olmalı?
Çoğu oyun yürüme hızının yarısı ile tamamı arasında bir değer ekler: 16, 24 ile 32 arasında bir şey olur. Kısa ve yavaş bir koşu korkuya, uzun ve hızlı bir koşu da büyük haritalara uyar. Oyun türüne göre preset'ler her biri için yürüme hızını, koşu bonusunu ve stamina sayılarını veriyor.
Staminalı koşu nasıl yapılır?
Oyuncunun cihazında bir stamina sayısı tut, koşarken onu her karede harca ve kısa bir dinlenmeden sonra doldur, ikisinde de kare süresini hesaba kat ve 0'a gelince koşuyu durdur. Adım 3'teki MovementClient bunu ekranda bir çubukla yapıyor; sayılar MovementConfig'de.
Roblox'ta kontrolcüyle nasıl koşulur?
Gamepad'in ButtonL3'ünü (sol çubuğa basmak) Left Shift ile birlikte ContextActionService üzerinden bağla, buradaki iki scriptin de yaptığı gibi. ShiftToSprint L3'ü aç kapa yapıyor, çünkü çubuğu basılı tutup aynı anda onunla yön vermek yorucu.
Shift ile koşma Shift Lock ile çakışır mı?
Çakışabilir. Roblox ayarlarında Shift Lock'u açmış oyuncular onu Shift tuşuyla açıp kapatır, yani bir tuş iki şey yapar. Roblox belgeleri Shift Lock API'lerinin kullanımdan kaldırıldığını söylüyor. Çakışma oyuncularını rahatsız ediyorsa StarterPlayer.EnableMouseLockOption'ı kapat ya da MovementClient'ta koşuyu Left Ctrl gibi başka bir tuşa bağla.
Kaynaklar ve ek okumalar
- Roblox Creator Docs: ContextActionService (İngilizce). BindAction, dokunmatik butonlar, 7 buton sınırı ve neden çoğu durumda InputBegan'den iyi olduğu
- Roblox Creator Docs: Humanoid (İngilizce). WalkSpeed ve güvenlik notu, MoveDirection, StateChanged ve çift zıplama örnekli ChangeState
- Roblox Creator Docs: LinearVelocity (İngilizce). Plane modu, teğet eksenler ve MaxForce
- Roblox Creator Docs: Mover constraints (İngilizce). kullanımdan kalkmış BodyVelocity'den LinearVelocity'ye geçiş
- Roblox Creator Docs: UserInputService (İngilizce). JumpRequest ve neden debounce gerektirdiği
- Roblox Creator Docs: Network ownership, movement validation, and physics (İngilizce). client'ın neyi kontrol ettiği, mesafe kontrolleri, sızdıran kovalar ve ışınlanma istisnaları
- Roblox Creator Docs: Server authority model (İngilizce). hareketin sunucuda olduğu model, BindToSimulation ve gerektirdiği Workspace ayarları
- Roblox Creator Docs: Input Action System (İngilizce). InputAction ve InputBinding ile Character Sprint örneği
- Roblox Creator Docs: Custom abilities (İngilizce). Character Controller Library'de dash yeteneği
- Roblox Creator Docs: Studio testing modes (İngilizce). Device Simulator ve Controller Emulator
Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.