Roblox · Системы

Стамина: бег, прыжок, усталость

Выносливость: бег на Shift (на телефоне — кнопка «Бег») и прыжки тратят стамину, после паузы она восстанавливается. Кончилась — игрок устал: бежать и прыгать нельзя, пока не наберётся 20%. Желтая полоска на экране темнеет, когда игрок устал.

Структура

Синим — что нужно создать.

ReplicatedStorage
├─ Bars (ModuleScript) — из темы «Здоровье»
└─ StaminaEvent (RemoteEvent) — бег и прыжок
ServerScriptService
├─ Stamina (ModuleScript) — Spend, Drain, Regen, COSTS
└─ StaminaServer (Script)
StarterPlayer
└─ StarterPlayerScripts
   └─ StaminaLocal (LocalScript) — Shift, кнопка, полоска

Шаги

  1. Значения — атрибуты игрока: Stamina (сейчас), MaxStamina (максимум; растёт с уровнем в теме «Опыт»), Exhausted (устал). Меняет их только сервер.
  2. Сколько стоит действие — таблица COSTS в модуле Stamina: Run — в секунду, Jump, Roll, Attack — за раз. Добавляй свои действия туда же.
  3. В своих скриптах (на сервере): if Stamina.Spend(player, Stamina.COSTS.Attack) then … удар … end — не хватило стамины, удара нет.
  4. Бег: StaminaLocal через ContextActionService ловит Shift и кнопку на телефоне и сообщает серверу. Сервер 10 раз в секунду: если игрок держит Shift и идёт — тратит стамину и ставит RUN_SPEED, иначе — WALK_SPEED и восстанавливает.
  5. Прыжок: игрок сообщает о прыжке, сервер списывает стамину. Мало стамины — сервер ставит JumpHeight = 0, прыгнуть нельзя.
  6. Усталость: на нуле Exhausted = true — бежать и прыгать нельзя, пока стамина не наберёт RECOVER (20%) от максимума. Без этого игрок дёргался бы: побежал — встал — побежал.
  7. StaminaServer сам задаёт WalkSpeed — если в игре есть ускорения (раздел «Усиления»), прибавляй их к WALK_SPEED и RUN_SPEED здесь, иначе сервер их перебьёт.
  8. Полоска в интерфейсе: Bars.new("Stamina", жёлтый, 2) — вторая в столбике. Обновляется по сигналам атрибутов Stamina, MaxStamina, Exhausted. Модуль Bars — из темы «Здоровье» (сборщик поставит его сам).

Скрипты

Stamina

Где: ServerScriptService · ModuleScript
Зачем: Стамина: потратить, восстановить, цены действий.

-- таблица модуля
local Stamina = {}
-- стамина нового игрока
Stamina.MAX = 100
-- восстановление в секунду
Stamina.REGEN = 20
-- через сколько секунд после траты начинает восстанавливаться
Stamina.REGEN_DELAY = 1
-- после нуля бегать можно с 20%
Stamina.RECOVER = 0.2
-- сколько стоит действие (бег — в секунду)
Stamina.COSTS = {Run = 15, Jump = 10, Roll = 20, Attack = 5}
-- игрок → время последней траты
local lastSpend = {}

-- сколько сейчас
function Stamina.Get(player)
    -- атрибут
    return player:GetAttribute("Stamina") or 0
-- конец функции
end
-- максимум
function Stamina.Max(player)
    -- атрибут (растёт с уровнем)
    return player:GetAttribute("MaxStamina") or Stamina.MAX
-- конец функции
end
-- записать и проверить усталость
local function SetValue(player, value)
    -- новое значение
    player:SetAttribute("Stamina", value)
    -- время траты
    lastSpend[player] = os.clock()
    -- кончилась — устал
    if value <= 0 then player:SetAttribute("Exhausted", true) end
-- конец функции
end

-- потратить на действие; false — не хватает
function Stamina.Spend(player, amount)
    -- сколько есть
    local value = Stamina.Get(player)
    -- устал или мало
    if player:GetAttribute("Exhausted") or value < amount then return false end
    -- тратим
    SetValue(player, value - amount)
    -- можно делать
    return true
-- конец функции
end
-- тратить сколько есть (бег, прыжок)
function Stamina.Drain(player, amount)
    -- не ниже нуля
    SetValue(player, math.max(Stamina.Get(player) - amount, 0))
-- конец функции
end
-- восстановить за dt секунд
function Stamina.Regen(player, dt)
    -- недавно тратил — ждём
    if os.clock() - (lastSpend[player] or 0) < Stamina.REGEN_DELAY then return end
    -- максимум
    local max = Stamina.Max(player)
    -- прибавляем, не выше максимума
    local value = math.min(Stamina.Get(player) + Stamina.REGEN * dt, max)
    -- записываем, только если изменилось
    if value ~= Stamina.Get(player) then player:SetAttribute("Stamina", value) end
    -- отдохнул
    if player:GetAttribute("Exhausted") and value >= max * Stamina.RECOVER then player:SetAttribute("Exhausted", false) end
-- конец функции
end

-- отдаём модуль
return Stamina

StaminaServer

Где: ServerScriptService · Script
Зачем: Бег, прыжок, скорость, восстановление.

-- игроки
local Players = game:GetService("Players")
-- событие
local RS = game:GetService("ReplicatedStorage")
-- модуль стамины
local Stamina = require(script.Parent:WaitForChild("Stamina"))
-- игрок сообщает: бег, прыжок
local event = RS:WaitForChild("StaminaEvent")
-- обычная скорость
local WALK_SPEED = 16
-- скорость бега
local RUN_SPEED = 26
-- обычная высота прыжка
local JUMP_HEIGHT = 7.2
-- как часто обновлять, секунд
local STEP = 0.1
-- игрок → держит ли Shift
local sprinting = {}

-- игрок зашёл
local function Setup(player)
    -- максимум (система опыта может поднять)
    if player:GetAttribute("MaxStamina") == nil then player:SetAttribute("MaxStamina", Stamina.MAX) end
    -- полная
    player:SetAttribute("Stamina", Stamina.Max(player))
    -- новый персонаж
    player.CharacterAdded:Connect(function(character)
        -- после смерти — полная
        player:SetAttribute("Stamina", Stamina.Max(player))
        -- не устал
        player:SetAttribute("Exhausted", false)
        -- прыжок задаём высотой (JumpHeight)
        character:WaitForChild("Humanoid").UseJumpPower = false
    -- конец функции
    end)
-- конец функции
end
-- новые игроки
Players.PlayerAdded:Connect(Setup)
-- кто зашёл раньше скрипта
for _, player in ipairs(Players:GetPlayers()) do Setup(player) end
-- вышел — забываем
Players.PlayerRemoving:Connect(function(player) sprinting[player] = nil end)

-- сообщение от игрока
event.OnServerEvent:Connect(function(player, action, on)
    -- зажал или отпустил Shift
    if action == "Sprint" then sprinting[player] = on == true end
    -- прыгнул
    if action == "Jump" then Stamina.Drain(player, Stamina.COSTS.Jump) end
-- конец функции
end)

-- бесконечно
while true do
    -- пауза
    task.wait(STEP)
    -- каждый игрок
    for _, player in ipairs(Players:GetPlayers()) do
        -- Humanoid
        local humanoid = player.Character and player.Character:FindFirstChildOfClass("Humanoid")
        -- есть персонаж
        if humanoid then
            -- устал?
            local tired = player:GetAttribute("Exhausted")
            -- держит Shift, не устал и идёт
            local running = sprinting[player] and not tired and humanoid.MoveDirection.Magnitude > 0
            -- бег тратит, отдых восстанавливает
            if running then Stamina.Drain(player, Stamina.COSTS.Run * STEP) else Stamina.Regen(player, STEP) end
            -- скорость
            humanoid.WalkSpeed = running and RUN_SPEED or WALK_SPEED
            -- нет стамины — прыгнуть нельзя
            humanoid.JumpHeight = (not tired and Stamina.Get(player) >= Stamina.COSTS.Jump) and JUMP_HEIGHT or 0
        -- конец проверки
        end
    -- конец перебора
    end
-- конец цикла
end

StaminaLocal

Где: StarterPlayer → StarterPlayerScripts · LocalScript
Зачем: Shift, кнопка «Бег», полоска.

-- игроки
local Players = game:GetService("Players")
-- модуль и событие
local RS = game:GetService("ReplicatedStorage")
-- клавиша и кнопка на телефоне
local CAS = game:GetService("ContextActionService")
-- полоски
local Bars = require(RS:WaitForChild("Bars"))
-- сообщить серверу
local event = RS:WaitForChild("StaminaEvent")
-- этот игрок
local player = Players.LocalPlayer
-- жёлтая
local COLOR = Color3.fromRGB(240, 200, 40)
-- тёмная — устал
local TIRED = Color3.fromRGB(140, 110, 40)
-- полоска стамины — вторая
local bar = Bars.new("Stamina", COLOR, 2)

-- обновить полоску
local function Update()
    -- значение
    bar.Set(player:GetAttribute("Stamina") or 0, player:GetAttribute("MaxStamina") or 100)
    -- устал — темнеет
    bar.SetColor(player:GetAttribute("Exhausted") and TIRED or COLOR)
-- конец функции
end
-- сразу
Update()
-- изменилась
player:GetAttributeChangedSignal("Stamina"):Connect(Update)
-- максимум изменился
player:GetAttributeChangedSignal("MaxStamina"):Connect(Update)
-- устал или отдохнул
player:GetAttributeChangedSignal("Exhausted"):Connect(Update)

-- Shift или кнопка «Бег»
local function OnSprint(_, state)
    -- нажал — бежим
    if state == Enum.UserInputState.Begin then event:FireServer("Sprint", true) end
    -- отпустил — идём
    if state == Enum.UserInputState.End or state == Enum.UserInputState.Cancel then event:FireServer("Sprint", false) end
    -- клавиша работает и для других скриптов
    return Enum.ContextActionResult.Pass
-- конец функции
end
-- true — кнопка на телефоне
CAS:BindAction("Sprint", OnSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3)
-- надпись на кнопке
CAS:SetTitle("Sprint", "Бег")

-- новый персонаж
local function Character(character)
    -- Humanoid
    local humanoid = character:WaitForChild("Humanoid")
    -- состояние изменилось
    humanoid.StateChanged:Connect(function(_, new)
        -- прыгнул — сервер спишет стамину
        if new == Enum.HumanoidStateType.Jumping then event:FireServer("Jump") end
    -- конец функции
    end)
-- конец функции
end
-- персонаж уже есть
if player.Character then task.spawn(Character, player.Character) end
-- и каждый новый
player.CharacterAdded:Connect(Character)

Проверка

Запусти Play (или Run) и убедись:

Собрать систему стамины одной командой