Publish up to 2 panels per server. The channel message shows the top; each player clicks View ranking and browses a message only they can see. Premium plan · WebLogs ≥ 9.6.
Setup
- 1My servers → DiscordBot → Connect (same bot as VIP, tickets and giveaways).
- 2Ranking menu: categories (Zombies is created automatically), emoji, reset and 24h/7d views, embed style.
- 3New panel → Discord channel + categories → Publish.
- 4In FiveM, add points with the export (or Adictos_Zombies already calls it on kills).
Periods, reset and events
In each category you can enable the Today, 7 days, 30 days and All-time views. Periods are calculated on calendar days, so Today starts empty at midnight just like an in-game daily ranking. You can also set the start and end of an event: only points within those dates count; when it ends the winner (and top 10) is recorded and the leaderboard is cleared. The reset every N days clears the all-time board automatically (panel cron).
Where points are stored
The tables are created automatically when you open Ranking or when the first batch arrives. With the Export source, points accumulate in the panel (ranking_scores, Rockstar licence without the license: prefix). With the ox_inventory or qb_inventory source, the ranking is read live from the inventory JSON in the same MySQL as the panel. The public embed interval is configured under Panel Settings → Discord.
| Table / field | What for |
|---|---|
ranking_categories | Categories (key, emoji or no emoji, reset, views, source) |
ranking_scores | All-time totals from the export |
ranking_scores_daily | Daily buckets: one row per player, category and day (Today / 7d / 30d rankings) |
ranking_event_winners | Winner and metadata when an event closes |
ranking_event_standings | All archived standings; retention = the plan’s log days (Free/Premium) |
ranking_panels | Up to 2 Discord messages (channel, categories, refresh) |
servers.weblogs_ranking_config | JSON: module on/off, colour, footer, rows per page |
Export (Adictos_WebLogs)
In-memory cache in FiveM and sending to the panel every N seconds (Panel Settings → Flush Ranking; 60 s by default). Optional delta (1 by default).
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) -- deltaReading the leaderboard from a script (RankingBoard)
For pause menus, HUDs or your own scripts you can request the top from the panel (same leaderboard as Discord). Requires WebLogs ≥ 9.6 and the category to exist under Ranking → Categories.
-- 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é| Board field | What it contains |
|---|---|
entries[] | Each row: rank, player_name, score, license |
total / page / pages | Pagination (rows per page = Ranking → Embed) |
period_days | 0 all-time · 1 24h · 7 · 30 |
period_label | Readable text of the active period |
category | Metadata (label, emoji, export/inventory source) |
zombies, pesca…). WebLogs normalises it to lowercase. The panel caches the board for a few seconds (Panel Settings → RankingBoard cache, default 15 s) for pause menus with many players; it is invalidated when new points arrive. Live inventory categories (ox/qb) are not cached.What the embed looks like
Public message (default category, first page). Colour and footer are edited under Ranking → Embed.
Carlos — 1.234María — 890Luis — 512Ana — 120Pedro — 98Troubleshooting
| Problem | What to check |
|---|---|
| Points don’t go up | WebLogs ≥ 9.6, Ranking module ON, export with the player’s source, flush in Panel Settings |
| Embed isn’t posted | DiscordBot connected; text channel; the bot can send embeds and buttons |
| Buttons don’t respond | The bot’s Interactions Endpoint URL pointing to the panel (as with giveaways) |
| 401 Unauthorized when posting | Invalid bot token. Panel Settings → Discord: paste the Bot Token (Bot → Reset Token), not the Public Key. Invite the bot under My servers → DiscordBot. |
| Inventory at 0 | Choose the ox_inventory/qb_inventory source and the correct item; same MySQL as the panel. Or use Export and call Ranking(src, key). |