FiveBase Wiki
Willkommen zur offiziellen Dokumentation des FiveBase Discord Bots. Hier findest du alles, was du wissen musst, um den Bot optimal für deine Fraktion einzurichten und zu nutzen.
FiveBase ist komplett kostenlos nutzbar. Alle Funktionen stehen dir ohne Einschränkungen zur Verfügung.
Was ist FiveBase?
FiveBase ist ein speziell für staatliche Fraktionen auf GTA RP Servern entwickelter Discord Bot. Er bietet dir:
- Stempelsystem - Automatische Zeiterfassung für Mitarbeiter
- Ticketsystem - Bewerbungen, Beschwerden und interne Anfragen
- Dienstnummern - Live-Übersicht aller vergebenen Nummern
- Personalverwaltung - Digitale Personalakten mit Statistiken
- Urlaubssystem - Urlaubsanträge über Discord
- Teamliste - Live-Übersicht aller Mitarbeiter nach Rängen sortiert
- Einstellungssystem - Automatische Einstellung mit DN-Vergabe
- Moderationssystem - Auto-Mod, Welcome, Logging, Auto-Rollen, Commands
Wichtige Links
| Link | Beschreibung |
|---|---|
| dashboard.5base.de | Einstellungs-Dashboard (Bot konfigurieren) |
| personal.5base.de | Personalverwaltung (Akten, Urlaub, etc.) |
| Discord Support | Hilfe & Support Server |
Schnellstart
In nur 5 Minuten ist FiveBase einsatzbereit. Folge diesen Schritten:
Stelle sicher, dass die Bot-Rolle ÜBER den Rollen liegt, die er verwalten soll. Sonst kann er keine Rollen vergeben/entfernen!
Bot einladen
Um FiveBase auf deinen Server einzuladen, benötigst du Administrator-Rechte auf dem Zielserver.
Benötigte Berechtigungen
| Berechtigung | Wofür benötigt |
|---|---|
| Rollen verwalten | Im-Dienst-Rolle, Urlaubs-Rolle vergeben |
| Kanäle verwalten | Ticket-Kanäle erstellen |
| Nachrichten senden | Bot-Antworten, Logs, Embeds |
| Nachrichten verwalten | Auto-Mod und Clear-Befehle |
| Mitglieder verwalten | Timeouts, Kicks, Bans, Nicknames setzen |
Dashboard Login
Das Dashboard ermöglicht dir, alle Einstellungen des Bots bequem über den Browser zu verwalten.
So meldest du dich an
Nur Nutzer mit Administrator-Berechtigung auf dem jeweiligen Server können das Dashboard nutzen.
Tab: Allgemein
Im Tab "Allgemein" findest du die grundlegenden Einstellungen und kannst Module aktivieren/deaktivieren.
Module aktivieren
Jedes Modul muss erst aktiviert werden, bevor es genutzt werden kann:
Tab: Stempelsystem
Hier konfigurierst du das Zeiterfassungssystem für deine Mitarbeiter.
Rollen-Einstellungen
Kanal-Einstellungen
Weitere Einstellungen
Mitarbeiter-Ränge
Hier definierst du die Ränge für die Topliste und Reports. Jeder Rang besteht aus:
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Emoji | Ein Emoji zur Darstellung | 👮 oder 🎖️ |
| Name | Bezeichnung des Rangs | "Officer", "Sergeant" |
| Discord-Rolle | Die zugehörige Rolle | @Officer |
Tab: Ticketsystem
Das Ticketsystem ermöglicht Bewerbungen, Beschwerden und interne Anfragen.
Rollen
Kategoriespezifische Handler-Rollen
Für jede Ticket-Kategorie kannst du eine eigene Handler-Rolle festlegen. Diese Rolle kann das Ticket sehen und wird bei Erstellung gepingt. Falls keine Rolle angegeben wird, wird die allgemeine Support-Rolle verwendet.
Wenn keine kategoriespezifische Rolle eingestellt ist, wird automatisch die allgemeine Support-Rolle verwendet.
Kategorien (Bürger-Tickets)
Wähle für jede Ticket-Art eine Discord-Kategorie, in der die Ticket-Kanäle erstellt werden:
Kategorien (Mitarbeiter-Tickets)
Quiz-System (Bewerbungen)
Bewerbungsformular
Definiere die Fragen, die Bewerber ausfüllen müssen:
| Feld | Beschreibung |
|---|---|
| ID | Interner Name (z.B. "name", "age") |
| Beschriftung | Die Frage die angezeigt wird (z.B. "Wie heißen Sie?") |
Quiz-Fragen
Erstelle Multiple-Choice Fragen für das Bewerbungs-Quiz:
Markiere genau EINE Antwort pro Frage als "Richtig". Der Bewerber muss die richtige Antwort auswählen.
Tab: Dienstnummern
Die Dienstnummern-Übersicht zeigt live an, welche Nummern vergeben und welche frei sind.
Einstellungen
Blacklist
Hier kannst du Nummern sperren, die nicht vergeben werden sollen (z.B. reservierte Nummern für die Leitung).
Gesperrte Nummern werden als "🔒 Reserviert" angezeigt und können nicht vergeben werden.
Tab: Personal
Die Personalverwaltung ermöglicht digitale Akten, Urlaubsanträge und Abmahnungen.
Rollen-Berechtigungen
Urlaub-System
Automatisierung
Abmahnungsstufen
Definiere verschiedene Verwarnungsstufen für dein Abmahnungssystem:
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Emoji | Symbol für die Stufe | ⚠️, 🔶, 🔴, ❌ |
| Name | Bezeichnung der Stufe | "1. Abmahnung" |
| Rolle | Optional: Rolle die vergeben wird | @Abgemahnt |
| Tage | Gültigkeit in Tagen (0 = permanent) | 30 |
| Punkte | Punktwert für Statistiken | 1, 2, 3... |
Bei neuen Servern sind bereits 4 Standard-Stufen eingerichtet: 1. Abmahnung (30 Tage), 2. Abmahnung (60 Tage), 3. Abmahnung (90 Tage), Kündigung (permanent).
Ränge konfigurieren
Hier definierst du die Ränge deiner Fraktion. Diese werden für die automatische Akten-Erstellung und Rang-Synchronisierung verwendet.
Die Reihenfolge bestimmt die Hierarchie. Der erste Rang ist der höchste. Wenn jemand mehrere Rang-Rollen hat, wird der höchste genommen.
Tab: Teamliste
Die Teamliste zeigt alle Mitarbeiter sortiert nach Rängen in einem Live-Embed an.
Einstellungen
Ränge konfigurieren
Definiere die Ränge die in der Teamliste angezeigt werden sollen. Die Reihenfolge bestimmt die Sortierung (von oben nach unten).
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Emoji | Emoji vor dem Rang-Namen | 👑, ⭐, 🏅 |
| Name | Bezeichnung des Rangs | "Direktor", "Captain" |
| Discord-Rolle | Die zugehörige Discord-Rolle | @Direktor, @Captain |
Bei sehr großen Teams wird die Liste automatisch auf mehrere Nachrichten aufgeteilt, um Discord's Zeichenlimit einzuhalten.
Du kannst die Liste jederzeit manuell aktualisieren mit dem Befehl /teamlist update
Tab: Einstellung
Das Einstellungssystem ermöglicht die schnelle Einstellung neuer Mitarbeiter mit automatischer DN-Vergabe.
Berechtigungen
Rollen-Zuweisung
Dienstnummern
Logging
Mit einem einzigen Befehl werden automatisch: Rollen vergeben, Dienstnummer zugewiesen (falls aktiviert), Nickname gesetzt und die Einstellung geloggt.
Tab: Moderation
Steuere alle Moderationsfunktionen zentral: Auto-Mod, Welcome, Auto-Rollen, Logging und Befehls-Berechtigungen.
Moderations-Rollen
Auto-Moderation
Filter
| Filter | Beschreibung | Wichtige Optionen |
|---|---|---|
| Anti-Spam | Erkennt viele Nachrichten in kurzer Zeit | Max Nachrichten, Zeitfenster (Sekunden) |
| Anti-Links | Blockiert Links außer erlaubte Domains | Whitelist (eine Domain pro Zeile) |
| Bad Words | Filtert verbotene Wörter (case-insensitive) | Wortliste (ein Wort pro Zeile) |
| Anti-Caps | Blockiert zu hohe Großbuchstaben-Anteile | Min Länge, Max % Caps |
| Anti-Mentions | Limitiert @Erwähnungen pro Nachricht | Max Mentions |
Welcome System
{user}, {user.mention}, {user.tag}, {server}, {membercount}, {user.id}Auto-Roles
Logging
Stempelsystem
Das Stempelsystem erfasst automatisch die Arbeitszeit deiner Mitarbeiter.
So funktioniert's
/stempel panel um das Stempel-Panel in einem Kanal zu erstellen.Features
- Automatische Zeiterfassung - Jede Session wird mit Start- und Endzeit gespeichert
- Wöchentliche Statistiken - Zeiten werden wöchentlich zusammengefasst
- Topliste - Automatisch aktualisierte Rangliste nach Arbeitszeit
- AFK-Check - Inaktive Mitarbeiter werden automatisch ausgestempelt
- Session-Limit - Vergessene Sessions werden nach X Stunden beendet
Ticketsystem
Das Ticketsystem ermöglicht strukturierte Kommunikation mit Bürgern und innerhalb der Fraktion.
Ticket-Typen
Bürger-Tickets
Für externe Anfragen von Bürgern:
- 📝 Bewerbung - Mit Formular und optionalem Quiz
- 🛡️ Dienstbeschwerde - Beschwerden über Mitarbeiter
- 📋 Sonstiges - Allgemeine Anfragen
Mitarbeiter-Tickets
Für interne Anfragen (nur mit Mitarbeiter-Rolle sichtbar):
- ⚠️ Interne Beschwerde - Konflikte unter Mitarbeitern
- 📚 Ausbildung - Schulungsanfragen
- 📋 Sonstiges - Interne Anfragen
Panels erstellen
Ticket-Aktionen
In jedem Ticket stehen verschiedene Buttons zur Verfügung:
| Button | Funktion |
|---|---|
| 🔵 Management | Leitung zum Ticket hinzufügen |
| 🔒 Schließen | Ticket schließen und archivieren |
| ✅ Annehmen (Bewerbung) | Bewerbung akzeptieren |
| ❌ Ablehnen (Bewerbung) | Bewerbung ablehnen |
Kategoriespezifische Handler-Rollen
Für jede Ticket-Kategorie kann eine eigene Handler-Rolle definiert werden:
- ✅ Bewerbungen → Eigene Rolle (z.B. @Personalamt)
- ✅ Bürger-Beschwerden → Eigene Rolle (z.B. @IA)
- ✅ Ausbildungen → Eigene Rolle (z.B. @Ausbilder)
- ✅ Alle anderen Kategorien → Eigene Rollen möglich
- ✅ Fallback auf Support-Rolle falls keine spezifische Rolle definiert
Dienstnummern
Die Dienstnummern-Übersicht zeigt live alle freien und vergebenen Nummern.
So funktioniert's
Das System liest die Dienstnummern aus den Nicknames der Mitarbeiter:
Der Nickname muss das Format [XX] Name haben, z.B. [01] Max Mustermann
Übersicht erstellen
Das Embed wird automatisch erstellt wenn du im Dashboard den Kanal auswählst und speicherst. Es aktualisiert sich automatisch bei Änderungen.
Anzeige
- 🟢 Vergeben - Nummer ist einem Mitarbeiter zugewiesen
- ⚪ Frei - Nummer ist verfügbar
- 🔒 Reserviert - Nummer ist auf der Blacklist
Personalverwaltung
Digitale Personalakten für alle Mitarbeiter mit Statistiken, Historie und mehr.
Zugriff
Die Personalverwaltung erreichst du über:
- personal.5base.de (Webseite)
/personal(Discord-Command)
Personalakte
Jede Akte enthält:
| Information | Beschreibung |
|---|---|
| Dienstnummer | Die zugewiesene Dienstnummer |
| Name (IC) | Der Roleplay-Name |
| Rang | Aktueller Rang (synchronisiert mit Discord-Rollen) |
| Einstellungsdatum | Wann der Mitarbeiter eingestellt wurde |
| Discord | Verknüpfter Discord-Account |
| Discord ID | Die Discord-User-ID (kopierbar) |
| Verwarnungen | Anzahl aktiver Verwarnungen |
| Notizen | Freitext für Anmerkungen |
Tabs in der Akte
- 📋 Informationen - Allgemeine Daten und Notizen
- ⚠️ Verwarnungen - Aktive und abgelaufene Verwarnungen
- 📜 Historie - Alle Aktionen (Beförderungen, Notizen, etc.)
- 📊 Statistiken - Arbeitszeiten aus dem Stempelsystem
- 🏖️ Urlaub - Urlaubshistorie
Automatische Rang-Synchronisierung
Wenn sich die Discord-Rollen eines Mitarbeiters ändern, wird der Rang in der Akte automatisch aktualisiert und in der Historie dokumentiert.
Urlaubssystem
Mitarbeiter können Urlaub über Discord eintragen - ohne Genehmigung nötig.
So funktioniert's
/urlaub eintragen mit Start-, End-Datum und Grund.Befehle
Features
- ✅ Keine Genehmigung nötig - direkt aktiv
- ✅ Automatische Rollenvergabe/-entfernung
- ✅ Log-Nachricht wird automatisch gelöscht wenn Urlaub vorbei
- ✅ DM-Benachrichtigung bei Urlaubs-Ende
- ✅ Stündliche Prüfung aller Urlaube
Verwarnungssystem
Dokumentiere Abmahnungen und Verwarnungen professionell über die Personalverwaltung (separat vom Moderationssystem).
Befehle
Nur Nutzer mit der Management- oder Personal-Rolle können Verwarnungen erteilen.
Teamliste
Die Teamliste zeigt alle Mitarbeiter nach Rängen sortiert in einem Live-Embed an.
So funktioniert's
Die Liste liest automatisch alle Mitglieder mit den konfigurierten Rang-Rollen aus und sortiert sie hierarchisch.
Anzeige-Format
Für jeden Rang wird angezeigt:
- Emoji + Rang-Name als Überschrift
- Liste aller Mitarbeiter in diesem Rang
- Dienstnummer wird aus dem Nickname extrahiert ([XX] Name)
- Sortierung nach Dienstnummer aufsteigend
Wenn der Nickname das Format [XX] Name hat, wird die DN vor dem Namen angezeigt. Sonst nur der Name.
Befehle
Features
- ✅ Automatische Updates im konfigurierten Intervall
- ✅ Multi-Message Support bei großen Teams
- ✅ Hierarchische Sortierung nach Rängen
- ✅ DN-Erkennung aus Nickname
- ✅ Anpassbare Farbe und Titel
Einstellungssystem
Stelle neue Mitarbeiter mit einem einzigen Befehl ein - inklusive automatischer DN-Vergabe und Rollenzuweisung.
So funktioniert's
/einstellung mit Discord-User, IC-Name und optional einer Dienstnummer.Befehle
Was passiert automatisch?
- ✅ Mitarbeiter-Rolle wird vergeben
- ✅ PMA-Rolle wird vergeben (falls konfiguriert)
- ✅ Zusätzliche Rollen werden vergeben
- ✅ Dienstnummer wird automatisch gesucht (falls aktiviert) oder manuell vergeben
- ✅ Nickname wird gesetzt: [XX] IC_Name
- ✅ Log-Message wird erstellt mit allen Details
- ✅ Bestätigung an den Ausführenden
Auto-DN Vergabe
Das System durchsucht automatisch alle Mitglieder mit der Mitarbeiter-Rolle und findet die nächste freie Dienstnummer im konfigurierten Bereich.
Bei großen Servern kann die DN-Suche einige Sekunden dauern. Das System hat einen Timeout-Schutz und nutzt zwischengespeicherte Daten als Fallback.
Nur Nutzer mit der im Dashboard konfigurierten "Berechtigte Rolle" können diesen Befehl nutzen.
Moderationssystem
Das Moderationssystem bietet Auto-Moderation, Willkommensnachrichten, automatische Rollenvergabe, umfangreiches Logging und Moderations-Befehle.
Features
- ✅ Auto-Moderation (Spam, Links, Bad Words, Caps, Mentions)
- ✅ Welcome (mit Variablen und Embed-Designer)
- ✅ Auto-Roles (Rollen automatisch bei Join vergeben)
- ✅ Logging (6 getrennte Log-Kanäle)
- ✅ Moderations-Befehle (Ban, Kick, Timeout, Clear, Unban, Untimeout)
- ✅ Dashboard-Steuerung (alles per UI konfigurierbar)
Logging-Kategorien
| Kategorie | Beispiele |
|---|---|
| Auto-Mod | Gelöschte Nachrichten, Filter-Treffer |
| Join/Leave | Neue/gehende Mitglieder |
| Messages | Nachrichten gelöscht/editiert |
| Member | Rollen-/Nickname-Änderungen |
| Server | Kanäle/Rollen erstellt/gelöscht |
| Moderation | Ban, Kick, Timeout, Clear |
Moderations-Verwarnungen (/warn) sind entfernt. Verwarnungen laufen ausschließlich über die Personalverwaltung.
Alle Befehle
Übersicht aller verfügbaren Discord-Befehle.
Allgemeine Befehle
| Befehl | Beschreibung |
|---|---|
/ping | Zeigt die Bot-Latenz an |
/help | Zeigt die Hilfe-Übersicht |
/dashboard | Link zum Web-Dashboard |
/personal | Link zur Personalverwaltung |
Stempel-Befehle
| Befehl | Beschreibung |
|---|---|
/stempel panel | Erstellt das Stempel-Panel im Kanal |
/stempel stats | Zeigt deine persönlichen Statistiken |
/stempel list | Zeigt alle Mitarbeiter die gerade im Dienst sind |
Personal-Befehle
| Befehl | Beschreibung |
|---|---|
/urlaub eintragen | Urlaub eintragen |
/urlaub beenden | Urlaub vorzeitig beenden |
/urlaub liste | Alle aktuellen Urlaube anzeigen |
/verwarnung erteilen | Verwarnung an Mitarbeiter erteilen |
/verwarnung liste | Verwarnungen eines Mitarbeiters anzeigen |
/verwarnung loeschen | Verwarnung löschen |
Moderation-Befehle
| Befehl | Beschreibung |
|---|---|
/ban | Bannt ein Mitglied (optional: Grund, Tage Nachrichten löschen) |
/unban | Hebt einen Bann per User-ID auf |
/kick | Kick eines Mitglieds vom Server |
/timeout | Timeout für eine Dauer (z.B. 10m, 2h, 1d) |
/untimeout | Entfernt einen aktiven Timeout |
/clear | Löscht 1-100 Nachrichten (optional: nur von User) |
Nur Administratoren oder Nutzer mit den im Dashboard definierten Moderations-Rollen können diese Befehle nutzen. Rollen-Hierarchie wird beachtet.
Häufige Fragen (FAQ)
Stelle sicher, dass die Bot-Rolle ÜBER den Rollen liegt, die er verwalten soll. In Discord: Servereinstellungen → Rollen → Die Bot-Rolle nach oben ziehen.
Du siehst nur Server auf denen du Administrator bist UND der Bot bereits eingeladen wurde. Stelle sicher, dass beides zutrifft.
Der Nickname muss das Format [XX] Name haben, also z.B. [01] Max Mustermann. Die eckigen Klammern sind wichtig!
Kontaktiere uns im Support-Discord. Wir können die Daten für deinen Server komplett zurücksetzen.
Ja! Der Bot kann auf beliebig vielen Servern genutzt werden. Jeder Server hat seine eigenen unabhängigen Einstellungen.
Fehlerbehebung
Häufige Probleme
- Prüfe ob der Bot online ist (grüner Punkt)
- Stelle sicher, dass du Slash-Commands verwendest (/befehl)
- Warte 1-2 Minuten - Commands werden manchmal verzögert registriert
- Klicke auf den "Speichern" Button unten im Dashboard
- Warte auf die Bestätigungsmeldung
- Lade die Seite neu und prüfe ob die Einstellungen übernommen wurden
- Stelle sicher, dass das Ticketsystem aktiviert ist
- Prüfe ob alle Kategorien im Dashboard ausgewählt sind
- Erstelle das Panel neu mit /setup-tickets-buerger
Bei weiteren Problemen komm in unseren Support Discord - wir helfen dir gerne!
Changelog
- Neu: Moderationssystem mit Auto-Mod, Welcome, Auto-Rollen und Logging
- Neu: Dashboard Tab "Moderation" inkl. aller Einstellungen
- Neu: Moderations-Befehle: /ban, /unban, /kick, /timeout, /untimeout, /clear
- Entfernt: Moderations-Verwarnungen (/warn, /warnings) – Verwarnungen laufen über die Personalverwaltung
- Fix: Modul-Toggle für Moderation speichert korrekt
- Update: Wiki mit Moderations-Dokumentation ergänzt