All-Resources/[char]/mercyv-stamina/README.md

mercyv-stamina

Eigenes Sprint/Jog-System für FiveM RP. Ersetzt das Vanilla GTA-Ausdauersystem vollständig.

Features

• Frei einstellbarer Schwellwert ab wann der Charakter ins Joggen wechselt
• Konfigurierbare Drain- und Regen-Werte
• Hysterese verhindert ständiges Hin- und Herschalten
• Schnellere Stamina-Regen im Fahrzeug
• Ingame-Befehl /stamina zum Live-Anpassen
• Export-Funktionen für andere Scripts (z.B. Essen, Trinken)
• Server-seitige Stamina-Kontrolle per Exports & Konsolenbefehl

---

Installation

1. Ordner mercyv-stamina in dein resources-Verzeichnis legen
2. In der server.cfg eintragen:

   ensure mercyv-stamina
   

3. Fertig.

---

Konfiguration (config.lua)

Variable	Standard	Beschreibung
JogThreshold	20	Ab welchem % Stamina ins Joggen gewechselt wird
JogHysteresis	10	Wieviel % ÜBER dem Schwellwert für Rückkehr nötig
JogClipset	"move_m@casual@d"	Animations-Clipset beim Joggen
StaminaDrain	0.4	Verbrauch pro Tick beim Sprinten
StaminaRegen	0.15	Regen pro Tick (außerhalb Fahrzeug)
VehicleRegenMultiplier	2.0	Regen-Multiplikator im Fahrzeug
RegenDelay	2000	Millisekunden Pause nach Sprint vor Regen
StartStamina	100	Stamina beim Einloggen/Spawnen
TickInterval	100	Loop-Interval in ms
DisableVanilla	true	Vanilla-System deaktivieren
AllowCommand	true	/stamina Befehl erlauben
ShowDebug	false	Debug-Logs aktivieren

---

Ingame-Befehl

/stamina           → Zeigt aktuellen Schwellwert und Stamina
/stamina 30        → Setzt JogThreshold auf 30%

---

Integration mit anderen Scripts

Stamina auffüllen (Client → Client)

-- +50 Stamina geben (z.B. nach dem Essen)
TriggerEvent("mercyv-stamina:refill", 50)

Stamina direkt setzen (Client → Client)

TriggerEvent("mercyv-stamina:set", 100)

Stamina abrufen (Export)

local stamina = exports["mercyv-stamina"]:GetStamina()
-- Gibt aktuellen Wert als Zahl zurück (0-100)

Jog-Status prüfen (Export)

local jogging = exports["mercyv-stamina"]:IsJogging()
-- Gibt true/false zurück

Vom Server aus auffüllen

-- In einem anderen Server-Script:
exports["mercyv-stamina"]:RefillStamina(playerId, 50)
exports["mercyv-stamina"]:SetStamina(playerId, 100)

Server-Konsole

staminarefill [playerid] [menge]

---

Beispiel: Essen-Script Integration

-- In deinem food/drink script:
RegisterNetEvent("myfood:eat")
AddEventHandler("myfood:eat", function(amount)
    TriggerEvent("mercyv-stamina:refill", amount)
end)

---

Ordnerstruktur

mercyv-stamina/
├── fxmanifest.lua
├── config.lua
├── client/
│   └── main.lua
└── server/
    └── main.lua