Туторіал · Ігрові системи

Як зробити біг на Shift у Roblox Studio для ПК, телефона і консолі

Біг на Shift у Roblox зводиться до одного числа: WalkSpeed у Humanoid, яке росте, поки затиснуто Shift. Крок 1 робить саме це в одному короткому LocalScript, який працює і з кнопкою Sprint на телефоні, і з геймпадом. Решта гайду додає те, що потрібно великій грі: смужку стаміни, ривок на сучасній фізиці, подвійний стрибок, який не спрацьовує від затиснутої кнопки, і розуміння того, що сервер може перевірити, а що ні.

Оновлено 20 листопада 2026 р.23 хв читанняАвтор:

Коротко

Покладіть один 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. Наскільки швидко і як довго бігти, підкажуть пресети за типом гри з числами для хорору, бойовки й відкритого світу.
На цій сторінці
  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 робить ривок за чверть смужки, а друге натискання стрибка в повітрі стрибає ще раз.

Пристрій кожного гравця рухає його власного персонажа. Клавіатура, контролер або сенсорний екран вирішують, куди йде персонаж, а Roblox передає результат серверу і всім іншим. Тому біг це LocalScript, який піднімає Humanoid.WalkSpeed, поки затиснуто клавішу, і це все, що робить Крок 1. Решта гайду це те, що потрібно великій грі навколо нього: смужка стаміни, ривок, подвійний стрибок і серверна перевірка для чітерів.

З чого складається система руху
ЕлементДе знаходитьсяЩо робить
LocalScript ShiftToSprintStarterPlayerScriptsКрок 1 сам по собі: біг на клавіатурі, телефоні й геймпаді, без стаміни. Коли ви додаєте стаміну й ривок, його замінює MovementClient.
ModuleScript MovementConfigReplicatedStorageЧисла: бонус бігу, стаміна і ривок. Їх читають і LocalScript, і серверна перевірка.
LocalScript MovementClientStarterPlayerScriptsПрив'язує Sprint і Dash до клавіші, кнопки геймпада і сенсорної кнопки, крутить цикл стаміни, малює смужку й робить ривок.
LocalScript DoubleJumpStarterCharacterScriptsДає один додатковий стрибок у повітрі. Нова копія запускається в кожному новому персонажі.
Script MovementCheckServerScriptServiceВимірює, як далеко насправді рухається кожен персонаж, і пише попередження в Output, коли хтось довго рухається швидше, ніж дозволяють біг і ривок.
Explorer, коли система руху готова
ReplicatedStorage
  MovementConfig ModuleScript new
ServerScriptService
  MovementCheck Script new
StarterPlayer
  StarterCharacterScripts
    DoubleJump LocalScript new
  StarterPlayerScripts
    MovementClient LocalScript new

Якщо різниця між Script і LocalScript для вас нова, Script, LocalScript і ModuleScript пояснює, де запускається кожен вид і чому.

Крок 1: біг на Shift в одному LocalScript

Якщо вам потрібен лише швидший біг, поки затиснуто Shift, вистачить одного цього скрипта. Він ще дає телефонам кнопку Sprint на екрані, а на геймпаді дозволяє бігти лівим стиком.

  1. В Explorer розгорніть StarterPlayer, наведіть на StarterPlayerScripts, натисніть кнопку + і вставте LocalScript з іменем ShiftToSprint.
  2. Замініть його вміст кодом нижче й натисніть Play.
LocalScript у StarterPlayerScripts з назвою ShiftToSprint
-- 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 лише скидає прапорець.

Утримання чи перемикання?

Як ShiftToSprint працює на кожному пристрої, коли TOGGLE_ON_TOUCH_AND_GAMEPAD дорівнює true
Пристрій і ввідПрацює якЧому
Клавіатура: 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 читає той самий модуль на сервері, щоб знати, якою має бути швидкість бігу й ривка.

  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 під час бігу. WalkSpeed у Roblox за замовчуванням 16, тому біг іде зі швидкістю 26 стадів за секунду.
MAX_STAMINA100Повна смужка.
DRAIN_PER_SECOND20Повної смужки вистачає на 5 секунд бігу.
REGEN_PER_SECOND15Порожня смужка заповнюється приблизно за 6.7 секунди.
REGEN_DELAY1Секунди відпочинку до початку відновлення.
MIN_TO_START20Стаміна, потрібна, щоб почати біг.
DASH_SPEED60Стадів за секунду під час ривка.
DASH_SECONDS0.2Скільки триває ривок: близько 12 стадів при 60 стадах за секунду.
DASH_COST25Стаміна на кожен ривок.
DASH_COOLDOWN1Секунди між ривками.

Кожна сторона запускає свою копію модуля (модуль виконується один раз на кожній стороні), тому гравець, який змінює ці числа на своєму пристрої, змінює лише свою копію. Але тут це нічого не захищає: його пристрій і так рухає його персонажа, тому може дати собі нескінченну стаміну, хоч що було б у модулі. Серверна перевірка з Кроку 5 побудована з урахуванням цього.

Крок 3: біг зі стаміною і ривок

Цей LocalScript робить те, що відчувають гравці. Він прив'язує Sprint і Dash, малює смужку стаміни, щокадру крутить цикл стаміни й робить ривок.

  1. В Explorer розгорніть StarterPlayer, наведіть на StarterPlayerScripts і вставте LocalScript з іменем MovementClient.
  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

	-- 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 кладе копію скриптів із цього контейнера в кожного персонажа під час спавну, і ці копії не переживають респавн, тому кожне життя починається зі свіжого скрипта, і нічого не переноситься з минулого.

  1. В Explorer розгорніть StarterPlayer, наведіть на StarterCharacterScripts і вставте LocalScript з іменем DoubleJump.
  2. Замініть його вміст кодом нижче.
LocalScript у StarterCharacterScripts з назвою DoubleJump
-- Дає один додатковий стрибок у повітрі. Запускається заново для кожного нового персонажа,
-- тому після респавну нічого не переноситься.

local UserInputService = game:GetService("UserInputService")

local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid

local EXTRA_JUMPS = 1
local MIN_SECONDS_BETWEEN_JUMPS = 0.25 -- JumpRequest спрацьовує кілька разів на одне натискання
local NEW_PRESS_GAP = 0.1 -- затиснута кнопка стрибка й далі надсилає JumpRequest; пауза такої довжини означає, що її відпустили

local jumpsLeft = 0
local lastJump = 0
local lastRequest = 0

humanoid.StateChanged:Connect(function(oldState: Enum.HumanoidStateType, newState: Enum.HumanoidStateType)
	if newState == Enum.HumanoidStateType.Jumping and oldState ~= Enum.HumanoidStateType.Freefall then
		-- Стрибок із землі (не один із наших стрибків у повітрі) відновлює стрибки в повітрі
		jumpsLeft = EXTRA_JUMPS
		lastJump = os.clock()
	elseif newState == Enum.HumanoidStateType.Landed then
		jumpsLeft = 0
	end
end)

-- JumpRequest спрацьовує, коли гравець просить стрибок, наприклад через Space або кнопку стрибка на телефоні
UserInputService.JumpRequest:Connect(function()
	local now = os.clock()
	local newPress = now - lastRequest > NEW_PRESS_GAP
	lastRequest = now
	-- Знову стрибає лише нове натискання, щоб затиснута кнопка не витрачала стрибок у повітрі
	if not newPress or jumpsLeft <= 0 or now - lastJump < MIN_SECONDS_BETWEEN_JUMPS then
		return
	end
	if humanoid:GetState() == Enum.HumanoidStateType.Freefall then
		jumpsLeft -= 1
		lastJump = now
		humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
	end
end)

Поставте EXTRA_JUMPS рівним 2 для потрійного стрибка.

Скрипт стежить за станом персонажа через 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.

  1. Наведіть на ServerScriptService і вставте Script з іменем MovementCheck.
  2. Замініть його вміст кодом нижче.
Script у ServerScriptService з назвою MovementCheck
-- Пристрої гравців рухають своїх персонажів, тому експлойтер може виставити будь-яку WalkSpeed.
-- Ця перевірка вимірює, як далеко насправді рухається кожен персонаж, і пише в Output,
-- коли хтось довго рухається швидше, ніж дозволяють біг і ривок. Вона лише попереджає:
-- лаг, телепорти й конвеєри можуть виглядати як перевищення швидкості, тож налаштуйте її, перш ніж когось карати.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local StarterPlayer = game:GetService("StarterPlayer")

type Config = { SPRINT_BONUS: number, DASH_SPEED: number, DASH_SECONDS: number }
local Config = require(ReplicatedStorage:WaitForChild("MovementConfig")) :: Config

local CHECK_EVERY = 0.5 -- секунди
-- Швидкість бігу плюс запас на лаг. Збільште, якщо продаєте прискорення.
local SPEED_ALLOWANCE = (StarterPlayer.CharacterWalkSpeed + Config.SPRINT_BONUS) * 1.25
local BURST_ALLOWANCE = Config.DASH_SPEED * Config.DASH_SECONDS * 2 -- запас на один або два ривки
local DRAIN_PER_CHECK = BURST_ALLOWANCE / 8 -- як швидко пробачаються минулі ривки

local lastPosition: { [Player]: Vector3 } = {}
local lastRoot: { [Player]: BasePart } = {} -- кореневий парт, на якому виміряно lastPosition
local excess: { [Player]: number } = {} -- стади понад допуск, поступово пробачаються

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), і наступна перевірка почне вимірювати з нової позиції, а не позначить стрибок:

Пади й меню з гайду про телепорти і пад Finish з гайду про першу гру уже ставлять його після кожного переміщення.

Зараховується лише значення із сервера. Атрибут, який гравець ставить на своєму пристрої, залишається на цьому пристрої (дивіться що реплікується, а що ні), тому чітер не може вимкнути ним перевірку.

Рішення на майбутнє: server authority

Документація Roblox з безпеки називає модель server authority, на момент написання в беті, найнадійнішим способом зупинити експлойти руху. Джерелом правди стає сервер, а пристрої гравців лише повідомляють свій ввід, що, за словами документації, не дає працювати спідхакам, бо пристрою ніколи не довіряють повідомляти власну позицію.

Перехід це переписування, а не налаштування. У цій моделі рух рахує сервер, тому WalkSpeed або LinearVelocity, які виставляє лише LocalScript, скасовуються, коли приходить стан із сервера. У документації Roblox сказано, що основна логіка має працювати у функціях RunService:BindToSimulation() у ModuleScript, який запускають і клієнт, і сервер. Моделі також потрібні кілька налаштувань Workspace, зокрема PlayerScriptsUseInputActionSystem, тож ваше керування теж переїде на Input Action System. Залиште версію з цього гайду, доки не перенесете біг, стаміну й ривок у цю схему. До того часу перевірка за відстанню, як ця, і є тим, що описує розділ Roblox про перевірку руху.

Крок 6: перевірте на кожному пристрої

  1. Натисніть Play і тримайте Shift під час ходьби. Швидкість росте з 16 до 26 стадів за секунду, а зелена смужка внизу екрана зменшується. Приблизно через 5 секунд вона порожня, і ви знову йдете кроком.
  2. Відпустіть Shift. Через 1 секунду смужка починає заповнюватися. Поки вона не заповниться на п'яту частину, Shift нічого не робить.
  3. Натисніть Q під час ходьби: ви трохи проноситеся вперед, і чверті смужки немає. Натисніть Q одразу ще раз, і нічого не станеться, доки не мине секунда. Якщо ривок здається надто коротким або довгим, змініть DASH_SPEED або DASH_SECONDS у MovementConfig.
  4. Стрибніть, потім натисніть стрибок ще раз у повітрі для другого стрибка. Приземліться й спробуйте знову: кожен стрибок із землі повертає стрибок у повітрі.
  5. Тримайте Space затиснутим увесь стрибок. Має вийти один стрибок, а не два, бо стрибку в повітрі потрібне нове натискання.
  6. Увімкніть Device Simulator у Studio (на момент написання це бета: File, Beta Features, New Device Simulator, потім перезапустіть Studio) або ввімкніть старий Device Emulator у меню Test. Виберіть телефон і натисніть Play. З'являться кнопки Sprint і Dash. Тримайте Sprint, поки кермуєте, потім тримайте кнопку стрибка весь стрибок і перевірте, що стрибок лише один.
  7. Відкрийте Controller Emulator (Controller на вкладці Emulation або Virtual controller на панелі Device Simulator). Тримайте L3 під час руху, щоб бігти, натисніть B для ривка і A двічі для подвійного стрибка.
  8. Скиньте персонажа через меню гри. Смужка знову повна, в Output немає попередження MovementCheck, а якщо ви все ще симулюєте телефон, кнопки Sprint і Dash на місці.
  9. Тепер зіграйте за чітера. Натискайте перемикач Client/Server, доки Explorer не покаже клієнт, виділіть Humanoid свого персонажа у Workspace і поставте WalkSpeed рівним 60 у вікні Properties. Походіть кілька секунд: в Output з'явиться попередження на зразок MovementCheck: YourName moved 60 studs/s. Поверніть 16, потім хвилину бігайте й робіть ривки як звичайно і перевірте, що Output мовчить.
  10. Якщо у вашому плейсі Workspace.PlayerScriptsUseInputActionSystem стоїть у Enabled, перевірте подвійний стрибок ще раз: документація Roblox не каже, чи поводиться JumpRequest з ним так само.

Якщо не відбувається взагалі нічого, відкрийте вікно Output через меню Window у Studio й пошукайте червону помилку від MovementClient або загляньте в часті помилки.

Наскільки швидко і як довго: пресети за типом гри

Правильний біг залежить від гри. Погоні в хорорі потрібен короткий повільний біг, який закінчується в найневдаліший момент; великій відкритій карті потрібен довгий, щоб гравцям не було нудно її перетинати. Ці пресети використовують ті самі скрипти й змінюють лише швидкість ходьби і MovementConfig. Це наші стартові точки, пораховані за налаштуваннями, а не виміряні на гравцях.

Швидкість ходьби, біг і стаміна за типом гри. Час бігу це MAX_STAMINA / DRAIN_PER_SECOND; відновлення це MAX_STAMINA / REGEN_PER_SECOND плюс 1 секунда REGEN_DELAY
Тип гриCharacterWalkSpeedSPRINT_BONUS (швидкість бігу)DRAIN_PER_SECONDREGEN_PER_SECONDПовний бігВід порожньої до повноїВідстань на одній смужці
Цей гайд1610 (26)20155 с7.7 с130 стадів
Погоня в хорорі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 підлаштовується. Він дозволяє швидкість ходьби плюс бонус бігу й ще чверть на лаг: 25 стадів за секунду для пресета хорору, 40 для відкритого світу. Більше нічого змінювати не треба.
  • В обі біг змінює трасу. Зі швидшим бігом перестрибуються довші прірви. Побудуйте стрибки, а потім перевірте кожен на швидкості бігу, інакше біг зробить етапи надто легкими. Гайд про чекпоінти для обі добре поєднується з ShiftToSprint.
  • У хорорі орієнтир це вбивця. Зробіть переслідувача трохи швидшим за швидкість ходьби й трохи повільнішим за біг, щоб утеча залежала від того, коли скінчиться смужка. Гайд про хорор-гру розбирає решту циклу.

Що не так зі старими скриптами бігу

Старі туторіали про біг, ривок і подвійний стрибок часто все ще працюють, але багато з них використовують прийоми, які Roblox відтоді замінив, або ламають інші системи у вашій грі. Якщо ви лагодите скопійований скрипт, звірте його з цим списком.

Прийоми зі старих туторіалів і що замість них робить цей гайд
ПрийомУ чому проблемаЦей гайд
BodyVelocity для ривкаЗастарів: Roblox каже використовувати замість нього LinearVelocityLinearVelocity у режимі Plane
Цикл на RunService.RenderSteppedДля нової роботи його замінив PreRender. Ігровій логіці на зразок стаміни місце на Heartbeat, який Roblox описує для періодичних задач, таких як відновлення здоров'яHeartbeat з deltaTime
Цикл стаміни на wait()wait() застарів на користь task.wait() і пригальмовується, тому може чекати довше, ніж просили, і фіксоване витрачання за кожен wait витрачає стаміну нерівноВитрачання й відновлення щокадру з урахуванням deltaTime
UserInputService.InputBegan без перевірки чатуНатискання Shift під час набору повідомлення в чаті запускає бігContextActionService, який ще й додає кнопку на телефоні
WalkSpeed = 16 під час відпускання або щокадруПерезаписує будь-яку іншу швидкість, наприклад перк геймпасаЗмінює WalkSpeed лише на старті й наприкінці бігу, додаючи до поточного значення
Біг через RemoteEvent, щоб WalkSpeed ставив серверЕксплойтери однаково ставлять собі WalkSpeed самі, а біг починається із затримкою на шлях туди й назадБіг на клієнті плюс перевірка відстані на сервері
Подвійний стрибок на кожен JumpRequestJumpRequest спрацьовує кілька разів на один запит стрибка, а затиснута кнопка може й далі запитувати стрибкиПауза 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 і подвійний стрибок.

RoCode робить
  • Може спершу переглянути ваш плейс через 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.

Джерела та що почитати

Як перевірявся код: кожен скрипт на цій сторінці проходить сувору перевірку типів Luau з визначеннями Roblox API (luau-lsp, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.

Спробуйте RoCode у своїй грі.

Безкоштовні кредити щодня, без картки. Встановіть плагін, опишіть функцію та перевірте, що з'явилося в Studio.