Eğitim · Oyun sistemleri

Roblox Studio'da PC, telefon ve konsol için Shift ile koşma nasıl yapılır

Roblox'ta Shift ile koşma tek bir sayıya dayanır: Shift basılıyken artan Humanoid WalkSpeed'i. Adım 1 tam olarak bunu, telefondaki Sprint butonuyla ve gamepad ile de çalışan kısa bir LocalScript'te yapıyor. Rehberin geri kalanı büyük bir oyunun ihtiyacı olanları ekliyor: bir stamina çubuğu, modern fizikle bir dash, basılı tutulan butonla tetiklenmeyen bir çift zıplama ve sunucunun neyi kontrol edip neyi edemeyeceğinin anlaşılması.

Güncellendi: 20 Kasım 202621 dk okumaYazan:

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
  1. Nasıl çalışır
  2. 1. Shift ile koşma
  3. 2. Ayar modülü
  4. 3. Koşu ve dash
  5. 4. Çift zıplama
  6. 5. Sunucuda kontrol
  7. 6. Deneme
  8. Hız preset'leri
  9. Eski scriptler
  10. Input Action System
  11. Genişletmeler
  12. Common errors
  13. RoCode ile
  14. Sık sorulan sorular
  15. Kaynaklar ve ek okumalar

Roblox'ta koşu nasıl çalışır

ÇizimShift çubuk azalırken WalkSpeed 26 ile koşturuyor, Q çubuğun dörtte biri karşılığında dash yapıyor, havada ikinci kez zıplamaya basmak da bir kez daha zıplatıyor.

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.

Hareket sistemi nelerden oluşur
ParçaNerede dururNe yapar
LocalScript ShiftToSprintStarterPlayerScriptsTek başına Adım 1: klavyede, telefonda ve gamepad'de staminasız koşu. Stamina ve dash eklediğinde yerini MovementClient alır.
ModuleScript MovementConfigReplicatedStorageSayılar: koşu bonusu, stamina ve dash. Onları hem LocalScript hem sunucu kontrolü okur.
LocalScript MovementClientStarterPlayerScriptsSprint 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 DoubleJumpStarterCharacterScriptsHavada bir ek zıplama verir. Her yeni karakterde yeni bir kopyası çalışır.
Script MovementCheckServerScriptServiceHer 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.
Hareket sistemi hazır olduğunda Explorer
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.

  1. Explorer'da StarterPlayer'ı aç, fareyle StarterPlayerScripts üzerine gel, + butonuna tıkla ve ShiftToSprint adlı bir LocalScript ekle.
  2. İçeriğini aşağıdaki kodla değiştir ve Play'e bas.
LocalScript konum: StarterPlayerScripts adı: ShiftToSprint
-- 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ı?

TOGGLE_ON_TOUCH_AND_GAMEPAD true iken ShiftToSprint her cihazda nasıl çalışır
Cihaz ve girdiŞöyle çalışırNeden
Klavye: Left ShiftBasılı tutmaHareket 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 butonuAç kapaButonu 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.

  1. Explorer'da fareyle ReplicatedStorage üzerine gel, + butonuna tıkla ve bir ModuleScript ekle.
  2. Adını MovementConfig yap ve içeriğini aşağıdaki kodla değiştir.
ModuleScript konum: ReplicatedStorage adı: MovementConfig
-- 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
Her ayar ne yapar
AyarDeğerEtki
SPRINT_BONUS10Koşarken WalkSpeed'e eklenir. Roblox'ta varsayılan WalkSpeed 16, bu yüzden koşu saniyede 26 stud hızla olur.
MAX_STAMINA100Dolu çubuk.
DRAIN_PER_SECOND20Dolu bir çubuk 5 saniye koşuya yeter.
REGEN_PER_SECOND15Boş bir çubuk yaklaşık 6.7 saniyede dolar.
REGEN_DELAY1Dolma başlamadan önceki dinlenme saniyesi.
MIN_TO_START20Koşmaya başlamak için gereken stamina.
DASH_SPEED60Dash sırasında saniyede stud.
DASH_SECONDS0.2Dash'in ne kadar sürdüğü: saniyede 60 stud'da yaklaşık 12 stud.
DASH_COST25Her dash için stamina.
DASH_COOLDOWN1İ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.

  1. Explorer'da StarterPlayer'ı aç, fareyle StarterPlayerScripts üzerine gel ve MovementClient adlı bir LocalScript ekle.
  2. İçeriğini aşağıdaki kodla değiştir.
LocalScript konum: StarterPlayerScripts adı: MovementClient
-- 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.

  1. Explorer'da StarterPlayer'ı aç, fareyle StarterCharacterScripts üzerine gel ve DoubleJump adlı bir LocalScript ekle.
  2. İçeriğini aşağıdaki kodla değiştir.
LocalScript konum: StarterCharacterScripts adı: DoubleJump
-- 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.

  1. Fareyle ServerScriptService üzerine gel ve MovementCheck adlı bir Script ekle.
  2. İçeriğini aşağıdaki kodla değiştir.
Script konum: ServerScriptService adı: MovementCheck
-- 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.

Sayılarına göre hesaplanınca kontrol neyi yakalar
HileciMovementCheck ne yapar
WalkSpeed'i 100 yaparYaklaşık bir saniyelik koşudan sonra uyarır
WalkSpeed'i 50 yaparYaklaşı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ırBir sonraki kontrolde uyarır
Saniyede 38 stud'a kadar, yani koşudan yaklaşık bir buçuk kat hızlı koşarHiç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ştirirHiç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çerHiç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:

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

  1. 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.
  2. Shift'i bırak. 1 saniye sonra çubuk dolmaya başlar. Beşte biri dolana kadar Shift hiçbir şey yapmaz.
  3. 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 da DASH_SECONDS'ı değiştir.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. Ş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/s gibi 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.
  10. Place'inde Workspace.PlayerScriptsUseInputActionSystem Enabled ise çift zıplamayı bir kez daha dene: Roblox belgeleri JumpRequest'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üne göre yürüme hızı, koşu ve stamina. Koşu süresi MAX_STAMINA / DRAIN_PER_SECOND; dolma MAX_STAMINA / REGEN_PER_SECOND artı 1 saniyelik REGEN_DELAY
Oyun türüCharacterWalkSpeedSPRINT_BONUS (koşu hızı)DRAIN_PER_SECONDREGEN_PER_SECONDTam koşuBoştan doluyaBir çubukla mesafe
Bu rehber1610 (26)20155 sn7.7 sn130 stud
Korku kovalamacası128 (20)25104 sn11 sn80 stud
Battleground'lar ve dövüş1612 (28)15206.7 sn6 snyaklaşık 187 stud
Açık dünya ya da simülatör1616 (32)102510 sn5 sn320 stud
Obby ya da parkur168 (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üne SPRINT_BONUS ekler, 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.

Eski eğitimlerdeki yöntemler ve bu rehberin onların yerine ne yaptığı
YöntemSorun neBu rehber
Dash için BodyVelocityKullanımdan kalktı: Roblox yerine LinearVelocity kullanılmasını söylüyorPlane 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ığı HeartbeatdeltaTime 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üketirdeltaTime hesaba katılarak her karede harcama ve dolma
Chat kontrolü olmadan UserInputService.InputBeganChat'te mesaj yazarken Shift'e basmak koşuyu başlatırTelefona buton da ekleyen ContextActionService
Bırakınca ya da her karede WalkSpeed = 16Game pass perk'i gibi başka her hızın üstüne yazarWalkSpeed'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şuExploiter'lar WalkSpeed'i yine kendileri ayarlar, koşu da gidiş dönüş kadar gecikmeyle başlarClient'ta koşu artı sunucuda mesafe kontrolü
Her JumpRequest'te çift zıplamaJumpRequest tek bir zıplama isteğinde birkaç kez tetiklenir, basılı tutulan buton da zıplama istemeye devam edebilir0.25 saniyelik duraklama ve yeni basış kontrolü
"Bu bir telefon" kontrolü olarak UserInputService.TouchEnabledDokunmatik ekranlı dizüstülerde true olurContextActionService senin kendi cihaz kontrolün olmadan dokunmatik cihazlarda ekrana butonlar ekler
Koşu animasyonu için Humanoid:LoadAnimationAnimator: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.

Sen yazarsın

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.

RoCode yapar
  • 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

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.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.