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 moderne Panel-basierte Ticketsystem ermöglicht flexible Ticket-Management mit kategorieabhängigen Workflows.
🎯 Panels verwalten
Erstelle und verwalte mehrere Ticket-Panels mit je eigenen Einstellungen und Kategorien:
📋 Ticket-Kategorien pro Panel
Jedes Panel kann mehrere Kategorien haben mit eigenen Einstellungen:
⚙️ Status-Einstellungen pro Panel neu
Jedes Panel hat seine eigenen aktivierten Statuse (global gestaltbar, pro Panel aktivierbar):
🔴 Geschlossen wird automatisch gesetzt, wenn auf den "Schließen"-Button geklickt wird.
👑 Management-Rolle neu
Wähle eine Rolle die benachrichtigt wird, wenn in einem Ticket auf "Management Hinzufügen" geklickt wird.
📤 Panel versenden
Sende ein Ticket-Panel als Message in einen Discord-Kanal. Benutzer können dann das Panel mit Select-Menu öffnen.
Klicke auf "📤 Senden" bei einem Panel, wähle einen Kanal und das Embed mit Select-Menu wird dort angezeigt.
⚙️ Allgemeine Einstellungen
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
Panels werden im Dashboard erstellt und konfiguriert:
- Gehe zu 🎯 Panels verwalten
- Klicke + Panel Erstellen
- Gib Name, Präfix und Beschreibung ein (z.B. "Bürgerpanels", "BUERGER")
- Füge Kategorien hinzu (Bewerbung, Dienstbeschwerde, etc.)
- Konfiguriere für jede Kategorie die Discord-Kanalkategorie und Rollen
- Stelle die Status ein die aktiviert sein sollen
- Klicke 📤 Senden um das Panel in einen Discord-Kanal zu posten
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 korrekt konfiguriert sind (Discord-Kategorien, Rollen)
- Gehe zu 🎯 Panels verwalten und bearbeite das Panel
- Wende die Änderungen an und versende das Panel neu über 📤 Senden
Bei weiteren Problemen komm in unseren Support Discord - wir helfen dir gerne!
Changelog
- 🎯 Neu: Panel-basiertes Ticketsystem mit mehreren unabhängigen Panels
- 📋 Neu: Multi-Kategorie-Architektur pro Panel mit kategoriespezifischen Einstellungen
- ⚙️ Neu: Per-Panel Status-Konfiguration (🟢 Neu, 🟡 In Bearbeitung, 🔵 Management, ⚪ Fertig)
- 👑 Neu: Management-Rolle pro Panel für spezielle Benachrichtigungen
- 📤 Neu: Panel-Versand-Feature zum Senden als Discord-Embed
- ⏰ Neu: Konfigurierbare Archival-Verzögerung (Stunden) und benutzerdefinierte Archiv-Nachricht
- 🔴 Neu: Automatischer "Geschlossen"-Status mit Emoji im Kanalnamen
- Fix: Status-Emoji zeigen sich korrekt im Kanalnamen bei Erstellung und Status-Wechsel
- Fix: Rollenüberprüfung bei Ticket-Erstellung funktioniert zuverlässig
- Fix: Multi-Select Menü für Kategoriewahl funktioniert korrekt
- Update: Wiki mit vollständiger Panel-System Dokumentation erweitert
- 📝 Neu: Detaillierter Changelog für Discord-Community
- 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