Dokumentation / Discord-Ranking

Discord-Ranking

Öffentliche Bestenlisten auf Discord (Zombies, Angeln, Items…) mit Buttons und Seitenumbruch. Premium-Plan.

Veröffentliche bis zu 2 Panels pro Server. Die Kanalnachricht zeigt die Top-Liste; jeder Spieler klickt auf Ranking ansehen und blättert in einer Nachricht, die nur er sieht. Premium-Plan · WebLogs ≥ 9.6.

Einrichtung

  1. 1Meine Server → DiscordBot → Verbinden (derselbe Bot wie für VIP, Tickets und Gewinnspiele).
  2. 2Menü Ranking: Kategorien (Zombies wird automatisch angelegt), Emoji, Zurücksetzen und 24h/7T-Ansichten, Embed-Stil.
  3. 3Neues Panel → Discord-Kanal + Kategorien → Veröffentlichen.
  4. 4Addiere in FiveM Punkte mit dem Export (Adictos_Zombies ruft ihn bereits bei jedem Kill auf).
Team: Berechtigungen Ranking ansehen / Ranking verwalten. Flush FiveM → Panel: Panel Settings → Flush Ranking (standardmäßig 5 Min.).

Zeiträume, Zurücksetzen und Events

In jeder Kategorie kannst du die Ansichten Heute, 7 Tage, 30 Tage und Gesamt aktivieren. Die Zeiträume beruhen auf Kalendertagen, daher beginnt Heute um Mitternacht leer – wie ein tägliches Ingame-Ranking. Du kannst auch Beginn und Ende eines Events festlegen: Es zählen nur Punkte innerhalb dieses Zeitraums; zum Ende werden Gewinner (und Top 10) gespeichert und die Bestenliste geleert. Das Zurücksetzen alle N Tage leert die Gesamtwertung automatisch (Panel-Cron).

Wo die Punkte gespeichert werden

Die Tabellen werden beim Öffnen von Ranking oder beim ersten empfangenen Paket automatisch angelegt. Mit der Quelle Export sammeln sich die Punkte im Panel (ranking_scores, Rockstar-Lizenz ohne Präfix license:). Mit der Quelle ox_inventory oder qb_inventory wird das Ranking live aus dem Inventar-JSON in derselben MySQL wie das Panel gelesen. Das Intervall des öffentlichen Embeds stellst du unter Panel Settings → Discord ein.

Tabelle / FeldWofür
ranking_categoriesKategorien (Schlüssel, Emoji oder ohne, Zurücksetzen, Ansichten, Quelle)
ranking_scoresGesamtsummen aus dem Export
ranking_scores_dailyTägliche Buckets: eine Zeile pro Spieler, Kategorie und Tag (Rankings Heute / 7T / 30T)
ranking_event_winnersGewinner und Metadaten beim Abschluss eines Events
ranking_event_standingsAlle archivierten Platzierungen; Aufbewahrung = Log-Tage des Plans (Free/Premium)
ranking_panelsBis zu 2 Discord-Nachrichten (Kanal, Kategorien, Aktualisierung)
servers.weblogs_ranking_configJSON: Modul an/aus, Farbe, Fußzeile, Zeilen pro Seite
Inventar: Wähle in der Kategorie ox_inventory oder qb_inventory und das Item des Servers (dieselbe MySQL wie das Panel). Export: Gib einen beliebigen Schlüssel ein oder nutze eine Vorlage (Zombies, Angeln, Missionen, Anbau, Holzfällen, Bergbau…). Eine neue Export-Kategorie wird auch automatisch angelegt, sobald das erste Paket ankommt.

Export (Adictos_WebLogs)

Cache im Speicher von FiveM und Versand an das Panel alle N Sekunden (Panel Settings → Flush Ranking; standardmäßig 60 s). Optionales Delta (Standard 1).

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 ruft den Export bereits bei jedem Kill auf. Adictos_Quest addiert MisionesDiarias/Semanales/Mensuales + MisionesTotales bei der Abgabe. In anderen Skripten (Ernte, Schmelze, Holzfällen…) eine Zeile pro Ereignis.

Bestenliste aus einem Skript lesen (RankingBoard)

Für Pausenmenüs, HUDs oder eigene Skripte kannst du die Top-Liste beim Panel abfragen (dieselbe Bestenliste wie auf Discord). Erfordert WebLogs ≥ 9.6 und dass die Kategorie unter Ranking → Kategorien existiert.

-- 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é
Feld des BoardsInhalt
entries[]Jede Zeile: rank, player_name, score, license
total / page / pagesSeitenumbruch (Zeilen pro Seite = Ranking → Embed)
period_days0 gesamt · 1 24h · 7 · 30
period_labelLesbarer Text des aktiven Zeitraums
categoryMetadaten (Bezeichnung, Emoji, Quelle Export/Inventar)
Der Kategorieschlüssel ist derselbe wie beim Addieren von Punkten (zombies, pesca…). WebLogs wandelt ihn in Kleinbuchstaben um. Das Panel cacht das Board einige Sekunden (Panel Settings → RankingBoard-Cache, Standard 15 s) für Pausenmenüs mit vielen Spielern; der Cache wird ungültig, sobald neue Punkte eintreffen. Live-Inventarkategorien (ox/qb) werden nicht gecacht.

So sieht das Embed aus

Öffentliche Nachricht (Standardkategorie, erste Seite). Farbe und Fußzeile bearbeitest du unter Ranking → Embed.

Wochenranking — 🧟 Zombies
🥇 Carlos — 1.234
🥈 María — 890
🥉 Luis — 512
#4 Ana — 120
#5 Pedro — 98
24h · Top 10 · Klicke auf Ranking ansehen, um zu blättern (nur du)
🧟 Zombies🐟 Angeln24h7 TageRanking ansehen
Wenn du auf Ranking ansehen, eine andere Kategorie oder einen Zeitraum (24h / 7 Tage) klickst, antwortet Discord mit einer flüchtigen Nachricht (nur für dich) und ◀ ▶-Buttons. Die Kanalnachricht ändert sich für die anderen nicht.

Fehlerbehebung

ProblemWas prüfen
Punkte steigen nichtWebLogs ≥ 9.6, Ranking-Modul AN, Export mit der source des Spielers, Flush in den Panel Settings
Embed wird nicht veröffentlichtDiscordBot verbunden; Textkanal; der Bot darf Embeds und Buttons senden
Buttons reagieren nichtInteractions Endpoint URL des Bots zeigt auf das Panel (wie bei Gewinnspielen)
401 Unauthorized beim VeröffentlichenUngültiger Bot-Token. Panel Settings → Discord: Füge den Bot Token ein (Bot → Reset Token), nicht den Public Key. Lade den Bot unter Meine Server → DiscordBot ein.
Inventar bei 0Wähle die Quelle ox_inventory/qb_inventory und das richtige Item; dieselbe MySQL wie das Panel. Oder nutze Export und rufe Ranking(src, Schlüssel) auf.