教學 · 遊戲系統

如何在 Roblox Studio 製作 Shift 跑步,支援電腦、手機與主機

Roblox 的 Shift 跑步其實只是一個數值:Humanoid 的 WalkSpeed,在按住 Shift 時變大。步驟 1 就在一個簡短的 LocalScript 中做到這件事,而且手機上的 Sprint 按鈕和手把都能用。教學其餘部分加上大型遊戲需要的東西:體力條、使用新式物理的衝刺、不會因為按住按鈕而觸發的二段跳,以及伺服器能檢查什麼、不能檢查什麼。

更新日期 2026年11月20日閱讀約 6 分鐘作者

重點摘要

在 StarterPlayerScripts 中放一個 LocalScript,用 ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3) 綁定 Sprint 動作。按住 Shift 時把 Humanoid.WalkSpeed 加 10(16 變成 26),放開時改回原本的數值。引數 true 會在觸控螢幕上加入 Sprint 按鈕,在本教學的 Script 中,這個按鈕和手把上的 L3 是用來開關跑步,而不是要一直按住。

  • 要在目前的 WalkSpeed 上加,而不是直接設成 26,這樣遊戲通行證給的加速才會保留。
  • 跑步是在玩家的裝置上運作的。伺服器無法強制設定 WalkSpeed;它只能測量角色實際移動了多遠,並標記出跑步無法解釋的速度。
  • 步驟 2 到 4 用同樣的概念加上體力條、衝刺與二段跳。要跑多快、跑多久,可以參考依遊戲類型的預設值,裡面有恐怖、戰鬥與開放世界遊戲的數值。
本頁內容
  1. 運作方式
  2. 1. Shift 跑步
  3. 2. 設定模組
  4. 3. 跑步與衝刺
  5. 4. 二段跳
  6. 5. 伺服器檢查
  7. 6. 測試
  8. 速度預設值
  9. 舊的 Script
  10. Input Action System
  11. 擴充
  12. Common errors
  13. 用 RoCode
  14. 常見問題
  15. 來源與延伸閱讀

Roblox 的跑步是怎麼運作的

示意畫面Shift 讓角色以 WalkSpeed 26 奔跑,同時體力條減少;Q 花四分之一條體力衝刺;在空中再按一次跳躍會再跳一次。

每位玩家的裝置負責移動自己的角色。鍵盤、控制器或觸控螢幕決定角色往哪裡走,Roblox 再把結果傳給伺服器和其他所有人。所以跑步就是一個 LocalScript,在按住按鍵時提高 Humanoid.WalkSpeed,這也正是步驟 1 所做的全部事情。教學其餘部分是大型遊戲在它周圍需要的東西:體力條、衝刺、二段跳,以及抓作弊者的伺服器檢查。

移動系統由哪些部分組成
部分位置作用
LocalScript ShiftToSprintStarterPlayerScripts單獨使用的步驟 1:鍵盤、手機與手把都能跑步,沒有體力。加入體力與衝刺後,由 MovementClient 取代它。
ModuleScript MovementConfigReplicatedStorage數值:跑步加成、體力與衝刺。LocalScript 和伺服器檢查都會讀取它。
LocalScript MovementClientStarterPlayerScripts把 Sprint 與 Dash 綁定到按鍵、手把按鈕和觸控按鈕,執行體力迴圈、畫出體力條並執行衝刺。
LocalScript DoubleJumpStarterCharacterScripts在空中多給一次跳躍。每個新角色都會執行一份新的副本。
Script MovementCheckServerScriptService測量每個角色實際移動了多遠,當有人長時間移動得比跑步與衝刺允許的還快時,在 Output 中寫出警告。
移動系統完成後的 Explorer
ReplicatedStorage
  MovementConfig ModuleScript new
ServerScriptService
  MovementCheck Script new
StarterPlayer
  StarterCharacterScripts
    DoubleJump LocalScript new
  StarterPlayerScripts
    MovementClient LocalScript new

如果你還不清楚 Script 和 LocalScript 的差別,Script、LocalScript 與 ModuleScript 說明了每一種在哪裡執行以及原因。

步驟 1:用一個 LocalScript 做出 Shift 跑步

如果你只需要按住 Shift 時跑得更快,這一個 Script 就夠了。它還會在手機畫面上加一個 Sprint 按鈕,並讓手把可以用左搖桿跑步。

  1. 在 Explorer 中展開 StarterPlayer,把游標移到 StarterPlayerScripts 上,按 + 按鈕,插入一個名為 ShiftToSprint 的 LocalScript。
  2. 把它的內容換成下面的程式碼,然後按 Play。
LocalScript 位於 StarterPlayerScripts 名稱為 ShiftToSprint
-- 放在 StarterPlayer > StarterPlayerScripts 中、名為 ShiftToSprint 的 LocalScript。
-- 按住 Left Shift 跑步。在手把上按下左搖桿(L3)可以
-- 開啟或關閉跑步。在手機上按 Sprint 按鈕可以開啟或關閉跑步。

local ContextActionService = game:GetService("ContextActionService")
local Players = game:GetService("Players")

-- 設定
local SPRINT_BONUS = 10 -- 跑步時加到 WalkSpeed 上(16 變成 26)
local TOGGLE_ON_TOUCH_AND_GAMEPAD = true -- false:按鈕需要一直按住

local player = Players.LocalPlayer
local sprinting = false
local normalSpeed = 16 -- 跑步結束時要回到的 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
		-- 記住目前的速度並在上面加,這樣其他 Script 給的加速才會保留
		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
		-- 按住:按鍵或按鈕按著時跑步
		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
		-- 切換:每按一次就開啟或關閉跑步
		setSprinting(not sprinting)
	end
	return Enum.ContextActionResult.Pass
end

-- 一次呼叫就綁定按鍵、手把按鈕,以及觸控螢幕上的畫面按鈕
ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3)
ContextActionService:SetTitle("Sprint", "Sprint")

-- 新角色從走路開始:它的 Humanoid 已經是一般的 WalkSpeed
player.CharacterAdded:Connect(function()
	sprinting = false
end)

修改 SPRINT_BONUS 讓跑步變快或變慢。把 TOGGLE_ON_TOUCH_AND_GAMEPAD 設為 false,手機按鈕和 L3 就會像 Shift 一樣:只有按住時才跑。

BindAction 把同一個動作綁定到 Left Shift 和手把上的 L3,它的第三個引數 true 會在觸控螢幕上加入按鈕;SetTitle 在按鈕上寫「Sprint」。處理函式也會收到輸入本身,所以能分辨是鍵盤按下,還是手把或觸控按鈕。跑步開始時,Script 記住目前的 WalkSpeed 並加上 SPRINT_BONUS;結束時改回記住的數值。其他 Script 設定的速度,例如遊戲通行證教學中的 Speed 福利,都會保留。新角色從一般的 WalkSpeed 開始,所以 CharacterAdded 處理函式只需要重設旗標。

按住還是切換?

TOGGLE_ON_TOUCH_AND_GAMEPAD 為 true 時,ShiftToSprint 在各種裝置上的運作方式
裝置與輸入運作方式原因
鍵盤:Left Shift按住移動時按住按鍵很輕鬆,放開就會立刻停止跑步。
手把:按下左搖桿(L3)切換一邊把搖桿壓下去一邊用它控制方向很累。
手機或平板:畫面上的 Sprint 按鈕切換按住按鈕的大拇指沒辦法同時按 Jump。

測試時,按 Play,走路時按住 Shift:速度會從每秒 16 stud 升到 26 stud,放開就會慢下來。測試手機時,在 Studio 的 Device Simulator 中選一支手機,按 Play,按一次 Sprint 開始跑,再按一次停止。測試手把時,在試玩測試中打開 Controller Emulator 並按 L3。各裝置的完整檢查清單在步驟 6。

步驟 2 和 3 會用另一個有體力條和衝刺的 Script 取代這個 Script。步驟 4 和 5 加入二段跳和伺服器檢查,兩個 Script 都能搭配使用。

步驟 2:把體力與衝刺的數值放在一個模組中

想要會用完的跑步,步驟 2 和 3 會把 ShiftToSprint 換成一個較大的 LocalScript,裡面有體力條和衝刺。請先刪除 ShiftToSprint:兩個 Script 都會綁定 Sprint 動作。

所有數值都放在一個 ModuleScript 中,所以移動手感只要在一個地方調整。MovementClient 在每位玩家的裝置上讀取它們,MovementCheck 則在伺服器上讀取同一個模組,以便知道跑步和衝刺應該是什麼速度。

  1. 在 Explorer 中把游標移到 ReplicatedStorage 上,按 + 按鈕,插入一個 ModuleScript。
  2. 把它改名為 MovementConfig,並把內容換成下面的程式碼。
ModuleScript 位於 ReplicatedStorage 名稱為 MovementConfig
-- 移動用 LocalScript 和伺服器速度檢查共用的一組數值。

local MovementConfig = {
	SPRINT_BONUS = 10, -- 加到目前的 WalkSpeed 上:16(Roblox 預設值)變成 26

	MAX_STAMINA = 100,
	DRAIN_PER_SECOND = 20, -- 滿條體力可以跑 5 秒
	REGEN_PER_SECOND = 15,
	REGEN_DELAY = 1, -- 跑步結束後經過幾秒,體力才開始回復
	MIN_TO_START = 20, -- 開始跑步需要的體力,讓空的體力條不會閃爍

	DASH_SPEED = 60, -- 衝刺時每秒移動的 stud 數
	DASH_SECONDS = 0.2, -- 這樣一次衝刺大約移動 12 stud
	DASH_COST = 25, -- 體力
	DASH_COOLDOWN = 1,
}

return MovementConfig
每項設定的作用
設定數值效果
SPRINT_BONUS10跑步時加到 WalkSpeed 上。Roblox 預設的 WalkSpeed 是 16,所以跑步速度是每秒 26 stud。
MAX_STAMINA100滿條體力。
DRAIN_PER_SECOND20滿條體力可以跑 5 秒。
REGEN_PER_SECOND15空的體力條大約 6.7 秒回滿。
REGEN_DELAY1開始回復前要休息的秒數。
MIN_TO_START20開始跑步需要的體力。
DASH_SPEED60衝刺時每秒移動的 stud 數。
DASH_SECONDS0.2衝刺持續多久:以每秒 60 stud 計算大約 12 stud。
DASH_COST25每次衝刺消耗的體力。
DASH_COOLDOWN1兩次衝刺之間的秒數。

每一邊都執行自己那份模組(模組在每一邊只會執行一次),所以在自己裝置上改這些數值的玩家,只改到自己那一份。但這在這裡保護不了什麼:他的裝置本來就在移動他的角色,所以不管模組裡寫什麼,他都可以給自己無限體力。步驟 5 的伺服器檢查就是考慮到這一點設計的。

步驟 3:有體力的跑步與衝刺

這個 LocalScript 負責玩家感受到的部分。它綁定 Sprint 和 Dash,畫出體力條,每一幀執行體力迴圈並執行衝刺。

  1. 在 Explorer 中展開 StarterPlayer,把游標移到 StarterPlayerScripts 上,插入一個名為 MovementClient 的 LocalScript。
  2. 把它的內容換成下面的程式碼。
LocalScript 位於 StarterPlayerScripts 名稱為 MovementClient
-- 按住 Shift(或 L3,或手機上的 Sprint 按鈕),在還有體力時跑步。
-- 按 Q(或 B,或 Dash 按鈕)朝移動方向衝刺。

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 -- 跑步結束時要回到的 WalkSpeed
local lastSprintTime = 0
local lastDashTime = -math.huge

-- 體力條:一個外框加上填色,填色寬度等於剩餘體力
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

-- 跑步:這裡只設定旗標;下面的 Heartbeat 迴圈每一幀決定要不要跑
local function onSprint(_name: string, state: Enum.UserInputState, _input: InputObject): Enum.ContextActionResult
	-- 只有按下和放開會改變它:手指在觸控按鈕上滑動時會傳送 Change
	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()
	-- 坐著時不能衝刺:坐著的角色焊接在座位上,所以會推動整台載具
	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 -- 像跑步一樣暫停回復

	-- 朝玩家移動的方向衝刺,站著不動時則朝他面對的方向
	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 模式的 LinearVelocity 會維持水平速度,而且不會影響重力
	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

-- 每次呼叫都會綁定按鍵、手把按鈕,以及觸控裝置上的畫面按鈕
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")

-- 每一幀:跑步並移動時消耗體力,短暫休息後回復
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,這樣
	-- 其他 Script 設定的速度(例如速度通行證)會保留,跑步則加在上面
	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)

-- 新角色從滿體力開始,而且沒有按住任何東西
player.CharacterAdded:Connect(function()
	stamina = Config.MAX_STAMINA
	sprintHeld = false
	sprinting = false -- 新的 Humanoid 從一般的 WalkSpeed 開始
end)

體力條是用程式碼建立的,ResetOnSpawn 為 false,所以重生後仍會留在畫面上,底部的 CharacterAdded 處理函式則會替每個新角色把它重新補滿。type Config 這幾行描述模組回傳的內容,讓嚴格型別檢查能抓到設定名稱的拼字錯誤;遊戲執行時它們不會改變任何東西。

一次呼叫搞定鍵盤、手把與手機按鈕

ContextActionService:BindAction 接受動作名稱、處理函式、是否建立觸控按鈕,接著是輸入。第三個引數傳 true 時,ContextActionService 會在觸控裝置的畫面上加入按鈕,放在玩家 PlayerGui 中名為 ContextActionGui 的 ScreenGui 裡。SetTitle 在這些按鈕上寫「Sprint」和「Dash」。BindAction 最多只能建立 7 個觸控按鈕,所以如果遊戲中的其他 Script 也會用到,請注意數量。

處理函式會收到輸入狀態:按下時是 Begin,放開時是 End。onSprint 只記錄 Sprint 是否被按住。它也把 Cancel 當成放開,這是其他綁定接手輸入時 ContextActionService 傳送的狀態,並忽略手指在觸控按鈕上移動時可能傳來的 Change。兩個處理函式都回傳 Pass,所以同一個按鍵上的下一個綁定也能收到輸入。

Roblox 的 ContextActionService 參考文件建議在大多數情況下用它取代 UserInputService.InputBegan。它的例子是:綁在 H 的汽車喇叭,不應該在玩家打聊天訊息時響。綁定只有在它是這個輸入的最後一個綁定時才會觸發,所以聊天接管鍵盤時,你不需要做任何檢查。手把的輸入是 ButtonL3(按下左搖桿,移動時本來就按著)和 ButtonB。Roblox 自己的跑步範例用的是 ButtonY,如果你的遊戲那樣比較順手,就改 BindAction 中的 KeyCode。

體力迴圈

RunService.Heartbeat 在每一幀的物理步驟之後觸發,並傳入 deltaTime,也就是距離上一幀的秒數。把消耗和回復速度乘上它,不管遊戲是每秒 30 幀還是 240 幀,滿條體力都能跑 5 秒。

迴圈每一幀判斷角色是否該跑:Sprint 被按住、角色在走路(角色站著時 Humanoid.MoveDirection 是零向量),而且還有體力。開始跑步至少需要 MIN_TO_START(20);繼續跑只要大於 0 就行。少了這個落差,每一幀都回復一點點的空體力條,會讓跑步每一幀開了又關。回復會在最後一次跑步或衝刺後 REGEN_DELAY(1 秒)開始,所以把體力條用完後,玩家大約要等 2.3 秒才能再跑。

WalkSpeed 只在跑步開始或結束的那一幀改變。開始時,Script 記住目前的 WalkSpeed 並加上 SPRINT_BONUS;結束時改回記住的數值。所以其他 Script 設定的速度會保留:遊戲通行證教學中的 Speed 福利把 WalkSpeed 設為 24,搭配這個 Script,擁有它的玩家跑步速度是 34。每一幀或每次放開時都寫入 WalkSpeed = 16 的 Script,會不知不覺抵消這個福利。

衝刺

衝刺會把角色推向他移動的方向,站著不動時則推向他面對的方向,而且方向會被拉平,絕不會朝上或朝下。它消耗 25 體力,像跑步一樣暫停回復,冷卻時間 1 秒。它不檢查地面,所以在空中也能用,和二段跳很搭。角色坐著時衝刺沒有作用:坐著的角色焊接在座位上,在載具中推一下可能會讓整台載具移動。

推動的力量是根零件 RootAttachment 上的 LinearVelocity 約束。在 X 與 Z 軸的 Plane 模式下,它維持每秒 60 stud 的水平速度,不影響垂直方向,所以重力照常作用,從平台邊緣衝刺出去會正常落下。MaxForce 是 math.huge,所以推力不受限制。Debris:AddItem 會在 DASH_SECONDS 後銷毀約束,而不需要讓 Script 等待,所以衝刺持續 0.2 秒,以這個速度大約是 12 stud。

舊教學使用 BodyVelocity,Roblox 已經把它標為已淘汰,並註明改用 LinearVelocity。它把某一軸的 MaxForce 設為零的技巧,已經由 LinearVelocity 的 Line、Plane 與 Vector 模式取代。因為玩家的裝置會自己模擬自己的角色,LocalScript 建立的約束就能移動角色,其他玩家看到的衝刺就跟其他移動一樣。

Roblox 自己的 UI 教學也是用完全一樣的方式把約束接到 humanoid.RootPart.RootAttachment 上。如果你的遊戲使用自訂角色,而它的根零件上沒有名為 RootAttachment 的 Attachment,衝刺就不會有作用:請把它加到你 StarterCharacter 的 HumanoidRootPart 中。

步驟 4:二段跳

二段跳放在 StarterCharacterScripts 中自己的 LocalScript 裡。每個角色生成時,Roblox 都會把這個容器中的 Script 複製一份放進角色,而這些副本不會在重生後留下,所以每一條命都從全新的 Script 開始,不會帶著上一條命的任何狀態。

  1. 在 Explorer 中展開 StarterPlayer,把游標移到 StarterCharacterScripts 上,插入一個名為 DoubleJump 的 LocalScript。
  2. 把它的內容換成下面的程式碼。
LocalScript 位於 StarterCharacterScripts 名稱為 DoubleJump
-- 在空中多給一次跳躍。每個新角色都會重新執行,
-- 所以重生後不會帶著任何狀態。

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 會觸發好幾次
local NEW_PRESS_GAP = 0.1 -- 按住的跳躍鍵會持續傳送 JumpRequest;停頓這麼久代表已經放開

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
		-- 從地面起跳(不是我們的空中跳躍)會恢復空中跳躍次數
		jumpsLeft = EXTRA_JUMPS
		lastJump = os.clock()
	elseif newState == Enum.HumanoidStateType.Landed then
		jumpsLeft = 0
	end
end)

-- 玩家要求跳躍時 JumpRequest 會觸發,例如按 Space 或手機上的跳躍按鈕
UserInputService.JumpRequest:Connect(function()
	local now = os.clock()
	local newPress = now - lastRequest > NEW_PRESS_GAP
	lastRequest = now
	-- 只有新的按壓才會再跳,讓按住的按鈕不會浪費空中跳躍
	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)

把 EXTRA_JUMPS 設為 2 就是三段跳。

Script 透過 Humanoid.StateChanged 追蹤角色的狀態。不是從 Freefall 進入的 Jumping 是從地面起跳,所以會給一次空中跳躍,Landed 再把它收回。從平台邊緣走下去時,角色會在沒有跳躍的情況下進入 Freefall,所以拿不到空中跳躍。如果那時也需要,請在從 Jumping 以外的任何狀態進入 Freefall 時也設定 jumpsLeft。

UserInputService.JumpRequest 會在玩家要求跳躍時觸發,例如按 Space 或手機上的跳躍按鈕。Roblox 參考文件警告,一次跳躍請求它會觸發好幾次,並建議做防抖,所以 Script 會忽略上次跳躍後 0.25 秒內的請求。按住的跳躍鍵也可能持續要求跳躍,在角色離開地面的那一刻就用掉空中跳躍,所以只有在 0.1 秒沒有請求之後,請求才會被當成新的按壓。

空中跳躍本身就是 Humanoid:ChangeState(Enum.HumanoidStateType.Jumping)。Roblox 參考文件說,它必須在擁有角色網路所有權的裝置上的 LocalScript 中呼叫,而預設情況下那是玩家自己的裝置,不是伺服器。參考文件中 ChangeState 的範例程式碼正好就是二段跳。

步驟 5:在伺服器上抓加速外掛

跑步教學常常停在用戶端。伺服器 Script 無法信任玩家的 WalkSpeed,因為外掛使用者會在自己的裝置上修改它,但伺服器看得到他們的角色最後到了哪裡。MovementCheck 每秒測量兩次,當有人長時間移動得比跑步與衝刺允許的還快時,在 Output 中寫出警告。它從 MovementConfig 讀取跑步與衝刺的數值,所以即使你保留了 ShiftToSprint,也要加入步驟 2的這個模組。

  1. 把游標移到 ServerScriptService 上,插入一個名為 MovementCheck 的 Script。
  2. 把它的內容換成下面的程式碼。
Script 位於 ServerScriptService 名稱為 MovementCheck
-- 玩家的裝置會移動自己的角色,所以外掛使用者可以設定任何 WalkSpeed。
-- 這項檢查測量每個角色實際移動了多遠,並在有人長時間移動得
-- 比跑步與衝刺允許的還快時寫進 Output。它只會警告:
-- 延遲、傳送與輸送帶看起來都可能像超速,所以在懲罰任何人之前先調整好它。

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 -- 秒
-- 跑步速度加上延遲的餘裕。如果你販售加速,請調高。
local SPEED_ALLOWANCE = (StarterPlayer.CharacterWalkSpeed + Config.SPRINT_BONUS) * 1.25
local BURST_ALLOWANCE = Config.DASH_SPEED * Config.DASH_SECONDS * 2 -- 一到兩次衝刺的餘裕
local DRAIN_PER_CHECK = BURST_ALLOWANCE / 8 -- 之前的衝刺被原諒的速度

local lastPosition: { [Player]: Vector3 } = {}
local lastRoot: { [Player]: BasePart } = {} -- 測量 lastPosition 時所用的根零件
local excess: { [Player]: number } = {} -- 超出容許值的 stud 數,會逐漸被原諒

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
			-- 重生代表新的根零件,而伺服器傳送(回合開始、檢查點)
			-- 會設定下面的屬性:重新開始測量,而不是標記這次跳動
			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
				-- 只看水平移動:掉得快不算作弊
				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

在 Studio 中,警告會出現在 Output。在上線的遊戲中,它會進入 Developer Console 的伺服器記錄,身為遊戲擁有者的你可以讀取:請見上線遊戲中的輸出。

它測量什麼

每半秒,Script 讀取每個角色根零件的位置,並測量它從上次檢查以來在水平方向移動了多遠。高度會被忽略,所以落下和跳躍永遠不會被計入;Roblox 關於移動驗證的建議,也為在地面上行走的遊戲提出同樣投影到 XZ 平面的做法。容許值是預設走路速度加上跑步加成,再加四分之一作為延遲餘裕:每秒 32.5 stud。超出的距離會進入「漏水桶」,這是一種累加器,Roblox 文件提到它很適合許多開發者用來處理短暫的爆發。水桶每次檢查流掉 3 stud,當裡面超過 24 stud 時 Script 就會警告,這大約是兩次衝刺的餘裕。

依它的數值計算,這項檢查能抓到什麼
作弊者MovementCheck 的反應
把 WalkSpeed 設為 100跑大約 1 秒後警告
把 WalkSpeed 設為 50跑大約 2.5 秒後警告
不等冷卻連續衝刺(每秒 60 stud)大約 1.5 秒後警告
一次傳送超過 43 stud在下一次檢查時警告
以最高每秒 38 stud 的速度跑,大約是跑步的一倍半沒有反應:低於每秒 38.5 stud 時,水桶流掉的速度和裝滿的速度一樣快
修改自己的 MovementConfig 換取無限體力沒有反應:以每秒 26 stud 跑步不管多久都是允許的
飛行、無限跳躍或穿牆沒有反應:這項檢查忽略高度,也不看碰撞

也就是說,這項檢查能抓到讓玩家明顯比其他人快的粗糙外掛,但會放過小心的外掛。這是距離檢查真實的極限,也是 Roblox 正在做更強方案的原因(請見下面的 server authority)。

為什麼它只會警告

Roblox 文件提到,簡單的速度檢查可能會誤判連線不穩的正常玩家,而且在有載具或其他複雜移動的遊戲中會失效。延遲突波、輸送帶、載具、把角色炸飛的爆炸,以及你自己的傳送,看起來都可能像超速,所以 Script 只印出警告。你和測試者正常遊玩時注意 Output,如果正常玩家被它誤判,就調高 SPEED_ALLOWANCE,只有在這項檢查於正常遊玩中保持安靜時,才加入懲罰,例如把玩家拉回原位。如果你的遊戲有把角色炸飛的爆炸,也請略過 Humanoid 已經沒有生命值的玩家。

重生與傳送

重生會建立新的根零件,Script 看到它時就會重新開始測量,所以死在離重生點很遠的地方永遠不會被當成超速。你自己的伺服器 Script 所做的傳送需要例外處理,Roblox 文件對任何有傳送的遊戲都這麼說。傳送之後加上 player:SetAttribute("MovementCheckSkip", true),下一次檢查就會從新位置開始測量,而不是標記這次跳動:

傳送教學中的傳送墊與選單,以及第一款遊戲教學中的 Finish 傳送墊,已經會在每次移動後設定它。

只有來自伺服器的數值才算數。玩家在自己裝置上設定的屬性只會留在那台裝置上(請見哪些會複寫、哪些不會),所以作弊者無法用它關掉檢查。

未來的解法:server authority

Roblox 的安全文件把 server authority 模型(撰寫本文時仍在 beta)稱為阻止移動外掛最可靠的方法。伺服器成為唯一的真實來源,玩家的裝置只回報自己的輸入,文件說這能讓加速外掛失效,因為裝置從來不被信任去回報自己的位置。

改用它是重寫,而不是調整設定。在這個模型中由伺服器計算移動,所以只由 LocalScript 設定的 WalkSpeed 或 LinearVelocity,會在伺服器狀態傳來時被覆蓋。Roblox 文件說,核心邏輯必須在用戶端和伺服器都會執行的 ModuleScript 中的 RunService:BindToSimulation() 函式裡執行。這個模型還需要幾項 Workspace 設定,包括 PlayerScriptsUseInputActionSystem,所以你的操作也要搬到 Input Action System。在把跑步、體力與衝刺搬進這個架構之前,請保留本教學的版本。在那之前,像這樣的距離檢查,就是 Roblox 移動驗證章節所描述的做法。

步驟 6:在每種裝置上測試

  1. 按 Play,走路時按住 Shift。速度從每秒 16 stud 升到 26 stud,畫面底部的綠色體力條會變短。大約 5 秒後它就空了,你又回到走路。
  2. 放開 Shift。1 秒後體力條開始回復。在它回到五分之一之前,按 Shift 不會有任何反應。
  3. 走路時按 Q:你會向前衝一小段,體力條少了四分之一。馬上再按一次 Q,在過了一秒之前什麼都不會發生。如果衝刺感覺太短或太長,請修改 MovementConfig 中的 DASH_SPEED 或 DASH_SECONDS。
  4. 跳起來,然後在空中再按一次跳躍做出第二跳。落地再試一次:每次從地面起跳都會恢復空中跳躍。
  5. 整個跳躍過程都按住 Space。應該只會跳一次而不是兩次,因為空中跳躍需要新的按壓。
  6. 在 Studio 中開啟 Device Simulator(撰寫本文時它是 beta:File、Beta Features、New Device Simulator,然後重新啟動 Studio),或在 Test 選單中開啟舊版的 Device Emulator。選一支手機並按 Play。Sprint 和 Dash 按鈕會出現。一邊控制方向一邊按住 Sprint,接著在整個跳躍過程按住跳躍按鈕,確認只跳一次。
  7. 打開 Controller Emulator(Emulation 分頁中的 Controller,或 Device Simulator 面板上的 Virtual controller)。移動時按住 L3 跑步,按 B 衝刺,按兩次 A 二段跳。
  8. 透過遊戲選單重設角色。體力條又是滿的,Output 中沒有 MovementCheck 的警告,如果你還在模擬手機,Sprint 和 Dash 按鈕也還在。
  9. 現在扮演作弊者。按 Client/Server 切換按鈕,直到 Explorer 顯示用戶端,在 Workspace 中選取你角色的 Humanoid,在 Properties 視窗中把 WalkSpeed 設為 60。走幾秒:Output 中會出現像 MovementCheck: YourName moved 60 studs/s 這樣的警告。改回 16,然後像平常一樣跑步和衝刺一分鐘,確認 Output 保持安靜。
  10. 如果你的場景中 Workspace.PlayerScriptsUseInputActionSystem 設為 Enabled,請再測一次二段跳:Roblox 文件沒有說明開啟它時 JumpRequest 的行為是否相同。

如果完全沒有反應,請從 Studio 的 Window 選單打開 Output 視窗,尋找 MovementClient 的紅色錯誤,或查看常見錯誤。

要跑多快、跑多久:依遊戲類型的預設值

合適的跑步取決於遊戲。恐怖遊戲的追逐需要短而慢、在最糟時機用完的跑步;大型開放地圖需要很長的跑步,玩家穿越地圖時才不會無聊。這些預設值使用同樣的 Script,只改走路速度和 MovementConfig。它們是我們依設定計算出來的起點,不是從玩家身上測得的。

依遊戲類型的走路速度、跑步與體力。跑步時間是 MAX_STAMINA / DRAIN_PER_SECOND;回復時間是 MAX_STAMINA / REGEN_PER_SECOND 再加 1 秒 REGEN_DELAY
遊戲類型CharacterWalkSpeedSPRINT_BONUS(跑步速度)DRAIN_PER_SECONDREGEN_PER_SECOND滿條跑步從空到滿一條體力的距離
本教學1610 (26)20155 秒7.7 秒130 stud
恐怖遊戲追逐128 (20)25104 秒11 秒80 stud
Battlegrounds 與戰鬥1612 (28)15206.7 秒6 秒大約 187 stud
開放世界或模擬器1616 (32)102510 秒5 秒320 stud
障礙賽或跑酷168 (24)沒有體力:使用 ShiftToSprint
  • 走路速度在 StarterPlayer 中設定。選取 StarterPlayer 並設定 CharacterWalkSpeed(預設 16)。每個新角色都從這個速度開始,跑步在上面加上 SPRINT_BONUS,MovementCheck 也會讀取它,所以伺服器檢查會跟著你的選擇。
  • MovementCheck 會自動調整。它允許走路速度加上跑步加成,再加四分之一作為延遲餘裕:恐怖遊戲預設值是每秒 25 stud,開放世界是 40。其他都不用改。
  • 在障礙賽中,跑步會改變關卡。跑得更快就能跳過更長的缺口。先蓋好跳台,再用跑步速度測試每一個,否則跑步會讓關卡變得太簡單。障礙賽檢查點教學很適合搭配 ShiftToSprint。
  • 在恐怖遊戲中,基準是殺手。讓追逐者比走路速度快一點、比跑步慢一點,這樣能不能逃掉就取決於體力條什麼時候用完。恐怖遊戲教學說明其餘的遊戲循環。

舊的跑步 Script 有什麼問題

舊的跑步、衝刺與二段跳教學通常還能用,但很多使用 Roblox 後來已經取代的做法,或會弄壞你遊戲中的其他系統。如果你在修一個複製來的 Script,請對照這份清單。

舊教學中的做法,以及本教學改用的做法
做法問題在哪本教學
用 BodyVelocity 衝刺已淘汰:Roblox 說改用 LinearVelocityPlane 模式的 LinearVelocity
在 RunService.RenderStepped 上跑迴圈新的開發已由 PreRender 取代。像體力這種遊戲邏輯應該放在 Heartbeat,Roblox 把它描述為用於週期性工作,例如回復生命值搭配 deltaTime 的 Heartbeat
用 wait() 跑體力迴圈wait() 已淘汰,改用 task.wait(),而且它會被節流,可能等得比要求的更久,每次 wait 固定消耗的做法會讓體力消耗不均每一幀依 deltaTime 消耗與回復
沒有檢查聊天的 UserInputService.InputBegan打聊天訊息時按 Shift 會開始跑步ContextActionService,還會加上手機按鈕
放開時或每一幀設定 WalkSpeed = 16會覆蓋其他任何速度,例如遊戲通行證的福利只在跑步開始和結束時改變 WalkSpeed,加在目前的數值上
透過 RemoteEvent 跑步,讓伺服器設定 WalkSpeed外掛使用者照樣會自己設定 WalkSpeed,而跑步會因為來回傳輸而延遲才開始在用戶端跑步,加上伺服器的距離檢查
每次 JumpRequest 都二段跳一次跳躍請求 JumpRequest 會觸發好幾次,而按住的按鈕會持續要求跳躍0.25 秒的停頓,加上新按壓的檢查
把 UserInputService.TouchEnabled 當成「這是手機」的判斷在有觸控螢幕的筆電上它也是 trueContextActionService 會在觸控裝置上加入畫面按鈕,不需要你自己判斷裝置
用 Humanoid:LoadAnimation 播放跑步動畫已淘汰,改用 Animator:LoadAnimation下面的跑步動畫使用 Animator

Roblox 的新做法:Input Action System

Roblox 介紹 Input Action System 的頁面,第一個範例就是角色跑步。操作不是用 BindAction 呼叫,而是在 Studio 中設定:在 ReplicatedStorage 的 input context 中放一個名為 CharacterSprint 的 InputAction,一個 InputBinding 給 Left Shift,一個給手把的 Y 鍵,還有一個連到你在 StarterGui 中畫的畫面按鈕。接著用戶端 Script 監聽動作的 Pressed 與 Released 事件,按下時把 WalkSpeed 加倍,放開時改回來。

如果你想在 Studio 而不是程式碼中配置操作、想用自己的觸控按鈕取代 ContextActionService 的按鈕,或想用 context 切換整組操作(例如選單或載具),就值得改用它。該頁面也建議把 Workspace.PlayerScriptsUseInputActionSystem 設為 Enabled,而 server authority 則要求這麼做。

本教學的體力迴圈與衝刺,單獨搭配 Input Action System(沒有 server authority)時也能照樣運作。保留 MovementConfig、Heartbeat 迴圈與 dash(),刪除兩個 BindAction 呼叫和它們的處理函式,改接上動作:跑步動作的 Pressed 把 sprintHeld 設為 true,它的 Released 設為 false,衝刺動作的 Pressed 呼叫 dash()。請像 MovementClient 一樣每一幀繼續尋找 Humanoid,因為文件中的範例保存的是第一個角色的 Humanoid,重生後它就不存在了。

Roblox 也在測試 Character Controller Library,這是一個要在 Studio 的 Beta Features 與 Avatar Settings 中開啟的 beta。它介紹自訂能力的頁面,以一個有效時間 0.2 秒、冷卻 1 秒的衝刺當作範例,也就是和本教學的衝刺時間完全相同。

如何擴充:動畫、鏡頭與跑步通行證

跑步動畫

在 Animation Editor 中製作跑步動畫,把優先順序設為 Movement(Roblox 建議走路與跑步動畫使用它),發布後複製素材 ID。在 MovementClient 中建立一個 AnimationId 為這個 ID 的 Animation,用角色 Humanoid 中的 Animator 透過 Animator:LoadAnimation 載入它,在跑步開始的地方播放動畫軌,在跑步結束的地方停止。每個新角色都要重新載入。

只要你使用 Roblox 放在那裡的 Animator,你的裝置在自己角色上播放的動畫所有人都看得到:載入到由 LocalScript 建立的 Animator 上的動畫軌不會複寫。許多舊教學使用的 Humanoid:LoadAnimation 已經淘汰。

跑步時鏡頭變廣

稍微寬一點的視野會讓跑步感覺更快。在同樣的兩個地方,跑步開始時把 workspace.CurrentCamera.FieldOfView 從預設的 70 用 tween 調到大約 80,結束時再調回來,例如用 TweenService:Create(workspace.CurrentCamera, TweenInfo.new(0.25), { FieldOfView = 80 }):Play()。Roblox 把數值限制在 1 到 120 之間,並警告過低或過高的數值可能讓玩家失去方向感。如果遊戲中還有其他 Script 會改視野,請 tween 回你讀到的數值,而不是 70。

把快速跑步做成遊戲通行證

遊戲通行證教學已經能和這個 Script 搭配:它的 Speed 福利在伺服器上把每個新角色的 WalkSpeed 設為 24,MovementClient 在上面加上跑步加成,每秒 34 stud 仍在 MovementCheck 允許的範圍內。

如果要做讓跑步本身變快的通行證,請把 FastSprint 通行證加到那篇教學的 PassConfig.ids 中。購買一經確認,它的伺服器 Script 就會替玩家設定 OwnsPass_FastSprint 屬性。在 MovementClient 中,當 player:GetAttribute("OwnsPass_FastSprint") == true 時,使用比 Config.SPRINT_BONUS 更大的加成。在 MovementCheck 中,在玩家無法修改它的伺服器上讀取同一個屬性,給這些玩家更大的容許值,並確認新的最高速度仍低於檢查會標記的速度。

有一個限制要知道:如果其他 Script 在跑步途中改了 WalkSpeed,這次跑步結束時會改回跑步前的速度。下一次重生會重新設定通行證的速度,因為遊戲通行證 Script 會把它套用到每個新角色上。

常見錯誤與解法

按 Play 之前先打開 Output 視窗(Window 選單,然後 Output)。這些 Script 的大多數問題都會在那裡印出帶有 Script 名稱與行號的錯誤或警告。

Infinite yield possible on 'ReplicatedStorage:WaitForChild("MovementConfig")'

MovementClient 或 MovementCheck 在等一個名稱不完全相同或不存在的模組。它必須是直接放在 ReplicatedStorage 中、名為 MovementConfig 的 ModuleScript。Script 錯誤教學會詳細說明這個警告。

Shift 沒有作用

確認 ShiftToSprint 或 MovementClient 是 LocalScript 而不是 Script,而且放在 StarterPlayerScripts 中。使用 MovementClient 時,角色還必須在走路並且至少有 20 體力才會開始跑,所以請在移動時按住 Shift。如果切換的是 Shift Lock 而不是跑步,請看下面關於 Shift Lock 的問題。

跑幾秒就停了

這是體力用完了:100 體力以每秒 20 消耗,可以跑 5 秒。請在 MovementConfig 中調高 MAX_STAMINA 或調低 DRAIN_PER_SECOND。

衝刺沒有作用

衝刺需要 25 體力,距離上一次要等 1 秒,坐著時也沒有作用。如果不是這些原因,可能是你角色的根零件上沒有名為 RootAttachment 的 Attachment,有些自訂角色會這樣:請把它加到你 StarterCharacter 的 HumanoidRootPart 中。

二段跳沒有觸發

DoubleJump 必須是放在 StarterCharacterScripts 中的 LocalScript,而不是 StarterPlayerScripts,因為它把 script.Parent 當作角色。離開地面後再按一次跳躍:按住的按鈕不算新的按壓,從平台邊緣走下去也不會給空中跳躍。

手機上沒有 Sprint 或 Dash 按鈕

ContextActionService 只會在觸控裝置上加入它的按鈕,所以在沒有觸控螢幕的電腦上永遠看不到。請在 Studio 的 Device Simulator 中用手機測試(它是 beta:在 File、Beta Features 中開啟 New Device Simulator,然後重新啟動 Studio)。BindAction 最多只能建立 7 個觸控按鈕,所以請算一算遊戲中其他 Script 建立了幾個。

MovementCheck 對正常玩家發出警告

常見原因是:其他伺服器 Script 做的傳送、輸送帶或載具,或者延遲。在你的傳送之後設定 MovementCheckSkip 屬性(請見重生與傳送),如果檢查在正常遊玩中仍會觸發,就調高 SPEED_ALLOWANCE。

跑步後加速消失了

跑步途中有其他 Script 改了 WalkSpeed,而跑步結束時改回了它在開始時看到的速度。請像遊戲通行證教學那樣在角色生成時給予加速,這樣重生時就會重新設定正確的速度。

用 RoCode 來做

如果不想手動設定這一切,RoCode 可以在你開啟的場景中把它組好。RoCode 是 Roblox Studio 的獨立 AI 代理,不是 Roblox 官方的:你在網頁聊天中描述變更,它的 Studio 外掛程式就會在你的 Explorer 中建立 Script,所以不需要貼上程式碼。

你輸入

加入有體力條的 Shift 跑步:按住 Shift 時走路速度加 10,100 體力,每秒消耗 20,休息一秒後每秒回復 15,手機上有 Sprint 按鈕,Q 鍵衝刺,還有二段跳。

RoCode 會做
  • 可以先透過 Search Scripts 與 Read Script 瀏覽你的場景,找出其他會改變 WalkSpeed 的 Script(例如遊戲通行證的福利),讓跑步加在它們上面
  • 透過 Create Script 寫出 ModuleScript、幾個 LocalScript 與伺服器檢查
  • 它被要求用 Check Script 檢查寫出的每個 Script 能否編譯,Check Script 會在 Studio 中編譯而不執行它
  • 在每一批變更前後設定復原點,所以 Ctrl+Z 一次復原一批

RoCode 無法製作跑步動畫:請在 Animation Editor 中建立,再貼上它的 ID。使用外掛程式 3.9.11 或更新版本,RoCode 可以在 Studio 中執行你遊戲的試玩測試,並操控測試角色確認一切正常;使用外掛程式 3.9.15 或更新版本,測試角色還可以按鍵,例如按住 Shift 並確認 WalkSpeed 提高了。它會自己決定何時執行試玩測試,每次建置最多 2 次,再加 1 次用來檢查自己的修正,而且只檢查它自己決定要測試的項目,所以跑步、衝刺與二段跳請自己試試看,手機按鈕請在 Studio 的 Device Simulator 中檢查。移動只是遊戲中眾多系統之一;用 RoCode 製作整個遊戲也是像這裡一樣,一個提示詞做一個系統。RoCode 如何連接 Studio。

常見問題

為什麼跑步 Script 在手機上沒有作用?

手機沒有 Shift 鍵。請透過 ContextActionService:BindAction 綁定跑步,並在第三個引數傳入 true:這會在觸控裝置的畫面上加入按鈕,ShiftToSprint 和 MovementClient 都是這麼做的。

跑步需要做在伺服器上嗎?

不需要。每台裝置都移動自己的角色,所以伺服器設定的 WalkSpeed 擋不住可以自己設定速度的作弊者,而且新的速度要等來回傳輸後才到,所以跑步會延遲才開始。請在用戶端做跑步,並在伺服器上檢查角色實際移動了多遠,就像步驟 5 那樣。Roblox 的 server authority beta 運作方式不同,移動程式碼得為它重寫。

為什麼我放開 Shift 後角色還在跑?

Script 漏掉了放開的動作,通常是因為它只監聽按下。ContextActionService 在放開按鍵時傳送 End,在其他綁定接手時傳送 Cancel;MovementClient 在這兩種情況下都會停止,體力用完或角色停止移動時也會停止。

要怎麼加入跑步動畫?

在同一個 LocalScript 中,透過角色 Humanoid 中的 Animator 載入跑步動畫,跑步開始時播放,結束時停止。把它的優先順序設為 Movement。在你自己角色上播放的動畫,所有人都看得到。

為什麼手機上的二段跳會自己觸發?

手機上按住的跳躍按鈕會持續要求跳躍。只有在請求短暫停止後,才把跳躍當成新的按壓,就像 DoubleJump Script 那樣。

Roblox 預設的走路速度是多少?

每秒 16 stud。它來自 StarterPlayer.CharacterWalkSpeed,這個屬性會設定每個新角色的 Humanoid.WalkSpeed。本教學的跑步加上 10,所以跑步速度是 26。

Roblox 的跑步應該多快?

大多數遊戲會加上走路速度的一半到一倍:16 會變成 24 到 32 之間。短而慢的跑步適合恐怖遊戲,長而快的跑步適合大型地圖。依遊戲類型的預設值為每種遊戲列出走路速度、跑步加成與體力數值。

要怎麼做有體力的跑步?

在玩家的裝置上保存體力數值,跑步時每一幀消耗,短暫休息後回復,兩者都依照幀時間計算,並在它降到 0 時停止跑步。步驟 3 的 MovementClient 就是這麼做的,畫面上還有體力條;數值放在 MovementConfig 中。

Roblox 要怎麼用控制器跑步?

透過 ContextActionService 把手把的 ButtonL3(按下左搖桿)和 Left Shift 一起綁定,這裡的兩個 Script 都是這麼做的。ShiftToSprint 把 L3 做成切換,因為一邊把搖桿壓下去一邊用它控制方向很累。

Shift 跑步會和 Shift Lock 衝突嗎?

有可能。在 Roblox 設定中開啟 Shift Lock 的玩家會用 Shift 鍵切換它,所以同一個按鍵會做兩件事。Roblox 文件說 Shift Lock 的 API 正在逐步停用。如果衝突影響到你的玩家,請關閉 StarterPlayer.EnableMouseLockOption,或在 MovementClient 中把跑步綁定到別的按鍵,例如 Left Ctrl。

來源與延伸閱讀

程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。

在你自己的遊戲裡試試 RoCode。

每天都有免費點數,不需要信用卡。安裝外掛程式,描述你要的功能,再看看 Studio 裡出現了什麼。