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
- 1Mes serveurs → DiscordBot → Connecter (même bot que VIP, tickets et tirages).
- 2Menu Ranking : catégories (Zombies est créée automatiquement), emoji, réinitialisation et vues 24h/7j, style de l’embed.
- 3Nouveau panneau → salon Discord + catégories → Publier.
- 4Dans FiveM, ajoutez des points avec l’export (Adictos_Zombies l’appelle déjà à chaque élimination).
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_categories | Catégories (clé, emoji ou sans emoji, réinitialisation, vues, source) |
ranking_scores | Totaux historiques de l’export |
ranking_scores_daily | Buckets quotidiens : une ligne par joueur, catégorie et jour (classements Aujourd’hui / 7j / 30j) |
ranking_event_winners | Gagnant et métadonnées à la clôture d’un événement |
ranking_event_standings | Toutes les positions archivées ; rétention = jours de logs du plan (Free/Premium) |
ranking_panels | Jusqu’à 2 messages Discord (salon, catégories, rafraîchissement) |
servers.weblogs_ranking_config | JSON : module on/off, couleur, pied de page, lignes par page |
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) -- deltaLire 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 board | Contenu |
|---|---|
entries[] | Chaque ligne : rank, player_name, score, license |
total / page / pages | Pagination (lignes par page = Ranking → Embed) |
period_days | 0 historique · 1 24h · 7 · 30 |
period_label | Texte lisible de la période active |
category | Métadonnées (libellé, emoji, source export/inventaire) |
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.
Carlos — 1.234María — 890Luis — 512Ana — 120Pedro — 98En cas de problème
| Problème | Quoi vérifier |
|---|---|
| Les points n’augmentent pas | WebLogs ≥ 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 pas | Interactions Endpoint URL du bot pointant vers le panneau (comme pour les tirages) |
| 401 Unauthorized lors de la publication | Jeton 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 à 0 | Choisissez la source ox_inventory/qb_inventory et le bon objet ; même MySQL que le panneau. Ou utilisez Export et appelez Ranking(src, clé). |