V skratke
Dajte jeden LocalScript do StarterPlayerScripts, ktorý naviaže akciu Sprint cez ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3). Kým je Shift stlačený, pripočítajte 10 k Humanoid.WalkSpeed (zo 16 je 26) a po pustení vráťte pôvodnú hodnotu. Argument true pridá na dotykových obrazovkách tlačidlo Sprint a v skripte z tohto návodu toto tlačidlo aj L3 na gamepade sprint zapínajú a vypínajú, nefungujú na podržanie.
- Pripočítavajte k aktuálnej WalkSpeed, nenastavujte 26, aby zrýchlenie z gamepassu zostalo zachované.
- Sprint beží na zariadení hráča. Server nemôže WalkSpeed vynútiť; môže len merať, ako ďaleko sa postavy pohnú, a označiť rýchlosť, ktorú sprint nevysvetlí.
- Ukazovateľ staminy, dash a dvojitý skok na rovnakom princípe pridávajú Kroky 2 až 4. Ako rýchlo a ako dlho bežať, napovedia predvoľby podľa typu hry s číslami pre horor, bojovku a otvorený svet.
Na tejto stránke
Ako funguje sprint v Robloxe
Zariadenie každého hráča hýbe jeho vlastnou postavou. Klávesnica, ovládač alebo dotyková obrazovka rozhodujú, kam postava ide, a Roblox výsledok odovzdá serveru a všetkým ostatným. Preto je sprint LocalScript, ktorý zvýši Humanoid.WalkSpeed, kým je kláves stlačený, a to je všetko, čo robí Krok 1. Zvyšok návodu je to, čo okolo neho potrebuje väčšia hra: ukazovateľ staminy, dash, dvojitý skok a serverová kontrola proti cheaterom.
| Prvok | Kde je | Čo robí |
|---|---|---|
LocalScript ShiftToSprint | StarterPlayerScripts | Samotný Krok 1: sprint na klávesnici, mobile a gamepade, bez staminy. Keď pridáte staminu a dash, nahradí ho MovementClient. |
ModuleScript MovementConfig | ReplicatedStorage | Čísla: bonus sprintu, stamina a dash. Číta ich LocalScript aj serverová kontrola. |
LocalScript MovementClient | StarterPlayerScripts | Naviaže Sprint a Dash na kláves, tlačidlo gamepadu a dotykové tlačidlo, poháňa cyklus staminy, kreslí ukazovateľ a robí dash. |
LocalScript DoubleJump | StarterCharacterScripts | Dá jeden skok navyše vo vzduchu. Nová kópia sa spustí v každej novej postave. |
Script MovementCheck | ServerScriptService | Meria, ako ďaleko sa každá postava v skutočnosti pohne, a zapíše varovanie do Output, keď sa niekto dlho hýbe rýchlejšie, než dovoľujú sprint a dash. |
ReplicatedStorage
MovementConfig ModuleScript new
ServerScriptService
MovementCheck Script new
StarterPlayer
StarterCharacterScripts
DoubleJump LocalScript new
StarterPlayerScripts
MovementClient LocalScript new
Ak je pre vás rozdiel medzi Scriptom a LocalScriptom nový, Script, LocalScript a ModuleScript vysvetľuje, kde sa spúšťa každý druh a prečo.
Krok 1: sprint na Shift v jednom LocalScripte
Ak potrebujete len rýchlejší beh, kým držíte Shift, stačí tento jediný skript. Navyše dá mobilom tlačidlo Sprint na obrazovke a na gamepade umožní šprintovať ľavou páčkou.
- V Exploreri rozbaľte StarterPlayer, nabehnite na StarterPlayerScripts, kliknite na tlačidlo + a vložte LocalScript s názvom
ShiftToSprint. - Nahraďte jeho obsah kódom nižšie a stlačte Play.
-- LocalScript v StarterPlayer > StarterPlayerScripts s názvom ShiftToSprint.
-- Držte Left Shift, ak chcete šprintovať. Na gamepade stlačte ľavú páčku (L3), aby ste
-- sprint zapli alebo vypli. Na mobile stlačte tlačidlo Sprint, aby ste ho zapli alebo vypli.
local ContextActionService = game:GetService("ContextActionService")
local Players = game:GetService("Players")
-- Nastavenia
local SPRINT_BONUS = 10 -- pripočíta sa k WalkSpeed počas sprintu (zo 16 je 26)
local TOGGLE_ON_TOUCH_AND_GAMEPAD = true -- false: tlačidlo treba držať
local player = Players.LocalPlayer
local sprinting = false
local normalSpeed = 16 -- WalkSpeed, ku ktorej sa treba vrátiť
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
-- Zapamätáme si aktuálnu rýchlosť a pripočítame k nej, aby zrýchlenie z iného skriptu zostalo
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
-- Držanie: sprint, kým je kláves alebo tlačidlo stlačené
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
-- Prepínanie: každé stlačenie sprint zapne alebo vypne
setSprinting(not sprinting)
end
return Enum.ContextActionResult.Pass
end
-- Jedno volanie naviaže kláves, tlačidlo gamepadu a na dotykových obrazovkách tlačidlo na obrazovke
ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3)
ContextActionService:SetTitle("Sprint", "Sprint")
-- Nová postava začína chôdzou: jej Humanoid už má bežnú WalkSpeed
player.CharacterAdded:Connect(function()
sprinting = false
end)
Meňte SPRINT_BONUS, aby bol sprint rýchlejší alebo pomalší. Nastavte TOGGLE_ON_TOUCH_AND_GAMEPAD na false, aby tlačidlo na mobile a L3 fungovali ako Shift: sprint len počas držania.
BindAction naviaže jednu akciu na Left Shift a na tlačidlo L3 na gamepade a jeho tretí argument, true, pridá tlačidlo na dotykových obrazovkách; SetTitle na ňom napíše "Sprint". Obsluha dostane aj samotný vstup, takže rozlíši stlačenie na klávesnici od gamepadu alebo dotykového tlačidla. Keď sprint začne, skript si zapamätá aktuálnu WalkSpeed a pripočíta SPRINT_BONUS; keď skončí, vráti zapamätanú hodnotu. Rýchlosť, ktorú nastavil iný skript, napríklad perk Speed z návodu na gamepassy, zostane zachovaná. Nová postava začína s bežnou WalkSpeed, takže obsluha CharacterAdded len vynuluje príznak.
Držanie alebo prepínanie?
| Zariadenie a vstup | Funguje ako | Prečo |
|---|---|---|
| Klávesnica: Left Shift | Držanie | Držať kláves počas pohybu je ľahké a pustenie sprint hneď zastaví. |
| Gamepad: stlačenie ľavej páčky (L3) | Prepínanie | Držať páčku stlačenú a zároveň ňou riadiť je únavné. |
| Mobil alebo tablet: tlačidlo Sprint na obrazovke | Prepínanie | Palec, ktorý drží tlačidlo, nemôže v tom istom čase stlačiť Jump. |
Ak to chcete overiť, stlačte Play a počas chôdze držte Shift: rýchlosť stúpne zo 16 na 26 studov za sekundu, a keď pustíte, spomalíte. Pre mobil vyberte telefón v Device Simulatore v Studiu, stlačte Play a ťuknite na Sprint raz na začatie a ešte raz na zastavenie. Pre gamepad otvorte počas playtestu Controller Emulator a stlačte L3. Úplný zoznam kontrol podľa zariadení je v Kroku 6.
Kroky 2 a 3 nahrádzajú tento skript iným, s ukazovateľom staminy a dashom. Kroky 4 a 5 pridávajú dvojitý skok a serverovú kontrolu a fungujú s ktorýmkoľvek z oboch skriptov.
Krok 2: čísla staminy a dashu v jednom module
Pre sprint, ktorý sa minie, Kroky 2 a 3 vymenia ShiftToSprint za väčší LocalScript s ukazovateľom staminy a dashom. Najprv odstráňte ShiftToSprint: oba skripty viažu akciu Sprint.
Všetky čísla sú v jednom ModuleScripte, takže pocit z pohybu sa ladí na jednom mieste. MovementClient ich číta na zariadení každého hráča a MovementCheck číta ten istý modul na serveri, aby vedel, aká má byť rýchlosť sprintu a dashu.
- V Exploreri nabehnite na ReplicatedStorage, kliknite na tlačidlo + a vložte ModuleScript.
- Premenujte ho na
MovementConfiga nahraďte obsah kódom nižšie.
-- Jedna sada čísel pre LocalScript pohybu a serverovú kontrolu rýchlosti.
local MovementConfig = {
SPRINT_BONUS = 10, -- pripočíta sa k aktuálnej WalkSpeed: 16 (predvolená hodnota Robloxu) sa zmení na 26
MAX_STAMINA = 100,
DRAIN_PER_SECOND = 20, -- 5 sekúnd sprintu s plným ukazovateľom
REGEN_PER_SECOND = 15,
REGEN_DELAY = 1, -- sekundy po skončení sprintu, kým sa stamina začne obnovovať
MIN_TO_START = 20, -- stamina potrebná na začatie sprintu, aby prázdny ukazovateľ neblikal
DASH_SPEED = 60, -- studov za sekundu počas dashu
DASH_SECONDS = 0.2, -- takto dash prejde asi 12 studov
DASH_COST = 25, -- stamina
DASH_COOLDOWN = 1,
}
return MovementConfig
| Nastavenie | Hodnota | Efekt |
|---|---|---|
SPRINT_BONUS | 10 | Pripočíta sa k WalkSpeed počas sprintu. Predvolená WalkSpeed v Robloxe je 16, takže sprint ide rýchlosťou 26 studov za sekundu. |
MAX_STAMINA | 100 | Plný ukazovateľ. |
DRAIN_PER_SECOND | 20 | Plný ukazovateľ vystačí na 5 sekúnd sprintu. |
REGEN_PER_SECOND | 15 | Prázdny ukazovateľ sa doplní asi za 6.7 sekundy. |
REGEN_DELAY | 1 | Sekundy oddychu pred začiatkom obnovy. |
MIN_TO_START | 20 | Stamina potrebná na začatie sprintu. |
DASH_SPEED | 60 | Studov za sekundu počas dashu. |
DASH_SECONDS | 0.2 | Ako dlho trvá dash: asi 12 studov pri 60 studoch za sekundu. |
DASH_COST | 25 | Stamina za každý dash. |
DASH_COOLDOWN | 1 | Sekundy medzi dashmi. |
Každá strana spúšťa vlastnú kópiu modulu (modul sa spustí raz na každej strane), takže hráč, ktorý tieto čísla zmení na svojom zariadení, zmení len svoju kópiu. Tu to však nič nechráni: jeho zariadenie aj tak hýbe jeho postavou, takže si môže dať nekonečnú staminu bez ohľadu na to, čo je v module. Serverová kontrola z Kroku 5 s tým počíta.
Krok 3: sprint so staminou a dash
Tento LocalScript robí to, čo hráči cítia. Naviaže Sprint a Dash, kreslí ukazovateľ staminy, každý snímok poháňa cyklus staminy a robí dash.
- V Exploreri rozbaľte StarterPlayer, nabehnite na StarterPlayerScripts a vložte LocalScript s názvom
MovementClient. - Nahraďte jeho obsah kódom nižšie.
-- Držte Shift (alebo L3, alebo tlačidlo Sprint na mobile), aby ste šprintovali, kým je stamina.
-- Stlačte Q (alebo B, alebo tlačidlo Dash), aby ste urobili dash v smere pohybu.
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, ku ktorej sa vrátiť, keď sprint skončí
local lastSprintTime = 0
local lastDashTime = -math.huge
-- Ukazovateľ staminy: rámik s výplňou, ktorej šírka zodpovedá zostávajúcej stamine
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
-- Sprint: tu je len príznak; cyklus Heartbeat nižšie každý snímok rozhoduje, či šprintovať
local function onSprint(_name: string, state: Enum.UserInputState, _input: InputObject): Enum.ContextActionResult
-- Menia ho len stlačenie a pustenie: prst kĺzajúci po dotykovom tlačidle posiela 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()
-- V sede dash nie je: sediaca postava je privarená k sedadlu, takže by strčila celé vozidlo
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 -- pozastavíme obnovu, ako to robí sprint
-- Dash tam, kam sa hráč hýbe, alebo tam, kam sa pozerá, ak stojí na mieste
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 v režime Plane drží vodorovnú rýchlosť a neprekáža gravitácii
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ždé volanie naviaže kláves, tlačidlo gamepadu a na dotykových zariadeniach tlačidlo na obrazovke
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")
-- Každý snímok: míňame staminu počas sprintu a pohybu, obnovujeme ju po krátkom oddychu
RunService.Heartbeat:Connect(function(deltaTime: number)
local humanoid = getHumanoid()
if not humanoid then
return
end
local moving = humanoid.MoveDirection.Magnitude > 0
local now = os.clock()
local enoughStamina = if sprinting then stamina > 0 else stamina >= Config.MIN_TO_START
local shouldSprint = sprintHeld and moving and enoughStamina
-- WalkSpeed meníme len na začiatku a na konci sprintu, aby rýchlosť nastavená
-- iným skriptom (napríklad passom na rýchlosť) zostala a sprint sa k nej pripočítal
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)
-- Nová postava začína s plnou staminou a nič nie je stlačené
player.CharacterAdded:Connect(function()
stamina = Config.MAX_STAMINA
sprintHeld = false
sprinting = false -- nový Humanoid začína s bežnou WalkSpeed
end)
Ukazovateľ staminy sa vytvára v kóde s ResetOnSpawn rovným false, takže zostáva na obrazovke aj po respawne, a obsluha CharacterAdded dole ho znova naplní pre každú novú postavu. Riadky type Config opisujú, čo modul vracia, aby striktná kontrola typov zachytila preklep v názve nastavenia; počas hry nič nemenia.
Klávesnica, gamepad a tlačidlo na mobile jedným volaním
ContextActionService:BindAction prijíma názov akcie, funkciu obsluhy, či sa má vytvoriť dotykové tlačidlo, a potom vstupy. Ak ako tretí argument odovzdáte true, ContextActionService pridá na dotykových zariadeniach tlačidlo na obrazovku, vnútri ScreenGui s názvom ContextActionGui v PlayerGui hráča. SetTitle na tieto tlačidlá napíše "Sprint" a "Dash". BindAction dokáže vytvoriť najviac 7 dotykových tlačidiel, takže sledujte ich počet, ak ich používajú aj iné skripty v hre.
Obsluha dostane stav vstupu: Begin pri stlačení a End pri pustení. onSprint si len pamätá, či je Sprint stlačený. Za pustenie považuje aj Cancel, ktorý ContextActionService pošle, keď vstup zachytí iné naviazanie, a ignoruje Change, ktorý môže poslať prst pohybujúci sa po dotykovom tlačidle. Obe obsluhy vracajú Pass, takže vstup dostane aj ďalšie naviazanie na tom istom klávese.
Referencia Robloxu k ContextActionService ho vo väčšine prípadov odporúča namiesto UserInputService.InputBegan. Jej príklad: klaksón auta na H, ktorý nemá trúbiť, kým hráč píše do chatu. Naviazanie sa spustí, len kým je posledné pre daný vstup, takže keď chat zoberie klávesnicu, nemusíte nič kontrolovať. Vstupy gamepadu: ButtonL3 (stlačenie ľavej páčky, drží sa počas pohybu) a ButtonB. Vlastný príklad sprintu od Robloxu používa ButtonY, takže zmeňte KeyCode v BindAction, ak to vašej hre viac vyhovuje.
Cyklus staminy
RunService.Heartbeat sa spúšťa každý snímok po kroku fyziky a odovzdáva deltaTime, počet sekúnd od minulého snímku. Ak ním násobíte rýchlosť míňania a obnovy, plný ukazovateľ vystačí na 5 sekúnd, či hra beží na 30 alebo na 240 snímkach za sekundu.
Každý snímok cyklus rozhoduje, či má postava šprintovať: Sprint je stlačený, postava ide (Humanoid.MoveDirection je nulový vektor, keď stojí) a stamina ešte zostáva. Na začatie sprintu treba aspoň MIN_TO_START (20); na pokračovanie stačí čokoľvek nad 0. Bez tejto medzery by prázdny ukazovateľ, ktorý sa každý snímok trošku doplní, zapínal a vypínal sprint každý snímok. Obnova začne REGEN_DELAY (1 sekundu) po poslednom sprinte alebo dashi, takže keď hráč ukazovateľ vyprázdni, čaká asi 2.3 sekundy, kým môže znova šprintovať.
WalkSpeed sa mení len v snímku, keď sprint začne alebo skončí. Na začiatku si skript zapamätá aktuálnu WalkSpeed a pripočíta SPRINT_BONUS; na konci vráti zapamätanú hodnotu. Preto rýchlosť nastavená iným skriptom zostane zachovaná: perk Speed z návodu na gamepassy nastaví WalkSpeed 24 a s týmto skriptom jeho majitelia šprintujú na 34. Skript, ktorý zapisuje WalkSpeed = 16 každý snímok alebo pri každom pustení, by tento perk nenápadne zrušil.
Dash
Dash strčí postavu tam, kam sa hýbe, alebo tam, kam sa pozerá, ak stojí na mieste, pričom smer sa vyrovná, aby nikdy nemieril hore ani dole. Stojí 25 staminy, pozastaví obnovu ako sprint a má cooldown 1 sekundu. Zem sa v ňom nekontroluje, takže funguje aj vo vzduchu, čo sa dobre spája s dvojitým skokom. Kým postava sedí, dash nerobí nič: sediaca postava je privarená k sedadlu a vo vozidle by náraz mohol pohnúť celým vozidlom.
Náraz je obmedzenie LinearVelocity na RootAttachment koreňového partu. V režime Plane s osami X a Z drží vodorovnú rýchlosť 60 studov za sekundu a zvislej sa nedotýka, takže gravitácia funguje a dash z rímsy padá ako zvyčajne. MaxForce je math.huge, takže náraz nie je ničím obmedzený. Debris:AddItem obmedzenie zničí po DASH_SECONDS bez toho, aby skript musel čakať, takže dash trvá 0.2 sekundy, asi 12 studov pri tejto rýchlosti.
Staré návody používajú BodyVelocity, ktorý Roblox označil ako zastaraný s poznámkou používať namiesto neho LinearVelocity. Jeho trik s nulovým MaxForce na jednej osi nahrádzajú režimy Line, Plane a Vector pri LinearVelocity. Keďže zariadenie hráča samo simuluje jeho postavu, obmedzenie vytvorené LocalScriptom ňou hýbe a ostatní hráči vidia dash ako akýkoľvek iný pohyb.
Vlastný UI návod Robloxu pripája obmedzenie k humanoid.RootPart.RootAttachment presne takto. Ak má vaša hra vlastnú postavu, ktorej koreňový part nemá Attachment s názvom RootAttachment, dash nerobí nič: pridajte ho do HumanoidRootPart vášho StarterCharacter.
Krok 4: dvojitý skok
Dvojitý skok žije vo vlastnom LocalScripte v StarterCharacterScripts. Roblox vloží kópiu skriptov z tohto kontajnera do každej postavy pri spawne a tieto kópie respawn neprežijú, takže každý život začína s čerstvým skriptom a nič sa neprenáša z minulého.
- V Exploreri rozbaľte StarterPlayer, nabehnite na StarterCharacterScripts a vložte LocalScript s názvom
DoubleJump. - Nahraďte jeho obsah kódom nižšie.
-- Dá jeden skok navyše vo vzduchu. Spúšťa sa nanovo pre každú novú postavu,
-- takže po respawne sa nič neprenáša.
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 sa spustí niekoľkokrát na jedno stlačenie
local NEW_PRESS_GAP = 0.1 -- držané tlačidlo skoku stále posiela JumpRequest; pauza takejto dĺžky znamená, že ho pustili
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 zo zeme (nie jeden z našich skokov vo vzduchu) obnoví skoky vo vzduchu
jumpsLeft = EXTRA_JUMPS
lastJump = os.clock()
elseif newState == Enum.HumanoidStateType.Landed then
jumpsLeft = 0
end
end)
-- JumpRequest sa spustí, keď hráč požiada o skok, napríklad cez Space alebo tlačidlo skoku na mobile
UserInputService.JumpRequest:Connect(function()
local now = os.clock()
local newPress = now - lastRequest > NEW_PRESS_GAP
lastRequest = now
-- Znova skáče len nové stlačenie, aby držané tlačidlo neminulo skok vo vzduchu
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)
Nastavte EXTRA_JUMPS na 2 pre trojitý skok.
Skript sleduje stav postavy cez Humanoid.StateChanged. Prechod do Jumping, ktorý neprišiel z Freefall, je skok zo zeme, takže pridelí skok vo vzduchu, a Landed ho znova zoberie. Ak postava zíde z rímsy, dostane sa do Freefall bez skoku, takže skok vo vzduchu nedostane. Ak ho chcete aj tam, nastavujte jumpsLeft aj pri prechode do Freefall z akéhokoľvek stavu okrem Jumping.
UserInputService.JumpRequest sa spustí, keď hráč požiada o skok, napríklad cez Space alebo tlačidlo skoku na mobile. Referencia Robloxu upozorňuje, že sa spúšťa niekoľkokrát na jednu požiadavku skoku, a odporúča debounce, preto skript ignoruje požiadavky počas 0.25 sekundy po poslednom skoku. Držané tlačidlo skoku tiež môže ďalej žiadať o skoky a minulo by skok vo vzduchu v tom istom okamihu, keď sa postava odlepí od zeme, preto sa požiadavka považuje za nové stlačenie až po 0.1 sekundy bez požiadaviek.
Samotný skok vo vzduchu je Humanoid:ChangeState(Enum.HumanoidStateType.Jumping). Referencia Robloxu hovorí, že ho treba volať z LocalScriptu na zariadení, ktoré má sieťové vlastníctvo postavy, a predvolene je to zariadenie samotného hráča, nie server. Ukážkový kód k ChangeState v referencii je práve dvojitý skok.
Krok 5: chytáme speedhack na serveri
Návody na sprint často končia na klientovi. Serverový Script nemôže veriť WalkSpeed hráča, pretože exploiteri ju menia na svojom zariadení, ale vidí, kde ich postava skončí. MovementCheck to meria dvakrát za sekundu a zapíše varovanie do Output, keď sa niekto dlho hýbe rýchlejšie, než dovoľujú sprint a dash. Čísla sprintu a dashu číta z MovementConfig, takže tento modul z Kroku 2 pridajte, aj keď ste si nechali ShiftToSprint.
- Nabehnite na ServerScriptService a vložte Script s názvom
MovementCheck. - Nahraďte jeho obsah kódom nižšie.
-- Zariadenia hráčov hýbu svojimi postavami, takže exploiter si môže nastaviť akúkoľvek WalkSpeed.
-- Táto kontrola meria, ako ďaleko sa každá postava v skutočnosti pohne, a zapíše do Output,
-- keď sa niekto dlho hýbe rýchlejšie, než dovoľujú sprint a dash. Len varuje:
-- lag, teleporty a dopravníky môžu vyzerať ako prekročenie rýchlosti, takže ju nalaďte skôr, ako niekoho potrestáte.
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
-- Rýchlosť sprintu plus rezerva na lag. Zväčšite, ak predávate zrýchlenia.
local SPEED_ALLOWANCE = (StarterPlayer.CharacterWalkSpeed + Config.SPRINT_BONUS) * 1.25
local BURST_ALLOWANCE = Config.DASH_SPEED * Config.DASH_SECONDS * 2 -- rezerva na jeden alebo dva dashe
local DRAIN_PER_CHECK = BURST_ALLOWANCE / 8 -- ako rýchlo sa minulé dashe odpúšťajú
local lastPosition: { [Player]: Vector3 } = {}
local lastRoot: { [Player]: BasePart } = {} -- koreňový part, na ktorom sa merala lastPosition
local excess: { [Player]: number } = {} -- study nad povolenú mieru, postupne sa odpúšťajú
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 je nový koreňový part a serverový teleport (štart kola, checkpoint)
-- nastaví atribút nižšie: začneme merať odznova, neoznačíme 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
-- Len vodorovný pohyb: rýchlo padať nie je cheatovanie
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
Varovanie sa objaví v Output v Studiu. V živej hre sa dostane do serverového logu Developer Console, ktorý môžete čítať ako vlastník hry: pozrite výstup v živej hre.
Čo meria
Každú pol sekundu skript prečíta pozíciu koreňového partu každej postavy a zmeria, o koľko sa vodorovne posunul od minulej kontroly. Výška sa ignoruje, takže pády a skoky sa nikdy nepočítajú; rada Robloxu ku kontrole pohybu odporúča tú istú projekciu na rovinu XZ pre hry, kde sa chodí po zemi. Povolená miera je predvolená rýchlosť chôdze plus bonus sprintu a ešte štvrtina na lag: 32.5 studa za sekundu. Vzdialenosť nad to ide do „deravého vedra“, zásobníka, o ktorom dokumentácia Robloxu uvádza, že mnohým vývojárom dobre slúži na krátke výpady. Vedro stratí 3 study pri každej kontrole a skript varuje, keď je v ňom viac ako 24 studov, čo je rezerva približne na dva dashe.
| Cheater | Čo urobí MovementCheck |
|---|---|
| Nastaví WalkSpeed 100 | Varuje asi po sekunde behu |
| Nastaví WalkSpeed 50 | Varuje asi po 2.5 sekundy behu |
| Robí dashe za sebou bez cooldownu (60 studov za sekundu) | Varuje asi po 1.5 sekundy |
| Teleportuje sa naraz o viac ako 43 studov | Varuje pri ďalšej kontrole |
| Beží rýchlosťou do 38 studov za sekundu, asi jedenapolkrát rýchlejšie ako sprint | Nič: pod 38.5 studa za sekundu sa vedro vyprázdňuje rovnako rýchlo, ako sa plní |
| Zmení svoj MovementConfig kvôli nekonečnej stamine | Nič: sprint na 26 studoch za sekundu je povolený ľubovoľne dlho |
| Lieta, skáče bez obmedzení alebo prechádza cez steny | Nič: kontrola ignoruje výšku a nepozerá sa na zrážky |
Kontrola teda zachytí hrubé cheaty, pri ktorých je hráč zjavne rýchlejší ako všetci ostatní, a jemné prepustí. To je úprimná hranica kontroly podľa vzdialenosti a dôvod, prečo Roblox robí niečo silnejšie (pozrite server authority nižšie).
Prečo len varuje
Dokumentácia Robloxu uvádza, že jednoduché kontroly rýchlosti môžu označiť poctivých hráčov s nestabilným pripojením a zlyhávajú v hrách s vozidlami alebo iným zložitým pohybom. Výkyvy lagu, dopravníky, vozidlá, výbuchy, ktoré odhadzujú postavy, a vaše vlastné teleporty môžu vyzerať ako prekročenie rýchlosti, preto skript len vypíše varovanie. Sledujte Output, kým vy a vaši testeri hráte ako zvyčajne, zväčšite SPEED_ALLOWANCE, ak na ňom zakopávajú poctiví hráči, a trest, napríklad vrátenie hráča späť, pridajte, až keď kontrola pri bežnej hre mlčí. Ak vo vašej hre výbuchy odhadzujú postavy, preskočte aj hráčov, ktorých Humanoidu nezostalo zdravie.
Respawny a teleporty
Respawn vytvorí nový koreňový part a skript začne merať odznova, keď ho uvidí, takže smrť ďaleko od bodu spawnu sa nikdy nepočíta ako prekročenie rýchlosti. Teleporty, ktoré robia vaše vlastné serverové skripty, potrebujú výnimku, ako uvádza dokumentácia Robloxu pre každú hru s teleportmi. Po teleporte pridajte player:SetAttribute("MovementCheckSkip", true) a ďalšia kontrola začne merať od novej pozície namiesto toho, aby označila skok:
- V systéme kôl hneď po
character:PivotTo(...)vstartRound. - V skripte checkpointov pre obby hneď po každom
character:PivotTo(...), ktorý presunie hráča na jeho checkpoint.
Pady a menu z návodu na teleporty a pad Finish z návodu na prvú hru ho už nastavujú po každom presune.
Počíta sa len hodnota zo servera. Atribút, ktorý hráč nastaví na svojom zariadení, zostane na tomto zariadení (pozrite čo sa replikuje a čo nie), takže cheater ním kontrolu vypnúť nemôže.
Riešenie do budúcnosti: server authority
Bezpečnostná dokumentácia Robloxu označuje model server authority, v čase písania v bete, za najspoľahlivejší spôsob, ako zastaviť exploity pohybu. Zdrojom pravdy sa stane server a zariadenia hráčov len hlásia svoj vstup, čo podľa dokumentácie nedovolí fungovať speedhackom, pretože zariadeniu sa nikdy neverí, že nahlási vlastnú pozíciu.
Prechod je prepísanie, nie ladenie. V tomto modeli pohyb počíta server, takže WalkSpeed alebo LinearVelocity, ktoré nastaví len LocalScript, sa zrušia, keď príde stav zo servera. Dokumentácia Robloxu uvádza, že hlavná logika má bežať vo funkciách RunService:BindToSimulation() v ModuleScripte, ktorý spúšťa klient aj server. Model potrebuje aj niekoľko nastavení Workspace vrátane PlayerScriptsUseInputActionSystem, takže aj vaše ovládanie sa presunie na Input Action System. Ponechajte si verziu z tohto návodu, kým sprint, staminu a dash neprenesiete do tejto schémy. Dovtedy je kontrola podľa vzdialenosti, ako je táto, presne to, čo opisuje časť Robloxu o kontrole pohybu.
Krok 6: otestujte na každom zariadení
- Stlačte Play a počas chôdze držte Shift. Rýchlosť stúpne zo 16 na 26 studov za sekundu a zelený ukazovateľ dole na obrazovke sa zmenšuje. Asi po 5 sekundách je prázdny a znova idete krokom.
- Pustite Shift. Po 1 sekunde sa ukazovateľ začne dopĺňať. Kým sa nenaplní na pätinu, Shift nerobí nič.
- Počas chôdze stlačte Q: kúsok sa preženiete dopredu a štvrtina ukazovateľa zmizne. Stlačte Q hneď ešte raz a nič sa nestane, kým neuplynie sekunda. Ak sa vám dash zdá príliš krátky alebo dlhý, zmeňte
DASH_SPEEDaleboDASH_SECONDSv MovementConfig. - Skočte, potom vo vzduchu stlačte skok ešte raz pre druhý skok. Pristaňte a skúste znova: každý skok zo zeme vráti skok vo vzduchu.
- Držte Space stlačený celý skok. Má z toho byť jeden skok, nie dva, pretože skok vo vzduchu potrebuje nové stlačenie.
- Zapnite Device Simulator v Studiu (v čase písania je to beta: File, Beta Features, New Device Simulator, potom reštartujte Studio) alebo zapnite starší Device Emulator v menu Test. Vyberte telefón a stlačte Play. Objavia sa tlačidlá Sprint a Dash. Držte Sprint, kým riadite, potom držte tlačidlo skoku celý skok a overte, že skok je len jeden.
- Otvorte Controller Emulator (Controller na karte Emulation alebo Virtual controller na paneli Device Simulatora). Držte L3 počas pohybu, aby ste šprintovali, stlačte B na dash a A dvakrát na dvojitý skok.
- Resetujte postavu cez menu hry. Ukazovateľ je znova plný, v Output nie je varovanie MovementCheck, a ak stále simulujete telefón, tlačidlá Sprint a Dash sú na mieste.
- Teraz hrajte za cheatera. Klikajte na prepínač Client/Server, kým Explorer neukáže klienta, označte Humanoid svojej postavy vo Workspace a v okne Properties nastavte WalkSpeed na 60. Pochoďte niekoľko sekúnd: v Output sa objaví varovanie ako
MovementCheck: YourName moved 60 studs/s. Vráťte 16, potom minútu šprintujte a robte dashe ako zvyčajne a overte, že Output mlčí. - Ak má váš place
Workspace.PlayerScriptsUseInputActionSystemnastavené na Enabled, otestujte dvojitý skok ešte raz: dokumentácia Robloxu neuvádza, či saJumpRequests ním správa rovnako.
Ak sa nedeje vôbec nič, otvorte okno Output cez menu Window v Studiu a nájdite červenú chybu od MovementClient alebo nazrite do častých chýb.
Ako rýchlo a ako dlho: predvoľby podľa typu hry
Správny sprint závisí od hry. Naháňačke v horore pristane krátky pomalý sprint, ktorý skončí v najnevhodnejšej chvíli; veľká otvorená mapa potrebuje dlhý, aby hráčov nenudilo ju prechádzať. Tieto predvoľby používajú tie isté skripty a menia len rýchlosť chôdze a MovementConfig. Sú to naše východiskové body, vypočítané z nastavení, nie namerané na hráčoch.
| Typ hry | CharacterWalkSpeed | SPRINT_BONUS (rýchlosť sprintu) | DRAIN_PER_SECOND | REGEN_PER_SECOND | Celý sprint | Z prázdneho na plný | Vzdialenosť na jeden ukazovateľ |
|---|---|---|---|---|---|---|---|
| Tento návod | 16 | 10 (26) | 20 | 15 | 5 s | 7.7 s | 130 studov |
| Naháňačka v horore | 12 | 8 (20) | 25 | 10 | 4 s | 11 s | 80 studov |
| Battlegroundy a bojovky | 16 | 12 (28) | 15 | 20 | 6.7 s | 6 s | asi 187 studov |
| Otvorený svet alebo simulátor | 16 | 16 (32) | 10 | 25 | 10 s | 5 s | 320 studov |
| Obby alebo parkúr | 16 | 8 (24) | bez staminy: použite ShiftToSprint |
- Rýchlosť chôdze sa nastavuje v StarterPlayer. Označte StarterPlayer a nastavte
CharacterWalkSpeed(predvolene 16). Každá nová postava začína s touto rýchlosťou, sprint k nej pripočítaSPRINT_BONUSa MovementCheck ju číta tiež, takže serverová kontrola sa riadi vaším výberom. - MovementCheck sa prispôsobí. Povoľuje rýchlosť chôdze plus bonus sprintu a ešte štvrtinu na lag: 25 studov za sekundu pre predvoľbu hororu, 40 pre otvorený svet. Nič iné meniť netreba.
- V obby sprint mení trať. S rýchlejším sprintom sa preskočia dlhšie priepasti. Postavte skoky a potom každý otestujte pri rýchlosti sprintu, inak sprint urobí etapy príliš ľahkými. Návod na checkpointy pre obby sa dobre spája so ShiftToSprint.
- V horore je meradlom vrah. Urobte prenasledovateľa o trochu rýchlejšieho ako chôdza a o trochu pomalšieho ako sprint, aby útek závisel od toho, kedy sa ukazovateľ minie. Návod na hororovú hru rozoberá zvyšok cyklu.
Čo je zlé na starších skriptoch sprintu
Staré návody na sprint, dash a dvojitý skok často stále fungujú, ale mnohé používajú postupy, ktoré Roblox odvtedy nahradil, alebo rozbíjajú iné systémy vo vašej hre. Ak opravujete skopírovaný skript, porovnajte ho s týmto zoznamom.
| Postup | V čom je problém | Tento návod |
|---|---|---|
BodyVelocity na dash | Zastaraný: Roblox hovorí používať namiesto neho LinearVelocity | LinearVelocity v režime Plane |
Cyklus na RunService.RenderStepped | Pre novú prácu ho nahradil PreRender. Hernej logike, ako je stamina, patrí Heartbeat, ktorý Roblox opisuje pre periodické úlohy, ako je obnova zdravia | Heartbeat s deltaTime |
Cyklus staminy na wait() | wait() je zastarané v prospech task.wait() a je brzdené, takže môže čakať dlhšie, než ste žiadali, a pevné míňanie za každý wait spotrebúva staminu nerovnomerne | Míňanie a obnova každý snímok s ohľadom na deltaTime |
UserInputService.InputBegan bez kontroly chatu | Stlačenie Shift počas písania správy do chatu spustí sprint | ContextActionService, ktorý navyše pridá tlačidlo na mobile |
WalkSpeed = 16 pri pustení alebo každý snímok | Prepíše akúkoľvek inú rýchlosť, napríklad perk gamepassu | Mení WalkSpeed len na začiatku a na konci sprintu a pripočítava k aktuálnej hodnote |
| Sprint cez RemoteEvent, aby WalkSpeed nastavoval server | Exploiteri si WalkSpeed aj tak nastavia sami a sprint začne s oneskorením na cestu tam a späť | Sprint na klientovi plus kontrola vzdialenosti na serveri |
Dvojitý skok pri každom JumpRequest | JumpRequest sa spustí niekoľkokrát na jednu požiadavku skoku a držané tlačidlo môže ďalej žiadať o skoky | Pauza 0.25 sekundy a kontrola nového stlačenia |
UserInputService.TouchEnabled ako kontrola „je to mobil“ | Je true aj na notebookoch s dotykovou obrazovkou | ContextActionService pridáva tlačidlá na obrazovku na dotykových zariadeniach bez vašej vlastnej kontroly zariadenia |
Humanoid:LoadAnimation na animáciu behu | Zastarané v prospech Animator:LoadAnimation | Animácia behu nižšie používa Animator |
Nový spôsob od Robloxu: Input Action System
Stránka Robloxu o Input Action System berie ako prvý príklad sprint postavy. Namiesto volaní BindAction sa ovládanie nastavuje v Studiu: InputAction s názvom CharacterSprint vnútri input contextu v ReplicatedStorage, s jedným InputBinding pre Left Shift, jedným pre tlačidlo Y na gamepade a jedným prepojeným s tlačidlom na obrazovke, ktoré nakreslíte v StarterGui. Potom klientsky skript počúva udalosti akcie Pressed a Released, pri stlačení WalkSpeed zdvojnásobí a pri pustení ju vráti.
Prejsť naň sa oplatí, ak chcete rozkladať ovládanie v Studiu, nie v kóde, vlastné dotykové tlačidlo namiesto tlačidla ContextActionService alebo kontexty, ktoré menia celé sady ovládania, napríklad pre menu alebo vozidlá. Stránka tiež odporúča nastaviť Workspace.PlayerScriptsUseInputActionSystem na Enabled a server authority to vyžaduje.
Cyklus staminy a dash z tohto návodu fungujú rovnako so samotným Input Action System (bez server authority). Ponechajte MovementConfig, cyklus Heartbeat a dash(), odstráňte dve volania BindAction a ich obsluhy a namiesto nich pripojte akcie: Pressed akcie sprintu nastaví sprintHeld na true a jej Released na false a Pressed akcie dashu zavolá dash(). Humanoid naďalej hľadajte každý snímok, ako to robí MovementClient, pretože príklad z dokumentácie si uloží Humanoid prvej postavy a po respawne už neexistuje.
Roblox tiež testuje Character Controller Library, betu, ktorá sa zapína v Beta Features a Avatar Settings v Studiu. Jej stránka o vlastných schopnostiach stavia ako príklad dash s aktívnym oknom 0.2 sekundy a cooldownom 1 sekunda, teda s rovnakým časovaním ako dash z tohto návodu.
Ako rozšíriť: animácia, kamera a pass na sprint
Animácia behu
Urobte animáciu behu v Animation Editore, dajte jej prioritu Movement (Roblox ju odporúča pre animácie chôdze a behu), publikujte ju a skopírujte ID assetu. V MovementClient vytvorte Animation s týmto AnimationId, načítajte ju cez Animator:LoadAnimation pomocou Animator vnútri Humanoidu postavy, spustite stopu tam, kde sprint začína, a zastavte ju tam, kde končí. Načítajte ju nanovo pre každú novú postavu.
Animácie, ktoré vaše zariadenie spustí na vašej postave, vidia všetci, ak používate Animator, ktorý tam vložil Roblox: stopy načítané na Animator vytvorený LocalScriptom sa nereplikujú. Humanoid:LoadAnimation, ktorý používa veľa starých návodov, je zastaraný.
Širšia kamera počas sprintu
O niečo širší uhol záberu robí sprint pocitovo rýchlejším. Na tých istých dvoch miestach tweenujte workspace.CurrentCamera.FieldOfView z predvolenej hodnoty 70 asi na 80, keď sprint začne, a späť, keď skončí, napríklad cez TweenService:Create(workspace.CurrentCamera, TweenInfo.new(0.25), { FieldOfView = 80 }):Play(). Roblox obmedzuje hodnotu od 1 do 120 a upozorňuje, že veľmi nízke alebo veľmi vysoké hodnoty môžu hráčov dezorientovať. Ak uhol záberu mení v hre ešte iný skript, tweenujte späť na zistenú hodnotu, nie na 70.
Rýchlejší sprint ako gamepass
Návod na gamepassy už s týmto skriptom funguje: jeho perk Speed na serveri nastaví WalkSpeed 24 každej novej postave, MovementClient navrch pripočíta bonus sprintu a 34 studov za sekundu zostáva v medziach toho, čo povoľuje MovementCheck.
Pre pass, ktorý zrýchľuje samotný sprint, pridajte pass FastSprint do PassConfig.ids z toho návodu. Jeho serverový skript potom hráčovi nastaví atribút OwnsPass_FastSprint, hneď ako je nákup potvrdený. V MovementClient použite bonus väčší ako Config.SPRINT_BONUS, keď player:GetAttribute("OwnsPass_FastSprint") == true. V MovementCheck dajte takým hráčom väčšiu povolenú mieru čítaním toho istého atribútu na serveri, kde ho hráč nemôže zmeniť, a overte, že nová maximálna rýchlosť zostáva pod tým, čo kontrola označí.
Jedno obmedzenie, o ktorom treba vedieť: ak iný skript zmení WalkSpeed uprostred sprintu, koniec tohto sprintu vráti rýchlosť, ktorá bola pred ním. Ďalší respawn znova nastaví rýchlosť passu, pretože skript gamepassu ju aplikuje na každú novú postavu.
Časté chyby a riešenia
Pred stlačením Play otvorte okno Output (menu Window, potom Output). Väčšina problémov s týmito skriptmi tam vypíše chybu alebo varovanie s názvom skriptu a číslom riadku.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("MovementConfig")'
MovementClient alebo MovementCheck čaká na modul, ktorý pod presne týmto názvom neexistuje. Musí to byť ModuleScript s názvom MovementConfig priamo v ReplicatedStorage. Návod na chyby v skriptoch toto varovanie podrobne rozoberá.
Shift nerobí nič
Skontrolujte, že ShiftToSprint alebo MovementClient je LocalScript, nie Script, a že je v StarterPlayerScripts. S MovementClient musí postava na začatie sprintu aj ísť a mať aspoň 20 staminy, takže Shift držte počas pohybu. Ak sa namiesto sprintu prepína Shift Lock, pozrite otázku o Shift Lock nižšie.
Sprint po niekoľkých sekundách skončí
Míňa sa stamina: 100 staminy po 20 za sekundu vystačí na 5 sekúnd. Zväčšite MAX_STAMINA alebo zmenšite DRAIN_PER_SECOND v MovementConfig.
Dash nerobí nič
Dash potrebuje 25 staminy, čaká 1 sekundu po predchádzajúcom a nerobí nič, kým sedíte. Ak to nie je ono, koreňový part vašej postavy nemusí mať Attachment s názvom RootAttachment, čo sa stáva pri niektorých vlastných postavách: pridajte ho do HumanoidRootPart vášho StarterCharacter.
Dvojitý skok nefunguje
DoubleJump musí byť LocalScript v StarterCharacterScripts, nie v StarterPlayerScripts, pretože script.Parent číta ako postavu. Stlačte skok druhýkrát po odlepení od zeme: držané tlačidlo sa nepočíta ako nové stlačenie a zídenie z rímsy skok vo vzduchu nedá.
Na mobile nie je tlačidlo Sprint ani Dash
ContextActionService pridáva svoje tlačidlá len na dotykových zariadeniach, takže na PC bez dotykovej obrazovky ich nikdy neuvidíte. Testujte s telefónom v Device Simulatore v Studiu (je to beta: zapnite New Device Simulator v File, Beta Features a reštartujte Studio). BindAction dokáže vytvoriť najviac 7 dotykových tlačidiel, takže spočítajte, koľko ich robia iné skripty v hre.
MovementCheck hlási poctivých hráčov
Bežné príčiny: teleport z iného serverového skriptu, dopravník alebo vozidlo, alebo lag. Po svojich teleportoch nastavujte atribút MovementCheckSkip (pozrite Respawny a teleporty) a zväčšite SPEED_ALLOWANCE, ak sa kontrola stále spúšťa pri bežnej hre.
Zrýchlenie po sprinte zmizne
Iný skript zmenil WalkSpeed počas sprintu a sprint po skončení vrátil rýchlosť, ktorú videl na začiatku. Zrýchlenia dávajte pri spawne postavy, ako to robí návod na gamepassy, aby respawn znova nastavil správnu rýchlosť.
Urobiť s RoCode
Ak sa vám to všetko nechce nastavovať ručne, RoCode to môže postaviť vo vašom otvorenom place. RoCode je nezávislý AI agent pre Roblox Studio, nie od Robloxu: zmenu opíšete vo webovom chate a jeho plugin pre Studio vytvorí skripty vo vašom Exploreri, takže vkladať kód nemusíte.
Pridaj sprint na Shift s ukazovateľom staminy: rýchlosť chôdze plus 10, kým je stlačený Shift, 100 staminy, míňanie 20 za sekundu, obnova 15 za sekundu po sekunde oddychu, tlačidlo Sprint na mobiloch, dash na Q a dvojitý skok.
- Môže si najprv prezrieť váš place cez Search Scripts a Read Script, aby našiel iné skripty, ktoré menia WalkSpeed (napríklad perk gamepassu), a sprint sa k nim pripočítaval
- Píše ModuleScript, LocalScripty a serverovú kontrolu cez Create Script
- Má za úlohu overiť kompiláciu každého napísaného skriptu cez Check Script, ktorý ho skompiluje v Studiu bez spustenia
- Pred každou dávkou zmien aj po nej vytvorí bod na vrátenie, takže Ctrl+Z vracia po jednej dávke
RoCode nevie urobiť animáciu behu: vytvorte ju v Animation Editore a vložte jej ID. S pluginom 3.9.11 alebo novším môže RoCode spustiť playtest vašej hry v Studiu a ovládať testovaciu postavu, aby overil, že všetko funguje, a s pluginom 3.9.15 alebo novším môže testovacia postava stláčať klávesy, napríklad držať Shift a overiť, že WalkSpeed stúpla. Sám rozhoduje, kedy spustí playtest, najviac 2 za stavbu plus 1 na overenie svojej opravy, a kontroluje len to, čo sa sám rozhodol otestovať, preto sprint, dash a dvojitý skok vyskúšajte sami a tlačidlá na mobile overte v Device Simulatore v Studiu. Pohyb je jeden systém z mnohých v hre; vytvorenie celej hry s RoCode postupuje po jednom systéme na prompt, ako tu. Ako sa RoCode pripája k Studiu.
Časté otázky
Prečo skript sprintu nefunguje na mobile?
Mobil nemá kláves Shift. Sprint naviažte cez ContextActionService:BindAction a ako tretí argument odovzdajte true: to pridá tlačidlo na obrazovku na dotykových zariadeniach, ako to robia ShiftToSprint aj MovementClient.
Treba robiť sprint na serveri?
Nie. Každé zariadenie hýbe svojou postavou, takže WalkSpeed nastavená serverom nezastaví cheatera, ktorý si môže nastaviť vlastnú, a nová rýchlosť príde až po ceste tam a späť, takže sprint začne s oneskorením. Sprint robte na klientovi a na serveri kontrolujte, ako ďaleko sa postavy v skutočnosti pohnú, ako v Kroku 5. Beta server authority od Robloxu funguje inak a kód pohybu bude pre ňu treba prepísať.
Prečo postava šprintuje ďalej, keď som pustil Shift?
Skript premeškal pustenie, zvyčajne preto, že počúva len stlačenie. ContextActionService pošle End, keď sa kláves pustí, a Cancel, keď ho zachytí iné naviazanie; MovementClient sa zastaví pri oboch a navyše vtedy, keď sa minie stamina alebo sa postava prestane hýbať.
Ako pridať animáciu behu?
Načítajte animáciu behu cez Animator v Humanoide postavy v tom istom LocalScripte, spustite ju, keď sprint začne, a zastavte ju, keď skončí. Dajte jej prioritu Movement. Animácie spustené na vašej vlastnej postave vidia všetci.
Prečo sa dvojitý skok na mobile spúšťa sám?
Držané tlačidlo skoku na mobile ďalej žiada o skoky. Skok považujte za nový, len ak požiadavky na okamih ustali, ako to robí skript DoubleJump.
Aká je predvolená rýchlosť chôdze v Robloxe?
16 studov za sekundu. Berie sa zo StarterPlayer.CharacterWalkSpeed, ktorý nastavuje Humanoid.WalkSpeed každej novej postavy. Sprint z tohto návodu pripočíta 10, takže sprint ide na 26.
Aký rýchly má byť sprint v Robloxe?
Väčšina hier pripočíta polovicu až celú rýchlosť chôdze: zo 16 je niečo medzi 24 a 32. Krátky pomalý sprint sa hodí do hororu a dlhý rýchly na veľké mapy. Predvoľby podľa typu hry dávajú pre každý rýchlosť chôdze, bonus sprintu a čísla staminy.
Ako urobiť sprint so staminou?
Majte číslo staminy na zariadení hráča, míňajte ho každý snímok počas sprintu a obnovujte po krátkom oddychu, v oboch prípadoch s ohľadom na čas snímku, a sprint zastavte, keď klesne na 0. MovementClient z Kroku 3 to robí s ukazovateľom na obrazovke; čísla sú v MovementConfig.
Ako šprintovať s ovládačom v Robloxe?
Naviažte ButtonL3 gamepadu (stlačenie ľavej páčky) cez ContextActionService spolu s Left Shift, ako to robia oba skripty tu. ShiftToSprint robí z L3 prepínač, pretože držať páčku stlačenú a zároveň ňou riadiť je únavné.
Je sprint na Shift v konflikte so Shift Lock?
Môže byť. Hráči, ktorí si zapli Shift Lock v nastaveniach Robloxu, ho prepínajú klávesom Shift, takže jeden kláves robí dve veci. Dokumentácia Robloxu uvádza, že API Shift Lock sa vyraďujú z používania. Ak konflikt vašim hráčom prekáža, vypnite StarterPlayer.EnableMouseLockOption alebo v MovementClient naviažte sprint na iný kláves, napríklad Left Ctrl.
Zdroje a ďalšie čítanie
- Roblox Creator Docs: ContextActionService (po anglicky). BindAction, dotykové tlačidlá, limit 7 tlačidiel a prečo je vo väčšine prípadov lepší ako InputBegan
- Roblox Creator Docs: Humanoid (po anglicky). WalkSpeed a poznámka o bezpečnosti, MoveDirection, StateChanged a ChangeState s príkladom dvojitého skoku
- Roblox Creator Docs: LinearVelocity (po anglicky). režim Plane, dotyčnicové osi a MaxForce
- Roblox Creator Docs: Mover constraints (po anglicky). prechod zo zastaraného BodyVelocity na LinearVelocity
- Roblox Creator Docs: UserInputService (po anglicky). JumpRequest a prečo potrebuje debounce
- Roblox Creator Docs: Network ownership, movement validation, and physics (po anglicky). čo ovláda klient, kontroly vzdialenosti, deravé vedrá a výnimky pre teleporty
- Roblox Creator Docs: Server authority model (po anglicky). model s pohybom na serveri, BindToSimulation a nastavenia Workspace, ktoré potrebuje
- Roblox Creator Docs: Input Action System (po anglicky). príklad Character Sprint s InputAction a InputBinding
- Roblox Creator Docs: Custom abilities (po anglicky). schopnosť dashu v Character Controller Library
- Roblox Creator Docs: Studio testing modes (po anglicky). Device Simulator a Controller Emulator
Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.