🛡️ DS Armor System Erweitertes Schutzwesten-System für FiveM | ESX & QBCore | Version 1.0.0
📦 Beschreibung
Das DS Armor System bringt ein vollständiges, realistisches Schutzwesten-System auf deinen FiveM-Server. Westen werden als Items im Inventar getragen, persistent in der Datenbank gespeichert und serverseitig gegen Exploits abgesichert.
🦺 Verfügbare Schutzwesten
🟡 Kleine Schutzweste — 50% Schutz | Rüstungswert: 50 | Item: armor_small 🔵 Mittlere Schutzweste — 75% Schutz | Rüstungswert: 75 | Item: armor_medium 🟢 Schwere Schutzweste — 100% Schutz | Rüstungswert: 100 | Item: armor_heavy
⚙️ Features
💾 Persistenz — Der Rüstungsstatus wird in der Datenbank gespeichert und bleibt nach Server-Restarts erhalten. Spieler starten automatisch mit ihrer zuletzt getragenen Weste.
🔒 Serverseitige Sicherheit — Eine serverseitige Prüfung verhindert, dass Spieler mehrere Westen gleichzeitig anlegen können.
🎒 Ausziehen & Zurücklegen — Unbeschädigte Westen können jederzeit ausgezogen und direkt ins Inventar zurückgelegt werden.
🔥 Schadenslogik — Sobald eine Weste Schaden erhalten hat, kann sie nicht mehr ausgezogen werden. Fällt der Rüstungswert auf 0%, wird die Weste automatisch zerstört.
🖥️ Natives GTA-HUD — Das Script nutzt die Standard GTA-Rüstungsanzeige. Kein eigenes HUD, keine UI-Konflikte mit anderen Ressourcen.
📋 UI-Menü — Übersichtliches Menü zum Anlegen und Ausziehen der Weste. Standard-Taste ist F5, kann aber jederzeit vom Spieler selbst unter ESC → Einstellungen → Tastenbelegung geändert werden.
🔔 Flexibles Notify-System — Vollständig anpassbar. Unterstützt ESX, QBCore, eigene Exports (z.B. ox_lib, okokNotify) sowie eigene TriggerEvents.
🔌 Exports — Andere Ressourcen können den Rüstungsstatus und alle Rüstungsdaten des Spielers direkt abfragen.
💬 Befehle
F5 (anpassbar) — Schutzwesten-Menü öffnen und schließen /armor_status — Aktuellen Rüstungsstatus anzeigen /unequip_armor — Weste ausziehen, sofern sie unbeschädigt ist
🔧 Kompatibilität
✅ ESX (es_extended) ✅ QBCore (qb-core) ✅ oxmysql ✅ mysql-async
📋 Voraussetzungen
oxmysql oder mysql-async muss auf dem Server installiert sein. ESX (es_extended) oder QBCore (qb-core) wird als Framework benötigt.