SCRIPTS

🔗 FiveM – Discord Rolesync (ESX Legacy & ACE)

Automatisiere deine Teamverwaltung und Rechtestruktur! Discord Rolesync prüft beim Verbinden eines Spielers automatisch dessen Discord-Rollen und weist ihm nahtlos die passenden ESX- und ACE-Gruppen auf deinem Server zu.

Kein manuelles Zuweisen von Admin- oder Team-Rängen mehr – alles läuft vollautomatisch, sicher und zu 100 % serverseitig ab!

✨ Key Features im Überblick

• Vollautomatische Rechtevergabe: Zuweisung von ESX- und ACE-Gruppen direkt beim Joinen anhand der Discord-Rollen des Spielers.
• Smartes Prioritätssystem: Besitzt ein Spieler mehrere relevante Teamrollen (z. B. Moderator + Supporter), erhält er automatisch nur die Rolle mit der höchsten Priorität.
• Fallback & Standardgruppen: Zuweisung einer konfigurierbaren Standardgruppe (z. B. user), falls der Spieler keine Teamrolle besitzt.
• Server-Zugangskontrolle (Whitelist Option):
  • Optionale Discord-Verbindungspflicht.
  • Automatischer Kick von Spielern, die nicht auf dem Discord-Server sind.
  • Einstellbares Verhalten bei Discord-API-Ausfällen.
• Sauberes Bereinigungssystem: ACE-Rechte werden beim Disconnect des Spielers oder beim Stoppen der Resource automatisch wieder entfernt – für maximale Server-Sicherheit.
• Detailliertes Webhook-Logging: Sendet anpassbare Discord-Embeds mit Spielername, Discord-Tag, vergebener Gruppe und Zeitstempel.

🔒 Maximale Sicherheit & Performance

• 100 % Serverseitig: Keine Client-Skripte oder anfällige Events – Manipulation durch Modder ist ausgeschlossen.
• Sicherer Bot-Token: Der Bot-Token kann geschützt über eine Server-Convar (server.cfg) hinterlegt werden.
• Ressourcenschonend: Nutzt direkte Abfragen über die offizielle Discord-API.

⚙️ Technische Details & Anforderungen

Kategorie

Details

Framework

ESX Legacy (es_extended)

Voraussetzungen

Discord-Bot auf eurem Guild-Server • Aktivierter discord:-Identifier beim Spieler

Optional

Discord-Webhook für Beitritts- & Rollen-Logs

🛠️ Anpassungsmöglichkeiten (config.lua)

• Discord-Server-ID & Bot-Token / Convar-Einstellungen
• Zuordnung aller Discord-Rollen zu ESX- & ACE-Gruppen
• Prioritäts-Reihenfolge & Standard-Gruppe
• Sämtliche Kick- & Fehlermeldungen (z. B. bei fehlendem Discord)
• Vollständiges Design des Discord-Log-Embeds (Farben, Bilder, Fußzeile)