チュートリアル · ゲームシステム

Roblox Studio で PC、スマホ、コンソール対応の Shift ダッシュを作る方法

Roblox で Shift を押して走るスプリントは、つまるところ1つの数値です。Shift を押している間に大きくなる、Humanoid の WalkSpeed です。ステップ1はまさにそれだけを短い LocalScript 1つで行い、スマホの Sprint ボタンにもゲームパッドにも対応します。ガイドの残りでは、本格的なゲームに必要なものを足していきます。スタミナバー、最新の物理演算を使ったダッシュ、押しっぱなしのボタンでは発動しない二段ジャンプ、そしてサーバーが何をチェックできて何をできないかの理解です。

更新日 2026年11月20日読了時間 約5分執筆

要点

StarterPlayerScripts に LocalScript を1つ置き、ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3) で Sprint アクションを割り当てます。Shift を押している間は Humanoid.WalkSpeed に 10 を足し(16 が 26 になります)、離したら元の値に戻します。引数の true はタッチスクリーンに Sprint ボタンを追加します。このガイドのスクリプトでは、このボタンとゲームパッドの L3 は長押しではなく、スプリントのオンとオフを切り替えます。

  • 26 に設定するのではなく、今の WalkSpeed に足してください。そうすればゲームパスによる加速が残ります。
  • スプリントはプレイヤーの端末で動きます。サーバーは WalkSpeed を強制できません。できるのは、キャラクターがどれだけ移動したかを測り、スプリントでは説明できない速度を記録することだけです。
  • 同じ考え方でスタミナバー、ダッシュ、二段ジャンプを足すのがステップ2から4です。どれくらい速く、どれくらい長く走るかは、ホラー、バトル、オープンワールド向けの数値をまとめたゲームの種類別プリセットが参考になります。
このページの内容
  1. 仕組み
  2. 1. Shift スプリント
  3. 2. 設定モジュール
  4. 3. スプリントとダッシュ
  5. 4. 二段ジャンプ
  6. 5. サーバーチェック
  7. 6. テスト
  8. 速度のプリセット
  9. 古いスクリプト
  10. Input Action System
  11. 拡張
  12. Common errors
  13. RoCode で
  14. よくある質問
  15. 参考資料

Roblox のスプリントの仕組み

イラストShift でバーが減る間 WalkSpeed 26 で走り、Q でバーの4分の1を使ってダッシュし、空中でジャンプをもう一度押すと再びジャンプします。

各プレイヤーの端末は、自分のキャラクターを動かします。キーボード、コントローラー、タッチスクリーンがキャラクターの進む方向を決め、Roblox がその結果をサーバーとほかの全員に伝えます。そのため、スプリントはキーを押している間 Humanoid.WalkSpeed を上げる LocalScript であり、ステップ1がしているのはそれだけです。ガイドの残りは、本格的なゲームでその周りに必要になるものです。スタミナバー、ダッシュ、二段ジャンプ、チート対策のサーバーチェックです。

移動システムの構成
要素場所役割
LocalScript ShiftToSprintStarterPlayerScriptsステップ1単体: キーボード、スマホ、ゲームパッドでのスプリント、スタミナなし。スタミナとダッシュを足すときは MovementClient に置き換えます。
ModuleScript MovementConfigReplicatedStorage数値: スプリントのボーナス、スタミナ、ダッシュ。LocalScript とサーバーチェックの両方が読みます。
LocalScript MovementClientStarterPlayerScriptsSprint と Dash をキー、ゲームパッドのボタン、タッチボタンに割り当て、スタミナのループを回し、バーを描いてダッシュを行います。
LocalScript DoubleJumpStarterCharacterScripts空中でもう1回ジャンプできるようにします。新しいキャラクターごとに新しいコピーが動きます。
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 1つで Shift スプリント

Shift を押している間に速く走れればいいだけなら、このスクリプト1つで十分です。スマホには画面上の 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
		-- 今の速度を覚えてそこに足すので、別のスクリプトによる加速が残る
		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

-- 1回の呼び出しで、キー、ゲームパッドのボタン、タッチスクリーンでは画面上のボタンを割り当てる
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 は1つのアクションを Left Shift とゲームパッドの L3 ボタンに割り当て、3番目の引数 true でタッチスクリーンにボタンを追加します。SetTitle はそのボタンに "Sprint" と表示します。ハンドラーは入力そのものも受け取るので、キーボードでの押下か、ゲームパッドやタッチボタンかを区別できます。スプリントが始まると、スクリプトは今の WalkSpeed を覚えて SPRINT_BONUS を足し、終わると覚えた値に戻します。ゲームパスのガイドにある Speed 特典のように、ほかのスクリプトが設定した速度は残ります。新しいキャラクターは通常の WalkSpeed で始まるので、CharacterAdded ハンドラーはフラグをリセットするだけです。

長押しか、切り替えか?

TOGGLE_ON_TOUCH_AND_GAMEPAD が true のとき、ShiftToSprint が各端末でどう動くか
端末と入力動作理由
キーボード: Left Shift長押し移動しながらキーを押し続けるのは簡単で、離せばすぐスプリントが止まります。
ゲームパッド: 左スティックの押し込み(L3)切り替えスティックを押し込んだまま同時にそれで操作するのは疲れます。
スマホまたはタブレット: 画面上の Sprint ボタン切り替えボタンを押している親指では、同時に Jump を押せません。

テストするには、Play を押し、歩きながら Shift を押し続けます。速度が毎秒 16 から 26 スタッドに上がり、離すと遅くなります。スマホは、Studio の Device Simulator でスマホを選んで Play を押し、Sprint を1回押して走り始め、もう1回押して止めます。ゲームパッドは、プレイテスト中に Controller Emulator を開いて L3 を押します。端末ごとのチェックの完全な一覧はステップ6にあります。

ステップ2と3では、このスクリプトをスタミナバーとダッシュのある別のスクリプトに置き換えます。ステップ4と5では二段ジャンプとサーバーチェックを足し、どちらのスクリプトとも一緒に使えます。

ステップ2: スタミナとダッシュの数値を1つのモジュールに

切れるスプリントにするために、ステップ2と3では ShiftToSprint を、スタミナバーとダッシュのあるもっと大きな LocalScript に置き換えます。まず ShiftToSprint を削除してください。どちらのスクリプトも Sprint アクションを割り当てるからです。

数値はすべて1つの ModuleScript にあるので、動きの手触りを1か所で調整できます。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, -- ダッシュ中の毎秒スタッド数
	DASH_SECONDS = 0.2, -- これでダッシュは約12スタッド進む
	DASH_COST = 25, -- スタミナ
	DASH_COOLDOWN = 1,
}

return MovementConfig
各設定の役割
設定値効果
SPRINT_BONUS10スプリント中に WalkSpeed に足します。Roblox の WalkSpeed のデフォルトは 16 なので、スプリントは毎秒 26 スタッドになります。
MAX_STAMINA100満タンのバー。
DRAIN_PER_SECOND20満タンのバーで5秒間スプリントできます。
REGEN_PER_SECOND15空のバーが約 6.7 秒で満タンになります。
REGEN_DELAY1回復が始まるまでの休憩の秒数。
MIN_TO_START20スプリントを始めるのに必要なスタミナ。
DASH_SPEED60ダッシュ中の毎秒スタッド数。
DASH_SECONDS0.2ダッシュの長さ: 毎秒 60 スタッドで約 12 スタッド。
DASH_COST25ダッシュ1回あたりのスタミナ。
DASH_COOLDOWN1ダッシュとダッシュの間の秒数。

それぞれの側がモジュールの自分用のコピーを実行する(モジュールは各側で1回実行される)ので、自分の端末でこの数値を変えたプレイヤーが変えられるのは自分のコピーだけです。ただし、ここではそれは何も守っていません。そのプレイヤーの端末はもともと自分のキャラクターを動かしているので、モジュールの中身に関係なく、無限のスタミナを自分に与えられます。ステップ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

-- 1回の呼び出しごとに、キー、ゲームパッドのボタン、タッチ端末では画面上のボタンを割り当てる
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 を変えるのはスプリントの開始時と終了時だけ。こうすると別のスクリプトが設定した
	-- 速度(たとえばスピードのパス)が残り、スプリントはそこに足される
	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 の行はモジュールが返すものを記述しており、strict の型チェックが設定名の打ち間違いを見つけられるようにしています。ゲーム中には何も変えません。

キーボード、ゲームパッド、スマホのボタンを1回の呼び出しで

ContextActionService:BindAction は、アクション名、ハンドラー関数、タッチボタンを作るかどうか、そして入力を受け取ります。3番目の引数に true を渡すと、ContextActionService はタッチ端末の画面にボタンを追加します。ボタンはプレイヤーの PlayerGui の中の ContextActionGui という ScreenGui に入ります。SetTitle はそのボタンに "Sprint" と "Dash" と表示します。BindAction が作れるタッチボタンは7個までなので、ゲーム内のほかのスクリプトも使っている場合は数に注意してください。

ハンドラーは入力の状態を受け取ります。押したときは Begin、離したときは End です。onSprint は、Sprint が押されているかどうかを覚えるだけです。別の割り当てが入力を横取りしたときに ContextActionService が送る Cancel も解放として扱い、タッチボタンの上を動く指が送ることのある Change は無視します。どちらのハンドラーも Pass を返すので、同じキーの次の割り当ても入力を受け取ります。

Roblox の ContextActionService のリファレンスは、ほとんどの場合 UserInputService.InputBegan よりこちらを勧めています。その例は H キーの車のクラクションで、プレイヤーがチャットに入力している間は鳴ってはいけません。割り当ては、その入力に対して最後のものである間だけ発動するので、チャットがキーボードを使っているときに何もチェックする必要がありません。ゲームパッドの入力は ButtonL3(左スティックの押し込み、移動中に押し続けるもの)と ButtonB です。Roblox 自身のスプリントの例では ButtonY を使っているので、ゲームに合うなら BindAction の KeyCode を変えてください。

スタミナのループ

RunService.Heartbeat は毎フレーム物理演算のステップの後に発火し、前のフレームからの秒数である deltaTime を渡します。消費と回復の速さにこれを掛けると、ゲームが毎秒 30 フレームでも 240 フレームでも、満タンのバーで5秒間走れます。

ループは毎フレーム、キャラクターがスプリントすべきかを判断します。条件は、Sprint が押されている、キャラクターが歩いている(止まっているときは Humanoid.MoveDirection がゼロベクトル)、スタミナがまだある、の3つです。スプリントを始めるには最低 MIN_TO_START(20)が必要で、続けるには 0 より大きければ何でもかまいません。この差がないと、毎フレーム少しずつ回復する空のバーが、毎フレームスプリントをオンとオフに切り替えてしまいます。回復は最後のスプリントかダッシュから REGEN_DELAY(1秒)後に始まるので、バーを空にしたプレイヤーは、また走れるようになるまで約 2.3 秒待ちます。

WalkSpeed が変わるのは、スプリントが始まるか終わるフレームだけです。開始時にスクリプトは今の WalkSpeed を覚えて SPRINT_BONUS を足し、終了時に覚えた値に戻します。そのため、ほかのスクリプトが設定した速度は残ります。ゲームパスのガイドにある Speed 特典は WalkSpeed を 24 にするので、このスクリプトと組み合わせると、持ち主は 34 で走ります。毎フレームや離すたびに WalkSpeed = 16 と書くスクリプトだと、この特典が気づかないうちに打ち消されてしまいます。

ダッシュ

ダッシュは、キャラクターを移動している方向へ、止まっていれば向いている方向へ押し出します。方向は水平にそろえるので、上や下を向くことはありません。スタミナを 25 使い、スプリントと同じように回復を一時停止し、1秒のクールダウンがあります。地面のチェックはしないので空中でも使え、二段ジャンプとの相性も良好です。キャラクターが座っている間は何もしません。座ったキャラクターは座席に溶接されていて、乗り物の中で押すと乗り物ごと動いてしまうおそれがあるからです。

押し出す力は、ルートパーツの RootAttachment に付けた LinearVelocity 拘束です。X 軸と Z 軸の Plane モードでは、水平方向の速度を毎秒 60 スタッドに保ち、垂直方向には触れないので、重力はそのまま働き、段差からのダッシュはふつうに落ちます。MaxForce は math.huge なので、押し出しは何にも制限されません。Debris:AddItem はスクリプトを待たせずに DASH_SECONDS 後に拘束を破棄するので、ダッシュは 0.2 秒、この速度で約 12 スタッドです。

古いチュートリアルでは BodyVelocity を使っていますが、Roblox はこれを非推奨にし、代わりに LinearVelocity を使うよう案内しています。1つの軸の MaxForce をゼロにする BodyVelocity の技は、LinearVelocity の Line、Plane、Vector モードに置き換わっています。プレイヤーの端末が自分のキャラクターをシミュレートしているので、LocalScript が作った拘束でもキャラクターは動き、ほかのプレイヤーにはダッシュがほかの動きと同じように見えます。

Roblox 自身の UI のチュートリアルでも、まったく同じように humanoid.RootPart.RootAttachment に拘束を付けています。ゲームが独自のキャラクターを使っていて、そのルートパーツに RootAttachment という名前の Attachment がない場合、ダッシュは何もしません。StarterCharacter の HumanoidRootPart に追加してください。

ステップ4: 二段ジャンプ

二段ジャンプは、StarterCharacterScripts の専用の LocalScript に置きます。Roblox はスポーン時にこのコンテナのスクリプトのコピーを各キャラクターに入れ、そのコピーはリスポーンすると残らないので、毎回の命が新しいスクリプトで始まり、前の命から何も引き継がれません。

  1. Explorer で StarterPlayer を展開し、StarterCharacterScripts にカーソルを合わせて、DoubleJump という名前の LocalScript を挿入します。
  2. 中身を下のコードに置き換えます。
LocalScript 場所: StarterCharacterScripts 名前: DoubleJump
-- 空中でもう1回ジャンプできるようにする。新しいキャラクターごとに最初から動くので、
-- リスポーン後に何も引き継がれない。

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 は1回の押下で何度か発火する
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 にします。

スクリプトは Humanoid.StateChanged でキャラクターの状態を見ています。Freefall 以外から Jumping に移ったら地面からのジャンプなので、空中ジャンプを1回与え、Landed でまた取り上げます。段差から降りると、キャラクターはジャンプせずに Freefall になるので、空中ジャンプはもらえません。そこでも必要なら、Jumping 以外のどの状態から Freefall に移ったときにも jumpsLeft を設定してください。

UserInputService.JumpRequest は、Space やスマホのジャンプボタンなどでプレイヤーがジャンプを求めたときに発火します。Roblox のリファレンスは、1回のジャンプの要求で何度か発火すると注意し、デバウンスを勧めているので、スクリプトは最後のジャンプから 0.25 秒以内の要求を無視します。押しっぱなしのジャンプボタンもジャンプを要求し続けることがあり、キャラクターが地面を離れた瞬間に空中ジャンプを使ってしまうので、要求が 0.1 秒途切れた後でなければ新しい押下とはみなしません。

空中ジャンプそのものは Humanoid:ChangeState(Enum.HumanoidStateType.Jumping) です。Roblox のリファレンスによると、これはキャラクターのネットワーク所有権を持つ端末の LocalScript から呼ぶ必要があり、デフォルトではそれはサーバーではなくプレイヤー自身の端末です。リファレンスの ChangeState のサンプルコードは、まさに二段ジャンプです。

ステップ5: サーバーでスピードハックを捕まえる

スプリントのチュートリアルは、クライアントで終わってしまうことがよくあります。エクスプロイターは自分の端末で WalkSpeed を変えるので、サーバーの Script はプレイヤーの WalkSpeed を信用できませんが、キャラクターがどこにいるかは見えます。MovementCheck はそれを毎秒2回測り、スプリントとダッシュで可能な速さより速く長時間動いている人がいると 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 -- ダッシュ1、2回分の余裕
local DRAIN_PER_CHECK = BURST_ALLOWANCE / 8 -- 過去のダッシュを許していく速さ

local lastPosition: { [Player]: Vector3 } = {}
local lastRoot: { [Player]: BasePart } = {} -- lastPosition を測ったルートパーツ
local excess: { [Player]: number } = {} -- 許容量を超えたスタッド数。少しずつ許していく

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 のサーバーログに出ます。ライブのゲームでの出力を参照してください。

何を測っているか

スクリプトは0.5秒ごとに各キャラクターのルートパーツの位置を読み、前回のチェックから水平方向にどれだけ動いたかを測ります。高さは無視するので、落下やジャンプが数えられることはありません。移動のチェックについての Roblox のアドバイスでも、地面を歩くゲームでは同じように XZ 平面への投影を勧めています。許容量は、デフォルトの歩行速度にスプリントのボーナスを足し、さらにラグ用に4分の1を足したもので、毎秒 32.5 スタッドです。それを超えた距離は「漏れるバケツ」に入ります。これは、Roblox のドキュメントで、短いダッシュには多くの開発者にうまく合うとされている蓄積の仕組みです。バケツはチェックごとに 3 スタッド減り、24 スタッドを超えるとスクリプトが警告します。これはダッシュ約2回分の余裕です。

数値から計算した、チェックが捕まえるもの
チーターMovementCheck の動作
WalkSpeed を 100 にする走って約1秒で警告
WalkSpeed を 50 にする走って約 2.5 秒で警告
クールダウンなしで連続ダッシュする(毎秒 60 スタッド)約 1.5 秒で警告
一度に 43 スタッドより遠くへテレポートする次のチェックで警告
毎秒最大 38 スタッド、スプリントの約1.5倍の速さで走る何もしない: 毎秒 38.5 スタッド未満では、バケツは溜まるのと同じ速さで空になる
無限のスタミナのために自分の MovementConfig を変える何もしない: 毎秒 26 スタッドのスプリントは、いくら長くても許可される
飛ぶ、無制限にジャンプする、壁をすり抜ける何もしない: チェックは高さを無視し、衝突も見ない

つまり、このチェックは、プレイヤーが明らかにほかの全員より速くなる雑なチートは捕まえ、慎重なものは見逃します。これが距離によるチェックの正直な限界であり、Roblox がもっと強力なものを作っている理由です(下の server authority を参照)。

なぜ警告するだけなのか

Roblox のドキュメントでは、単純な速度チェックは接続が不安定な正直なプレイヤーを記録してしまうことがあり、乗り物やその他の複雑な動きがあるゲームでは機能しなくなると指摘されています。ラグの急増、コンベア、乗り物、キャラクターを吹き飛ばす爆発、そして自分で行うテレポートは速度超過に見えることがあるので、スクリプトは警告を表示するだけです。自分とテスターがふつうに遊んでいる間に Output を見て、正直なプレイヤーが引っかかるなら SPEED_ALLOWANCE を大きくし、ふつうのプレイでチェックが何も言わなくなってから、プレイヤーを元の位置に戻すなどの罰を追加してください。ゲームで爆発がキャラクターを吹き飛ばすなら、Humanoid の体力が残っていないプレイヤーも除外してください。

リスポーンとテレポート

リスポーンすると新しいルートパーツが作られ、スクリプトはそれを見ると測り直すので、スポーン地点から遠くで死んでも速度超過とはみなされません。自分のサーバースクリプトで行うテレポートには例外が必要で、これはテレポートのあるすべてのゲームについて Roblox のドキュメントに書かれているとおりです。テレポートの後に player:SetAttribute("MovementCheckSkip", true) を追加すると、次のチェックは跳躍を記録せず、新しい位置から測り始めます。

テレポートのガイドのパッドとメニュー、初めてのゲームのガイドの Finish パッドは、移動のたびにすでにこれを設定しています。

有効なのはサーバーの値だけです。プレイヤーが自分の端末で設定した属性はその端末にとどまる(何がレプリケートされ、何がされないかを参照)ので、チーターがそれでチェックを無効にすることはできません。

将来の解決策: server authority

Roblox のセキュリティのドキュメントは、執筆時点でベータの server authority モデルを、移動のエクスプロイトを止める最も確実な方法としています。サーバーが正しい状態の基準になり、プレイヤーの端末は入力を伝えるだけです。ドキュメントによると、端末に自分の位置を報告させることが決してないので、スピードハックが機能しなくなります。

移行は調整ではなく書き直しです。このモデルでは移動をサーバーが計算するので、LocalScript だけが設定した WalkSpeed や LinearVelocity は、サーバーからの状態が届くと取り消されます。Roblox のドキュメントでは、主なロジックはクライアントとサーバーの両方が実行する ModuleScript の中の RunService:BindToSimulation() 関数で動かすべきだとされています。このモデルには PlayerScriptsUseInputActionSystem を含む Workspace の設定もいくつか必要なので、操作も Input Action System に移ることになります。スプリント、スタミナ、ダッシュをこの構成に移すまでは、このガイドのバージョンを使い続けてください。それまでは、このような距離によるチェックこそが、移動のチェックについての Roblox の項目で説明されているものです。

ステップ6: すべての端末でテストする

  1. Play を押し、歩きながら Shift を押し続けます。速度は毎秒 16 から 26 スタッドに上がり、画面下の緑のバーが減っていきます。約5秒で空になり、また歩きに戻ります。
  2. Shift を離します。1秒後にバーが回復し始めます。5分の1まで回復するまでは、Shift を押しても何も起こりません。
  3. 歩きながら Q を押します。少し前へ飛び出し、バーの4分の1がなくなります。すぐにもう一度 Q を押しても、1秒たつまでは何も起こりません。ダッシュが短すぎたり長すぎたりする場合は、MovementConfig の DASH_SPEED か DASH_SECONDS を変えてください。
  4. ジャンプして、空中でもう一度ジャンプを押すと2回目のジャンプになります。着地してもう一度試してください。地面からジャンプするたびに空中ジャンプが戻ります。
  5. ジャンプの間ずっと Space を押したままにします。ジャンプは2回ではなく1回になるはずです。空中ジャンプには新しい押下が必要だからです。
  6. Studio で Device Simulator をオンにする(執筆時点ではベータです: File、Beta Features、New Device Simulator、そのあと Studio を再起動)か、Test メニューで古い Device Emulator をオンにします。スマホを選んで Play を押します。Sprint と Dash のボタンが表示されます。操作しながら Sprint を押し続け、次にジャンプボタンをジャンプの間ずっと押し続けて、ジャンプが1回だけか確認します。
  7. Controller Emulator を開きます(Emulation タブの Controller、または Device Simulator パネルの Virtual controller)。移動中に L3 を押し続けて走り、B でダッシュ、A を2回で二段ジャンプします。
  8. ゲームのメニューからキャラクターをリセットします。バーは再び満タンで、Output に MovementCheck の警告はなく、まだスマホをシミュレートしているなら Sprint と Dash のボタンもそのままです。
  9. 次はチーターになってみます。Explorer にクライアントが表示されるまで Client/Server の切り替えを押し、Workspace で自分のキャラクターの Humanoid を選び、Properties ウィンドウで WalkSpeed を 60 にします。数秒歩き回ると、Output に MovementCheck: YourName moved 60 studs/s のような警告が出ます。16 に戻し、1分間ふつうに走ったりダッシュしたりして、Output に何も出ないことを確認します。
  10. プレイスで Workspace.PlayerScriptsUseInputActionSystem が Enabled になっている場合は、二段ジャンプをもう一度テストしてください。Roblox のドキュメントには、その設定で JumpRequest が同じように動くかどうか書かれていません。

まったく何も起こらない場合は、Studio の Window メニューから Output ウィンドウを開いて MovementClient の赤いエラーを探すか、よくあるエラーを見てください。

どれくらい速く、どれくらい長く: ゲームの種類別プリセット

ちょうどいいスプリントはゲームによって違います。ホラーの追いかけっこには、最悪のタイミングで切れる短くて遅いスプリントが合い、広いオープンワールドのマップには、プレイヤーが横断に飽きないよう長いスプリントが合います。これらのプリセットは同じスクリプトを使い、変えるのは歩行速度と MovementConfig だけです。設定から計算した私たちの出発点であり、プレイヤーで測ったものではありません。

ゲームの種類別の歩行速度、スプリント、スタミナ。スプリント時間は MAX_STAMINA / DRAIN_PER_SECOND、回復は MAX_STAMINA / REGEN_PER_SECOND に REGEN_DELAY の1秒を足したもの
ゲームの種類CharacterWalkSpeedSPRINT_BONUS(スプリント速度)DRAIN_PER_SECONDREGEN_PER_SECOND満タンでのスプリント空から満タンまでバー1本での距離
このガイド1610 (26)20155 秒7.7 秒130 スタッド
ホラーの追いかけっこ128 (20)25104 秒11 秒80 スタッド
バトルグラウンドと戦闘1612 (28)15206.7 秒6 秒約 187 スタッド
オープンワールドまたはシミュレーター1616 (32)102510 秒5 秒320 スタッド
オビーまたはパルクール168 (24)スタミナなし: ShiftToSprint を使う
  • 歩行速度は StarterPlayer で設定します。StarterPlayer を選び、CharacterWalkSpeed(デフォルトは 16)を設定します。新しいキャラクターはすべてこの速度で始まり、スプリントはそこに SPRINT_BONUS を足し、MovementCheck もこれを読むので、サーバーチェックもあなたの選択に従います。
  • MovementCheck は自動で合わせます。歩行速度にスプリントのボーナスを足し、さらにラグ用に4分の1を足した速度を許可します。ホラーのプリセットなら毎秒 25 スタッド、オープンワールドなら 40 です。ほかに変える必要はありません。
  • オビーではスプリントがコースを変えます。スプリントが速いほど、長い隙間を跳び越えられます。ジャンプを作ってから、それぞれをスプリントの速度で確認してください。そうしないと、スプリントでステージが簡単になりすぎます。オビーのチェックポイントのガイドは ShiftToSprint と相性が良いです。
  • ホラーでは基準は殺人鬼です。追っ手を歩行速度より少し速く、スプリントより少し遅くすると、逃げ切れるかどうかがバーの切れるタイミングで決まります。ホラーゲームのガイドで残りのループを解説しています。

古いスプリントのスクリプトの問題点

スプリント、ダッシュ、二段ジャンプの古いチュートリアルは、今でも動くことが多いものの、その後 Roblox が置き換えた手法を使っていたり、ゲーム内のほかのシステムを壊したりするものがたくさんあります。コピーしたスクリプトを直しているなら、この一覧と照らし合わせてください。

古いチュートリアルの手法と、このガイドでの代わりのやり方
手法何が問題かこのガイド
ダッシュに BodyVelocity非推奨: Roblox は代わりに LinearVelocity を使うよう案内しているPlane モードの LinearVelocity
RunService.RenderStepped でのループ新しい作業では PreRender に置き換わっている。スタミナのようなゲームロジックは、Roblox が体力の回復のような定期的な処理向けと説明している Heartbeat に置くべきdeltaTime 付きの Heartbeat
wait() を使ったスタミナのループwait() は task.wait() に置き換えられて非推奨で、スロットリングされるため指定より長く待つことがあり、wait ごとに固定量を減らすとスタミナの減り方が不均一になるdeltaTime を考慮して毎フレーム消費と回復
チャットのチェックがない UserInputService.InputBeganチャットにメッセージを入力中に Shift を押すとスプリントが始まるスマホのボタンも追加してくれる ContextActionService
離したときや毎フレームの WalkSpeed = 16ゲームパスの特典など、ほかの速度をすべて上書きしてしまうWalkSpeed を変えるのはスプリントの開始時と終了時だけで、今の値に足す
サーバーが WalkSpeed を設定するよう RemoteEvent でスプリントエクスプロイターはどのみち WalkSpeed を自分で設定し、スプリントの開始が往復の分だけ遅れるクライアントでのスプリントとサーバーでの距離チェック
JumpRequest のたびに二段ジャンプJumpRequest は1回のジャンプの要求で何度か発火し、押しっぱなしのボタンはジャンプを要求し続けることがある0.25 秒の間隔と新しい押下のチェック
「スマホかどうか」の判定に UserInputService.TouchEnabledタッチスクリーン付きのノートパソコンでも true になるContextActionService は、自分で端末を判定しなくてもタッチ端末の画面にボタンを追加する
走るアニメーションに Humanoid:LoadAnimationAnimator:LoadAnimation に置き換えられて非推奨下の走るアニメーションは Animator を使う

Roblox の新しい方法: Input Action System

Input Action System についての Roblox のページは、最初の例にキャラクターのスプリントを取り上げています。BindAction を呼ぶ代わりに、操作を Studio で設定します。ReplicatedStorage の input context の中に CharacterSprint という名前の InputAction を置き、Left Shift 用、ゲームパッドの Y ボタン用、StarterGui に自分で作る画面上のボタンにつながったものの3つの InputBinding を持たせます。そしてクライアントのスクリプトがアクションの Pressed と Released イベントを待ち受け、押されたら WalkSpeed を2倍にし、離されたら元に戻します。

移行する価値があるのは、操作をコードではなく Studio で配置したい場合、ContextActionService のボタンではなく自分のタッチボタンを使いたい場合、メニューや乗り物のように操作のセットを丸ごと切り替えるコンテキストが欲しい場合です。そのページは Workspace.PlayerScriptsUseInputActionSystem を Enabled にすることも勧めており、server authority ではこれが必須です。

このガイドのスタミナのループとダッシュは、Input Action System だけ(server authority なし)でも同じように動きます。MovementConfig、Heartbeat のループ、dash() は残し、2つの BindAction の呼び出しとそのハンドラーを削除して、代わりにアクションをつなぎます。スプリントのアクションの Pressed で sprintHeld を true に、Released で false にし、ダッシュのアクションの Pressed で dash() を呼びます。MovementClient と同じように Humanoid は毎フレーム探し続けてください。ドキュメントの例は最初のキャラクターの Humanoid を保存しており、リスポーン後にはもう存在しないからです。

Roblox は Character Controller Library もテストしています。Studio の Beta Features と Avatar Settings でオンにするベータです。そのカスタムアビリティのページでは、例として有効時間 0.2 秒、クールダウン 1 秒のダッシュを作っており、このガイドのダッシュと同じタイミングです。

拡張する: アニメーション、カメラ、スプリントのパス

走るアニメーション

Animation Editor で走るアニメーションを作り、優先度を Movement(Roblox は歩きや走りのアニメーションにこれを推奨しています)にして公開し、アセット ID をコピーします。MovementClient で、その AnimationId を持つ Animation を作り、キャラクターの Humanoid の中の Animator を使って Animator:LoadAnimation で読み込み、スプリントが始まる箇所でトラックを再生し、終わる箇所で止めます。新しいキャラクターごとに読み込み直してください。

自分の端末が自分のキャラクターで再生するアニメーションは、Roblox がそこに入れた Animator を使えば全員に見えます。LocalScript が作った Animator に読み込んだトラックはレプリケートされません。古いチュートリアルの多くが使っている Humanoid:LoadAnimation は非推奨です。

スプリント中にカメラを広く

視野角を少し広げると、スプリントの体感が速くなります。同じ2か所で、スプリントが始まったら workspace.CurrentCamera.FieldOfView をデフォルトの 70 から 80 くらいにトゥイーンし、終わったら戻します。たとえば TweenService:Create(workspace.CurrentCamera, TweenInfo.new(0.25), { FieldOfView = 80 }):Play() を使います。Roblox は値を 1 から 120 に制限しており、極端に低い値や高い値はプレイヤーを混乱させることがあると注意しています。ゲーム内のほかのスクリプトも視野角を変える場合は、70 ではなく、見つけた値に戻すようトゥイーンしてください。

ゲームパスとしての速いスプリント

ゲームパスのガイドは、すでにこのスクリプトと一緒に動きます。その Speed 特典はサーバーで新しいキャラクターごとに WalkSpeed を 24 にし、MovementClient がその上にスプリントのボーナスを足し、毎秒 34 スタッドは MovementCheck が許す範囲に収まります。

スプリントそのものを速くするパスなら、そのガイドの PassConfig.ids に FastSprint パスを追加します。すると、購入が確認されしだい、そのサーバースクリプトがプレイヤーに OwnsPass_FastSprint 属性を設定します。MovementClient では、player:GetAttribute("OwnsPass_FastSprint") == true のとき Config.SPRINT_BONUS より大きいボーナスを使います。MovementCheck では、プレイヤーが変更できないサーバー側で同じ属性を読んでそのプレイヤーに大きめの許容量を与え、新しい最高速度がチェックに記録される値より低いままであることを確認してください。

知っておきたい制限が1つあります。スプリントの途中でほかのスクリプトが WalkSpeed を変えると、そのスプリントの終わりに、始まる前の速度に戻ってしまいます。次のリスポーンでパスの速度がまた設定されます。ゲームパスのスクリプトは新しいキャラクターごとにそれを適用するからです。

よくあるエラーと対処法

Play を押す前に Output ウィンドウを開いてください(Window メニューから Output)。これらのスクリプトの問題のほとんどは、そこにスクリプト名と行番号付きのエラーか警告を表示します。

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

MovementClient か MovementCheck が、その名前どおりのモジュールがないまま待っています。ReplicatedStorage の直下にある MovementConfig という名前の ModuleScript でなければなりません。スクリプトのエラーのガイドで、この警告を詳しく説明しています。

Shift を押しても何も起こらない

ShiftToSprint か MovementClient が Script ではなく LocalScript であること、StarterPlayerScripts にあることを確認してください。MovementClient では、スプリントを始めるにはキャラクターが歩いていて、スタミナが最低 20 ある必要もあるので、移動しながら Shift を押してください。スプリントではなく Shift Lock が切り替わる場合は、下の Shift Lock の質問を見てください。

数秒でスプリントが止まる

スタミナが切れています。スタミナ 100 を毎秒 20 ずつ使うと5秒もちます。MovementConfig の MAX_STAMINA を大きくするか、DRAIN_PER_SECOND を小さくしてください。

ダッシュが何もしない

ダッシュにはスタミナ 25 が必要で、前回から1秒待ち、座っている間は何もしません。それが原因でなければ、キャラクターのルートパーツに RootAttachment という名前の Attachment がないのかもしれません。独自のキャラクターではそうなることがあります。StarterCharacter の HumanoidRootPart に追加してください。

二段ジャンプが発動しない

DoubleJump は script.Parent をキャラクターとして読むので、StarterPlayerScripts ではなく StarterCharacterScripts の LocalScript でなければなりません。地面を離れてから2回目のジャンプを押してください。押しっぱなしのボタンは新しい押下とはみなされず、段差から降りても空中ジャンプはもらえません。

スマホに Sprint や Dash のボタンがない

ContextActionService がボタンを追加するのはタッチ端末だけなので、タッチスクリーンのない PC では決して見えません。Studio の Device Simulator でスマホを選んでテストしてください(ベータです: File、Beta Features で New Device Simulator をオンにして Studio を再起動します)。BindAction が作れるタッチボタンは7個までなので、ゲーム内のほかのスクリプトがいくつ作っているか数えてください。

MovementCheck が正直なプレイヤーに警告を出す

よくある原因は、ほかのサーバースクリプトからのテレポート、コンベアや乗り物、ラグです。自分のテレポートの後に MovementCheckSkip 属性を設定し(リスポーンとテレポートを参照)、ふつうのプレイでもまだチェックが反応するなら SPEED_ALLOWANCE を大きくしてください。

スプリントの後に加速が消える

スプリント中にほかのスクリプトが WalkSpeed を変え、スプリントが終わったときに開始時に見た速度に戻しました。ゲームパスのガイドのように、加速はキャラクターのスポーン時に与えてください。そうすればリスポーンで正しい速度がまた設定されます。

RoCode で作る

全部を手作業で設定したくない場合は、RoCode が開いているプレイスにこれを組み立てられます。RoCode は Roblox 製ではない独立した Roblox Studio 向けの AI エージェントです。ウェブチャットで変更内容を説明すると、Studio プラグインがあなたの Explorer にスクリプトを作るので、コードを貼り付ける必要はありません。

あなたの入力

スタミナバー付きの Shift スプリントを追加して: Shift を押している間は歩行速度プラス 10、スタミナ 100、消費は毎秒 20、1秒休んだら毎秒 15 回復、スマホには Sprint ボタン、Q でダッシュ、それに二段ジャンプ。

RoCode の作業
  • まず Search Scripts と Read Script でプレイスを調べ、WalkSpeed を変えるほかのスクリプト(ゲームパスの特典など)を見つけて、スプリントがそこに足されるようにすることがあります
  • Create Script で ModuleScript、LocalScript、サーバーチェックを書きます
  • 書いた各スクリプトのコンパイルを Check Script で確認するよう指示されています。Check Script はスクリプトを実行せずに Studio でコンパイルします
  • 変更のまとまりごとに前後に取り消しポイントを置くので、Ctrl+Z で1まとまりずつ元に戻せます

RoCode は走るアニメーションを作れません。Animation Editor で作り、その ID を貼り付けてください。プラグイン 3.9.11 以降なら、RoCode は Studio でゲームのプレイテストを実行し、テスト用のキャラクターを操作してすべて動くか確かめられます。プラグイン 3.9.15 以降なら、テスト用のキャラクターはキーを押すこともでき、たとえば Shift を押し続けて WalkSpeed が上がったか確認します。いつプレイテストを実行するかは RoCode 自身が決め、1回のビルドにつき最大2回、加えて自分の修正を確認するために1回です。確認するのは自分でテストすると決めたことだけなので、スプリント、ダッシュ、二段ジャンプは自分で試し、スマホのボタンは Studio の Device Simulator で確認してください。移動はゲームの多くのシステムの1つにすぎません。RoCode でゲーム全体を作るときも、ここと同じようにプロンプト1つにつき1システムずつ進めます。RoCode が Studio に接続する仕組み。

よくある質問

スプリントのスクリプトがスマホで動かないのはなぜですか?

スマホには Shift キーがありません。スプリントは ContextActionService:BindAction で割り当て、3番目の引数に true を渡してください。ShiftToSprint と MovementClient の両方がしているように、タッチ端末の画面にボタンが追加されます。

スプリントはサーバーで処理する必要がありますか?

いいえ。各端末が自分のキャラクターを動かすので、サーバーが設定した WalkSpeed では、自分で値を設定できるチーターを止められません。しかも新しい速度は往復の後でしか届かないので、スプリントの開始が遅れます。スプリントはクライアントで行い、サーバーではステップ5のように、キャラクターが実際にどれだけ移動したかをチェックしてください。Roblox のベータの server authority は仕組みが違い、そのためには移動のコードを書き直す必要があります。

Shift を離してもキャラクターが走り続けるのはなぜですか?

スクリプトが解放を見逃しています。ふつうは押下しか待ち受けていないのが原因です。ContextActionService は、キーが離されたときに End を、別の割り当てに横取りされたときに Cancel を送ります。MovementClient はその両方で止まり、スタミナが切れたときやキャラクターが動かなくなったときにも止まります。

走るアニメーションを追加するには?

同じ LocalScript で、キャラクターの Humanoid の中の Animator を使って走るアニメーションを読み込み、スプリントが始まったら再生し、終わったら止めます。優先度は Movement にしてください。自分のキャラクターで再生したアニメーションは全員に見えます。

スマホで二段ジャンプが勝手に発動するのはなぜですか?

スマホの押しっぱなしのジャンプボタンは、ジャンプを要求し続けます。DoubleJump のスクリプトのように、要求が一瞬途切れたときだけ新しいジャンプとみなしてください。

Roblox のデフォルトの歩行速度はいくつですか?

毎秒 16 スタッドです。これは StarterPlayer.CharacterWalkSpeed から来ており、新しいキャラクターごとの Humanoid.WalkSpeed を決めています。このガイドのスプリントは 10 を足すので、毎秒 26 で走ります。

Roblox のスプリントはどれくらいの速さにすべきですか?

ほとんどのゲームは、歩行速度の半分から同じくらいを足します。16 が 24 から 32 のあたりになります。短くて遅いスプリントはホラーに、長くて速いスプリントは広いマップに合います。ゲームの種類別プリセットで、それぞれの歩行速度、スプリントのボーナス、スタミナの数値を紹介しています。

スタミナ付きのスプリントを作るには?

スタミナの数値をプレイヤーの端末に持ち、スプリント中は毎フレーム減らし、少し休んだら回復させます。どちらもフレームの時間を考慮し、0 になったらスプリントを止めます。ステップ3の MovementClient は、画面上のバー付きでこれを行います。数値は MovementConfig にあります。

Roblox でコントローラーを使ってスプリントするには?

ここにある両方のスクリプトと同じように、ゲームパッドの ButtonL3(左スティックの押し込み)を Left Shift と一緒に ContextActionService で割り当てます。ShiftToSprint は L3 を切り替え式にしています。スティックを押し込んだまま同時にそれで操作するのは疲れるからです。

Shift スプリントは Shift Lock と競合しますか?

競合することがあります。Roblox の設定で Shift Lock をオンにしたプレイヤーは Shift キーでそれを切り替えるので、1つのキーが2つのことをします。Roblox のドキュメントには、Shift Lock の API は廃止予定とあります。競合がプレイヤーの邪魔になるなら、StarterPlayer.EnableMouseLockOption をオフにするか、MovementClient のスプリントを Left Ctrl など別のキーに割り当ててください。

参考資料

コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。

RoCode を自分のゲームで試してみましょう。

毎日無料のクレジット付き、カード不要です。プラグインを入れて、作りたい機能を説明し、Studio に反映された内容を確認してください。