重點摘要
在 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 用同樣的概念加上體力條、衝刺與二段跳。要跑多快、跑多久,可以參考依遊戲類型的預設值,裡面有恐怖、戰鬥與開放世界遊戲的數值。
本頁內容
Roblox 的跑步是怎麼運作的
每位玩家的裝置負責移動自己的角色。鍵盤、控制器或觸控螢幕決定角色往哪裡走,Roblox 再把結果傳給伺服器和其他所有人。所以跑步就是一個 LocalScript,在按住按鍵時提高 Humanoid.WalkSpeed,這也正是步驟 1 所做的全部事情。教學其餘部分是大型遊戲在它周圍需要的東西:體力條、衝刺、二段跳,以及抓作弊者的伺服器檢查。
| 部分 | 位置 | 作用 |
|---|---|---|
LocalScript ShiftToSprint | StarterPlayerScripts | 單獨使用的步驟 1:鍵盤、手機與手把都能跑步,沒有體力。加入體力與衝刺後,由 MovementClient 取代它。 |
ModuleScript MovementConfig | ReplicatedStorage | 數值:跑步加成、體力與衝刺。LocalScript 和伺服器檢查都會讀取它。 |
LocalScript MovementClient | StarterPlayerScripts | 把 Sprint 與 Dash 綁定到按鍵、手把按鈕和觸控按鈕,執行體力迴圈、畫出體力條並執行衝刺。 |
LocalScript DoubleJump | StarterCharacterScripts | 在空中多給一次跳躍。每個新角色都會執行一份新的副本。 |
Script MovementCheck | ServerScriptService | 測量每個角色實際移動了多遠,當有人長時間移動得比跑步與衝刺允許的還快時,在 Output 中寫出警告。 |
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 按鈕,並讓手把可以用左搖桿跑步。
- 在 Explorer 中展開 StarterPlayer,把游標移到 StarterPlayerScripts 上,按 + 按鈕,插入一個名為
ShiftToSprint的 LocalScript。 - 把它的內容換成下面的程式碼,然後按 Play。
-- 放在 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 處理函式只需要重設旗標。
按住還是切換?
| 裝置與輸入 | 運作方式 | 原因 |
|---|---|---|
| 鍵盤: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 則在伺服器上讀取同一個模組,以便知道跑步和衝刺應該是什麼速度。
- 在 Explorer 中把游標移到 ReplicatedStorage 上,按 + 按鈕,插入一個 ModuleScript。
- 把它改名為
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_BONUS | 10 | 跑步時加到 WalkSpeed 上。Roblox 預設的 WalkSpeed 是 16,所以跑步速度是每秒 26 stud。 |
MAX_STAMINA | 100 | 滿條體力。 |
DRAIN_PER_SECOND | 20 | 滿條體力可以跑 5 秒。 |
REGEN_PER_SECOND | 15 | 空的體力條大約 6.7 秒回滿。 |
REGEN_DELAY | 1 | 開始回復前要休息的秒數。 |
MIN_TO_START | 20 | 開始跑步需要的體力。 |
DASH_SPEED | 60 | 衝刺時每秒移動的 stud 數。 |
DASH_SECONDS | 0.2 | 衝刺持續多久:以每秒 60 stud 計算大約 12 stud。 |
DASH_COST | 25 | 每次衝刺消耗的體力。 |
DASH_COOLDOWN | 1 | 兩次衝刺之間的秒數。 |
每一邊都執行自己那份模組(模組在每一邊只會執行一次),所以在自己裝置上改這些數值的玩家,只改到自己那一份。但這在這裡保護不了什麼:他的裝置本來就在移動他的角色,所以不管模組裡寫什麼,他都可以給自己無限體力。步驟 5 的伺服器檢查就是考慮到這一點設計的。
步驟 3:有體力的跑步與衝刺
這個 LocalScript 負責玩家感受到的部分。它綁定 Sprint 和 Dash,畫出體力條,每一幀執行體力迴圈並執行衝刺。
- 在 Explorer 中展開 StarterPlayer,把游標移到 StarterPlayerScripts 上,插入一個名為
MovementClient的 LocalScript。 - 把它的內容換成下面的程式碼。
-- 按住 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 開始,不會帶著上一條命的任何狀態。
- 在 Explorer 中展開 StarterPlayer,把游標移到 StarterCharacterScripts 上,插入一個名為
DoubleJump的 LocalScript。 - 把它的內容換成下面的程式碼。
-- 在空中多給一次跳躍。每個新角色都會重新執行,
-- 所以重生後不會帶著任何狀態。
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的這個模組。
- 把游標移到 ServerScriptService 上,插入一個名為
MovementCheck的 Script。 - 把它的內容換成下面的程式碼。
-- 玩家的裝置會移動自己的角色,所以外掛使用者可以設定任何 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),下一次檢查就會從新位置開始測量,而不是標記這次跳動:
- 在回合系統中,緊接在
startRound裡的character:PivotTo(...)之後。 - 在障礙賽的檢查點 Script 中,緊接在每個把玩家移到他檢查點的
character:PivotTo(...)之後。
傳送教學中的傳送墊與選單,以及第一款遊戲教學中的 Finish 傳送墊,已經會在每次移動後設定它。
只有來自伺服器的數值才算數。玩家在自己裝置上設定的屬性只會留在那台裝置上(請見哪些會複寫、哪些不會),所以作弊者無法用它關掉檢查。
未來的解法:server authority
Roblox 的安全文件把 server authority 模型(撰寫本文時仍在 beta)稱為阻止移動外掛最可靠的方法。伺服器成為唯一的真實來源,玩家的裝置只回報自己的輸入,文件說這能讓加速外掛失效,因為裝置從來不被信任去回報自己的位置。
改用它是重寫,而不是調整設定。在這個模型中由伺服器計算移動,所以只由 LocalScript 設定的 WalkSpeed 或 LinearVelocity,會在伺服器狀態傳來時被覆蓋。Roblox 文件說,核心邏輯必須在用戶端和伺服器都會執行的 ModuleScript 中的 RunService:BindToSimulation() 函式裡執行。這個模型還需要幾項 Workspace 設定,包括 PlayerScriptsUseInputActionSystem,所以你的操作也要搬到 Input Action System。在把跑步、體力與衝刺搬進這個架構之前,請保留本教學的版本。在那之前,像這樣的距離檢查,就是 Roblox 移動驗證章節所描述的做法。
步驟 6:在每種裝置上測試
- 按 Play,走路時按住 Shift。速度從每秒 16 stud 升到 26 stud,畫面底部的綠色體力條會變短。大約 5 秒後它就空了,你又回到走路。
- 放開 Shift。1 秒後體力條開始回復。在它回到五分之一之前,按 Shift 不會有任何反應。
- 走路時按 Q:你會向前衝一小段,體力條少了四分之一。馬上再按一次 Q,在過了一秒之前什麼都不會發生。如果衝刺感覺太短或太長,請修改 MovementConfig 中的
DASH_SPEED或DASH_SECONDS。 - 跳起來,然後在空中再按一次跳躍做出第二跳。落地再試一次:每次從地面起跳都會恢復空中跳躍。
- 整個跳躍過程都按住 Space。應該只會跳一次而不是兩次,因為空中跳躍需要新的按壓。
- 在 Studio 中開啟 Device Simulator(撰寫本文時它是 beta:File、Beta Features、New Device Simulator,然後重新啟動 Studio),或在 Test 選單中開啟舊版的 Device Emulator。選一支手機並按 Play。Sprint 和 Dash 按鈕會出現。一邊控制方向一邊按住 Sprint,接著在整個跳躍過程按住跳躍按鈕,確認只跳一次。
- 打開 Controller Emulator(Emulation 分頁中的 Controller,或 Device Simulator 面板上的 Virtual controller)。移動時按住 L3 跑步,按 B 衝刺,按兩次 A 二段跳。
- 透過遊戲選單重設角色。體力條又是滿的,Output 中沒有 MovementCheck 的警告,如果你還在模擬手機,Sprint 和 Dash 按鈕也還在。
- 現在扮演作弊者。按 Client/Server 切換按鈕,直到 Explorer 顯示用戶端,在 Workspace 中選取你角色的 Humanoid,在 Properties 視窗中把 WalkSpeed 設為 60。走幾秒:Output 中會出現像
MovementCheck: YourName moved 60 studs/s這樣的警告。改回 16,然後像平常一樣跑步和衝刺一分鐘,確認 Output 保持安靜。 - 如果你的場景中
Workspace.PlayerScriptsUseInputActionSystem設為 Enabled,請再測一次二段跳:Roblox 文件沒有說明開啟它時JumpRequest的行為是否相同。
如果完全沒有反應,請從 Studio 的 Window 選單打開 Output 視窗,尋找 MovementClient 的紅色錯誤,或查看常見錯誤。
要跑多快、跑多久:依遊戲類型的預設值
合適的跑步取決於遊戲。恐怖遊戲的追逐需要短而慢、在最糟時機用完的跑步;大型開放地圖需要很長的跑步,玩家穿越地圖時才不會無聊。這些預設值使用同樣的 Script,只改走路速度和 MovementConfig。它們是我們依設定計算出來的起點,不是從玩家身上測得的。
| 遊戲類型 | CharacterWalkSpeed | SPRINT_BONUS(跑步速度) | DRAIN_PER_SECOND | REGEN_PER_SECOND | 滿條跑步 | 從空到滿 | 一條體力的距離 |
|---|---|---|---|---|---|---|---|
| 本教學 | 16 | 10 (26) | 20 | 15 | 5 秒 | 7.7 秒 | 130 stud |
| 恐怖遊戲追逐 | 12 | 8 (20) | 25 | 10 | 4 秒 | 11 秒 | 80 stud |
| Battlegrounds 與戰鬥 | 16 | 12 (28) | 15 | 20 | 6.7 秒 | 6 秒 | 大約 187 stud |
| 開放世界或模擬器 | 16 | 16 (32) | 10 | 25 | 10 秒 | 5 秒 | 320 stud |
| 障礙賽或跑酷 | 16 | 8 (24) | 沒有體力:使用 ShiftToSprint |
- 走路速度在 StarterPlayer 中設定。選取 StarterPlayer 並設定
CharacterWalkSpeed(預設 16)。每個新角色都從這個速度開始,跑步在上面加上SPRINT_BONUS,MovementCheck 也會讀取它,所以伺服器檢查會跟著你的選擇。 - MovementCheck 會自動調整。它允許走路速度加上跑步加成,再加四分之一作為延遲餘裕:恐怖遊戲預設值是每秒 25 stud,開放世界是 40。其他都不用改。
- 在障礙賽中,跑步會改變關卡。跑得更快就能跳過更長的缺口。先蓋好跳台,再用跑步速度測試每一個,否則跑步會讓關卡變得太簡單。障礙賽檢查點教學很適合搭配 ShiftToSprint。
- 在恐怖遊戲中,基準是殺手。讓追逐者比走路速度快一點、比跑步慢一點,這樣能不能逃掉就取決於體力條什麼時候用完。恐怖遊戲教學說明其餘的遊戲循環。
舊的跑步 Script 有什麼問題
舊的跑步、衝刺與二段跳教學通常還能用,但很多使用 Roblox 後來已經取代的做法,或會弄壞你遊戲中的其他系統。如果你在修一個複製來的 Script,請對照這份清單。
| 做法 | 問題在哪 | 本教學 |
|---|---|---|
用 BodyVelocity 衝刺 | 已淘汰:Roblox 說改用 LinearVelocity | Plane 模式的 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 當成「這是手機」的判斷 | 在有觸控螢幕的筆電上它也是 true | ContextActionService 會在觸控裝置上加入畫面按鈕,不需要你自己判斷裝置 |
用 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 鍵衝刺,還有二段跳。
- 可以先透過 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。
來源與延伸閱讀
- Roblox Creator Docs:ContextActionService(英文). BindAction、觸控按鈕、7 個按鈕的上限,以及為什麼大多數情況下它比 InputBegan 好
- Roblox Creator Docs:Humanoid(英文). WalkSpeed 與安全性說明、MoveDirection、StateChanged,以及附二段跳範例的 ChangeState
- Roblox Creator Docs:LinearVelocity(英文). Plane 模式、切線軸與 MaxForce
- Roblox Creator Docs:Mover constraints(英文). 從已淘汰的 BodyVelocity 改用 LinearVelocity
- Roblox Creator Docs:UserInputService(英文). JumpRequest 以及為什麼它需要防抖
- Roblox Creator Docs:Network ownership, movement validation, and physics(英文). 用戶端控制什麼、距離檢查、漏水桶與傳送的例外處理
- Roblox Creator Docs:Server authority model(英文). 由伺服器計算移動的模型、BindToSimulation,以及它需要的 Workspace 設定
- Roblox Creator Docs:Input Action System(英文). 使用 InputAction 與 InputBinding 的 Character Sprint 範例
- Roblox Creator Docs:Custom abilities(英文). Character Controller Library 中的衝刺能力
- Roblox Creator Docs:Studio testing modes(英文). Device Simulator 與 Controller Emulator
程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。