SCRIPTS

🎙️ FiveM – Modernes VoiceNUI & Mute-System

Gib deinen Spielern volle Kontrolle und Transparenz über ihren Sprachstatus! VoiceNUI blendet eine elegante, moderne NUI-Oberfläche ein, sobald das Mikrofon eines Spielers stummgeschaltet oder deaktiviert ist.

Egal ob versehentliches Muten in SaltyChat, Stummschaltung in pma-voice oder Admin-Mutes über externe Skripte – deine Spieler sehen sofort ihren Status und können das Mikrofon direkt per Klick oder Taste wieder aktivieren.

✨ Key Features im Überblick

• Smart Mute-Display:
  • Automatische Einblendung der NUI bei Stummschaltung/Deaktivierung des Mikrofons.
  • Interaktiver NUI-Button zum direkten Wiederaktivieren des Mikrofons (inkl. optionalem Cursor).
  • Anzeige des aktiven Voice-Systems und individueller Mute-Gründe (z. B. Support/Admin-Mute).
• Volle Voice-System-Kompatibilität:
  • SaltyChat: Vollständige Unterstützung aller Mic- & Sound-State-Events.
  • pma-voice: Integrierter lokaler Mute via Proximity-Check & Network-Voice-Fallback.
  • Custom Voice: Einfache Anbindung eigener Systeme über bereitgestellte Events & Exports.
• Intelligente Hotkeys & Keymapping:
  • Umschaltbar per Befehl (/voicemute) oder Hotkey (Standard: F9, frei belegbar in den FiveM-Einstellungen).
  • Smart Blocking: Hotkeys werden bei geöffnetem Chat, Pause-Menü oder anderen NUIs automatisch ignoriert.
• Optionales Branding & Community-Kacheln:
  • Integrierbare Kacheln für Discord- & TeamSpeak-Links.
  • Discord-Link direkt aus der NUI per Klick im Browser öffenbar.
• Erweiterte Gameplay-Optionen:
  • Akustisches Feedback (Sounds) beim Statuswechsel.
  • Optionale Bewegungssperre (Blockieren von Laufen, Schießen & Fahrsteuerung während des Mutes).

🔌 Entwickler-Freundlich (Exports & Events)

Steuere die NUI mühelos aus deinen eigenen Admin-, Polizei- oder Support-Skripten:

• Export: exports['CV_VoiceNUI']:SetMuted(state, reason)
• Events: cv-voicenui:show, cv-voicenui:hide, cv-voicenui:setMuted

🔒 Maximale Unabhängigkeit & Performance

• Framework-Unabhängig: Reines Client-Skript – keine ESX-, QB-Core- oder Datenbank-Abhängigkeit erforderlich!
• Optimiert: Extrem ressourcenschonende Ausführung im Hintergrund.

⚙️ Technische Details & Anforderungen

Kategorie

Details

Framework

Standalone (Framework-Unabhängig)

Voice-Systeme

SaltyChat, pma-voice oder Custom Voice

Standard-Keybind

F9 oder /voicemute

Offene Konfiguration

Vollständige Anpassung aller Texte, Links, Sounds & Voice-Events via config.lua