Einrichtung

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

Kaufen und Abo

Unter Preise wählst du Teammanagement, Control oder das Bundle, jeweils monatlich oder einmal für immer. Die Zahlung läuft über Stripe (Karte, PayPal, SEPA). Direkt danach bekommst du eine E-Mail mit dem Lizenz-Key und der Rechnung als PDF; der Key steht auch im Panel unter „Lizenz einlösen".

Abo verlängern

Passiert von selbst. Jede Monatszahlung verlängert die Lizenz, die Rechnung kommt per Mail.

Abo kündigen

Panel → Einstellungen → Meine Käufe → „Abo verwalten". Die Lizenz bleibt bis zum Ende des bezahlten Monats aktiv.

Rechnungen

Ebenfalls unter „Abo verwalten" bzw. „Rechnungen", dort liegen alle als PDF.

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.

4 · Resource installieren

1. Im Panel unter Einrichtung helix_sync.zip herunterladen
2. Entpacken. Du bekommst den Ordner helix_sync
3. Ordner in den resources-Ordner deines Servers kopieren
4. 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, egal 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.

Bewerberportal

Unter Bewerbungen → Einstellungen schaltest du eure eigene Bewerbungsseite ein: helix-bot.com/bewerben/euer-name. Dort steht eure Einleitung, darunter die offenen Stellen. Bewerber melden sich mit Discord an und beantworten eure Fragen.

Stellen und Fragen

Jede Stelle hat einen Namen, eine Beschreibung und den Rang, den man beim Einstellen bekommt. Fragen gibt es für alle Stellen gemeinsam und zusätzlich je Stelle — als Kurztext, Langtext, Auswahl, Ja/Nein oder Zahl. Mit „Vorlage einsetzen“ und „Standard-Stellen anlegen“ steht in einer Minute ein fertiges Portal, das ihr dann anpasst.

Der Weg einer Bewerbung

Neu → In Prüfung → Gespräch → Zusage oder Absage. Ihr könnt übernehmen, Notizen schreiben, eine Rückmeldung per DM schicken und einen Gesprächstermin vorschlagen. Der Bewerber bestätigt den Termin direkt in der DM oder nennt im Portal andere Zeiten — die seht ihr dann in der Bewerbung und wählt eine aus.

Zusage heißt Einstellen: Rang (aus der Stelle vorbelegt), Discord-Rollen, Ingame-Rechte und Nickname werden gesetzt wie beim normalen Einstellen, der Bewerber bekommt eine Willkommens-DM. Absage geht mit oder ohne Begründung und mit einer Sperrfrist, bevor sich die Person erneut bewerben kann.

Im Discord werben: In den Einstellungen postet der Bot auf Wunsch eine Nachricht mit Link zum Portal in einen Kanal — eigener Text oder eine von drei Vorlagen, mit Vorschau.

Verwarnungen

Eine Verwarnung hat einen Schweregrad — leicht (1 Punkt), mittel (2) oder schwer (3) — und eine Kategorie. Nach der eingestellten Zeit verfällt sie: Sie bleibt in der Personalakte, zählt aber nicht mehr.

In der Personalakte (Klick auf die Zahl neben dem Namen) legt ihr über das Zahnrad fest, ab wie vielen Punkten eskaliert wird und was dann passiert: nur ein Hinweis an die Leitung im Protokoll, oder die Person wird automatisch suspendiert. Verwarnungen lassen sich nachträglich bearbeiten; jede Änderung ist markiert.

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“.

Control

Control ist das zweite Produkt: Live-Karte, Spielerliste und Eingriffe. Es braucht eine eigene Lizenz und läuft über dieselbe Resource wie die Teammanagement. Ist die Resource schon installiert, reicht das Einlösen des Control-Keys, dann erscheint oben im Kontomenü „Zu HELIX Control".

Übersicht

Zustand deiner Gameserver, Spieler online, letzte Ereignisse.

Live-Spieler

Wer online ist, mit Leben, Schild, Geld, Job und Position. Spieler anklicken für Aktionen: Heilen, Schild, Wiederbeleben, Nachricht, Geld, Item, Job, Versetzen, Hinbringen. Bei Geld und Items ist ein Grund Pflicht.

Inventar

Im Spielerdetail. Mit − und + direkt eins nehmen oder geben, mit „…" eine Menge wählen.

Zusehen

Bilderstrom vom Bildschirm des Spielers, etwa drei Bilder pro Sekunde. Der Spieler merkt davon nichts. Braucht die Resourcescreenshot-basic auf dem Server, vor helix_sync gestartet.

Spielerdatenbank

Alle je gesehenen Spieler, auch offline. Geld und Items lassen sich vormerken, der Spieler bekommt sie beim nächsten Login.

Protokoll

Jeder Eingriff mit Grund und ausführender Person.

Wiederbeleben und Heilen funktionieren mit den gängigen Ambulance-Scripts (visn_are, ars, wasabi, qb, esx). Bei einem unbekannten Script lässt sich in server/config.lua ein eigenes Event eintragen.

Control im Discord

/control öffnet eine Nachricht, die nur du siehst: Spieler im Menü auswählen, dann eine Karte mit Leben, Schild, Geld, Job und den Aktionen als Knöpfe. Du siehst nur die Knöpfe, für die du das Recht hast. Die Karte aktualisiert sich ein paar Minuten lang selbst.

Voraussetzung: Dein Discord ist im Panel unter Einstellungen verknüpft, und der Discord-Server ist per /setup mit deinem HELIX-Server gekoppelt.

Wer darf was

Teammanagement

Lizenzinhaber

Alles. Steht außerhalb der Rangleiter. Pro Server genau einer.

Admin

Ränge, Einstellungen, Protokoll und Personalaktionen bis zum eigenen Rang.

Staff

Personalaktionen bis zum eigenen Rang.

Control

Lizenzinhaber

Alles, inklusive Zugänge vergeben.

Verwalter

Alle Eingriffe.

Beobachter

Sehen ja, eingreifen nur mit Einzelrecht.

Einzelrechte

Beim Einladen oder in der Benutzerliste über „Rechte": Nachrichten, Heilen, Geld, Items, Job, Versetzen, Inventar, Zusehen, Kicken, Bannen. Ein Beobachter darf genau das, was angekreuzt ist. Dazu das Recht „Benutzer verwalten" bzw. „Zugänge verwalten".

Die eine Regel

Wer Benutzer verwaltet, handelt nur unterhalb des eigenen Rangs: nie an sich selbst, nie an Gleichrangigen, nie am Lizenzinhaber. Niemand befördert sich selbst, niemand sperrt den Inhaber aus.

Personalaktionen in der Teammanagement setzen voraus, dass die Person ihren Discord verknüpft hat und als Teammitglied eingetragen ist. Lizenzinhaber und Support sind davon ausgenommen.

Support-Zugang

Wenn etwas klemmt, gibst du HELIX-Support zeitlich begrenzt Zugang zu deinem Server. Team → Server oder Control → Einrichtung, Karte „HELIX-Support": Dauer wählen (1 Stunde bis 3 Tage), optional „Eingriffe erlauben", freigeben.

Nur lesen

Support sieht alles, ändert nichts.

Eingriffe erlauben

Support hat die Rechte des Lizenzinhabers, kann aber am Lizenzinhaber selbst nichts ändern.

Protokoll

Freigabe, Übernahme und jede Aktion des Supports stehen in deinem Protokoll.

Beenden

Jederzeit über dieselbe Karte, sonst läuft der Zugang von selbst aus.

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.

Zusehen zeigt kein Bild

screenshot-basic fehlt oder startet nach helix_sync. Reihenfolge in der server.cfg prüfen.

Spieler wird als „voll" angezeigt, obwohl er am Boden liegt

Resource neu aus dem Panel laden. Ältere Fassungen erkannten den Zustand nur über das Leben, das manche Ambulance-Scripts oben halten.

Wiederbeleben tut nichts

Ambulance-Script wird nicht erkannt. In der Serverkonsole beim Start die Zeile „Control bereit … Ambulance: …" prüfen; bei „keins" das Script in server/config.lua eintragen.

/control sagt „kein Konto“

Discord im Panel unter Einstellungen verknüpfen.

Kauf hängt auf „Zahlung wird verbucht“

Meist nur ein paar Sekunden. Nach einer Minute: Support anschreiben, der Kauf wird nachgelegt.

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

/control

Spieler verwalten, nur für dich sichtbar

/setup

Discord-Server mit HELIX koppeln

Ingame (F8)

/verify

Code für die Discord-Verknüpfung

helixnotify <art> <text>

Notify testen (info, ok, warn, gefahr, geld)