🎮 Sistema de Energia, Sprint e HUD - Documentação Completa

[captoves]

Sistema de Energia, Sprint, Vida, Níveis e HUD — Resumo Completo​

​

Visão Geral​

Um sistema completo de vida, energia, sprint, dano por exaustão, progressão por nível, e HUD atualizado em tempo real. Tudo funciona integrado entre cliente e servidor.

---

Sistema de Vida​

• Vida inicial: 100
• Vida máxima evolui por nível (multiplicação por 2):
  • N1: 100
  • N2: 200
  • N3: 400
  • N4: 800
  • N5: 1600

Dano por Exaustão​

Ocorre quando energia = 0 e o jogador continua correndo.

• Dano: 3% da vida máxima a cada 5s
• Ex.: 800 de vida → perde 24 a cada 5s
• Mensagem: " [Nome] tomou X de dano por exaustão!"
• Para parar: basta não correr.

---

Sistema de Energia​

• Energia inicial: 100
• Escala por nível (x1.5):
  • N1: 100
  • N2: 150
  • N3: 225
  • N4: 337
  • N5: 506

Regeneração​

Estado	Regeneração
Parado	+1.5/s (rápido)
Andando	+0.5/s (lento)
Correndo	−2/s (consumo)

Energia nunca fica negativa.

---

Sistema de Sprint​

Como ativa:​

Duplo clique em W ou S (intervalo máximo 0,3s).

Velocidades:​

Modo	Velocidade	Energia
Caminhar	16	+0.5/s
Sprint frente (W)	25	−2/s
Sprint trás (S)	20	−2/s

Regras:​

• Enquanto a tecla for segurada, continua correndo.
• Se soltar → sprint desativa.
• Se energia chegar a 0 → sprint para automaticamente.

---

Sistema de Níveis e XP​

• Começa no nível 1, XP 0, meta inicial 100.
• Ao atingir a meta → sobe de nível automaticamente.
• XP necessária cresce ×8 a cada nível.

Tabela:​

Nível	Vida Máx	Energia Máx	Meta XP
1	100	100	100
2	200	150	800
3	400	225	6.400
4	800	337	51.200
5	1600	506	409.600
10	51.200	5.766	214.748.364.800

Mensagem ao subir:​

🎉 [Nome] subiu para o nível X
 └ Nova meta de XP
 └ Nova vida máxima
 └ Nova energia máxima

---

HUD (Interface)​

​

Local: canto inferior esquerdo — 250×140 px
Estilo: moderno, fundo cinza escuro (RGB 30,30,30)

Barra de Nível​

• Texto: " Nível — Lv.X — XP atual/meta"
• Cores:
  • "Nível": azul claro (0,150,255)
  • "Lv.X": roxo (150,50,200)
  • "XP": azul céu (100,200,255)
• Barra roxa preenchendo conforme XP.

Barra de Vida​

• Texto: " Vida — X/Y"
• Barra muda de cor automaticamente:
  

  Vida	Cor	RGB
  66–100%	Verde	0,255,0
  33–65%	Amarelo	255,255,0
  0–32%	Vermelho	255,0,0

Barra de Energia​

• Texto: " Energia — X/Y"
• Cor fixa azul (0,150,255)
• Reflete consumo ou recuperação em tempo real.

---

Arquitetura Técnica​

​

ServerScriptService​

PlayerDataModule

• Gerencia: vida, energia, XP, nível
• Trata sprint, regeneração e exaustão
• Calcula progressão
• Envia dados para o cliente via RemoteEvents

StarterCharacterScripts​

SprintScript (LocalScript)

• Detecta duplo clique
• Envia ao servidor o comando de sprint
• Controla input do jogador

StarterGui​

HUD_LocalScript

• Cria o HUD
• Atualiza barras 60 FPS
• Muda cores dinamicamente
• Recebe atualizações do servidor

ReplicatedStorage​

Folder RemoteEvents

• SprintEvent
• EnergyUpdateEvent

RemoteFunction:

• GetPlayerData

---

BLOCOS MÁGICOS​

Contêm blocos com scripts de teste prontos para demonstração.

---

DOWNLOAD DO SISTEMA​

---

Informações​

• Criador: Captoves
• Versão: 1.0
• Data: Dezembro 2025
• Compatível: Roblox Studio