Poradnik · Systemy gry

Jak zrobić sprint na Shift w Roblox Studio na PC, telefon i konsolę

Sprint na Shift w Roblox sprowadza się do jednej liczby: WalkSpeed w Humanoid, która rośnie, dopóki wciśnięty jest Shift. Krok 1 robi dokładnie to w jednym krótkim LocalScript, który działa i z przyciskiem Sprint na telefonie, i z padem. Reszta poradnika dodaje to, czego potrzebuje duża gra: pasek staminy, zryw na nowoczesnej fizyce, podwójny skok, który nie odpala się od przytrzymanego przycisku, i zrozumienie tego, co serwer może sprawdzić, a czego nie.

Zaktualizowano 20 listopada 202624 min czytaniaAutor:

W skrócie

Włóż jeden LocalScript do StarterPlayerScripts, który podpina akcję Sprint przez ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3). Dopóki Shift jest wciśnięty, dodawaj 10 do Humanoid.WalkSpeed (16 staje się 26), a po puszczeniu przywracaj poprzednią wartość. Argument true dodaje przycisk Sprint na ekranach dotykowych, a w skrypcie z tego poradnika ten przycisk i L3 na padzie włączają i wyłączają bieg, zamiast działać na przytrzymanie.

  • Dodawaj do bieżącej WalkSpeed, zamiast ustawiać 26, żeby przyspieszenie z game passa zostało.
  • Sprint działa na urządzeniu gracza. Serwer nie może narzucić WalkSpeed; może tylko mierzyć, jak daleko poruszają się postacie, i oznaczać prędkość, której biegiem nie da się wyjaśnić.
  • Pasek staminy, zryw i podwójny skok na tym samym pomyśle dodają kroki od 2 do 4. Jak szybko i jak długo biec, podpowiedzą presety według typu gry z liczbami dla horroru, walki i otwartego świata.
Na tej stronie
  1. Jak to działa
  2. 1. Sprint na Shift
  3. 2. Moduł ustawień
  4. 3. Sprint i zryw
  5. 4. Podwójny skok
  6. 5. Sprawdzenie na serwerze
  7. 6. Sprawdzenie
  8. Presety prędkości
  9. Stare skrypty
  10. Input Action System
  11. Rozbudowa
  12. Common errors
  13. Z RoCode
  14. Najczęstsze pytania
  15. Źródła i dalsza lektura

Jak działa sprint w Roblox

IlustracjaShift daje bieg z WalkSpeed 26, gdy pasek maleje, Q robi zryw za ćwierć paska, a drugie naciśnięcie skoku w powietrzu skacze jeszcze raz.

Urządzenie każdego gracza porusza jego własną postacią. Klawiatura, kontroler albo ekran dotykowy decydują, dokąd idzie postać, a Roblox przekazuje wynik serwerowi i wszystkim pozostałym. Dlatego sprint to LocalScript, który podnosi Humanoid.WalkSpeed, dopóki wciśnięty jest klawisz, i to wszystko, co robi krok 1. Reszta poradnika to to, czego potrzebuje wokół niego duża gra: pasek staminy, zryw, podwójny skok i serwerowe sprawdzenie dla oszustów.

Z czego składa się system ruchu
ElementGdzie jestCo robi
LocalScript ShiftToSprintStarterPlayerScriptsKrok 1 sam w sobie: sprint na klawiaturze, telefonie i padzie, bez staminy. Gdy dodajesz staminę i zryw, zastępuje go MovementClient.
ModuleScript MovementConfigReplicatedStorageLiczby: bonus biegu, stamina i zryw. Czytają je i LocalScript, i serwerowe sprawdzenie.
LocalScript MovementClientStarterPlayerScriptsPodpina Sprint i Dash do klawisza, przycisku pada i przycisku dotykowego, kręci pętlą staminy, rysuje pasek i robi zryw.
LocalScript DoubleJumpStarterCharacterScriptsDaje jeden dodatkowy skok w powietrzu. Nowa kopia uruchamia się w każdej nowej postaci.
Script MovementCheckServerScriptServiceMierzy, jak daleko naprawdę porusza się każda postać, i pisze ostrzeżenie w Output, gdy ktoś długo porusza się szybciej, niż pozwalają bieg i zryw.
Explorer, gdy system ruchu jest gotowy
ReplicatedStorage
  MovementConfig ModuleScript new
ServerScriptService
  MovementCheck Script new
StarterPlayer
  StarterCharacterScripts
    DoubleJump LocalScript new
  StarterPlayerScripts
    MovementClient LocalScript new

Jeśli różnica między Script a LocalScript jest dla ciebie nowa, Script, LocalScript i ModuleScript wyjaśnia, gdzie uruchamia się każdy rodzaj i dlaczego.

Krok 1: sprint na Shift w jednym LocalScript

Jeśli potrzebujesz tylko szybszego biegu, gdy Shift jest wciśnięty, wystarczy ten jeden skrypt. Daje też telefonom przycisk Sprint na ekranie, a na padzie pozwala biec lewą gałką.

  1. W Explorerze rozwiń StarterPlayer, najedź na StarterPlayerScripts, kliknij przycisk + i wstaw LocalScript o nazwie ShiftToSprint.
  2. Zastąp jego zawartość kodem poniżej i kliknij Play.
LocalScript w StarterPlayerScripts o nazwie ShiftToSprint
-- LocalScript w StarterPlayer > StarterPlayerScripts o nazwie ShiftToSprint.
-- Przytrzymaj Left Shift, żeby biec. Na padzie naciśnij lewą gałkę (L3), żeby
-- włączyć albo wyłączyć bieg. Na telefonie naciśnij przycisk Sprint, żeby go włączyć albo wyłączyć.

local ContextActionService = game:GetService("ContextActionService")
local Players = game:GetService("Players")

-- Ustawienia
local SPRINT_BONUS = 10 -- dodawane do WalkSpeed w trakcie biegu (16 staje się 26)
local TOGGLE_ON_TOUCH_AND_GAMEPAD = true -- false: przycisk trzeba przytrzymywać

local player = Players.LocalPlayer
local sprinting = false
local normalSpeed = 16 -- WalkSpeed, do której trzeba wrócić

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
		-- Zapamiętujemy bieżącą prędkość i do niej dodajemy, żeby przyspieszenie z innego skryptu zostało
		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
		-- Przytrzymanie: bieg, dopóki klawisz albo przycisk jest wciśnięty
		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
		-- Przełączanie: każde naciśnięcie włącza albo wyłącza bieg
		setSprinting(not sprinting)
	end
	return Enum.ContextActionResult.Pass
end

-- Jedno wywołanie podpina klawisz, przycisk pada i, na ekranach dotykowych, przycisk na ekranie
ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3)
ContextActionService:SetTitle("Sprint", "Sprint")

-- Nowa postać zaczyna od chodu: jej Humanoid ma już zwykłą WalkSpeed
player.CharacterAdded:Connect(function()
	sprinting = false
end)

Zmieniaj SPRINT_BONUS, żeby bieg był szybszy albo wolniejszy. Ustaw TOGGLE_ON_TOUCH_AND_GAMEPAD na false, żeby przycisk na telefonie i L3 działały jak Shift: bieg tylko, dopóki są wciśnięte.

BindAction podpina jedną akcję do Left Shift i do przycisku L3 na padzie, a jego trzeci argument, true, dodaje przycisk na ekranach dotykowych; SetTitle pisze na nim "Sprint". Handler dostaje też samo wejście, więc odróżnia naciśnięcie na klawiaturze od pada albo przycisku dotykowego. Gdy bieg się zaczyna, skrypt zapamiętuje bieżącą WalkSpeed i dodaje SPRINT_BONUS; gdy się kończy, przywraca zapamiętaną wartość. Prędkość, którą ustawił inny skrypt, na przykład perk Speed z poradnika o game passach, zostaje. Nowa postać zaczyna ze zwykłą WalkSpeed, więc handler CharacterAdded tylko resetuje flagę.

Przytrzymanie czy przełączanie?

Jak ShiftToSprint działa na każdym urządzeniu, gdy TOGGLE_ON_TOUCH_AND_GAMEPAD jest true
Urządzenie i wejścieDziała jakDlaczego
Klawiatura: Left ShiftPrzytrzymanieTrzymanie klawisza w trakcie ruchu jest łatwe, a puszczenie od razu zatrzymuje bieg.
Pad: naciśnięcie lewej gałki (L3)PrzełączanieTrzymanie wciśniętej gałki i jednoczesne sterowanie nią męczy.
Telefon albo tablet: przycisk Sprint na ekraniePrzełączanieKciuk, który trzyma przycisk, nie może w tym samym czasie nacisnąć Jump.

Żeby sprawdzić, kliknij Play i trzymaj Shift w trakcie chodzenia: prędkość rośnie z 16 do 26 studów na sekundę, a jeśli puścisz, zwolnisz. Dla telefonu wybierz telefon w Device Simulator w Studio, kliknij Play i naciśnij Sprint raz, żeby zacząć, i drugi raz, żeby skończyć. Dla pada otwórz Controller Emulator w trakcie playtestu i naciśnij L3. Pełna lista sprawdzeń według urządzeń jest w kroku 6.

Kroki 2 i 3 zastępują ten skrypt innym, z paskiem staminy i zrywem. Kroki 4 i 5 dodają podwójny skok i serwerowe sprawdzenie i działają z którymkolwiek z dwóch skryptów.

Krok 2: liczby staminy i zrywu w jednym module

Dla biegu, który się kończy, kroki 2 i 3 zamieniają ShiftToSprint na większy LocalScript z paskiem staminy i zrywem. Najpierw usuń ShiftToSprint: oba skrypty podpinają akcję Sprint.

Wszystkie liczby leżą w jednym ModuleScript, więc odczucie ruchu ustawia się w jednym miejscu. MovementClient czyta je na urządzeniu każdego gracza, a MovementCheck czyta ten sam moduł na serwerze, żeby wiedzieć, jaka powinna być prędkość biegu i zrywu.

  1. W Explorerze najedź na ReplicatedStorage, kliknij przycisk + i wstaw ModuleScript.
  2. Zmień jego nazwę na MovementConfig i zastąp zawartość kodem poniżej.
ModuleScript w ReplicatedStorage o nazwie MovementConfig
-- Jeden zestaw liczb dla LocalScript ruchu i serwerowego sprawdzania prędkości.

local MovementConfig = {
	SPRINT_BONUS = 10, -- dodawane do bieżącej WalkSpeed: 16 (domyślna wartość Roblox) staje się 26

	MAX_STAMINA = 100,
	DRAIN_PER_SECOND = 20, -- 5 sekund biegu z pełnego paska
	REGEN_PER_SECOND = 15,
	REGEN_DELAY = 1, -- sekundy po końcu biegu, zanim stamina zacznie się odnawiać
	MIN_TO_START = 20, -- stamina potrzebna do startu biegu, żeby pusty pasek nie migał

	DASH_SPEED = 60, -- studów na sekundę w trakcie zrywu
	DASH_SECONDS = 0.2, -- tak zryw przechodzi około 12 studów
	DASH_COST = 25, -- stamina
	DASH_COOLDOWN = 1,
}

return MovementConfig
Co robi każde ustawienie
UstawienieWartośćEfekt
SPRINT_BONUS10Dodawane do WalkSpeed w trakcie biegu. Domyślna WalkSpeed w Roblox to 16, więc bieg idzie z prędkością 26 studów na sekundę.
MAX_STAMINA100Pełny pasek.
DRAIN_PER_SECOND20Pełny pasek wystarcza na 5 sekund biegu.
REGEN_PER_SECOND15Pusty pasek wypełnia się w około 6.7 sekundy.
REGEN_DELAY1Sekundy odpoczynku przed początkiem odnawiania.
MIN_TO_START20Stamina potrzebna, żeby zacząć bieg.
DASH_SPEED60Studów na sekundę w trakcie zrywu.
DASH_SECONDS0.2Ile trwa zryw: około 12 studów przy 60 studach na sekundę.
DASH_COST25Stamina na każdy zryw.
DASH_COOLDOWN1Sekundy między zrywami.

Każda strona uruchamia własną kopię modułu (moduł wykonuje się raz po każdej stronie), więc gracz, który zmienia te liczby na swoim urządzeniu, zmienia tylko swoją kopię. Ale tutaj niczego to nie chroni: jego urządzenie i tak porusza jego postacią, więc może dać sobie nieskończoną staminę, cokolwiek jest w module. Serwerowe sprawdzenie z kroku 5 jest zbudowane z myślą o tym.

Krok 3: sprint ze staminą i zryw

Ten LocalScript robi to, co czują gracze. Podpina Sprint i Dash, rysuje pasek staminy, co klatkę kręci pętlą staminy i robi zryw.

  1. W Explorerze rozwiń StarterPlayer, najedź na StarterPlayerScripts i wstaw LocalScript o nazwie MovementClient.
  2. Zastąp jego zawartość kodem poniżej.
LocalScript w StarterPlayerScripts o nazwie MovementClient
-- Przytrzymaj Shift (albo L3, albo przycisk Sprint na telefonie), żeby biec, dopóki jest stamina.
-- Naciśnij Q (albo B, albo przycisk Dash), żeby zrobić zryw w kierunku ruchu.

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, do której wrócić, gdy bieg się skończy
local lastSprintTime = 0
local lastDashTime = -math.huge

-- Pasek staminy: ramka z wypełnieniem, którego szerokość odpowiada pozostałej staminie
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

-- Bieg: tu jest tylko flaga; pętla Heartbeat niżej co klatkę decyduje, czy biec
local function onSprint(_name: string, state: Enum.UserInputState, _input: InputObject): Enum.ContextActionResult
	-- Zmienia ją tylko naciśnięcie i puszczenie: palec przesuwający się po przycisku dotykowym wysyła 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()
	-- Na siedząco nie ma zrywu: siedząca postać jest przyspawana do siedzenia, więc pchnęłaby cały pojazd
	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 -- pauzujemy odnawianie, tak jak robi to bieg

	-- Zryw tam, dokąd gracz się porusza, albo tam, gdzie patrzy, jeśli stoi w miejscu
	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 w trybie Plane trzyma poziomą prędkość i nie przeszkadza grawitacji
	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

-- Każde wywołanie podpina klawisz, przycisk pada i, na urządzeniach dotykowych, przycisk na ekranie
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")

-- Co klatkę: zużywamy staminę w trakcie biegu i ruchu, odnawiamy po krótkim odpoczynku
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

	-- Zmieniamy WalkSpeed tylko na starcie i na końcu biegu, żeby prędkość ustawiona
	-- przez inny skrypt (na przykład passa na prędkość) została, a bieg się do niej dodawał
	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)

-- Nowa postać zaczyna z pełną staminą i nic nie jest wciśnięte
player.CharacterAdded:Connect(function()
	stamina = Config.MAX_STAMINA
	sprintHeld = false
	sprinting = false -- nowy Humanoid zaczyna ze zwykłą WalkSpeed
end)

Pasek staminy jest tworzony w kodzie z ResetOnSpawn ustawionym na false, więc zostaje na ekranie po respawnie, a handler CharacterAdded na dole od nowa wypełnia go dla każdej nowej postaci. Linie type Config opisują, co zwraca moduł, żeby ścisłe sprawdzanie typów wyłapywało literówkę w nazwie ustawienia; w trakcie gry niczego nie zmieniają.

Klawiatura, pad i przycisk na telefonie jednym wywołaniem

ContextActionService:BindAction przyjmuje nazwę akcji, funkcję-handler, czy tworzyć przycisk dotykowy, a potem wejścia. Jeśli przekażesz true jako trzeci argument, ContextActionService doda przycisk na ekranie na urządzeniach dotykowych, w ScreenGui o nazwie ContextActionGui w PlayerGui gracza. SetTitle pisze na tych przyciskach "Sprint" i "Dash". BindAction może utworzyć nie więcej niż 7 przycisków dotykowych, więc pilnuj liczby, jeśli używają ich też inne skrypty w grze.

Handler dostaje stan wejścia: Begin przy naciśnięciu i End przy puszczeniu. onSprint tylko zapamiętuje, czy Sprint jest wciśnięty. Traktuje jako puszczenie też Cancel, który ContextActionService wysyła, gdy wejście przejmuje inne podpięcie, i ignoruje Change, które może wysłać palec przesuwający się po przycisku dotykowym. Oba handlery zwracają Pass, więc następne podpięcie na tym samym klawiszu też dostaje wejście.

Dokumentacja Roblox o ContextActionService radzi go zamiast UserInputService.InputBegan w większości przypadków. Jej przykład: klakson samochodu pod H, który nie powinien trąbić, gdy gracz pisze na czacie. Podpięcie odpala się tylko wtedy, gdy jest ostatnie dla tego wejścia, więc gdy czat zabiera klawiaturę, nie musisz niczego sprawdzać. Wejścia pada: ButtonL3 (naciśnięcie lewej gałki, trzymane w trakcie ruchu) i ButtonB. We własnym przykładzie sprintu od Roblox używa się ButtonY, więc zmień KeyCode w BindAction, jeśli twojej grze tak jest wygodniej.

Pętla staminy

RunService.Heartbeat odpala się co klatkę po kroku fizyki i przekazuje deltaTime, liczbę sekund od poprzedniej klatki. Jeśli pomnożysz przez nią szybkość zużycia i odnawiania, pełny pasek wystarczy na 5 sekund, niezależnie od tego, czy gra chodzi w 30, czy w 240 klatkach na sekundę.

Co klatkę pętla decyduje, czy postać ma biec: Sprint jest wciśnięty, postać idzie (Humanoid.MoveDirection jest zerowym wektorem, gdy stoi) i jest jeszcze stamina. Żeby zacząć bieg, potrzeba co najmniej MIN_TO_START (20); żeby biec dalej, wystarczy cokolwiek powyżej 0. Bez tej przerwy pusty pasek, który co klatkę trochę się wypełnia, włączałby i wyłączał bieg co klatkę. Odnawianie zaczyna się REGEN_DELAY (1 sekundę) po ostatnim biegu albo zrywie, więc po opróżnieniu paska gracz czeka około 2.3 sekundy, zanim znowu będzie mógł biec.

WalkSpeed zmienia się tylko w tej klatce, w której bieg się zaczyna albo kończy. Na starcie skrypt zapamiętuje bieżącą WalkSpeed i dodaje SPRINT_BONUS; na końcu przywraca zapamiętaną wartość. Dlatego prędkość ustawiona przez inny skrypt zostaje: perk Speed z poradnika o game passach ustawia WalkSpeed 24, a z tym skryptem jego właściciele biegną z prędkością 34. Skrypt, który pisze WalkSpeed = 16 co klatkę albo przy każdym puszczeniu, po cichu anulowałby ten perk.

Zryw

Zryw pcha postać tam, dokąd się porusza, albo tam, gdzie patrzy, jeśli stoi w miejscu, a kierunek jest wyrównywany, żeby nigdy nie patrzył w górę ani w dół. Kosztuje 25 staminy, pauzuje odnawianie jak bieg i ma cooldown 1 sekundy. Nie sprawdza ziemi, więc działa też w powietrzu, co dobrze łączy się z podwójnym skokiem. Gdy postać siedzi, zryw nic nie robi: siedząca postać jest przyspawana do siedzenia, a w pojeździe pchnięcie mogłoby przesunąć cały pojazd.

Pchnięcie to ograniczenie LinearVelocity na RootAttachment głównego partu. W trybie Plane z osiami X i Z trzyma poziomą prędkość 60 studów na sekundę i nie rusza pionu, więc grawitacja działa, a zryw z półki spada jak zwykle. MaxForce to math.huge, więc pchnięcie niczym nie jest ograniczone. Debris:AddItem niszczy ograniczenie po DASH_SECONDS, nie każąc skryptowi czekać, więc zryw trwa 0.2 sekundy, około 12 studów przy tej prędkości.

Stare tutoriale używają BodyVelocity, który Roblox oznaczył jako przestarzały z dopiskiem, żeby zamiast niego używać LinearVelocity. Jego sztuczkę z zerowym MaxForce na jednej osi zastępują tryby Line, Plane i Vector w LinearVelocity. Ponieważ urządzenie gracza samo symuluje swoją postać, ograniczenie utworzone przez LocalScript ją przesuwa, a inni gracze widzą zryw jak każdy inny ruch.

Własny tutorial Roblox o UI mocuje ograniczenie do humanoid.RootPart.RootAttachment dokładnie tak samo. Jeśli twoja gra ma własną postać, której główny part nie ma Attachment o nazwie RootAttachment, zryw nic nie robi: dodaj go do HumanoidRootPart swojego StarterCharacter.

Krok 4: podwójny skok

Podwójny skok żyje we własnym LocalScript w StarterCharacterScripts. Roblox wkłada kopię skryptów z tego kontenera do każdej postaci przy spawnie, a te kopie nie przetrwają respawnu, więc każde życie zaczyna się od świeżego skryptu i nic nie przenosi się z poprzedniego.

  1. W Explorerze rozwiń StarterPlayer, najedź na StarterCharacterScripts i wstaw LocalScript o nazwie DoubleJump.
  2. Zastąp jego zawartość kodem poniżej.
LocalScript w StarterCharacterScripts o nazwie DoubleJump
-- Daje jeden dodatkowy skok w powietrzu. Uruchamia się od nowa dla każdej nowej postaci,
-- więc po respawnie nic się nie przenosi.

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 odpala się kilka razy na jedno naciśnięcie
local NEW_PRESS_GAP = 0.1 -- przytrzymany przycisk skoku dalej wysyła JumpRequest; przerwa takiej długości znaczy, że go puszczono

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
		-- Skok z ziemi (nie jeden z naszych skoków w powietrzu) przywraca skoki w powietrzu
		jumpsLeft = EXTRA_JUMPS
		lastJump = os.clock()
	elseif newState == Enum.HumanoidStateType.Landed then
		jumpsLeft = 0
	end
end)

-- JumpRequest odpala się, gdy gracz prosi o skok, na przykład przez Space albo przycisk skoku na telefonie
UserInputService.JumpRequest:Connect(function()
	local now = os.clock()
	local newPress = now - lastRequest > NEW_PRESS_GAP
	lastRequest = now
	-- Znowu skacze tylko nowe naciśnięcie, żeby przytrzymany przycisk nie zużywał skoku w powietrzu
	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)

Ustaw EXTRA_JUMPS na 2 dla potrójnego skoku.

Skrypt śledzi stan postaci przez Humanoid.StateChanged. Przejście w Jumping, które nie przyszło z Freefall, to skok z ziemi, więc daje skok w powietrzu, a Landed znowu go zabiera. Jeśli zejdziesz z półki, postać trafia do Freefall bez skoku, więc skoku w powietrzu nie dostaje. Jeśli jest potrzebny też tam, ustawiaj jumpsLeft także przy przejściu do Freefall z każdego stanu poza Jumping.

UserInputService.JumpRequest odpala się, gdy gracz prosi o skok, na przykład przez Space albo przycisk skoku na telefonie. Dokumentacja Roblox ostrzega, że odpala się kilka razy na jedno żądanie skoku, i radzi debounce, więc skrypt ignoruje żądania przez 0.25 sekundy po ostatnim skoku. Przytrzymany przycisk skoku też może dalej prosić o skoki i zużyłby skok w powietrzu w chwili, gdy postać oderwie się od ziemi, więc żądanie liczy się jako nowe naciśnięcie dopiero po 0.1 sekundy bez żądań.

Sam skok w powietrzu to Humanoid:ChangeState(Enum.HumanoidStateType.Jumping). Dokumentacja Roblox mówi, że trzeba go wywoływać z LocalScript na urządzeniu, które ma własność sieciową postaci, a domyślnie to urządzenie samego gracza, a nie serwer. Przykład kodu do ChangeState w dokumentacji to właśnie podwójny skok.

Krok 5: łapiemy speedhack na serwerze

Tutoriale o sprincie często kończą się na kliencie. Serwerowy Script nie może ufać WalkSpeed gracza, bo exploiterzy zmieniają ją na swoim urządzeniu, ale widzi, gdzie ląduje ich postać. MovementCheck mierzy to dwa razy na sekundę i pisze ostrzeżenie w Output, gdy ktoś długo porusza się szybciej, niż pozwalają bieg i zryw. Liczby biegu i zrywu czyta z MovementConfig, więc dodaj ten moduł z kroku 2, nawet jeśli zostawiłeś ShiftToSprint.

  1. Najedź na ServerScriptService i wstaw Script o nazwie MovementCheck.
  2. Zastąp jego zawartość kodem poniżej.
Script w ServerScriptService o nazwie MovementCheck
-- Urządzenia graczy poruszają swoimi postaciami, więc exploiter może ustawić dowolną WalkSpeed.
-- To sprawdzenie mierzy, jak daleko naprawdę porusza się każda postać, i pisze w Output,
-- gdy ktoś długo porusza się szybciej, niż pozwalają bieg i zryw. Tylko ostrzega:
-- lag, teleporty i taśmociągi mogą wyglądać jak przekroczenie prędkości, więc ustaw je, zanim kogoś ukarzesz.

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 -- sekundy
-- Prędkość biegu plus zapas na lag. Zwiększ, jeśli sprzedajesz przyspieszenia.
local SPEED_ALLOWANCE = (StarterPlayer.CharacterWalkSpeed + Config.SPRINT_BONUS) * 1.25
local BURST_ALLOWANCE = Config.DASH_SPEED * Config.DASH_SECONDS * 2 -- zapas na jeden albo dwa zrywy
local DRAIN_PER_CHECK = BURST_ALLOWANCE / 8 -- jak szybko wybaczane są dawne zrywy

local lastPosition: { [Player]: Vector3 } = {}
local lastRoot: { [Player]: BasePart } = {} -- główny part, na którym zmierzono lastPosition
local excess: { [Player]: number } = {} -- study ponad tolerancję, stopniowo wybaczane

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
			-- Respawn to nowy główny part, a serwerowy teleport (start rundy, checkpoint)
			-- ustawia atrybut niżej: zaczynamy mierzyć od nowa, zamiast oznaczać skok
			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
				-- Tylko ruch poziomy: szybkie spadanie to nie oszustwo
				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

Ostrzeżenie pojawia się w Output w Studio. W opublikowanej grze trafia do serwerowego logu Developer Console, który możesz czytać jako właściciel gry: zobacz wyjście w opublikowanej grze.

Co mierzy

Co pół sekundy skrypt czyta pozycję głównego partu każdej postaci i mierzy, o ile przesunął się w poziomie od poprzedniego sprawdzenia. Wysokość jest ignorowana, więc upadki i skoki nigdy się nie liczą; rada Roblox o sprawdzaniu ruchu proponuje to samo rzutowanie na płaszczyznę XZ dla gier, w których chodzi się po ziemi. Tolerancja to domyślna prędkość chodu plus bonus biegu i jeszcze ćwierć na lag: 32.5 studa na sekundę. Odległość ponad to trafia do „dziurawego wiadra”, akumulatora, o którym dokumentacja Roblox mówi, że wielu twórcom dobrze pasuje do krótkich zrywów. Wiadro traci 3 study przy każdym sprawdzeniu, a skrypt ostrzega, gdy jest w nim więcej niż 24 study, czyli zapas na mniej więcej dwa zrywy.

Co wyłapuje sprawdzenie, jeśli policzyć według jego liczb
OszustCo robi MovementCheck
Ustawia WalkSpeed 100Ostrzega po około sekundzie biegu
Ustawia WalkSpeed 50Ostrzega po około 2.5 sekundy biegu
Robi zrywy jeden po drugim bez cooldownu (60 studów na sekundę)Ostrzega po około 1.5 sekundy
Teleportuje się o więcej niż 43 study narazOstrzega przy następnym sprawdzeniu
Biegnie z prędkością do 38 studów na sekundę, mniej więcej półtora raza szybciej niż sprintNic: poniżej 38.5 studa na sekundę wiadro opróżnia się tak szybko, jak się napełnia
Zmienia swój MovementConfig dla nieskończonej staminyNic: bieg z prędkością 26 studów na sekundę jest dozwolony dowolnie długo
Lata, skacze bez ograniczeń albo przechodzi przez ścianyNic: sprawdzenie ignoruje wysokość i nie patrzy na kolizje

Czyli sprawdzenie wyłapuje grube cheaty, przy których gracz jest wyraźnie szybszy od wszystkich innych, i przepuszcza subtelne. To uczciwa granica sprawdzenia według odległości i powód, dla którego Roblox robi coś mocniejszego (zobacz server authority niżej).

Dlaczego tylko ostrzega

W dokumentacji Roblox zaznaczono, że proste sprawdzenia prędkości mogą oznaczać uczciwych graczy z niestabilnym połączeniem i psują się w grach z pojazdami albo innym złożonym ruchem. Skoki lagu, taśmociągi, pojazdy, wybuchy, które odrzucają postacie, i twoje własne teleporty mogą wyglądać jak przekroczenie prędkości, więc skrypt tylko wypisuje ostrzeżenie. Patrz w Output, gdy ty i twoi testerzy gracie normalnie, zwiększ SPEED_ALLOWANCE, jeśli potykają się na nim uczciwi gracze, i dodawaj karę, na przykład cofnięcie gracza, dopiero wtedy, gdy sprawdzenie milczy w zwykłej grze. Jeśli w twojej grze wybuchy odrzucają postacie, pomijaj też graczy, których Humanoid nie ma już zdrowia.

Respawny i teleporty

Respawn tworzy nowy główny part, a skrypt zaczyna mierzyć od nowa, gdy go widzi, więc śmierć daleko od punktu spawnu nigdy nie liczy się jako przekroczenie prędkości. Teleporty, które robią twoje własne serwerowe skrypty, potrzebują wyjątku, jak napisano w dokumentacji Roblox dla każdej gry z teleportami. Po teleporcie dodaj player:SetAttribute("MovementCheckSkip", true), a następne sprawdzenie zacznie mierzyć od nowej pozycji, zamiast oznaczać skok:

Pady i menu z poradnika o teleportach i pad Finish z poradnika o pierwszej grze już go ustawiają po każdym przeniesieniu.

Liczy się tylko wartość z serwera. Atrybut, który gracz ustawia na swoim urządzeniu, zostaje na tym urządzeniu (zobacz co się replikuje, a co nie), więc oszust nie może nim wyłączyć sprawdzenia.

Rozwiązanie na przyszłość: server authority

Dokumentacja Roblox o bezpieczeństwie nazywa model server authority, w chwili pisania w becie, najpewniejszym sposobem na zatrzymanie exploitów ruchu. Źródłem prawdy staje się serwer, a urządzenia graczy tylko zgłaszają swoje wejście, co według dokumentacji nie pozwala działać speedhackom, bo urządzeniu nigdy nie ufa się w zgłaszaniu własnej pozycji.

Przejście to przepisanie, a nie ustawienie. W tym modelu ruch liczy serwer, więc WalkSpeed albo LinearVelocity, które ustawia tylko LocalScript, są anulowane, gdy przychodzi stan z serwera. W dokumentacji Roblox napisano, że główna logika ma działać w funkcjach RunService:BindToSimulation() w ModuleScript, który uruchamiają i klient, i serwer. Model wymaga też kilku ustawień Workspace, łącznie z PlayerScriptsUseInputActionSystem, więc twoje sterowanie też przeniesie się na Input Action System. Zostaw wersję z tego poradnika, dopóki nie przeniesiesz biegu, staminy i zrywu do tego schematu. Do tego czasu sprawdzenie według odległości, takie jak to, jest właśnie tym, co opisuje sekcja Roblox o sprawdzaniu ruchu.

Krok 6: sprawdź na każdym urządzeniu

  1. Kliknij Play i trzymaj Shift w trakcie chodzenia. Prędkość rośnie z 16 do 26 studów na sekundę, a zielony pasek na dole ekranu maleje. Po około 5 sekundach jest pusty i znowu idziesz.
  2. Puść Shift. Po 1 sekundzie pasek zaczyna się wypełniać. Dopóki nie wypełni się w jednej piątej, Shift nic nie robi.
  3. Naciśnij Q w trakcie chodzenia: przemykasz trochę do przodu, a ćwierci paska nie ma. Naciśnij Q od razu jeszcze raz, a nic się nie stanie, dopóki nie minie sekunda. Jeśli zryw wydaje się za krótki albo za długi, zmień DASH_SPEED albo DASH_SECONDS w MovementConfig.
  4. Skocz, potem naciśnij skok jeszcze raz w powietrzu, żeby zrobić drugi skok. Wyląduj i spróbuj znowu: każdy skok z ziemi przywraca skok w powietrzu.
  5. Trzymaj Space wciśnięte przez cały skok. Powinien wyjść jeden skok, a nie dwa, bo skok w powietrzu wymaga nowego naciśnięcia.
  6. Włącz Device Simulator w Studio (w chwili pisania to beta: File, Beta Features, New Device Simulator, potem uruchom Studio ponownie) albo włącz stary Device Emulator w menu Test. Wybierz telefon i kliknij Play. Pojawią się przyciski Sprint i Dash. Trzymaj Sprint, gdy sterujesz, potem trzymaj przycisk skoku przez cały skok i sprawdź, czy skok jest tylko jeden.
  7. Otwórz Controller Emulator (Controller na karcie Emulation albo Virtual controller na panelu Device Simulator). Trzymaj L3 w trakcie ruchu, żeby biec, naciśnij B na zryw i A dwa razy na podwójny skok.
  8. Zresetuj postać przez menu gry. Pasek jest znowu pełny, w Output nie ma ostrzeżenia MovementCheck, a jeśli nadal symulujesz telefon, przyciski Sprint i Dash są na miejscu.
  9. Teraz zagraj jako oszust. Klikaj przełącznik Client/Server, aż Explorer pokaże klienta, zaznacz Humanoid swojej postaci w Workspace i ustaw WalkSpeed na 60 w oknie Properties. Pochodź kilka sekund: w Output pojawi się ostrzeżenie w rodzaju MovementCheck: YourName moved 60 studs/s. Przywróć 16, potem przez minutę biegaj i rób zrywy jak zwykle i sprawdź, czy Output milczy.
  10. Jeśli w twojej grze Workspace.PlayerScriptsUseInputActionSystem jest ustawione na Enabled, sprawdź podwójny skok jeszcze raz: dokumentacja Roblox nie mówi, czy JumpRequest zachowuje się z nim tak samo.

Jeśli nie dzieje się w ogóle nic, otwórz okno Output przez menu Window w Studio i poszukaj czerwonego błędu od MovementClient albo zajrzyj do częstych błędów.

Jak szybko i jak długo: presety według typu gry

Właściwy sprint zależy od gry. Pościg w horrorze potrzebuje krótkiego, wolnego biegu, który kończy się w najgorszym momencie; duża otwarta mapa potrzebuje długiego, żeby graczy nie nudziło jej przemierzanie. Te presety używają tych samych skryptów i zmieniają tylko prędkość chodu i MovementConfig. To nasze punkty startowe, policzone z ustawień, a nie zmierzone na graczach.

Prędkość chodu, bieg i stamina według typu gry. Czas biegu to MAX_STAMINA / DRAIN_PER_SECOND; odnawianie to MAX_STAMINA / REGEN_PER_SECOND plus 1 sekunda REGEN_DELAY
Typ gryCharacterWalkSpeedSPRINT_BONUS (prędkość biegu)DRAIN_PER_SECONDREGEN_PER_SECONDPełny biegOd pustego do pełnegoDystans na jednym pasku
Ten poradnik1610 (26)20155 s7.7 s130 studów
Pościg w horrorze128 (20)25104 s11 s80 studów
Battlegroundy i walka1612 (28)15206.7 s6 sokoło 187 studów
Otwarty świat albo symulator1616 (32)102510 s5 s320 studów
Obby albo parkour168 (24)bez staminy: użyj ShiftToSprint
  • Prędkość chodu ustawia się w StarterPlayer. Zaznacz StarterPlayer i ustaw CharacterWalkSpeed (domyślnie 16). Każda nowa postać zaczyna z tą prędkością, bieg dodaje do niej SPRINT_BONUS, a MovementCheck też ją czyta, więc serwerowe sprawdzenie idzie za twoim wyborem.
  • MovementCheck się dopasowuje. Pozwala na prędkość chodu plus bonus biegu i jeszcze ćwierć na lag: 25 studów na sekundę dla presetu horroru, 40 dla otwartego świata. Nic więcej nie trzeba zmieniać.
  • W obby sprint zmienia trasę. Szybszym biegiem przeskakuje się dłuższe przepaście. Zbuduj skoki, a potem sprawdź każdy z prędkością biegu, inaczej sprint uczyni etapy zbyt łatwymi. Poradnik o checkpointach do obby dobrze łączy się z ShiftToSprint.
  • W horrorze punktem odniesienia jest zabójca. Zrób ścigającego trochę szybszym niż prędkość chodu i trochę wolniejszym niż bieg, żeby ucieczka zależała od tego, kiedy skończy się pasek. Poradnik o grze horror omawia resztę pętli.

Co jest nie tak ze starymi skryptami sprintu

Stare tutoriale o sprincie, zrywie i podwójnym skoku często nadal działają, ale wiele z nich używa sposobów, które Roblox od tamtej pory zastąpił, albo psuje inne systemy w twojej grze. Jeśli naprawiasz skopiowany skrypt, porównaj go z tą listą.

Sposoby ze starych tutoriali i co zamiast nich robi ten poradnik
SposóbW czym problemTen poradnik
BodyVelocity do zrywuPrzestarzały: Roblox mówi, żeby używać zamiast niego LinearVelocityLinearVelocity w trybie Plane
Pętla na RunService.RenderSteppedDo nowej pracy zastąpił go PreRender. Logika gry w rodzaju staminy należy do Heartbeat, który Roblox opisuje dla okresowych zadań, takich jak odnawianie zdrowiaHeartbeat z deltaTime
Pętla staminy na wait()wait() jest przestarzałe na rzecz task.wait() i bywa spowalniane, więc może czekać dłużej, niż proszono, a stałe zużycie przy każdym wait zużywa staminę nierównoZużycie i odnawianie co klatkę z uwzględnieniem deltaTime
UserInputService.InputBegan bez sprawdzenia czatuNaciśnięcie Shift w trakcie pisania wiadomości na czacie uruchamia biegContextActionService, który dodatkowo dodaje przycisk na telefonie
WalkSpeed = 16 przy puszczeniu albo co klatkęNadpisuje każdą inną prędkość, na przykład perk game passaZmienia WalkSpeed tylko na starcie i na końcu biegu, dodając do bieżącej wartości
Sprint przez RemoteEvent, żeby WalkSpeed ustawiał serwerExploiterzy i tak ustawiają sobie WalkSpeed sami, a bieg zaczyna się z opóźnieniem na drogę tam i z powrotemSprint na kliencie plus sprawdzenie odległości na serwerze
Podwójny skok przy każdym JumpRequestJumpRequest odpala się kilka razy na jedno żądanie skoku, a przytrzymany przycisk może dalej prosić o skokiPrzerwa 0.25 sekundy i sprawdzenie nowego naciśnięcia
UserInputService.TouchEnabled jako sprawdzenie „to telefon”Jest true na laptopach z ekranem dotykowymContextActionService dodaje przyciski na ekranie na urządzeniach dotykowych bez twojego własnego sprawdzania urządzenia
Humanoid:LoadAnimation do animacji bieguPrzestarzały na rzecz Animator:LoadAnimationAnimacja biegu niżej używa Animator

Nowy sposób od Roblox: Input Action System

Strona Roblox o Input Action System bierze sprint postaci jako pierwszy przykład. Zamiast wywołań BindAction sterowanie ustawia się w Studio: InputAction o nazwie CharacterSprint w input context w ReplicatedStorage, z jednym InputBinding dla Left Shift, jednym dla przycisku Y na padzie i jednym powiązanym z przyciskiem na ekranie, który rysujesz w StarterGui. Potem kliencki skrypt nasłuchuje eventów akcji Pressed i Released, podwajając WalkSpeed przy naciśnięciu i przywracając ją przy puszczeniu.

Warto na niego przejść, jeśli chcesz układać sterowanie w Studio, a nie w kodzie, własny przycisk dotykowy zamiast przycisku ContextActionService albo konteksty, które zmieniają całe zestawy sterowania, na przykład dla menu albo pojazdu. Strona radzi też ustawić Workspace.PlayerScriptsUseInputActionSystem na Enabled, a server authority tego wymaga.

Pętla staminy i zryw z tego poradnika działają tak samo z samym Input Action System (bez server authority). Zostaw MovementConfig, pętlę Heartbeat i dash(), usuń dwa wywołania BindAction i ich handlery i podłącz zamiast nich akcje: Pressed akcji biegu ustawia sprintHeld na true, a jej Released na false, a Pressed akcji zrywu wywołuje dash(). Dalej szukaj Humanoid co klatkę, jak robi MovementClient, bo przykład z dokumentacji zachowuje Humanoid pierwszej postaci, a po respawnie już go nie ma.

Roblox testuje też Character Controller Library, betę, którą włącza się w Beta Features i Avatar Settings w Studio. Jej strona o własnych zdolnościach buduje jako przykład zryw z aktywnym oknem 0.2 sekundy i cooldownem 1 sekundy, czyli z tym samym timingiem co zryw z tego poradnika.

Jak rozbudować: animacja, kamera i pass na sprint

Animacja biegu

Zrób animację biegu w Animation Editor, ustaw jej priorytet Movement (Roblox zaleca go dla animacji chodu i biegu), opublikuj ją i skopiuj ID assetu. W MovementClient utwórz Animation z tym AnimationId, wczytaj ją przez Animator:LoadAnimation, używając Animator w Humanoid postaci, uruchamiaj track tam, gdzie zaczyna się bieg, i zatrzymuj tam, gdzie się kończy. Wczytuj ją od nowa dla każdej nowej postaci.

Animacje, które twoje urządzenie uruchamia na twojej postaci, widzą wszyscy, jeśli używasz Animatora, który włożył tam Roblox: tracki wczytane na Animator utworzony przez LocalScript się nie replikują. Humanoid:LoadAnimation, którego używa wiele starych tutoriali, jest przestarzały.

Szersza kamera w trakcie biegu

Trochę szersze pole widzenia sprawia, że bieg wydaje się szybszy. W tych samych dwóch miejscach tweenuj workspace.CurrentCamera.FieldOfView z domyślnego 70 do około 80, gdy bieg się zaczyna, i z powrotem, gdy się kończy, na przykład przez TweenService:Create(workspace.CurrentCamera, TweenInfo.new(0.25), { FieldOfView = 80 }):Play(). Roblox ogranicza wartość od 1 do 120 i ostrzega, że bardzo niskie albo bardzo wysokie wartości mogą dezorientować graczy. Jeśli pole widzenia zmienia też jakiś inny skrypt w grze, tweenuj z powrotem do znalezionej wartości, a nie do 70.

Szybszy sprint jako game pass

Poradnik o game passach już działa z tym skryptem: jego perk Speed na serwerze ustawia WalkSpeed 24 każdej nowej postaci, MovementClient dodaje na wierzch bonus biegu, a 34 study na sekundę mieszczą się w tym, na co pozwala MovementCheck.

Dla passa, który przyspiesza sam bieg, dodaj pass FastSprint do PassConfig.ids z tamtego poradnika. Jego serwerowy skrypt ustawia wtedy graczowi atrybut OwnsPass_FastSprint, gdy tylko zakup zostanie potwierdzony. W MovementClient używaj bonusu większego niż Config.SPRINT_BONUS, gdy player:GetAttribute("OwnsPass_FastSprint") == true. W MovementCheck daj takim graczom większą tolerancję, czytając ten sam atrybut na serwerze, gdzie gracz nie może go zmienić, i sprawdź, czy nowa maksymalna prędkość zostaje poniżej tego, co oznacza sprawdzenie.

Jedno ograniczenie, o którym warto wiedzieć: jeśli inny skrypt zmienia WalkSpeed w środku biegu, koniec tego biegu przywróci prędkość, która była przed nim. Następny respawn znowu ustawi prędkość passa, bo skrypt game passa stosuje ją do każdej nowej postaci.

Częste błędy i rozwiązania

Otwórz okno Output (menu Window, potem Output) przed kliknięciem Play. Większość problemów z tymi skryptami wypisuje tam błąd albo ostrzeżenie z nazwą skryptu i numerem linii.

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

MovementClient albo MovementCheck czeka na moduł, którego nie ma pod dokładnie taką nazwą. Musi to być ModuleScript o nazwie MovementConfig bezpośrednio w ReplicatedStorage. Poradnik o błędach skryptów szczegółowo omawia to ostrzeżenie.

Shift nic nie robi

Sprawdź, czy ShiftToSprint albo MovementClient to LocalScript, a nie Script, i czy leży w StarterPlayerScripts. Z MovementClient do startu biegu postać musi jeszcze iść i mieć co najmniej 20 staminy, więc trzymaj Shift w trakcie ruchu. Jeśli zamiast biegu przełącza się Shift Lock, zobacz pytanie o Shift Lock niżej.

Bieg kończy się po kilku sekundach

To kończy się stamina: 100 staminy po 20 na sekundę wystarcza na 5 sekund. Zwiększ MAX_STAMINA albo zmniejsz DRAIN_PER_SECOND w MovementConfig.

Zryw nic nie robi

Zryw potrzebuje 25 staminy, czeka 1 sekundę po poprzednim i nic nie robi, gdy siedzisz. Jeśli nie o to chodzi, główny part twojej postaci może nie mieć Attachment o nazwie RootAttachment, tak bywa z niektórymi własnymi postaciami: dodaj go do HumanoidRootPart swojego StarterCharacter.

Podwójny skok nie działa

DoubleJump musi być LocalScript w StarterCharacterScripts, a nie w StarterPlayerScripts, bo czyta script.Parent jako postać. Naciśnij skok drugi raz po oderwaniu się od ziemi: przytrzymany przycisk nie liczy się jako nowe naciśnięcie, a zejście z półki nie daje skoku w powietrzu.

Na telefonie nie ma przycisku Sprint albo Dash

ContextActionService dodaje swoje przyciski tylko na urządzeniach dotykowych, więc na PC bez ekranu dotykowego nigdy ich nie widać. Sprawdzaj z telefonem w Device Simulator w Studio (to beta: włącz New Device Simulator w File, Beta Features i uruchom Studio ponownie). BindAction może utworzyć nie więcej niż 7 przycisków dotykowych, więc policz, ile robią ich inne skrypty w grze.

MovementCheck czepia się uczciwych graczy

Zwykłe przyczyny: teleport z innego serwerowego skryptu, taśmociąg albo pojazd, albo lag. Ustawiaj atrybut MovementCheckSkip po swoich teleportach (zobacz Respawny i teleporty) i zwiększ SPEED_ALLOWANCE, jeśli sprawdzenie dalej się odpala w zwykłej grze.

Przyspieszenie znika po biegu

Inny skrypt zmienił WalkSpeed w trakcie biegu, a bieg, gdy się skończył, przywrócił prędkość, którą widział na starcie. Dawaj przyspieszenia przy spawnie postaci, jak robi poradnik o game passach, żeby respawn znowu ustawiał właściwą prędkość.

Zrób to z RoCode

Jeśli nie chce ci się ustawiać tego wszystkiego ręcznie, RoCode może to zbudować w grze, którą masz otwartą. RoCode to niezależny agent AI do Roblox Studio, nie robi go Roblox: opisujesz zmianę na czacie w przeglądarce, a jego plugin do Studio tworzy skrypty w twoim Explorerze, więc nie musisz wklejać kodu.

Ty piszesz

Dodaj sprint na Shift z paskiem staminy: prędkość chodu plus 10, dopóki wciśnięty jest Shift, 100 staminy, zużycie 20 na sekundę, odnawianie 15 na sekundę po sekundzie odpoczynku, przycisk Sprint na telefonach, zryw pod Q i podwójny skok.

RoCode robi
  • Może najpierw przejrzeć twoją grę przez Search Scripts i Read Script, żeby znaleźć inne skrypty, które zmieniają WalkSpeed (na przykład perk game passa), a bieg się do nich dodawał
  • Pisze ModuleScript, LocalScripty i serwerowe sprawdzenie przez Create Script
  • Ma polecone sprawdzać kompilację każdego napisanego skryptu przez Check Script, który kompiluje go w Studio bez uruchamiania
  • Stawia punkt cofania przed i po każdej paczce zmian, więc Ctrl+Z cofa po jednej paczce

RoCode nie umie robić animacji biegu: utwórz ją w Animation Editor i wstaw jej ID. Z pluginem 3.9.11 lub nowszym RoCode może uruchomić playtest twojej gry w Studio i sterować testową postacią, żeby sprawdzić, czy wszystko działa, a z pluginem 3.9.15 lub nowszym testowa postać może naciskać klawisze, na przykład trzymać Shift i sprawdzać, czy WalkSpeed urosła. Sam decyduje, kiedy uruchomić playtest, do 2 na budowę plus 1, żeby sprawdzić swoją poprawkę, i sprawdza tylko to, co sam postanowił przetestować, więc bieg, zryw i podwójny skok wypróbuj sam, a przyciski na telefonie sprawdź w Device Simulator w Studio. Ruch to jeden system z wielu w grze; tworzenie całej gry z RoCode idzie po jednym systemie na prompt, jak tutaj. Jak RoCode łączy się ze Studio.

Najczęstsze pytania

Dlaczego skrypt sprintu nie działa na telefonie?

Telefon nie ma klawisza Shift. Podpinaj sprint przez ContextActionService:BindAction i przekazuj true jako trzeci argument: to dodaje przycisk na ekranie na urządzeniach dotykowych, jak robią i ShiftToSprint, i MovementClient.

Czy sprint trzeba robić na serwerze?

Nie. Każde urządzenie porusza swoją postacią, więc WalkSpeed ustawiona przez serwer nie zatrzyma oszusta, który może ustawić własną, a nowa prędkość przychodzi dopiero po drodze tam i z powrotem, więc bieg zaczyna się z opóźnieniem. Rób sprint na kliencie, a na serwerze sprawdzaj, jak daleko naprawdę poruszają się postacie, jak w kroku 5. Beta server authority od Roblox działa inaczej i kod ruchu trzeba będzie dla niej przepisać.

Dlaczego postać dalej biegnie, gdy puściłem Shift?

Skrypt przegapił puszczenie, zwykle dlatego, że nasłuchuje tylko naciśnięcia. ContextActionService wysyła End, gdy klawisz zostaje puszczony, i Cancel, gdy przejmuje go inne podpięcie; MovementClient zatrzymuje się na obu, a także gdy kończy się stamina albo postać przestaje się ruszać.

Jak dodać animację biegu?

Wczytaj animację biegu przez Animator w Humanoid postaci w tym samym LocalScript, uruchamiaj ją, gdy bieg się zaczyna, i zatrzymuj, gdy się kończy. Daj jej priorytet Movement. Animacje uruchomione na twojej własnej postaci widzą wszyscy.

Dlaczego podwójny skok na telefonie odpala się sam?

Przytrzymany przycisk skoku na telefonie dalej prosi o skoki. Traktuj skok jako nowy tylko wtedy, gdy żądania na chwilę ustały, jak robi skrypt DoubleJump.

Jaka jest domyślna prędkość chodu w Roblox?

16 studów na sekundę. Pochodzi z StarterPlayer.CharacterWalkSpeed, który ustawia Humanoid.WalkSpeed każdej nowej postaci. Sprint z tego poradnika dodaje 10, więc bieg idzie z prędkością 26.

Jak szybki powinien być sprint w Roblox?

Większość gier dodaje od połowy do całej prędkości chodu: 16 staje się czymś od 24 do 32. Krótki wolny bieg pasuje do horroru, a długi szybki do dużych map. Presety według typu gry dają dla każdego prędkość chodu, bonus biegu i liczby staminy.

Jak zrobić sprint ze staminą?

Trzymaj liczbę staminy na urządzeniu gracza, zużywaj ją co klatkę w trakcie biegu i odnawiaj po krótkim odpoczynku, w obu przypadkach z uwzględnieniem czasu klatki, i zatrzymuj bieg, gdy dojdzie do 0. MovementClient z kroku 3 robi to z paskiem na ekranie; liczby leżą w MovementConfig.

Jak sprintować z kontrolerem w Roblox?

Podepnij ButtonL3 pada (naciśnięcie lewej gałki) przez ContextActionService razem z Left Shift, jak robią oba skrypty tutaj. ShiftToSprint robi z L3 przełącznik, bo trzymanie wciśniętej gałki i jednoczesne sterowanie nią męczy.

Czy sprint na Shift koliduje z Shift Lock?

Może. Gracze, którzy włączyli Shift Lock w ustawieniach Roblox, przełączają go klawiszem Shift, więc jeden klawisz robi dwie rzeczy. W dokumentacji Roblox napisano, że API Shift Lock są wycofywane. Jeśli konflikt przeszkadza twoim graczom, wyłącz StarterPlayer.EnableMouseLockOption albo podepnij sprint w MovementClient do innego klawisza, na przykład Left Ctrl.

Źródła i dalsza lektura

Jak sprawdziliśmy kod: każdy skrypt na tej stronie przechodzi ścisłe sprawdzanie typów Luau z definicjami API Robloxa (luau-lsp, 20 listopada 2026). Sprawdzanie typów wyłapuje źle wpisane API i błędne typy, ale nie logikę gry, więc przetestuj go w Studio przed publikacją.

Wypróbuj RoCode we własnej grze.

Darmowe kredyty codziennie, bez karty. Zainstaluj plugin, opisz funkcję i sprawdź, co pojawi się w Studio.