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
Jak działa sprint w Roblox
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.
| Element | Gdzie jest | Co robi |
|---|---|---|
LocalScript ShiftToSprint | StarterPlayerScripts | Krok 1 sam w sobie: sprint na klawiaturze, telefonie i padzie, bez staminy. Gdy dodajesz staminę i zryw, zastępuje go MovementClient. |
ModuleScript MovementConfig | ReplicatedStorage | Liczby: bonus biegu, stamina i zryw. Czytają je i LocalScript, i serwerowe sprawdzenie. |
LocalScript MovementClient | StarterPlayerScripts | Podpina Sprint i Dash do klawisza, przycisku pada i przycisku dotykowego, kręci pętlą staminy, rysuje pasek i robi zryw. |
LocalScript DoubleJump | StarterCharacterScripts | Daje jeden dodatkowy skok w powietrzu. Nowa kopia uruchamia się w każdej nowej postaci. |
Script MovementCheck | ServerScriptService | Mierzy, 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. |
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ą.
- W Explorerze rozwiń StarterPlayer, najedź na StarterPlayerScripts, kliknij przycisk + i wstaw LocalScript o nazwie
ShiftToSprint. - Zastąp jego zawartość kodem poniżej i kliknij Play.
-- 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?
| Urządzenie i wejście | Działa jak | Dlaczego |
|---|---|---|
| Klawiatura: Left Shift | Przytrzymanie | Trzymanie klawisza w trakcie ruchu jest łatwe, a puszczenie od razu zatrzymuje bieg. |
| Pad: naciśnięcie lewej gałki (L3) | Przełączanie | Trzymanie wciśniętej gałki i jednoczesne sterowanie nią męczy. |
| Telefon albo tablet: przycisk Sprint na ekranie | Przełączanie | Kciuk, 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.
- W Explorerze najedź na ReplicatedStorage, kliknij przycisk + i wstaw ModuleScript.
- Zmień jego nazwę na
MovementConfigi zastąp zawartość kodem poniżej.
-- 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
| Ustawienie | Wartość | Efekt |
|---|---|---|
SPRINT_BONUS | 10 | Dodawane 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_STAMINA | 100 | Pełny pasek. |
DRAIN_PER_SECOND | 20 | Pełny pasek wystarcza na 5 sekund biegu. |
REGEN_PER_SECOND | 15 | Pusty pasek wypełnia się w około 6.7 sekundy. |
REGEN_DELAY | 1 | Sekundy odpoczynku przed początkiem odnawiania. |
MIN_TO_START | 20 | Stamina potrzebna, żeby zacząć bieg. |
DASH_SPEED | 60 | Studów na sekundę w trakcie zrywu. |
DASH_SECONDS | 0.2 | Ile trwa zryw: około 12 studów przy 60 studach na sekundę. |
DASH_COST | 25 | Stamina na każdy zryw. |
DASH_COOLDOWN | 1 | Sekundy 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.
- W Explorerze rozwiń StarterPlayer, najedź na StarterPlayerScripts i wstaw LocalScript o nazwie
MovementClient. - Zastąp jego zawartość kodem poniżej.
-- 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.
- W Explorerze rozwiń StarterPlayer, najedź na StarterCharacterScripts i wstaw LocalScript o nazwie
DoubleJump. - Zastąp jego zawartość kodem poniżej.
-- 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.
- Najedź na ServerScriptService i wstaw Script o nazwie
MovementCheck. - Zastąp jego zawartość kodem poniżej.
-- 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.
| Oszust | Co robi MovementCheck |
|---|---|
| Ustawia WalkSpeed 100 | Ostrzega po około sekundzie biegu |
| Ustawia WalkSpeed 50 | Ostrzega 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 naraz | Ostrzega przy następnym sprawdzeniu |
| Biegnie z prędkością do 38 studów na sekundę, mniej więcej półtora raza szybciej niż sprint | Nic: poniżej 38.5 studa na sekundę wiadro opróżnia się tak szybko, jak się napełnia |
| Zmienia swój MovementConfig dla nieskończonej staminy | Nic: bieg z prędkością 26 studów na sekundę jest dozwolony dowolnie długo |
| Lata, skacze bez ograniczeń albo przechodzi przez ściany | Nic: 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:
- W systemie rund zaraz po
character:PivotTo(...)wstartRound. - W skrypcie checkpointów do obby zaraz po każdym
character:PivotTo(...), który przenosi gracza na jego checkpoint.
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
- 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.
- Puść Shift. Po 1 sekundzie pasek zaczyna się wypełniać. Dopóki nie wypełni się w jednej piątej, Shift nic nie robi.
- 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_SPEEDalboDASH_SECONDSw MovementConfig. - 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.
- 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.
- 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.
- 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.
- 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.
- 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. - Jeśli w twojej grze
Workspace.PlayerScriptsUseInputActionSystemjest ustawione na Enabled, sprawdź podwójny skok jeszcze raz: dokumentacja Roblox nie mówi, czyJumpRequestzachowuje 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.
| Typ gry | CharacterWalkSpeed | SPRINT_BONUS (prędkość biegu) | DRAIN_PER_SECOND | REGEN_PER_SECOND | Pełny bieg | Od pustego do pełnego | Dystans na jednym pasku |
|---|---|---|---|---|---|---|---|
| Ten poradnik | 16 | 10 (26) | 20 | 15 | 5 s | 7.7 s | 130 studów |
| Pościg w horrorze | 12 | 8 (20) | 25 | 10 | 4 s | 11 s | 80 studów |
| Battlegroundy i walka | 16 | 12 (28) | 15 | 20 | 6.7 s | 6 s | około 187 studów |
| Otwarty świat albo symulator | 16 | 16 (32) | 10 | 25 | 10 s | 5 s | 320 studów |
| Obby albo parkour | 16 | 8 (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 niejSPRINT_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ą.
| Sposób | W czym problem | Ten poradnik |
|---|---|---|
BodyVelocity do zrywu | Przestarzały: Roblox mówi, żeby używać zamiast niego LinearVelocity | LinearVelocity w trybie Plane |
Pętla na RunService.RenderStepped | Do 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 zdrowia | Heartbeat 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ówno | Zużycie i odnawianie co klatkę z uwzględnieniem deltaTime |
UserInputService.InputBegan bez sprawdzenia czatu | Naciśnięcie Shift w trakcie pisania wiadomości na czacie uruchamia bieg | ContextActionService, 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 passa | Zmienia WalkSpeed tylko na starcie i na końcu biegu, dodając do bieżącej wartości |
| Sprint przez RemoteEvent, żeby WalkSpeed ustawiał serwer | Exploiterzy i tak ustawiają sobie WalkSpeed sami, a bieg zaczyna się z opóźnieniem na drogę tam i z powrotem | Sprint na kliencie plus sprawdzenie odległości na serwerze |
Podwójny skok przy każdym JumpRequest | JumpRequest odpala się kilka razy na jedno żądanie skoku, a przytrzymany przycisk może dalej prosić o skoki | Przerwa 0.25 sekundy i sprawdzenie nowego naciśnięcia |
UserInputService.TouchEnabled jako sprawdzenie „to telefon” | Jest true na laptopach z ekranem dotykowym | ContextActionService dodaje przyciski na ekranie na urządzeniach dotykowych bez twojego własnego sprawdzania urządzenia |
Humanoid:LoadAnimation do animacji biegu | Przestarzały na rzecz Animator:LoadAnimation | Animacja 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.
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.
- 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
- Roblox Creator Docs: ContextActionService (po angielsku). BindAction, przyciski dotykowe, limit 7 przycisków i dlaczego w większości przypadków jest lepszy niż InputBegan
- Roblox Creator Docs: Humanoid (po angielsku). WalkSpeed i uwaga o bezpieczeństwie, MoveDirection, StateChanged i ChangeState z przykładem podwójnego skoku
- Roblox Creator Docs: LinearVelocity (po angielsku). tryb Plane, osie styczne i MaxForce
- Roblox Creator Docs: Mover constraints (po angielsku). przejście z przestarzałego BodyVelocity na LinearVelocity
- Roblox Creator Docs: UserInputService (po angielsku). JumpRequest i dlaczego potrzebuje debounce
- Roblox Creator Docs: Network ownership, movement validation, and physics (po angielsku). co kontroluje klient, sprawdzenia odległości, dziurawe wiadra i wyjątki dla teleportów
- Roblox Creator Docs: Server authority model (po angielsku). model z ruchem na serwerze, BindToSimulation i wymagane przez niego ustawienia Workspace
- Roblox Creator Docs: Input Action System (po angielsku). przykład Character Sprint z InputAction i InputBinding
- Roblox Creator Docs: Custom abilities (po angielsku). zdolność zrywu w Character Controller Library
- Roblox Creator Docs: Studio testing modes (po angielsku). Device Simulator i Controller Emulator
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ą.