Dokumentation / Discord-Rollen

Discord-Rollen

Temporäre VIPs, Ingame-VIP-Exports, Teamrollen auf Discord, Bot und Tickets.

Dieser Abschnitt behandelt die im Panel verwalteten Discord-Rollen: VIP mit Ablaufdatum (ingame über Exports von Adictos_WebLogs lesbar), wer in Ticket-Threads als Team gilt, erforderliche Rollen auf den Buttons des Ticket-Panels und Sperrliste nach Rolle. Nicht zu verwechseln mit den Steam-Berechtigungen des Panels (siehe Abschnitt Panel-Berechtigungen).

Bot verbinden

  1. 1Panel Settings → WebLogs → konfiguriere den globalen Bot (empfohlen) oder nutze einen eigenen Token.
  2. 2Meine Server → Tab DiscordBot → Bot einladen → Verbinden und erkennen.
  3. 3Nach der Erkennung füllen sich die Auswahllisten für Rollen und Kanäle automatisch.
Aktiviere im Developer Portal den Server Members Intent. Die Rolle des Bots auf Discord muss über den VIP-Rollen stehen, die er vergeben soll.

Temporäre VIPs (Discord VIP)

Vergib Discord-Rollen (VIP, VIP+, PRO usw.) mit Ablaufdatum direkt aus dem Panel:

  1. 1Meine Server → DiscordBot → Tabelle VIP-Rollen: Wähle die Rollen deines Discords (der Rollenname ist der Ingame-Rang).
  2. 2Optional pro Rolle: ACE-Gruppe und ESX-Job (um sie ingame in deinen Skripten zu nutzen).
  3. 3Konfiguriere Teamkanal, Vorwarntage und automatische Nachrichten (DM + Kanal).
  4. 4Teammitglieder mit der Berechtigung Discord VIP verwalten Zuweisungen im Menü Discord VIP des Panels (auch /vip auf Discord und Gewinnspielpreise).
  5. 5Abgelaufene Rollen werden automatisch entfernt; Vorwarnungen werden entsprechend den eingestellten Tagen verschickt.
Panel-BerechtigungFähigkeit
Discord VIP ansehenVIP-Zuweisungen einsehen
Discord VIP verwaltenVIP vergeben, verlängern und entziehen
Discord-Gewinnspiele (Teilnehmen-Button, VIP-/Item-Preise) sind im Abschnitt Gewinnspiele dokumentiert.

VIP ingame nutzen (Exports)

Adictos_WebLogs cacht die aktiven VIPs des Panels beim Start und aktualisiert sie bei Vergabe/Entzug/Ablauf. In deinen Skripten kannst du den Rang des Spielers mit diesen Exports (Server) auslesen:

ExportRückgabewert
GetPlayerRank(src)Rangname ("VIP", "VIP+", "PRO"…) oder false
GetPlayerRankInfo(src)Details: role_name, esx_job, end_date_ms, …
EnsurePlayerRank(src)Stellt sicher, dass der Rang für diesen Spieler im Cache liegt (nützlich beim Verbinden)
HasPlayerRank(src)true, wenn ein aktiver Rang vorhanden ist
-- Ejemplo en tu script (servidor)
local src = source
local rank = exports['Adictos_WebLogs']:GetPlayerRank(src)

if rank == 'VIP++' then
    -- ventaja máximo rango
elseif rank == 'VIP+' then
    -- …
elseif rank then
    -- cualquier otro nombre configurado en DiscordBot (VIP, PRO, …)
else
    -- sin VIP
end

local info = exports['Adictos_WebLogs']:GetPlayerRankInfo(src)
-- info.role_name, info.esx_job, info.end_date_ms
-- Al conectar / personaje listo
AddEventHandler('esx:playerLoaded', function(playerId)
    local src = tonumber(playerId) or source
    exports['Adictos_WebLogs']:EnsurePlayerRank(src)
end)

-- Cambio en caliente (panel asignó o caducó VIP)
AddEventHandler('adictos_weblogs:playerVipUpdated', function(src, info)
    print(('VIP src=%s rank=%s'):format(src, tostring(info.role_name)))
end)
Der Rang ist der exakte Rollenname aus DiscordBot (VIP, PRO, Pro+, …). Vergleiche in deinen Skripten mit genau diesem String.

Teamrollen auf Discord

Wähle unter Meine Server → DiscordBot → Teamrollen die Rolle Administrator und/oder Moderator deines Discords.

  • In Ticket-Threads schreibt, wer diese Rollen hat, als Team (nicht als Spieler).
  • Sie können Tickets übernehmen, schließen und wieder öffnen und im Ticket /add, /remove sowie den Alias /ticketadd mit einem Nutzer oder einer Rolle verwenden.
  • Sie können den Befehl /vip im konfigurierten Teamkanal nutzen.

Erforderliche Rolle auf Ticket-Buttons

Unter Ticket-Einstellungen → Discord-Panel kannst du eine Nachricht mit Buttons veröffentlichen. Jeder Button kann eine bestimmte Rolle verlangen (Spenden, Whitelist, Community…). Nur Mitglieder mit dieser Rolle können über diesen Button ein Ticket öffnen.

Ticket-Sperrliste nach Rolle

Ticket-Einstellungen → Sperrliste → Typ Discord-Rolle. Verhindert, dass Mitglieder mit dieser Rolle Tickets öffnen (vollständig oder nur in ausgewählten Kategorien). Praktisch, um Sanktionsrollen oder eingeschränkte Konten zu isolieren.

Discord-Ticket-Bot

Eigener Worker, der Threads mit dem Panel synchronisiert. Nachdem du DiscordBot verbunden und die Kanäle unter Ticket-Einstellungen → Discord-Sync konfiguriert hast, startest du den Bot unter Panel Settings → WebLogs.

  • Spieler: Panel-Buttons, /ticket oder der Befehl der Kategorie (z. B. /new).
  • Team: in diesem Befehl optional objetivo (Nutzer oder Rolle). Der Nutzer wird Inhaber und einmal erwähnt; die Rolle kommt wie mit /add hinzu, ohne Massenerwähnung. Im Ticket /add und /remove (Nutzer oder Rolle). /ticketadd ist ein Alias von /add. In einem privaten Thread lässt sich keine Rolle hinzufügen: Stattdessen werden ihre Mitglieder bis zu einem Limit hinzugefügt.
  • Thread-Nachrichten ↔ Webpanel und ingame (wenn der Spieler in players verknüpft ist).