Einrichtung

Vom Lizenzkey bis zum ersten eingestellten Teammitglied. Etwa 15 Minuten, keine Vorkenntnisse nötig.

Bevor du beginnst

Du brauchst drei Dinge:

Deinen Lizenzkey im FormatHLX-XXXX-XXXX-XXXX-XXXX
Administratorrechte auf deinem Discord-Server
Zugriff auf denresources-Ordner und die server.cfg deines FiveM-Servers

1 · Konto erstellen

Öffne helix-bot.com und wähle „Account erstellen“. Trag E-Mail, Benutzernamen und ein Passwort ein. Du bekommst eine Bestätigungsmail — der Link darin gilt 24 Stunden.

Keine Mail erhalten? Sieh im Spam-Ordner nach.

2 · Lizenz einlösen

Nach der ersten Anmeldung erscheint die Seite „Lizenz einlösen“. Tipp deinen Key ein — die Bindestriche setzt das Feld selbst. Danach öffnet sich die Einrichtung.

3 · Discord verbinden

Du siehst alle Discord-Server, auf denen du Verwaltungsrechte hast. Steht dort „HELIX muss noch eingeladen werden“, klick auf Bot einladen, wähle deinen Server und bestätige. Zurück im Panel: Verknüpfen.

Position der Bot-Rolle

Discord erlaubt einem Bot nur, Rollen unterhalb seiner eigenen zu vergeben. Zieh die Rolle HELIX BOT in den Servereinstellungen über alle Team-Rollen. Wird das vergessen, funktioniert alles andere — nur die Rollenvergabe schlägt still fehl.

4 · Resource installieren

Im Panel unter Einrichtung helix_sync.zip herunterladen
Entpacken — du erhältst den Ordner helix_sync
Ordner in den resources-Ordner deines Servers kopieren
Diese Zeile in die server.cfg eintragen:

ensure helix_sync

Mehr nicht. Kein Lizenzkey, keine Adresse, keine Zugangsdaten — das steckt bereits in der heruntergeladenen Datei.

Nach dem Serverstart erscheint in der Konsole:

[helix] Lizenz aktiviert — Server verbunden.

Rechtevergabe freigeben

FiveM erlaubt einer Resource die Vergabe von Berechtigungen erst nach ausdrücklicher Freigabe. Diese beiden Zeilen gehören deshalb vor ensure helix_sync — unabhängig davon, welches Framework du nutzt:

add_ace resource.helix_sync command.add_principal allow
add_ace resource.helix_sync command.remove_principal allow
ensure helix_sync

Auch mit ESX ist das sinnvoll: HELIX setzt die Gruppe dort zwar in der Datenbank, vergibt aber zusätzlich die ACE-Berechtigung. Viele Scripts und Adminmenüs prüfen genau die — ohne Freigabe fehlen sie.

Fehlen die Zeilen, meldet die Serverkonsole Access denied for command add_principal. Das Panel weist unter Einrichtung ebenfalls darauf hin.

5 · Ränge anlegen

Leg für jede Stufe deines Teams einen Rang an. Pro Rang trägst du ein:

Name: Erscheint im Panel, im Discord-Nickname und in Mitteilungen.
Discord-Rollen: Werden automatisch vergeben und wieder entzogen. Mehrere möglich.
Ingame-Gruppe: Die Gruppe, die dein Adminmenü prüft. Bei ESX steht sie in der Spaltegroup der Tabelle users, bei ACE-Systemen in deiner server.cfg hinter add_ace group.…
Panel-Berechtigungen: Mitglied, Personal oder Leitung.

Die Reihenfolge stellst du mit den Pfeilen ein — 1 ist der höchste Rang. Sie entscheidet, wer wen bearbeiten darf: Ranghöhere und Gleichrangige sind tabu.

6 · Team einstellen

Unter Team die Discord-ID eintragen, Rang wählen, fertig. Die Person bekommt sofort ihre Rollen, den Nickname und eine Nachricht.

Discord-ID kopieren: Einstellungen → Erweitert → Entwicklermodus aktivieren, dann Rechtsklick auf die Person → „Benutzer-ID kopieren“.

Ingame-Verknüpfung

Damit jemand ingame seine Rechte bekommt, muss HELIX wissen, welcher FiveM-Account zu welchem Discord gehört. Verbindet die Person mit laufendem Discord, geschieht das von selbst. Sonst tippt sie ingame/verify, merkt sich den Code und bestätigt ihn im Discord mit /team verify.

Kanäle einrichten

Unter Server lassen sich zwei Kanäle festlegen:

Team-Update-Kanal: Kurze Meldungen fürs Team: wer neu ist, befördert wurde oder gegangen ist.
Log-Kanal: Vollständiges Protokoll mit Grund und Ausführendem. Nur für die Leitung sichtbar machen — hier stehen Personalinterna.

Neben beiden gibt es Test senden. Kommt nichts an, fehlen dem Bot im Kanal die Rechte „Kanal ansehen“, „Nachrichten senden“ und „Links einbetten“.

Wer darf was

Lizenzinhaber: Alles. Steht außerhalb der Rangleiter und kann jedes Mitglied ändern. Pro Server genau einer.
Admin: Ränge, Server-Einstellungen, Protokoll und alle Personalaktionen — begrenzt durch den eigenen Rang.
Staff: Nur Personalaktionen, ebenfalls rangbegrenzt.

Personalaktionen setzen voraus, dass die Person ihren Discord verknüpft hat und als Teammitglied eingetragen ist — daraus ergibt sich ihr Rang.

Wenn etwas klemmt

Rollen werden nicht vergeben: Bot-Rolle steht unter den Team-Rollen — in Discord nach oben ziehen.
Nickname ändert sich nicht: Die Person ist Server-Owner. Discord erlaubt kein Umbenennen.
Keine Nachricht angekommen: Der Empfänger hat Direktnachrichten von Servermitgliedern deaktiviert.
„Ingame offen“ bleibt stehen: /verify ingame, dann /team verify im Discord.
Ingame keine Rechte: Prüfen, ob beim Rang eine Ingame-Gruppe eingetragen ist und ob sie genau so heißt wie im Adminmenü.
„Access denied for command add_principal“: Die beiden add_ace-Zeilen fehlen — siehe Schritt 4.

Befehle

Serverkonsole

helixinfo: Verbindungsstatus und Server-ID
helixids: Identifier der verbundenen Spieler
helixrefresh: Rechte aller Online-Spieler neu laden
helixreset: Aktivierung zurücksetzen

Discord

/team einstellen: Mitglied aufnehmen
/team rang: Rang ändern
/team verwarnen: Verwarnung aussprechen
/team kuendigen: Aus dem Team entfernen
/team verify: Ingame-Verknüpfung bestätigen