Documentation / Rôles Discord

Rôles Discord

VIP temporaires, exports VIP en jeu, rôles du staff sur Discord, bot et tickets.

Cette section traite des rôles Discord gérés depuis le panneau : VIP avec expiration (lisible en jeu via les exports d’Adictos_WebLogs), qui compte comme staff dans les fils de tickets, rôles exigés sur les boutons du panneau de tickets et liste noire par rôle. À ne pas confondre avec les permissions Steam du panneau (voir la section Permissions du panneau).

Connecter le bot

  1. 1Panel Settings → WebLogs → configurez le bot global (recommandé) ou utilisez votre propre jeton.
  2. 2Mes serveurs → onglet DiscordBot → Inviter le bot → Connecter et détecter.
  3. 3Après la détection, les listes déroulantes de rôles et de salons se remplissent automatiquement.
Dans le Developer Portal, activez Server Members Intent. Le rôle du bot sur Discord doit être au-dessus des rôles VIP qu’il va attribuer.

VIP temporaires (Discord VIP)

Attribuez des rôles Discord (VIP, VIP+, PRO, etc.) avec une date d’expiration depuis le panneau :

  1. 1Mes serveurs → DiscordBot → tableau Rôles VIP : choisissez les rôles de votre Discord (le nom du rôle est le rang en jeu).
  2. 2Optionnel par rôle : groupe ACE et job ESX (pour l’utiliser en jeu depuis vos scripts).
  3. 3Configurez le salon du staff, les jours de préavis et les messages automatiques (MP + salon).
  4. 4Le staff disposant de la permission Discord VIP gère les attributions dans le menu Discord VIP du panneau (aussi /vip sur Discord et les lots des tirages).
  5. 5Les rôles expirés sont retirés automatiquement ; les préavis sont envoyés selon les jours configurés.
Permission du panneauCapacité
Voir Discord VIPConsulter les attributions VIP
Gérer Discord VIPAttribuer, prolonger et retirer le VIP
Les tirages Discord (bouton Participer, lots VIP/objets) sont documentés dans la section Tirages au sort.

Utiliser le VIP en jeu (exports)

Adictos_WebLogs met en cache les VIP actifs du panneau au démarrage et les met à jour lors des attributions/retraits/expirations. Depuis vos scripts, vous pouvez lire le rang du joueur avec ces exports (serveur) :

ExportCe qu’il renvoie
GetPlayerRank(src)Nom du rang ("VIP", "VIP+", "PRO"…) ou false
GetPlayerRankInfo(src)Détail : role_name, esx_job, end_date_ms, …
EnsurePlayerRank(src)Garantit le rang en cache pour ce joueur (utile à la connexion)
HasPlayerRank(src)true s’il a un rang actif
-- 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)
Le rang est le nom exact du rôle dans DiscordBot (VIP, PRO, Pro+, …). Comparez avec cette chaîne dans vos scripts.

Rôles du staff sur Discord

Dans Mes serveurs → DiscordBot → Rôles du staff, choisissez le rôle administrateur et/ou modérateur de votre Discord.

  • Dans les fils de tickets, les personnes ayant ces rôles écrivent en tant que staff (et non en tant que joueur).
  • Elles peuvent réclamer, fermer, rouvrir et, dans le ticket, utiliser /add, /remove et l’alias /ticketadd avec un utilisateur ou un rôle.
  • Elles peuvent utiliser la commande /vip dans le salon du staff configuré.

Rôle requis sur les boutons de tickets

Dans Configuration des tickets → Panneau Discord, vous pouvez publier un message avec des boutons. Chaque bouton peut exiger un rôle précis (dons, whitelist, communauté…). Seuls les membres ayant ce rôle peuvent ouvrir un ticket depuis ce bouton.

Liste noire de tickets par rôle

Configuration des tickets → Liste noire → type Rôle Discord. Empêche quiconque possède ce rôle d’ouvrir des tickets (totalement ou seulement dans certaines catégories). Utile pour isoler des rôles de sanction ou des comptes restreints.

Bot de tickets Discord

Worker séparé qui synchronise les fils avec le panneau. Après avoir connecté DiscordBot et configuré les salons dans Configuration des tickets → Discord sync, démarrez le bot depuis Panel Settings → WebLogs.

  • Joueurs : boutons du panneau, /ticket ou la commande de la catégorie (p. ex. /new).
  • Staff : dans cette commande, objetivo optionnel (utilisateur ou rôle). L’utilisateur devient titulaire et est mentionné une fois ; le rôle entre comme avec /add, sans mention de masse. Dans le ticket, /add et /remove (utilisateur ou rôle). /ticketadd est un alias de /add. Un rôle ne peut pas être ajouté à un fil privé : ce sont ses membres qui entrent, dans une certaine limite.
  • Messages du fil ↔ panneau web et en jeu (si le joueur est lié dans players).