Коротко
Положите один LocalScript в StarterPlayerScripts, который привязывает действие Sprint через ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3). Пока Shift зажат, прибавляйте 10 к Humanoid.WalkSpeed (16 становится 26), а при отпускании возвращайте прежнее значение. Аргумент true добавляет кнопку Sprint на сенсорных экранах, и в скрипте из этого гайда эта кнопка и 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: бег на Shift в одном LocalScript
Если вам нужен только более быстрый бег, пока зажат Shift, хватит одного этого скрипта. Он ещё даёт телефонам кнопку Sprint на экране, а на геймпаде позволяет бежать левым стиком.
- В Explorer разверните StarterPlayer, наведите на StarterPlayerScripts, нажмите кнопку + и вставьте LocalScript с именем
ShiftToSprint. - Замените его содержимое кодом ниже и нажмите Play.
-- LocalScript в StarterPlayer > StarterPlayerScripts с именем ShiftToSprint.
-- Зажмите 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 стадов в секунду, а если отпустить, вы замедлитесь. Для телефона выберите телефон в Device Simulator в Studio, нажмите 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 во время бега. WalkSpeed в Roblox по умолчанию 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 | Сколько длится рывок: около 12 стадов при 60 стадах в секунду. |
DASH_COST | 25 | Стамина на каждый рывок. |
DASH_COOLDOWN | 1 | Секунды между рывками. |
Каждая сторона запускает свою копию модуля (модуль выполняется один раз на каждой стороне), поэтому игрок, который меняет эти числа на своём устройстве, меняет только свою копию. Но здесь это ничего не защищает: его устройство и так двигает его персонажа, поэтому может дать себе бесконечную стамину, что бы ни было в модуле. Серверная проверка из Шага 5 построена с учётом этого.
Шаг 3: бег со стаминой и рывок
Этот LocalScript делает то, что чувствуют игроки. Он привязывает Sprint и Dash, рисует полоску стамины, каждый кадр крутит цикл стамины и делает рывок.
- В Explorer разверните StarterPlayer, наведите на StarterPlayerScripts и вставьте LocalScript с именем
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
-- LinearVelocity в режиме Plane держит горизонтальную скорость и не мешает гравитации
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 добавит кнопку на экран на сенсорных устройствах, внутри ScreenGui с именем ContextActionGui в PlayerGui игрока. SetTitle пишет на этих кнопках "Sprint" и "Dash". BindAction может создать не больше 7 сенсорных кнопок, так что следите за количеством, если их используют и другие скрипты в игре.
Обработчик получает состояние ввода: Begin при нажатии и End при отпускании. onSprint только запоминает, зажат ли Sprint. Он считает отпусканием и Cancel, который ContextActionService шлёт, когда ввод перехватывает другая привязка, и игнорирует Change, который может прислать палец, двигающийся по сенсорной кнопке. Оба обработчика возвращают Pass, поэтому следующая привязка на той же клавише тоже получает ввод.
Справка Roblox по ContextActionService советует его вместо UserInputService.InputBegan в большинстве случаев. Её пример: гудок машины на H, который не должен гудеть, пока игрок пишет в чат. Привязка срабатывает, только пока она последняя для этого ввода, поэтому, когда чат забирает клавиатуру, вам ничего не нужно проверять. Вводы геймпада: ButtonL3 (нажатие на левый стик, его держат во время движения) и ButtonB. В собственном примере бега у Roblox используется ButtonY, так что поменяйте KeyCode в BindAction, если вашей игре так удобнее.
Цикл стамины
RunService.Heartbeat срабатывает каждый кадр после шага физики и передаёт deltaTime, число секунд с прошлого кадра. Если умножать на него скорость расхода и восстановления, полной полоски хватит на 5 секунд, идёт ли игра на 30 или на 240 кадрах в секунду.
Каждый кадр цикл решает, должен ли персонаж бежать: 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 секунду. Земля в нём не проверяется, поэтому он работает и в воздухе, что хорошо сочетается с двойным прыжком. Пока персонаж сидит, рывок ничего не делает: сидящий персонаж приварен к сиденью, и в транспорте толчок мог бы сдвинуть весь транспорт.
Толчок это ограничение LinearVelocity на RootAttachment корневого парта. В режиме Plane с осями X и Z оно держит горизонтальную скорость 60 стадов в секунду и не трогает вертикаль, поэтому гравитация работает, и рывок с уступа падает как обычно. MaxForce равен math.huge, так что толчок ничем не ограничен. Debris:AddItem уничтожает ограничение через DASH_SECONDS, не заставляя скрипт ждать, поэтому рывок длится 0.2 секунды, около 12 стадов на этой скорости.
Старые туториалы используют BodyVelocity, который Roblox пометил как устаревший с пометкой использовать вместо него LinearVelocity. Его трюк с нулевым MaxForce по одной оси заменяют режимы Line, Plane и Vector у LinearVelocity. Поскольку устройство игрока само симулирует своего персонажа, ограничение, созданное LocalScript, двигает его, и другие игроки видят рывок как любое другое движение.
Собственный туториал Roblox по UI крепит ограничение к humanoid.RootPart.RootAttachment точно так же. Если в вашей игре свой персонаж, у корневого парта которого нет Attachment с именем RootAttachment, рывок ничего не делает: добавьте его в HumanoidRootPart вашего StarterCharacter.
Шаг 4: двойной прыжок
Двойной прыжок живёт в своём LocalScript в StarterCharacterScripts. Roblox кладёт копию скриптов из этого контейнера в каждого персонажа при спавне, и эти копии не переживают респавн, поэтому каждая жизнь начинается со свежего скрипта, и ничего не переносится из прошлой.
- В Explorer разверните StarterPlayer, наведите на StarterCharacterScripts и вставьте LocalScript с именем
DoubleJump. - Замените его содержимое кодом ниже.
-- Даёт один дополнительный прыжок в воздухе. Запускается заново для каждого нового персонажа,
-- поэтому после респавна ничего не переносится.
local UserInputService = game:GetService("UserInputService")
local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local EXTRA_JUMPS = 1
local MIN_SECONDS_BETWEEN_JUMPS = 0.25 -- JumpRequest срабатывает несколько раз на одно нажатие
local NEW_PRESS_GAP = 0.1 -- зажатая кнопка прыжка продолжает слать JumpRequest; пауза такой длины значит, что её отпустили
local jumpsLeft = 0
local lastJump = 0
local lastRequest = 0
humanoid.StateChanged:Connect(function(oldState: Enum.HumanoidStateType, newState: Enum.HumanoidStateType)
if newState == Enum.HumanoidStateType.Jumping and oldState ~= Enum.HumanoidStateType.Freefall then
-- Прыжок с земли (не один из наших прыжков в воздухе) восстанавливает прыжки в воздухе
jumpsLeft = EXTRA_JUMPS
lastJump = os.clock()
elseif newState == Enum.HumanoidStateType.Landed then
jumpsLeft = 0
end
end)
-- JumpRequest срабатывает, когда игрок просит прыжок, например через Space или кнопку прыжка на телефоне
UserInputService.JumpRequest:Connect(function()
local now = os.clock()
local newPress = now - lastRequest > NEW_PRESS_GAP
lastRequest = now
-- Снова прыгает только новое нажатие, чтобы зажатая кнопка не тратила прыжок в воздухе
if not newPress or jumpsLeft <= 0 or now - lastJump < MIN_SECONDS_BETWEEN_JUMPS then
return
end
if humanoid:GetState() == Enum.HumanoidStateType.Freefall then
jumpsLeft -= 1
lastJump = now
humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
end
end)
Поставьте EXTRA_JUMPS равным 2 для тройного прыжка.
Скрипт следит за состоянием персонажа через Humanoid.StateChanged. Переход в Jumping, который пришёл не из Freefall, это прыжок с земли, поэтому он выдаёт прыжок в воздухе, а Landed снова его забирает. Если сойти с уступа, персонаж попадает в Freefall без прыжка, поэтому прыжка в воздухе не получает. Если он нужен и там, задавайте jumpsLeft ещё и при переходе в Freefall из любого состояния, кроме Jumping.
UserInputService.JumpRequest срабатывает, когда игрок просит прыжок, например через Space или кнопку прыжка на телефоне. Справка Roblox предупреждает, что он срабатывает несколько раз на один запрос прыжка, и советует дебаунс, поэтому скрипт игнорирует запросы в течение 0.25 секунды после последнего прыжка. Зажатая кнопка прыжка тоже может продолжать запрашивать прыжки и потратила бы прыжок в воздухе в тот же миг, как персонаж оторвётся от земли, поэтому запрос считается новым нажатием только после 0.1 секунды без запросов.
Сам прыжок в воздухе это Humanoid:ChangeState(Enum.HumanoidStateType.Jumping). Справка Roblox говорит, что его нужно вызывать из LocalScript на устройстве, у которого есть сетевое владение персонажем, а по умолчанию это устройство самого игрока, а не сервер. Пример кода к ChangeState в справке как раз двойной прыжок.
Шаг 5: ловим спидхак на сервере
Туториалы по бегу часто останавливаются на клиенте. Серверный Script не может доверять WalkSpeed игрока, потому что эксплойтеры меняют её на своём устройстве, но он видит, где оказывается их персонаж. MovementCheck измеряет это дважды в секунду и пишет предупреждение в Output, когда кто-то долго движется быстрее, чем позволяют бег и рывок. Числа бега и рывка он читает из MovementConfig, так что добавьте этот модуль из Шага 2, даже если оставили ShiftToSprint.
- Наведите на ServerScriptService и вставьте Script с именем
MovementCheck. - Замените его содержимое кодом ниже.
-- Устройства игроков двигают своих персонажей, поэтому эксплойтер может выставить любую WalkSpeed.
-- Эта проверка измеряет, как далеко на самом деле двигается каждый персонаж, и пишет в Output,
-- когда кто-то долго движется быстрее, чем позволяют бег и рывок. Она только предупреждает:
-- лаг, телепорты и конвейеры могут выглядеть как превышение скорости, так что настройте её, прежде чем кого-то наказывать.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local StarterPlayer = game:GetService("StarterPlayer")
type Config = { SPRINT_BONUS: number, DASH_SPEED: number, DASH_SECONDS: number }
local Config = require(ReplicatedStorage:WaitForChild("MovementConfig")) :: Config
local CHECK_EVERY = 0.5 -- секунды
-- Скорость бега плюс запас на лаг. Увеличьте, если продаёте ускорения.
local SPEED_ALLOWANCE = (StarterPlayer.CharacterWalkSpeed + Config.SPRINT_BONUS) * 1.25
local BURST_ALLOWANCE = Config.DASH_SPEED * Config.DASH_SECONDS * 2 -- запас на один или два рывка
local DRAIN_PER_CHECK = BURST_ALLOWANCE / 8 -- как быстро прощаются прошлые рывки
local lastPosition: { [Player]: Vector3 } = {}
local lastRoot: { [Player]: BasePart } = {} -- корневой парт, на котором измерена lastPosition
local excess: { [Player]: number } = {} -- стады сверх допуска, постепенно прощаются
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
Предупреждение появляется в Output в Studio. В живой игре оно попадает в серверный лог Developer Console, который вы можете читать как владелец игры: смотрите вывод в живой игре.
Что она измеряет
Каждые полсекунды скрипт читает позицию корневого парта каждого персонажа и измеряет, насколько он сдвинулся по горизонтали с прошлой проверки. Высота игнорируется, поэтому падения и прыжки никогда не считаются; совет Roblox по проверке движения предлагает ту же проекцию на плоскость XZ для игр, где ходят по земле. Допуск это скорость ходьбы по умолчанию плюс бонус бега и ещё четверть на лаг: 32.5 стада в секунду. Расстояние сверх этого попадает в «дырявое ведро», накопитель, про который в документации Roblox сказано, что многим разработчикам он хорошо подходит для коротких рывков. Ведро теряет 3 стада каждую проверку, а скрипт предупреждает, когда в нём больше 24 стадов, это запас примерно на два рывка.
| Читер | Что делает MovementCheck |
|---|---|
| Ставит WalkSpeed 100 | Предупреждает примерно через секунду бега |
| Ставит WalkSpeed 50 | Предупреждает примерно через 2.5 секунды бега |
| Делает рывки подряд без перезарядки (60 стадов в секунду) | Предупреждает примерно через 1.5 секунды |
| Телепортируется больше чем на 43 стада за раз | Предупреждает на следующей проверке |
| Бежит со скоростью до 38 стадов в секунду, примерно в полтора раза быстрее бега | Ничего: ниже 38.5 стада в секунду ведро опустошается так же быстро, как наполняется |
| Меняет свой MovementConfig ради бесконечной стамины | Ничего: бег на 26 стадах в секунду разрешён сколько угодно долго |
| Летает, прыгает без ограничений или проходит сквозь стены | Ничего: проверка игнорирует высоту и не смотрит на столкновения |
Значит, проверка ловит грубые читы, при которых игрок заметно быстрее всех остальных, и пропускает аккуратные. Это честный предел проверки по расстоянию и причина, по которой Roblox делает что-то посильнее (смотрите server authority ниже).
Почему она только предупреждает
В документации Roblox отмечено, что простые проверки скорости могут отмечать честных игроков с нестабильным соединением и ломаются в играх с транспортом или другим сложным движением. Скачки лага, конвейеры, транспорт, взрывы, которые отбрасывают персонажей, и ваши собственные телепорты могут выглядеть как превышение скорости, поэтому скрипт только печатает предупреждение. Смотрите в Output, пока вы и ваши тестеры играете как обычно, увеличьте SPEED_ALLOWANCE, если на нём спотыкаются честные игроки, и добавляйте наказание, например возврат игрока назад, только когда проверка молчит в обычной игре. Если в вашей игре взрывы отбрасывают персонажей, пропускайте ещё и игроков, у чьего Humanoid не осталось здоровья.
Респавны и телепорты
Респавн создаёт новый корневой парт, и скрипт начинает измерять заново, когда его видит, поэтому смерть далеко от точки спавна никогда не считается превышением скорости. Телепортам, которые делают ваши собственные серверные скрипты, нужно исключение, как сказано в документации Roblox для любой игры с телепортами. После телепорта добавьте player:SetAttribute("MovementCheckSkip", true), и следующая проверка начнёт измерять с новой позиции, а не отметит скачок:
- В системе раундов сразу после
character:PivotTo(...)вstartRound. - В скрипте чекпоинтов для обби сразу после каждого
character:PivotTo(...), который переносит игрока на его чекпоинт.
Пады и меню из гайда по телепортам и пад Finish из гайда по первой игре уже ставят его после каждого перемещения.
Считается только значение с сервера. Атрибут, который игрок ставит на своём устройстве, остаётся на этом устройстве (смотрите что реплицируется, а что нет), поэтому читер не может выключить им проверку.
Решение на будущее: server authority
Документация Roblox по безопасности называет модель server authority, на момент написания в бете, самым надёжным способом остановить эксплойты движения. Источником правды становится сервер, а устройства игроков только сообщают свой ввод, что, по словам документации, не даёт работать спидхакам, потому что устройству никогда не доверяют сообщать собственную позицию.
Переход это переписывание, а не настройка. В этой модели движение считает сервер, поэтому WalkSpeed или LinearVelocity, которые выставляет только LocalScript, отменяются, когда приходит состояние с сервера. В документации Roblox сказано, что основная логика должна работать в функциях RunService:BindToSimulation() в ModuleScript, который запускают и клиент, и сервер. Модели также нужны несколько настроек Workspace, включая PlayerScriptsUseInputActionSystem, так что ваше управление тоже переедет на Input Action System. Оставьте версию из этого гайда, пока не перенесёте бег, стамину и рывок в эту схему. До тех пор проверка по расстоянию, как эта, и есть то, что описывает раздел Roblox о проверке движения.
Шаг 6: проверьте на каждом устройстве
- Нажмите Play и держите Shift во время ходьбы. Скорость растёт с 16 до 26 стадов в секунду, а зелёная полоска внизу экрана уменьшается. Примерно через 5 секунд она пуста, и вы снова идёте шагом.
- Отпустите Shift. Через 1 секунду полоска начинает заполняться. Пока она не заполнится на пятую часть, Shift ничего не делает.
- Нажмите Q во время ходьбы: вы немного проноситесь вперёд, и четверти полоски нет. Нажмите Q сразу ещё раз, и ничего не случится, пока не пройдёт секунда. Если рывок кажется слишком коротким или длинным, поменяйте
DASH_SPEEDилиDASH_SECONDSв MovementConfig. - Прыгните, затем нажмите прыжок ещё раз в воздухе для второго прыжка. Приземлитесь и попробуйте снова: каждый прыжок с земли возвращает прыжок в воздухе.
- Держите Space зажатым весь прыжок. Должен получиться один прыжок, а не два, потому что прыжку в воздухе нужно новое нажатие.
- Включите Device Simulator в Studio (на момент написания это бета: File, Beta Features, New Device Simulator, затем перезапустите Studio) или включите старый Device Emulator в меню Test. Выберите телефон и нажмите Play. Появятся кнопки Sprint и Dash. Держите Sprint, пока рулите, затем держите кнопку прыжка весь прыжок и проверьте, что прыжок только один.
- Откройте Controller Emulator (Controller на вкладке Emulation или Virtual controller на панели Device Simulator). Держите L3 во время движения, чтобы бежать, нажмите B для рывка и A дважды для двойного прыжка.
- Сбросьте персонажа через меню игры. Полоска снова полная, в Output нет предупреждения MovementCheck, а если вы всё ещё симулируете телефон, кнопки Sprint и Dash на месте.
- Теперь сыграйте за читера. Нажимайте переключатель Client/Server, пока Explorer не покажет клиент, выделите Humanoid своего персонажа в Workspace и поставьте WalkSpeed равным 60 в окне Properties. Походите несколько секунд: в Output появится предупреждение вроде
MovementCheck: YourName moved 60 studs/s. Верните 16, затем минуту бегайте и делайте рывки как обычно и проверьте, что Output молчит. - Если в вашем плейсе
Workspace.PlayerScriptsUseInputActionSystemстоит в Enabled, проверьте двойной прыжок ещё раз: документация Roblox не говорит, ведёт ли себяJumpRequestс ним так же.
Если не происходит вообще ничего, откройте окно Output через меню Window в Studio и поищите красную ошибку от 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 подстраивается. Он разрешает скорость ходьбы плюс бонус бега и ещё четверть на лаг: 25 стадов в секунду для пресета хоррора, 40 для открытого мира. Больше ничего менять не нужно.
- В обби бег меняет трассу. С более быстрым бегом перепрыгиваются более длинные пропасти. Постройте прыжки, а затем проверьте каждый на скорости бега, иначе бег сделает этапы слишком лёгкими. Гайд по чекпоинтам для обби хорошо сочетается с ShiftToSprint.
- В хорроре ориентир это убийца. Сделайте преследователя чуть быстрее скорости ходьбы и чуть медленнее бега, чтобы побег зависел от того, когда кончится полоска. Гайд по хоррор-игре разбирает остальной цикл.
Что не так со старыми скриптами бега
Старые туториалы по бегу, рывку и двойному прыжку часто всё ещё работают, но многие используют приёмы, которые Roblox с тех пор заменил, или ломают другие системы в вашей игре. Если вы чините скопированный скрипт, сверьте его с этим списком.
| Приём | В чём проблема | Этот гайд |
|---|---|---|
BodyVelocity для рывка | Устарел: Roblox говорит использовать вместо него LinearVelocity | LinearVelocity в режиме Plane |
Цикл на RunService.RenderStepped | Для новой работы его заменил PreRender. Игровой логике вроде стамины место на Heartbeat, который Roblox описывает для периодических задач, таких как восстановление здоровья | Heartbeat с deltaTime |
Цикл стамины на 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: InputAction с именем CharacterSprint внутри input context в ReplicatedStorage, с одним InputBinding для Left Shift, одним для кнопки 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(). Продолжайте искать Humanoid каждый кадр, как это делает MovementClient, потому что пример из документации сохраняет Humanoid первого персонажа, а после респавна его уже нет.
Roblox также тестирует Character Controller Library, бету, которую включают в Beta Features и Avatar Settings в Studio. Её страница про свои способности строит в качестве примера рывок с активным окном 0.2 секунды и перезарядкой 1 секунда, то есть с тем же таймингом, что у рывка из этого гайда.
Как расширить: анимация, камера и пасс на бег
Анимация бега
Сделайте анимацию бега в Animation Editor, поставьте ей приоритет Movement (Roblox рекомендует его для анимаций ходьбы и бега), опубликуйте её и скопируйте ID ассета. В MovementClient создайте Animation с этим AnimationId, загрузите её через Animator:LoadAnimation, используя Animator внутри Humanoid персонажа, запускайте трек там, где начинается бег, и останавливайте там, где он заканчивается. Загружайте её заново для каждого нового персонажа.
Анимации, которые ваше устройство запускает на вашем персонаже, видят все, если вы используете Animator, который туда положил Roblox: треки, загруженные на Animator, созданный LocalScript, не реплицируются. 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.
Для пасса, который ускоряет сам бег, добавьте пасс FastSprint в PassConfig.ids из того гайда. Его серверный скрипт тогда ставит игроку атрибут OwnsPass_FastSprint, как только покупка подтверждена. В MovementClient используйте бонус больше Config.SPRINT_BONUS, когда player:GetAttribute("OwnsPass_FastSprint") == true. В MovementCheck дайте таким игрокам больший допуск, читая тот же атрибут на сервере, где игрок не может его изменить, и проверьте, что новая максимальная скорость остаётся ниже того, что отмечает проверка.
Одно ограничение, о котором стоит знать: если другой скрипт меняет WalkSpeed посреди бега, конец этого бега вернёт скорость, которая была до него. Следующий респавн снова выставит скорость пасса, потому что скрипт геймпасса применяет её к каждому новому персонажу.
Частые ошибки и решения
Откройте окно Output (меню Window, затем Output) до нажатия Play. Большинство проблем с этими скриптами печатает там ошибку или предупреждение с именем скрипта и номером строки.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("MovementConfig")'
MovementClient или MovementCheck ждёт модуль, которого нет под точно таким именем. Это должен быть ModuleScript с именем MovementConfig прямо внутри ReplicatedStorage. Гайд по ошибкам скриптов подробно разбирает это предупреждение.
Shift ничего не делает
Проверьте, что ShiftToSprint или MovementClient это LocalScript, а не Script, и что он лежит в StarterPlayerScripts. С MovementClient для старта бега персонаж ещё должен идти и иметь хотя бы 20 стамины, так что держите Shift во время движения. Если вместо бега переключается Shift Lock, смотрите вопрос про Shift Lock ниже.
Бег прекращается через несколько секунд
Это кончается стамина: 100 стамины по 20 в секунду хватает на 5 секунд. Увеличьте MAX_STAMINA или уменьшите DRAIN_PER_SECOND в MovementConfig.
Рывок ничего не делает
Рывку нужно 25 стамины, он ждёт 1 секунду после прошлого и ничего не делает, пока вы сидите. Если дело не в этом, у корневого парта вашего персонажа может не быть Attachment с именем RootAttachment, так бывает с некоторыми своими персонажами: добавьте его в HumanoidRootPart вашего StarterCharacter.
Двойной прыжок не срабатывает
DoubleJump должен быть LocalScript в StarterCharacterScripts, а не в StarterPlayerScripts, потому что он читает script.Parent как персонажа. Нажмите прыжок второй раз после отрыва от земли: зажатая кнопка не считается новым нажатием, а сход с уступа прыжка в воздухе не даёт.
На телефоне нет кнопки Sprint или Dash
ContextActionService добавляет свои кнопки только на сенсорных устройствах, поэтому на ПК без сенсорного экрана их никогда не видно. Проверяйте с телефоном в Device Simulator в Studio (это бета: включите New Device Simulator в File, Beta Features и перезапустите Studio). BindAction может создать не больше 7 сенсорных кнопок, так что посчитайте, сколько их делают другие скрипты в игре.
MovementCheck ругается на честных игроков
Обычные причины: телепорт из другого серверного скрипта, конвейер или транспорт, или лаг. Ставьте атрибут MovementCheckSkip после своих телепортов (смотрите Респавны и телепорты) и увеличьте SPEED_ALLOWANCE, если проверка всё ещё срабатывает в обычной игре.
Ускорение пропадает после бега
Другой скрипт поменял WalkSpeed во время бега, а бег, закончившись, вернул скорость, которую видел на старте. Давайте ускорения при спавне персонажа, как делает гайд по геймпассам, чтобы респавн снова выставлял правильную скорость.
Сделать с RoCode
Если не хочется настраивать всё это вручную, RoCode может собрать это в открытом у вас плейсе. RoCode это независимый ИИ-агент для Roblox Studio, не от Roblox: вы описываете изменение в веб-чате, а его плагин для Studio создаёт скрипты в вашем Explorer, так что вставлять код не нужно.
Добавь бег на Shift с полоской стамины: скорость ходьбы плюс 10, пока зажат Shift, 100 стамины, расход 20 в секунду, восстановление 15 в секунду после секунды отдыха, кнопка Sprint на телефонах, рывок на Q и двойной прыжок.
- Может сначала просмотреть ваш плейс через Search Scripts и Read Script, чтобы найти другие скрипты, которые меняют WalkSpeed (например, перк геймпасса), и бег прибавлялся к ним
- Пишет ModuleScript, LocalScript'ы и серверную проверку через Create Script
- Ему велено проверять компиляцию каждого написанного скрипта через Check Script, который компилирует его в Studio без запуска
- Ставит точку отмены до и после каждой пачки изменений, поэтому Ctrl+Z откатывает по одной пачке
RoCode не умеет делать анимацию бега: создайте её в Animation Editor и вставьте её ID. С плагином 3.9.11 или новее RoCode может запустить плейтест вашей игры в Studio и управлять тестовым персонажем, чтобы проверить, что всё работает, а с плагином 3.9.15 или новее тестовый персонаж может нажимать клавиши, например держать Shift и проверять, что WalkSpeed выросла. Он сам решает, когда запускать плейтест, до 2 за сборку плюс 1, чтобы проверить своё исправление, и проверяет только то, что сам решил протестировать, поэтому бег, рывок и двойной прыжок попробуйте сами, а кнопки на телефоне проверьте в Device Simulator в Studio. Движение это одна система из многих в игре; создание целой игры с RoCode идёт по одной системе на промпт, как здесь. Как RoCode подключается к Studio.
Частые вопросы
Почему скрипт бега не работает на телефоне?
У телефона нет клавиши Shift. Привязывайте бег через ContextActionService:BindAction и передавайте true третьим аргументом: это добавляет кнопку на экран на сенсорных устройствах, как делают и ShiftToSprint, и MovementClient.
Нужно ли делать бег на сервере?
Нет. Каждое устройство двигает своего персонажа, поэтому WalkSpeed, выставленная сервером, не остановит читера, который может выставить свою, а новая скорость приходит только после пути туда и обратно, так что бег начинается с задержкой. Делайте бег на клиенте, а на сервере проверяйте, как далеко на самом деле двигаются персонажи, как в Шаге 5. Бета server authority от Roblox устроена иначе, и код движения для неё придётся переписать.
Почему персонаж продолжает бежать, когда я отпустил Shift?
Скрипт пропустил отпускание, обычно потому, что слушает только нажатие. ContextActionService шлёт End, когда клавишу отпускают, и Cancel, когда её перехватывает другая привязка; MovementClient останавливается на обоих, а ещё когда кончается стамина или персонаж перестаёт двигаться.
Как добавить анимацию бега?
Загрузите анимацию бега через Animator в Humanoid персонажа в том же LocalScript, запускайте её, когда бег начинается, и останавливайте, когда он заканчивается. Дайте ей приоритет Movement. Анимации, запущенные на вашем собственном персонаже, видят все.
Почему двойной прыжок на телефоне срабатывает сам?
Зажатая кнопка прыжка на телефоне продолжает запрашивать прыжки. Считайте прыжок новым, только если запросы на мгновение прекратились, как делает скрипт DoubleJump.
Какая скорость ходьбы в Roblox по умолчанию?
16 стадов в секунду. Она берётся из StarterPlayer.CharacterWalkSpeed, который задаёт Humanoid.WalkSpeed каждого нового персонажа. Бег из этого гайда прибавляет 10, так что бег идёт на 26.
Какой скорости должен быть бег в Roblox?
Большинство игр прибавляет от половины до целой скорости ходьбы: 16 становится чем-то от 24 до 32. Короткий медленный бег подходит хоррору, а длинный быстрый большим картам. Пресеты по типу игры дают для каждого скорость ходьбы, бонус бега и числа стамины.
Как сделать бег со стаминой?
Храните число стамины на устройстве игрока, тратьте его каждый кадр во время бега и восстанавливайте после короткого отдыха, оба раза с учётом времени кадра, и останавливайте бег, когда оно дошло до 0. MovementClient из Шага 3 делает это с полоской на экране; числа лежат в MovementConfig.
Как бегать с контроллером в Roblox?
Привяжите ButtonL3 геймпада (нажатие на левый стик) через ContextActionService вместе с Left Shift, как делают оба скрипта здесь. ShiftToSprint делает L3 переключателем, потому что держать стик вдавленным и одновременно рулить им утомительно.
Конфликтует ли бег на Shift с Shift Lock?
Может. Игроки, которые включили Shift Lock в настройках Roblox, переключают его клавишей Shift, так что одна клавиша делает две вещи. В документации Roblox сказано, что API Shift Lock выводятся из использования. Если конфликт мешает вашим игрокам, выключите 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 (на английском). пример Character Sprint с InputAction и InputBinding
- Roblox Creator Docs: Custom abilities (на английском). способность рывка в Character Controller Library
- Roblox Creator Docs: Studio testing modes (на английском). Device Simulator и Controller Emulator
Как проверялся код: каждый скрипт на этой странице проходит строгую проверку типов Luau с определениями Roblox API (luau-lsp, 14 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.