Documentation / Classement Discord

Classement Discord

Classements publics sur Discord (zombies, pêche, objets…) avec boutons et pagination. Plan Premium.

Publiez jusqu’à 2 panneaux par serveur. Le message du salon affiche le top ; chaque joueur clique sur Voir le classement et navigue dans un message visible par lui seul. Plan Premium · WebLogs ≥ 9.6.

Mise en place

  1. 1Mes serveurs → DiscordBot → Connecter (même bot que VIP, tickets et tirages).
  2. 2Menu Ranking : catégories (Zombies est créée automatiquement), emoji, réinitialisation et vues 24h/7j, style de l’embed.
  3. 3Nouveau panneau → salon Discord + catégories → Publier.
  4. 4Dans FiveM, ajoutez des points avec l’export (Adictos_Zombies l’appelle déjà à chaque élimination).
Staff : permissions Voir le classement / Gérer le classement. Flush FiveM → panneau : Panel Settings → Flush Ranking (5 min par défaut).

Périodes, réinitialisation et événements

Dans chaque catégorie, vous pouvez activer les vues Aujourd’hui, 7 jours, 30 jours et Historique. Les périodes sont calculées sur des jours calendaires : Aujourd’hui repart donc de zéro à minuit, comme un classement quotidien en jeu. Vous pouvez aussi définir le début et la fin d’un événement : seuls les points obtenus entre ces dates comptent ; à la fin, le gagnant (et le top 10) est enregistré et le classement est vidé. La réinitialisation tous les N jours vide l’historique automatiquement (cron du panneau).

Où les points sont stockés

Les tables se créent automatiquement à l’ouverture de Ranking ou à la réception du premier lot. Avec la source Export, les points s’accumulent dans le panneau (ranking_scores, licence Rockstar sans le préfixe license:). Avec la source ox_inventory ou qb_inventory, le classement est lu en direct depuis le JSON d’inventaire dans la même MySQL que le panneau. L’intervalle de l’embed public se configure dans Panel Settings → Discord.

Table / champÀ quoi ça sert
ranking_categoriesCatégories (clé, emoji ou sans emoji, réinitialisation, vues, source)
ranking_scoresTotaux historiques de l’export
ranking_scores_dailyBuckets quotidiens : une ligne par joueur, catégorie et jour (classements Aujourd’hui / 7j / 30j)
ranking_event_winnersGagnant et métadonnées à la clôture d’un événement
ranking_event_standingsToutes les positions archivées ; rétention = jours de logs du plan (Free/Premium)
ranking_panelsJusqu’à 2 messages Discord (salon, catégories, rafraîchissement)
servers.weblogs_ranking_configJSON : module on/off, couleur, pied de page, lignes par page
Inventaire : dans la catégorie, choisissez ox_inventory ou qb_inventory et l’objet du serveur (même MySQL que le panneau). Export : saisissez une clé libre ou utilisez un raccourci (Zombies, Pêche, Missions, cultures, Abattage, Minage…). Une nouvelle catégorie export se crée aussi automatiquement à l’arrivée du premier lot.

Export (Adictos_WebLogs)

Cache en mémoire dans FiveM et envoi au panneau toutes les N secondes (Panel Settings → Flush Ranking ; 60 s par défaut). Delta optionnel (1 par défaut).

exports['Adictos_WebLogs']:Ranking(source, 'Zombies')
exports['Adictos_WebLogs']:Ranking(source, 'pesca')
exports['Adictos_WebLogs']:Ranking(source, 'MisionesDiarias')
exports['Adictos_WebLogs']:Ranking(source, 'Tomate', cantidad)
exports['Adictos_WebLogs']:Ranking(source, 'Zombies', 1)  -- delta
Adictos_Zombies appelle déjà l’export à chaque élimination. Adictos_Quest ajoute MisionesDiarias/Semanales/Mensuales + MisionesTotales à la remise. Dans les autres scripts (récolte, fonderie, abattage…), une ligne par événement.

Lire le classement depuis un script (RankingBoard)

Pour les menus pause, HUD ou scripts personnels, vous pouvez demander le top au panneau (même classement que Discord). Nécessite WebLogs ≥ 9.6 et que la catégorie existe dans Ranking → Catégories.

-- Histórico, página 1
exports['Adictos_WebLogs']:RankingBoard('zombies', 1, nil, function(ok, board)
    if not ok or type(board) ~= 'table' then return end
    for _, e in ipairs(board.entries or {}) do
        print(('#%s %s — %s'):format(e.rank, e.player_name, e.score))
    end
end)

-- Ranking 7 días (period: 0=histórico, 1=24h, 7, 30)
exports['Adictos_WebLogs']:RankingBoard('pesca', 1, 7, function(ok, board) ... end)

-- Atajo: solo callback (página 1, histórico)
exports['Adictos_WebLogs']:RankingBoard('zombies', function(ok, board) ... end)

exports['Adictos_WebLogs']:RankingFlush()        -- forzar envío de puntos pendientes
exports['Adictos_WebLogs']:RankingPendingCount() -- cuántos hay en caché
Champ du boardContenu
entries[]Chaque ligne : rank, player_name, score, license
total / page / pagesPagination (lignes par page = Ranking → Embed)
period_days0 historique · 1 24h · 7 · 30
period_labelTexte lisible de la période active
categoryMétadonnées (libellé, emoji, source export/inventaire)
La clé de catégorie est la même que lors de l’ajout de points (zombies, pesca…). WebLogs la normalise en minuscules. Le panneau met le board en cache quelques secondes (Panel Settings → Cache RankingBoard, 15 s par défaut) pour les menus pause avec beaucoup de joueurs ; le cache est invalidé à l’arrivée de nouveaux points. Les catégories d’inventaire (ox/qb) en direct ne sont pas mises en cache.

À quoi ressemble l’embed

Message public (catégorie par défaut, première page). La couleur et le pied de page se modifient dans Ranking → Embed.

Classement hebdomadaire — 🧟 Zombies
🥇 Carlos — 1.234
🥈 María — 890
🥉 Luis — 512
#4 Ana — 120
#5 Pedro — 98
24h · Top 10 · Cliquez sur Voir le classement pour paginer (vous seul)
🧟 Zombies🐟 Pêche24h7 joursVoir le classement
Lorsque vous cliquez sur Voir le classement, une autre catégorie ou une période (24h / 7 jours), Discord répond avec un message éphémère (vous seul) et des boutons ◀ ▶. Le message du salon ne change pas pour les autres.

En cas de problème

ProblèmeQuoi vérifier
Les points n’augmentent pasWebLogs ≥ 9.6, module Ranking ON, export avec le source du joueur, flush dans Panel Settings
L’embed n’est pas publiéDiscordBot connecté ; salon textuel ; le bot peut envoyer des embeds et des boutons
Les boutons ne répondent pasInteractions Endpoint URL du bot pointant vers le panneau (comme pour les tirages)
401 Unauthorized lors de la publicationJeton du bot invalide. Panel Settings → Discord : collez le Bot Token (Bot → Reset Token), pas la Public Key. Invitez le bot dans Mes serveurs → DiscordBot.
Inventaire à 0Choisissez la source ox_inventory/qb_inventory et le bon objet ; même MySQL que le panneau. Ou utilisez Export et appelez Ranking(src, clé).