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
- 1Panel Settings → WebLogs → configurez le bot global (recommandé) ou utilisez votre propre jeton.
- 2Mes serveurs → onglet DiscordBot → Inviter le bot → Connecter et détecter.
- 3Après la détection, les listes déroulantes de rôles et de salons se remplissent automatiquement.
VIP temporaires (Discord VIP)
Attribuez des rôles Discord (VIP, VIP+, PRO, etc.) avec une date d’expiration depuis le panneau :
- 1Mes serveurs → DiscordBot → tableau Rôles VIP : choisissez les rôles de votre Discord (le nom du rôle est le rang en jeu).
- 2Optionnel par rôle : groupe ACE et job ESX (pour l’utiliser en jeu depuis vos scripts).
- 3Configurez le salon du staff, les jours de préavis et les messages automatiques (MP + salon).
- 4Le staff disposant de la permission Discord VIP gère les attributions dans le menu Discord VIP du panneau (aussi
/vipsur Discord et les lots des tirages). - 5Les rôles expirés sont retirés automatiquement ; les préavis sont envoyés selon les jours configurés.
| Permission du panneau | Capacité |
|---|---|
| Voir Discord VIP | Consulter les attributions VIP |
| Gérer Discord VIP | Attribuer, prolonger et retirer le VIP |
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) :
| Export | Ce 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)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,/removeet l’alias/ticketaddavec un utilisateur ou un rôle. - Elles peuvent utiliser la commande
/vipdans 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,
/ticketou la commande de la catégorie (p. ex./new). - Staff : dans cette commande,
objetivooptionnel (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,/addet/remove(utilisateur ou rôle)./ticketaddest 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).