요약
StarterPlayerScripts에 LocalScript 하나를 넣고 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단계까지에서 추가합니다. 얼마나 빠르게, 얼마나 오래 달릴지는 호러, 전투, 오픈 월드용 숫자를 담은 게임 장르별 프리셋을 참고하세요.
이 페이지의 내용
Roblox에서 달리기가 작동하는 방식
각 플레이어의 기기가 자기 캐릭터를 움직입니다. 키보드, 컨트롤러, 터치스크린이 캐릭터가 어디로 갈지 정하고, Roblox가 그 결과를 서버와 다른 모든 사람에게 전달합니다. 그래서 달리기는 키를 누르고 있는 동안 Humanoid.WalkSpeed를 올리는 LocalScript이며, 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를 누르고 있는 동안 더 빨리 달리는 것만 필요하다면 이 스크립트 하나로 충분합니다. 모바일에는 화면에 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
-- 현재 속도를 기억하고 거기에 더해서, 다른 스크립트의 속도 증가가 유지되게 합니다
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"라고 씁니다. 핸들러는 입력 자체도 받으므로 키보드 입력과 게임패드나 터치 버튼 입력을 구분합니다. 달리기가 시작되면 스크립트는 현재 WalkSpeed를 기억하고 SPRINT_BONUS를 더하며, 끝나면 기억한 값으로 되돌립니다. 다른 스크립트가 정한 속도, 예를 들어 게임패스 가이드의 Speed 혜택은 유지됩니다. 새 캐릭터는 보통 WalkSpeed로 시작하므로 CharacterAdded 핸들러는 플래그만 초기화합니다.
누르기 방식인가, 전환 방식인가?
| 기기와 입력 | 작동 방식 | 이유 |
|---|---|---|
| 키보드: Left Shift | 누르기 | 이동하면서 키를 누르고 있기 쉽고, 떼면 바로 달리기가 멈춥니다. |
| 게임패드: 왼쪽 스틱 누르기(L3) | 전환 | 스틱을 누른 채로 동시에 방향을 조작하는 것은 피곤합니다. |
| 모바일 또는 태블릿: 화면의 Sprint 버튼 | 전환 | 버튼을 누르고 있는 엄지로는 동시에 Jump를 누를 수 없습니다. |
확인하려면 Play를 누르고 걸으면서 Shift를 누르고 있으세요. 속도가 초당 16스터드에서 26스터드로 올라가고, 떼면 느려집니다. 모바일은 Studio의 Device Simulator에서 휴대폰을 고르고 Play를 누른 뒤, Sprint를 한 번 눌러 시작하고 다시 눌러 멈추세요. 게임패드는 플레이 테스트 중에 Controller Emulator를 열고 L3를 누르세요. 기기별 전체 확인 목록은 6단계에 있습니다.
2단계와 3단계는 이 스크립트를 스태미나 바와 대시가 있는 다른 스크립트로 바꿉니다. 4단계와 5단계는 더블 점프와 서버 검사를 추가하며, 두 스크립트 중 어느 것과도 함께 작동합니다.
2단계: 스태미나와 대시 숫자를 모듈 하나에
바닥나는 달리기를 위해 2단계와 3단계는 ShiftToSprint를 스태미나 바와 대시가 있는 더 큰 LocalScript로 바꿉니다. 먼저 ShiftToSprint를 삭제하세요. 두 스크립트 모두 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, -- 대시 중 초당 스터드
DASH_SECONDS = 0.2, -- 이렇게 하면 대시가 약 12스터드를 이동합니다
DASH_COST = 25, -- 스태미나
DASH_COOLDOWN = 1,
}
return MovementConfig
| 설정 | 값 | 효과 |
|---|---|---|
SPRINT_BONUS | 10 | 달리는 동안 WalkSpeed에 더해집니다. Roblox의 기본 WalkSpeed는 16이므로 초당 26스터드로 달립니다. |
MAX_STAMINA | 100 | 가득 찬 바. |
DRAIN_PER_SECOND | 20 | 가득 찬 바로 5초 동안 달릴 수 있습니다. |
REGEN_PER_SECOND | 15 | 빈 바가 약 6.7초 만에 다시 찹니다. |
REGEN_DELAY | 1 | 회복이 시작되기 전 쉬는 시간(초). |
MIN_TO_START | 20 | 달리기를 시작하는 데 필요한 스태미나. |
DASH_SPEED | 60 | 대시 중 초당 스터드. |
DASH_SECONDS | 0.2 | 대시가 지속되는 시간: 초당 60스터드로 약 12스터드. |
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는 달리기의 시작과 끝에서만 바꿉니다. 그래야 다른 스크립트(예: 속도 패스)가
-- 정한 속도가 유지되고, 달리기가 그 위에 더해집니다
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개이므로, 게임의 다른 스크립트도 버튼을 쓴다면 개수를 확인하세요.
핸들러는 입력 상태를 받습니다. 누를 때 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은 영벡터입니다), 스태미나가 아직 남아 있어야 합니다. 달리기를 시작하려면 적어도 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를 쓰라고 안내합니다. 한 축의 MaxForce를 0으로 두던 요령은 LinearVelocity의 Line, Plane, Vector 모드가 대신합니다. 플레이어의 기기가 자기 캐릭터를 직접 시뮬레이션하므로 LocalScript가 만든 제약이 캐릭터를 움직이고, 다른 플레이어에게는 대시가 다른 움직임과 똑같이 보입니다.
Roblox 자체 UI 튜토리얼도 똑같이 제약을 humanoid.RootPart.RootAttachment에 붙입니다. 게임에서 루트 파트에 RootAttachment라는 Attachment가 없는 커스텀 캐릭터를 쓴다면 대시가 아무것도 하지 않으니, StarterCharacter의 HumanoidRootPart에 그것을 추가하세요.
4단계: 더블 점프
더블 점프는 StarterCharacterScripts 안의 별도 LocalScript에 있습니다. Roblox는 스폰할 때마다 이 컨테이너의 스크립트 사본을 각 캐릭터에 넣고, 이 사본은 리스폰 후에 남지 않습니다. 그래서 매번 새 스크립트로 시작하며, 이전 생명에서 아무것도 넘어오지 않습니다.
- 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로 하세요.
스크립트는 Humanoid.StateChanged로 캐릭터 상태를 지켜봅니다. Freefall에서 온 것이 아닌 Jumping으로의 전환은 땅에서 한 점프이므로 공중 점프를 하나 주고, Landed는 그것을 다시 가져갑니다. 턱에서 걸어 내려가면 캐릭터는 점프 없이 Freefall이 되므로 공중 점프를 받지 못합니다. 그때도 필요하다면 Jumping을 제외한 아무 상태에서 Freefall로 바뀔 때도 jumpsLeft를 설정하세요.
UserInputService.JumpRequest는 플레이어가 점프를 요청할 때, 예를 들어 Space나 모바일의 점프 버튼으로 실행됩니다. Roblox 레퍼런스는 이것이 점프 요청 한 번에 여러 번 실행된다고 경고하며 디바운스를 권합니다. 그래서 스크립트는 마지막 점프 후 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 } = {} -- 허용치를 넘은 스터드, 점차 봐줍니다
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스터드가 넘게 차면 경고합니다. 이는 대시 약 두 번 분량의 여유입니다.
| 치터 | MovementCheck가 하는 일 |
|---|---|
| WalkSpeed를 100으로 설정 | 약 1초 달리면 경고 |
| WalkSpeed를 50으로 설정 | 약 2.5초 달리면 경고 |
| 재사용 대기 없이 연속 대시(초당 60스터드) | 약 1.5초 후 경고 |
| 한 번에 43스터드보다 멀리 텔레포트 | 다음 검사에서 경고 |
| 달리기보다 약 1.5배 빠른 초당 최대 38스터드로 달림 | 아무것도 안 함: 초당 38.5스터드 미만이면 양동이가 차는 만큼 빨리 비워집니다 |
| 무한 스태미나를 위해 자기 MovementConfig를 바꿈 | 아무것도 안 함: 초당 26스터드 달리기는 얼마나 오래든 허용됩니다 |
| 날거나, 제한 없이 점프하거나, 벽을 통과함 | 아무것도 안 함: 검사는 높이를 무시하고 충돌을 보지 않습니다 |
즉, 이 검사는 플레이어가 다른 모두보다 눈에 띄게 빠른 노골적인 치트는 잡고, 조심스러운 치트는 놓칩니다. 이것이 거리 기반 검사의 솔직한 한계이며, Roblox가 더 강력한 방식을 만드는 이유입니다(아래 server authority 참고).
왜 경고만 하나
Roblox 문서는 단순한 속도 검사가 연결이 불안정한 정직한 플레이어를 표시할 수 있고, 탈것이나 다른 복잡한 이동이 있는 게임에서는 망가진다고 지적합니다. 랙 튐, 컨베이어, 탈것, 캐릭터를 날려 보내는 폭발, 그리고 직접 만든 텔레포트가 과속처럼 보일 수 있으므로 스크립트는 경고만 출력합니다. 나와 테스터들이 평소처럼 플레이하는 동안 Output을 지켜보고, 정직한 플레이어가 걸린다면 SPEED_ALLOWANCE를 늘리세요. 플레이어를 뒤로 되돌리는 것 같은 처벌은 평소 플레이에서 검사가 조용할 때만 추가하세요. 게임에서 폭발이 캐릭터를 날려 보낸다면 Humanoid의 체력이 남지 않은 플레이어도 건너뛰세요.
리스폰과 텔레포트
리스폰은 새 루트 파트를 만들고, 스크립트는 그것을 보면 측정을 새로 시작하므로 스폰 지점에서 멀리 떨어진 곳에서 죽어도 과속으로 계산되지 않습니다. 직접 만든 서버 스크립트가 하는 텔레포트에는 예외가 필요하며, Roblox 문서도 텔레포트가 있는 모든 게임에 그렇게 하라고 안내합니다. 텔레포트 뒤에 player:SetAttribute("MovementCheckSkip", true)를 추가하면 다음 검사가 순간 이동으로 표시하지 않고 새 위치부터 측정을 시작합니다.
- 라운드 시스템에서는
startRound의character:PivotTo(...)바로 뒤에. - 오비 체크포인트 스크립트에서는 플레이어를 체크포인트로 옮기는 모든
character:PivotTo(...)바로 뒤에.
텔레포트 가이드의 패드와 메뉴, 첫 게임 가이드의 Finish 패드는 이미 이동할 때마다 이 속성을 설정합니다.
서버의 값만 인정됩니다. 플레이어가 자기 기기에서 설정한 속성은 그 기기에만 남으므로(무엇이 복제되고 무엇이 안 되는지 참고), 치터가 이것으로 검사를 끌 수는 없습니다.
앞으로의 해결책: server authority
Roblox 보안 문서는 이 글을 쓰는 시점에 베타인 server authority 모델을 이동 익스플로잇을 막는 가장 확실한 방법으로 꼽습니다. 서버가 진실의 원천이 되고 플레이어의 기기는 입력만 보고합니다. 문서에 따르면 기기가 자기 위치를 보고하도록 믿는 일이 없으므로 스피드핵이 작동하지 않습니다.
이 전환은 조정이 아니라 다시 쓰기입니다. 이 모델에서는 서버가 이동을 계산하므로, LocalScript만 설정하는 WalkSpeed나 LinearVelocity는 서버 상태가 도착하면 취소됩니다. Roblox 문서에 따르면 핵심 로직은 클라이언트와 서버가 모두 실행하는 ModuleScript 안의 RunService:BindToSimulation() 함수에서 실행되어야 합니다. 이 모델에는 PlayerScriptsUseInputActionSystem을 포함한 몇 가지 Workspace 설정도 필요하므로, 조작도 Input Action System으로 옮기게 됩니다. 달리기, 스태미나, 대시를 이 구조로 옮기기 전까지는 이 가이드의 버전을 유지하세요. 그때까지는 이런 거리 기반 검사가 바로 Roblox의 이동 검사 섹션이 설명하는 방식입니다.
6단계: 모든 기기에서 확인하기
- Play를 누르고 걸으면서 Shift를 누르고 있으세요. 속도가 초당 16스터드에서 26스터드로 올라가고, 화면 아래의 초록색 바가 줄어듭니다. 약 5초 뒤 바가 비고 다시 걷게 됩니다.
- Shift를 떼세요. 1초 뒤 바가 차오르기 시작합니다. 바가 5분의 1만큼 차기 전까지는 Shift가 아무것도 하지 않습니다.
- 걸으면서 Q를 누르세요. 앞으로 조금 돌진하고 바의 4분의 1이 사라집니다. 곧바로 Q를 다시 누르면 1초가 지날 때까지 아무 일도 없습니다. 대시가 너무 짧거나 길게 느껴지면 MovementConfig의
DASH_SPEED나DASH_SECONDS를 바꾸세요. - 점프한 다음 공중에서 점프를 한 번 더 눌러 두 번째 점프를 하세요. 착지하고 다시 해 보세요. 땅에서 점프할 때마다 공중 점프가 돌아옵니다.
- 점프하는 내내 Space를 누르고 있으세요. 공중 점프에는 새로 누르는 것이 필요하므로 두 번이 아니라 한 번만 점프해야 합니다.
- Studio에서 Device Simulator를 켜거나(이 글을 쓰는 시점에는 베타입니다: 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 버튼이 그대로 있습니다.
- 이제 치터가 되어 보세요. Explorer가 클라이언트를 보여 줄 때까지 Client/Server 전환을 누르고, Workspace에서 내 캐릭터의 Humanoid를 선택한 뒤 Properties 창에서 WalkSpeed를 60으로 설정하세요. 몇 초 돌아다니면 Output에
MovementCheck: YourName moved 60 studs/s같은 경고가 나타납니다. 16으로 되돌린 뒤 1분 동안 평소처럼 달리고 대시하면서 Output이 조용한지 확인하세요. - 플레이스에서
Workspace.PlayerScriptsUseInputActionSystem이 Enabled라면 더블 점프를 한 번 더 확인하세요. Roblox 문서에는 이 설정에서JumpRequest가 똑같이 동작하는지 나와 있지 않습니다.
아무 일도 일어나지 않는다면 Studio의 Window 메뉴에서 Output 창을 열고 MovementClient의 빨간 오류를 찾아보거나 자주 나오는 오류를 확인하세요.
얼마나 빠르게, 얼마나 오래: 게임 장르별 프리셋
알맞은 달리기는 게임마다 다릅니다. 호러 게임의 추격에는 가장 나쁜 순간에 끝나는 짧고 느린 달리기가 필요하고, 넓은 오픈 맵에는 플레이어가 지루하지 않게 가로지를 수 있는 긴 달리기가 필요합니다. 이 프리셋들은 같은 스크립트를 쓰고 걷기 속도와 MovementConfig만 바꿉니다. 플레이어에게서 측정한 값이 아니라 설정으로 계산한 우리의 출발점입니다.
| 게임 장르 | CharacterWalkSpeed | SPRINT_BONUS (달리기 속도) | DRAIN_PER_SECOND | REGEN_PER_SECOND | 최대 달리기 | 빈 바에서 가득 찰 때까지 | 바 하나로 가는 거리 |
|---|---|---|---|---|---|---|---|
| 이 가이드 | 16 | 10 (26) | 20 | 15 | 5초 | 7.7초 | 130스터드 |
| 호러 추격 | 12 | 8 (20) | 25 | 10 | 4초 | 11초 | 80스터드 |
| 배틀그라운드와 전투 | 16 | 12 (28) | 15 | 20 | 6.7초 | 6초 | 약 187스터드 |
| 오픈 월드 또는 시뮬레이터 | 16 | 16 (32) | 10 | 25 | 10초 | 5초 | 320스터드 |
| 오비 또는 파쿠르 | 16 | 8 (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는 점프 요청 한 번에 여러 번 실행되고, 누르고 있는 버튼은 점프를 계속 요청할 수 있습니다 | 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을 두고, Left Shift용 InputBinding 하나, 게임패드 Y 버튼용 하나, StarterGui에 직접 그린 화면 버튼과 연결된 하나를 둡니다. 그런 다음 클라이언트 스크립트가 액션의 Pressed와 Released 이벤트를 듣고, 누르면 WalkSpeed를 두 배로 하고 떼면 되돌립니다.
조작을 코드가 아니라 Studio에서 배치하고 싶거나, ContextActionService 버튼 대신 나만의 터치 버튼을 쓰고 싶거나, 메뉴나 탈것처럼 조작 세트 전체를 바꾸는 컨텍스트가 필요하다면 옮겨 갈 만합니다. 이 페이지는 Workspace.PlayerScriptsUseInputActionSystem을 Enabled로 설정하라고도 권하며, server authority에는 이것이 필수입니다.
이 가이드의 스태미나 루프와 대시는 Input Action System만 쓸 때도(server authority 없이) 똑같이 작동합니다. MovementConfig, Heartbeat 루프, dash()는 그대로 두고, BindAction 호출 두 개와 그 핸들러를 지운 뒤 대신 액션을 연결하세요. 달리기 액션의 Pressed는 sprintHeld를 true로, Released는 false로 하고, 대시 액션의 Pressed는 dash()를 호출합니다. MovementClient처럼 매 프레임 Humanoid를 계속 찾으세요. 문서의 예제는 첫 캐릭터의 Humanoid를 저장해 두는데, 리스폰 후에는 그 Humanoid가 더 이상 없기 때문입니다.
Roblox는 Studio의 Beta Features와 Avatar Settings에서 켜는 베타인 Character Controller Library도 테스트하고 있습니다. 이 라이브러리의 커스텀 능력 페이지는 예제로 활성 구간 0.2초, 재사용 대기 1초의 대시를 만드는데, 이 가이드의 대시와 같은 타이밍입니다.
확장하기: 애니메이션, 카메라, 달리기 패스
달리기 애니메이션
Animation Editor에서 달리기 애니메이션을 만들고, 우선순위를 Movement로 정하고(Roblox는 걷기와 달리기 애니메이션에 이것을 권장합니다), 게시한 뒤 에셋 ID를 복사하세요. MovementClient에서 그 AnimationId로 Animation을 만들고, 캐릭터 Humanoid 안의 Animator를 써서 Animator:LoadAnimation으로 불러온 다음, 달리기가 시작되는 곳에서 트랙을 재생하고 끝나는 곳에서 멈추세요. 새 캐릭터마다 다시 불러오세요.
Roblox가 넣어 둔 Animator를 쓰면, 내 기기가 내 캐릭터에서 재생하는 애니메이션을 모두가 봅니다. LocalScript가 만든 Animator에 불러온 트랙은 복제되지 않습니다. 많은 예전 튜토리얼이 쓰는 Humanoid:LoadAnimation은 사용 중단되었습니다.
달리는 동안 카메라 넓히기
시야각을 조금 넓히면 달리기가 더 빠르게 느껴집니다. 같은 두 곳에서 달리기가 시작되면 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에서는 플레이어가 바꿀 수 없는 서버에서 같은 속성을 읽어 그 플레이어에게 더 큰 허용치를 주고, 새 최고 속도가 검사가 표시하는 값보다 낮은지 확인하세요.
알아 둘 제한이 하나 있습니다. 다른 스크립트가 달리기 도중에 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여야 합니다. 땅에서 떨어진 뒤에 점프를 한 번 더 누르세요. 누르고 있는 버튼은 새로 누른 것으로 계산되지 않고, 턱에서 걸어 내려가면 공중 점프가 주어지지 않습니다.
모바일에 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로 대시, 그리고 더블 점프.
- 먼저 Search Scripts와 Read Script로 플레이스를 살펴, WalkSpeed를 바꾸는 다른 스크립트(예: 게임패스 혜택)를 찾아 달리기가 그 위에 더해지게 할 수 있습니다
- Create Script로 ModuleScript, LocalScript들, 서버 검사를 작성합니다
- 작성한 스크립트마다 Check Script로 컴파일을 확인하도록 지시받으며, Check Script는 스크립트를 실행하지 않고 Studio에서 컴파일합니다
- 변경 묶음마다 앞뒤로 실행 취소 지점을 두므로, Ctrl+Z로 한 묶음씩 되돌릴 수 있습니다
RoCode는 달리기 애니메이션을 만들지 못합니다. Animation Editor에서 만들고 그 ID를 넣으세요. 플러그인 3.9.11 이상에서 RoCode는 Studio에서 게임을 플레이 테스트하고 테스트 캐릭터를 조작해 모든 것이 작동하는지 확인할 수 있으며, 플러그인 3.9.15 이상에서는 테스트 캐릭터가 키를 누를 수 있습니다. 예를 들어 Shift를 누르고 WalkSpeed가 올라갔는지 확인합니다. 플레이 테스트를 언제 할지는 RoCode가 스스로 정하며, 빌드당 최대 2번에 자기 수정을 확인하는 1번이 더해집니다. 스스로 테스트하기로 한 것만 확인하므로, 달리기, 대시, 더블 점프는 직접 해 보고, 모바일 버튼은 Studio의 Device Simulator에서 확인하세요. 이동은 게임의 여러 시스템 중 하나입니다. RoCode로 게임 전체 만들기도 여기처럼 프롬프트 하나에 시스템 하나씩 진행합니다. RoCode가 Studio에 연결되는 방식.
자주 묻는 질문
달리기 스크립트가 모바일에서 작동하지 않는 이유는 무엇인가요?
휴대폰에는 Shift 키가 없습니다. ContextActionService:BindAction으로 달리기를 연결하고 세 번째 인수로 true를 넘기세요. 그러면 ShiftToSprint와 MovementClient처럼 터치 기기의 화면에 버튼이 추가됩니다.
달리기를 서버에서 만들어야 하나요?
아니요. 각 기기가 자기 캐릭터를 움직이므로, 서버가 정한 WalkSpeed로는 스스로 값을 정할 수 있는 치터를 막지 못하고, 새 속도는 왕복 시간이 지나야 도착해서 달리기가 늦게 시작됩니다. 달리기는 클라이언트에서 만들고, 5단계처럼 서버에서는 캐릭터가 실제로 얼마나 멀리 움직이는지 검사하세요. Roblox의 server authority 베타는 방식이 달라서, 이동 코드를 다시 써야 합니다.
Shift를 뗐는데 캐릭터가 계속 달리는 이유는 무엇인가요?
스크립트가 떼는 순간을 놓친 것으로, 보통 누르는 것만 듣기 때문입니다. ContextActionService는 키를 떼면 End를, 다른 연결이 키를 가로채면 Cancel을 보냅니다. MovementClient는 둘 다에서 멈추고, 스태미나가 바닥나거나 캐릭터가 움직임을 멈출 때도 멈춥니다.
달리기 애니메이션은 어떻게 추가하나요?
같은 LocalScript에서 캐릭터 Humanoid의 Animator로 달리기 애니메이션을 불러오고, 달리기가 시작되면 재생하고 끝나면 멈추세요. 우선순위는 Movement로 하세요. 내 캐릭터에서 재생한 애니메이션은 모두가 봅니다.
모바일에서 더블 점프가 저절로 되는 이유는 무엇인가요?
모바일에서 누르고 있는 점프 버튼은 점프를 계속 요청합니다. DoubleJump 스크립트처럼, 요청이 잠깐 멈췄을 때만 점프를 새것으로 보세요.
Roblox의 기본 걷기 속도는 얼마인가요?
초당 16스터드입니다. 이 값은 새 캐릭터마다 Humanoid.WalkSpeed를 정하는 StarterPlayer.CharacterWalkSpeed에서 옵니다. 이 가이드의 달리기는 10을 더하므로 26으로 달립니다.
Roblox에서 달리기는 얼마나 빨라야 하나요?
대부분의 게임은 걷기 속도의 절반에서 한 배만큼을 더합니다. 16이 24에서 32 사이가 됩니다. 짧고 느린 달리기는 호러에, 길고 빠른 달리기는 큰 맵에 맞습니다. 게임 장르별 프리셋에 장르마다 걷기 속도, 달리기 보너스, 스태미나 숫자가 있습니다.
스태미나가 있는 달리기는 어떻게 만드나요?
스태미나 숫자를 플레이어 기기에 두고, 달리는 동안 매 프레임 줄이고 잠깐 쉰 뒤 회복하되 두 경우 모두 프레임 시간을 반영하고, 0이 되면 달리기를 멈추세요. 3단계의 MovementClient가 화면의 바와 함께 이렇게 하며, 숫자는 MovementConfig에 있습니다.
Roblox에서 컨트롤러로 달리려면 어떻게 하나요?
여기의 두 스크립트처럼 ContextActionService로 게임패드의 ButtonL3(왼쪽 스틱 누르기)를 Left Shift와 함께 연결하세요. 스틱을 누른 채로 동시에 방향을 조작하는 것은 피곤하므로 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
코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.