SCRIPTS

🛂 FiveM – Visum- & Levelsystem (ESX)

Bringe ein durchdachtes Fortbildungs- und Belohnungssystem auf deinen FiveM-Server! Mit diesem Skript belohnst du deine Spieler automatisch für ihre Aktivität, schützt dein Roleplay vor Missbrauch und schaffst klare Anreize für aktive Spielzeit.

✨ Hauptfunktionen im Überblick

• Automatischer Aufstieg: Spieler sammeln während des Spielens Minuten und steigen nahtlos in höherwertige Visumstufen auf.
• Belohnungssystem: Vergib bei jedem Level-Up individuell konfigurierbare Belohnungen (Bargeld, Bankguthaben, Items, Waffen oder sogar Fahrzeuge direkt in die owned_vehicles-Tabelle).
• Waffen- & Fahrzeug-Sperren: Binde mächtige Waffen oder schnelle Fahrzeuge an Mindest-Visumstufen. Spieler ohne nötige Stufe können geschützt oder automatisch aus dem Fahrzeug gesetzt werden.
• Modernes UI & HUD: Interaktives Menü (/visum) mit Fortschritts- & Belohnungsübersicht. Das HUD ist vom Spieler frei verschiebbar, speicherbar oder auf Wunsch ausblendbar.
• Anfänger-Schutz: Automatische Neuling-Anzeige über dem Kopf von Spielern mit niedriger Visumstufe.
• Einfache Admin-Steuerung: Komfortable Befehle zum Hinzufügen, Entfernen oder Setzen von Stufen inklusive Discord-Logging.

⚙️ Technische Details & Nutzung

Kategorie

Details

Framework

ESX (es_extended)

Datenbank

oxmysql (Tabellen users & owned_vehicles)

Admin-Rechte

Über ACE-Permissions oder ESX-Gruppen

Optimierung

Sichere automatische Speicherung (Level-Up, Disconnect & Intervall)

💻 Befehle & Exports

Player Commands

• /visum – Öffnet das Hauptmenü für den Spieler.

Admin Commands

• /visumset [ID] [Stufe] – Setzt die Visumstufe eines Spielers.
• /visumadd [ID] [Stufen] – Fügt Visumstufen hinzu.
• /visumremove [ID] [Stufen] – Zieht Visumstufen ab.

Developer Exports (Server & Client)

• GetVisumLevel | HasVisumLevel | GetVisumProgress

🛠️ Anpassungsmöglichkeiten (config.lua)

• Benötigte Spielzeit pro Stufe & maximale Visumstufe frei wählbar
• Belohnungstabellen je nach Level individuell konfigurierbar
• Freischalt-Schwellen für Waffen und Fahrzeuge
• Discord-Webhook-Integration für Transparenz bei Team-Aktionen